v0.2.0-beta

OpenAPI 3.1.0

קבלת תוצאות ‘Ads Traffic By Keywords’ לפי id

Felo API Support

MIT

שרת

https://openapi.felo.ai

ספריות לקוח

Shell Curl

DataForSEO

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

DataForSEO פעולות

get/v1/beta/dataforseo/keywords_data/google_ads/ad_traffic_by_keywords/task_get/{id}

קבלת תוצאות ‘Ads Traffic By Keywords’ לפי id

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

מראה תמחור

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

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

פרמטרי נתיב

id
סוג: string
חובה

מזהה המשימה
מזהה משימה ייחודי במערכת שלנו בפורמט UUID
אפשר להשתמש בו במשך 30 יום כדי לבקש את תוצאות המשימה בכל עת

תגובות

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

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

status_code
סוג: integer | null

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

status_message
סוג: string | null

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

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

מערך משימות

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

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

data
סוג: object | null

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

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

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

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

נתיב URL

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

מערך תוצאות

average_cpc
סוג: number | null פורמט: double

ערך עלות הקליקה הממוצע
מייצג את עלות הקליקה (בדולר ארה״ב) המוערכת עבור מילת מפתח בהתבסס על פרק הזמן שצוין ונתונים היסטוריים;
אם אין נתונים, הערך הוא_nulln

bid
סוג: number | null

ההצעה המותאמת המקסימלית
ההצעה שציינתם בעת הגדרת המשימה
מייצג את המחיר שאתם מוכנים לשלם עבור מודעה
ככל שהערך שציינתם גבוה יותר, כך תקבלו מדדים ועלות גבוהים יותר בתגובה
מידע נוסף במאמר מרכז העזרה הזה

clicks
סוג: number | null

מספר הקליקים על מודעה
מספר הקליקים שמודעה צפויה לקבל בפרק הזמן שצוין
אם אין נתונים, הערך הוא_nulln

cost
סוג: number | null

חיוב עבור מודעה
הסכום שיחויב עבור הרצת מודעה בפרק הזמן שצוין
אם אין נתונים, הערך הוא_nulln

ctr
סוג: number | null פורמט: double

שיעור הקלקה (CTR) חזוי של המודעה
מספר הקליקים שמודעה צפויה לקבל חלקי מספר חשיפות המודעה;
הערה: הפרמטר מיושן, הערך תמיד null

date_interval
סוג: string | null

מרווח תאריכי התחזית במערך POST

impressions
סוג: integer | null

מספר חשיפות המודעה החזוי
מספר החשיפות שמודעה צפויה לקבל בפרק הזמן שצוין
הערה: הפרמטר מיושן, הערך תמיד_nulln

keyword
סוג: string | null

מילת מפתח במערך POST
המדדים מסופקים עבור כל מילות המפתח שצוינו במערך POST

language_code
סוג: string | null

קוד שפה במערך POST
אם אין נתונים, הערך הוא null

location_code
סוג: integer | null

קוד מיקום במערך POST
אם אין נתונים, הערך הוא null

match
סוג: string | null

סוג ההתאמה של מילות מפתח
יכול לקבל את הערכים הבאים: exact, broad, phrase

search_partners
סוג: boolean | null

כלול שותפי חיפוש של Google
הערך תמיד false

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

get/v1/beta/dataforseo/keywords_data/google_ads/ad_traffic_by_keywords/task_get/{id}

curl https://openapi.felo.ai/v1/beta/dataforseo/keywords_data/google_ads/ad_traffic_by_keywords/task_get/00000000-0000-0000-0000-000000000000 \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

הצגת סכמה

{
  "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": [
        {
          "keyword": null,
          "location_code": null,
          "language_code": null,
          "date_interval": null,
          "search_partners": null,
          "bid": null,
          "match": null,
          "impressions": null,
          "ctr": null,
          "average_cpc": null,
          "cost": null,
          "clicks": null
        }
      ]
    }
  ]
}

פעולה מוצלחת

קבלת תוצאות ‘Ads Traffic By Keywords’ לפי id

אימותRequired

DataForSEO

קבלת תוצאות ‘Ads Traffic By Keywords’ לפי id

מראה תמחור