v0.2.0-beta

OpenAPI 3.1.0

הגדרת משימות ‘Ad Traffic By Keywords’

Felo API Support

MIT

שרת

https://openapi.felo.ai

ספריות לקוח

Shell Curl

DataForSEO

SEO, search-engine results, keyword research, backlinks and AI visibility data.

DataForSEO פעולות

post/v1/beta/dataforseo/keywords_data/google_ads/ad_traffic_by_keywords/task_post

הגדרת משימות ‘Ad Traffic By Keywords’

מעמיד בתור תחזית של קליקים, חשיפות והוצאה עבור keywords ב-bid ובסוג match נתונים, ומחזיר id של משימה. search_partners כולל את רשת השותפים של Google. התגובה עטופה במעטפת של DataForSEO: הנתונים ב-tasks[0].result, והתוצאה ב-tasks[0].status_code — גם בקשה שנדחתה מחזירה HTTP 200. זו נקודת הקצה היחידה של Google Ads כאן בלי וריאנט חי — תחזית תמיד נכנסת לתור. אחזרו עם get_dataforseo_keywords_gads_ad_traffic_fetch.

מראה תמחור

מדידה: עלות תגובה מדווחת.
אומדן בקשת עיון: 0.09 דולר ארה״ב.
מכפיל לקוח לעיון: 1.0. אין להחיל אותו בשנית על סכום לקוח שכבר נקבע.

זהו מטא-נתון לעיון בלבד, לא הצעת מחיר לחשבון, לא מחיר מובטח ולא תקרת הוצאה. קרדיטי משאבים אינם קרדיטים של Felo. החיוב הסופי נעשה לפי רשומות החיוב של Felo.

גוף

application/json

סוג: array (object | null)[]
- bid
  סוג: number
  
  ההצעה המותאמת המרבית
  שדה חובה
  הנתונים שנאספים יתבססו על הערך הזה
  הוא מייצג את המחיר שאתם מוכנים לשלם עבור מודעה; ככל שהערך שתציינו כאן גבוה יותר, כך תקבלו ערכים גבוהים יותר במדדים המוחזרים
  מידע נוסף במאמר מרכז העזרה הזה
- date_from
  סוג: string
  
  תאריך התחלה של טווח זמן החיזוי
  שדה חובה אם מציינים date_to
  אם תציינו date_from ו-date_to, אין צורך לציין date_interval
  הערך המינימלי הוא תאריך המחר
  הערך שתציינו ב-date_from לא צריך להיות מאוחר מ-date_to
  פורמט תאריך: "yyyy-mm-dd"
  דוגמה:
  "2021-10-30" אם נקודת הקצה Status מחזירה false בשדה actual_data, אפשר להגדיר את date_from לחודש שלפני האחרון ולחודשים שקדמו לו;
  אם נקודת הקצה Status מחזירה true בשדה actual_data, אפשר להגדיר את date_from לחודש האחרון ולחודשים שקדמו לו
- date_interval
  סוג: string | null
  
  מרווח תאריכים לחיזוי
  שדה אופציונלי
  אם תציינו date_interval, אין צורך לציין date_from ו-date_to
  ערכים אפשריים: next_week, next_month, next_quarter
  ערך ברירת מחדל: next_month
- date_to
  סוג: string
  
  תאריך סיום של טווח זמן החיזוי
  שדה חובה אם מציינים date_from
  אם תציינו date_from ו-date_to, אין צורך לציין date_interval
  הערך המינימלי הוא date_from + יום אחד
  הערך המרבי הוא היום והחודש הנוכחיים של השנה הבאה
  פורמט תאריך: "yyyy-mm-dd"
  דוגמה:
  "2022-10-30"
- keywords
  סוג: array string[]
  
  מילות מפתח
  שדה חובה
  המספר המרבי של מילות מפתח שאפשר לציין: 1000
  המספר המרבי של תווים בכל מילת מפתח: 80
  המספר המרבי של מילים בכל ביטוי מפתח: 10
  מילות המפתח שתציינו יומרו לאותיות קטנות
  הערה 1: ייתכן ש-Google Ads לא תחזיר נתונים עבור קבוצות מסוימות של מילות מפתח;
  הערה 2: Google Ads מספקת ערכי נפח חיפוש משולבים עבור קבוצות של מילות מפתח דומות
  כדי לקבל נפח חיפוש עבור מילות מפתח דומות, מומלץ לשלוח אותן בבקשות נפרדות;
  הערה 3: Google Ads לא מאפשרת להשתמש בסימנים ובתווים מסוימים (למשל תווי UTF ואימוג'ים), ולכן אי אפשר להשתמש בהם בעת הגדרת משימה;
  למידע נוסף על הסימנים והתווים המותרים, ראו את המאמר הזה
  
  מידע נוסף על הכללים והמגבלות של השדות keyword ו-keywords ב-DataForSEO API מופיע במאמר במרכז העזרה
- language_code
  סוג: string | null
  
  קוד שפת מנוע החיפוש
  שדה אופציונלי
  אפשר לקבל את רשימת השפות הזמינות של מנוע החיפוש עם language_code שלהן על ידי שליחת בקשה נפרדת אל https://api.dataforseo.com/v3/keywords_data/google_ads/languages
  דוגמה:
  en
- language_name
  סוג: string | null
  
  השם המלא של שפת מנוע החיפוש
  שדה אופציונלי
  אפשר לקבל את רשימת השפות הזמינות של מנוע החיפוש עם language_name שלהן על ידי שליחת בקשה נפרדת אל https://api.dataforseo.com/v3/keywords_data/google_ads/languages
  דוגמה:
  English
- location_code
  סוג: integer | null
  
  קוד מיקום מנוע החיפוש
  שדה אופציונלי
  אם לא תציינו מיקום, תקבלו תוצאות עולמיות, כלומר עבור כל המיקומים הזמינים;
  אם תשתמשו בשדה הזה, אין צורך לציין location_name או location_coordinate;
  אפשר לקבל את רשימת המיקומים הזמינים של מנועי החיפוש עם location_code שלהם על ידי שליחת בקשה נפרדת אל https://api.dataforseo.com/v3/keywords_data/google_ads/locations
  דוגמה:
  2840
- location_coordinate
  סוג: string | null
  
  קואורדינטות GPS של מיקום
  שדה אופציונלי
  אם לא תציינו מיקום, תקבלו תוצאות עולמיות, כלומר עבור כל המיקומים הזמינים;
  אם תשתמשו בשדה הזה, אין צורך לציין location_name או location_code;
  יש לציין את הפרמטר location_coordinate בפורמט "latitude,longitude";
  הנתונים יסופקו עבור המדינה שאליה שייכות הקואורדינטות שצוינו;
  דוגמה:
  52.6178549,-155.352142
- location_name
  סוג: string | null
  
  השם המלא של מיקום מנוע החיפוש
  שדה אופציונלי
  אם לא תציינו מיקום, תקבלו תוצאות עולמיות, כלומר עבור כל המיקומים הזמינים;
  אם תשתמשו בשדה הזה, אין צורך לציין location_code או location_coordinate
  אפשר לקבל את רשימת המיקומים הזמינים של מנוע החיפוש עם location_name שלהם על ידי שליחת בקשה נפרדת אל https://api.dataforseo.com/v3/keywords_data/google_ads/locations
  דוגמה:
  London,England,United Kingdom
- match
  סוג: string
  
  סוג התאמת מילות מפתח
  שדה חובה
  יכול לקבל את הערכים הבאים: exact, broad, phrase
- pingback_url
  סוג: string | null
  
  כתובת URL להתראה על השלמת משימה
  שדה אופציונלי
  כשהמשימה תושלם, נודיע לכם באמצעות בקשת GET שתישלח לכתובת ה-URL שציינתם
  אפשר להשתמש במחרוזת ‘$id’ כמשתנה $id וב-‘$tag’ כמשתנה $tag מקודד ב-urlencoded. נעדכן את הערכים הנדרשים לפני שליחת הבקשה.
  דוגמה:
  http://your-server.com/pingscript?id=$id
  http://your-server.com/pingscript?id=$id&tag=$tag
  הערה: תווים מיוחדים ב-pingback_url יקודדו ב-urlencoded;
  לדוגמה, התו # יקודד ל-%23
  
  מידע נוסף במרכז העזרה שלנו
- postback_url
  סוג: string | null
  
  כתובת URL לשליחת תוצאות המשימה
  שדה אופציונלי
  כשהמשימה תושלם, נשלח בקשת POST עם התוצאות שלה דחוסות בפורמט gzip אל ה-postback_url שציינתם
  אפשר להשתמש במחרוזת ‘$id’ כמשתנה $id וב-‘$tag’ כמשתנה $tag מקודד ב-urlencoded. נעדכן את הערכים הנדרשים לפני שליחת הבקשה.
  דוגמה:
  http://your-server.com/postbackscript?id=$id
  http://your-server.com/postbackscript?id=$id&tag=$tag
  הערה: תווים מיוחדים ב-postback_url יקודדו ב-urlencoded;
  לדוגמה, התו # יקודד ל-%23
  
  מידע נוסף במרכז העזרה שלנו
- sort_by
  סוג: string | null
  
  פרמטרי מיון תוצאות
  שדה אופציונלי
  השתמשו בפרמטרים האלה כדי למיין את התוצאות לפי relevance, average_cpc, cost או clicks בסדר יורד
  ערך ברירת מחדל: relevance
- tag
  סוג: string | null
  
  מזהה משימה מוגדר על ידי המשתמש
  שדה אופציונלי
  מגבלת התווים היא 255
  אפשר להשתמש בפרמטר הזה כדי לזהות את המשימה ולהתאים אותה לתוצאה
  את ערך ה-tag שציינתם תמצאו באובייקט data של התגובה

תגובות

200
סוג: object | null · Response36Afe1097B20_KeywordsDataGoogleAdsAdTrafficByKeywordsTaskPostResponseInfo
cost
סוג: number | null פורמט: double

סך עלות המשימות, בדולר ארה״ב

status_code
סוג: integer | null

קוד סטטוס כללי את הרשימה המלאה של קודי התגובה אפשר למצוא כאן

status_message
סוג: string | null

הודעה אינפורמטיבית כללית את הרשימה המלאה של ההודעות האינפורמטיביות הכלליות אפשר למצוא כאן

tasks
סוג: array (object | null)[] | null

מערך משימות

סוג: object | null · Response36Afe1097B20_KeywordsDataGoogleAdsAdTrafficByKeywordsTaskPostTaskInfo
cost
סוג: number | null פורמט: double

סך עלות המשימות, בדולר ארה״ב

data
סוג: object | null

מכיל את אותם הפרמטרים שציינתם בבקשת POST

propertyName
סוג: object | null
id
סוג: string | null

מזהה משימה מזהה משימה ייחודי במערכת שלנו בפורמט UUID

path
סוג: array (string | null)[] | null

נתיב URL

result
סוג: object | null

מערך תוצאות
במקרה זה, הערך יהיה null

result_count
סוג: integer | null פורמט: int64

מספר הפריטים במערך result

status_code
סוג: integer | null

קוד הסטטוס של המשימה נוצר על ידי DataForSEO ויכול להיות בטווח הבא: 10000-60000 את הרשימה המלאה של קודי התגובה אפשר למצוא כאן

status_message
סוג: string | null

הודעה אינפורמטיבית של המשימה את הרשימה המלאה של ההודעות האינפורמטיביות הכלליות אפשר למצוא כאן

time
סוג: string | null

זמן ביצוע, בשניות

tasks_count
סוג: integer | null פורמט: int64

מספר המשימות במערך tasks

tasks_error
סוג: integer | null פורמט: int64

מספר המשימות במערך tasks שהוחזרו עם שגיאה

time
סוג: string | null

זמן ביצוע כולל, בשניות

version
סוג: string | null

הגרסה הנוכחית של ה-API
application/json
400

לא ניתן היה לעבד את הבקשה. בדקו את פרמטרי הבקשה.
401

נדרש מפתח API תקף של Felo.
402

לא ניתן להמשיך את הבקשה משום שדרישת חיוב אינה מתקיימת.
403

החשבון אינו מורשה לבצע את הפעולה הזו.
429

הגעתם למגבלת בקשות או לתקרת הוצאה.
502

השירות לא הצליח להשלים את הבקשה.
503

שירות ה-API או החיוב אינו זמין באופן זמני.
504

השירות פג בזמן הטיפול בבקשה.
default

תגובת שגיאה; תגובות מעבר מהמעלה הזרם עשויות להשתמש בפורמטים של הספק

application/json

post/v1/beta/dataforseo/keywords_data/google_ads/ad_traffic_by_keywords/task_post

curl https://openapi.felo.ai/v1/beta/dataforseo/keywords_data/google_ads/ad_traffic_by_keywords/task_post \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "language_code": "en",
    "location_code": 2840,
    "bid": 999,
    "match": "exact",
    "keywords": [
      "seo marketing"
    ]
  }
]'

הצגת סכמה

{
  "version": null,
  "status_code": null,
  "status_message": null,
  "time": null,
  "cost": null,
  "tasks_count": null,
  "tasks_error": null,
  "tasks": [
    {
      "id": null,
      "status_code": null,
      "status_message": null,
      "time": null,
      "cost": null,
      "result_count": null,
      "path": [
        null
      ],
      "data": null,
      "result": null
    }
  ]
}

פעולה מוצלחת

הגדרת משימות ‘Ad Traffic By Keywords’

אימותRequired

DataForSEO

הגדרת משימות ‘Ad Traffic By Keywords’

מראה תמחור