Felo API PlatformFelo API Platform
כל ה-endpoints של DataForSEO
v0.2.0-beta
OpenAPI 3.1.0

הגדרת משימות ‘Bing Ads Audience Estimation’ בזמן אמת

Felo API Support
MIT
שרת:https://openapi.felo.ai
ספריות לקוח
Shell Curl

DataForSEO

​

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

DataForSEO פעולות

הגדרת משימות ‘Bing Ads Audience Estimation’ בזמן אמת

​

מעריך את קהל Bing Ads שניתן להגיע אליו ב-bid ו-daily_budget נתונים, בצמצום לפי location_code, age, תעשייה ותפקיד עבודה. התגובה עטופה במעטפת של DataForSEO: הנתונים ב-tasks[0].result, והתוצאה ב-tasks[0].status_code — גם בקשה שנדחתה מחזירה HTTP 200. ערכי התעשייה ותפקידי העבודה מגיעים מ-get_dataforseo_keywords_bing_audience_industries ומ-get_dataforseo_keywords_bing_audience_job_functions — שניהם בחינם, ושניהם שווים קריאה לפני הרכבת בקשה. תאומי השליחה והאחזור של נקודת קצה זו מבצעים את אותה עבודה באופן אסינכרוני, באותו מחיר, עבור אצוות גדולות מכדי להמתין להן.

מראה תמחור

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

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

גוף
application/json
  • סוג: array (object | null)[]
    • age
      סוג: array string[] | null

      בחירת טווחי גיל למיקוד
      ערכים אפשריים: eighteen_to_twenty_four, fifty_to_sixty_four, sixty_five_and_above, thirteen_to_seventeen, thirty_five_to_forty_nine, twenty_five_to_thirty_four, unknown, zero_to_twelve

    • bid
      סוג: number | null

      ערך הגדרת הצעת מחיר רצוי בדולר ארה״ב
      הערך המרבי: 1000

    • daily_budget
      סוג: number | null

      ערך תקציב יומי לקמפיין בדולר ארה״ב
      הערך המרבי: 10000

    • gender
      סוג: array string[] | null

      מין למיקוד
      ערכים אפשריים: male, female, unknown

    • industry
      סוג: array string[] | null

      ענף של מיקוד פרופיל LinkedIn

      אם משתמשים בשדה הזה, אפשר לקבל את רשימת שמות הענפים הזמינים עם industry_id על ידי שליחת בקשה נפרדת אל https://api.dataforseo.com/v3/keywords_data/bing/audience_estimation/industries

      דוגמה: 806301758

    • job_function
      סוג: array string[] | null

      תפקיד של מיקוד פרופיל LinkedIn

      אם משתמשים בשדה הזה, אפשר לקבל את רשימת שמות התפקידים הזמינים עם job_function_id על ידי שליחת בקשה נפרדת אל https://api.dataforseo.com/v3/keywords_data/bing/audience_estimation/job_functions

      דוגמה: 806300451

    • location_code
      סוג: integer

      קוד מיקום של מנוע החיפוש
      שדה חובה אם לא מציינים location_name או location_coordinate
      אם משתמשים בשדה הזה, אין צורך לציין location_name או location_coordinate
      אפשר לקבל את רשימת המיקומים הזמינים של מנועי החיפוש עם location_code שלהם על ידי שליחת בקשה נפרדת אל https://api.dataforseo.com/v3/keywords_data/bing/locations
      דוגמה:
      2840

    • location_coordinate
      סוג: string

      קואורדינטות GPS של מיקום
      שדה חובה אם לא מציינים location_name או location_code
      אם משתמשים בשדה הזה, אין צורך לציין location_name או location_code
      יש לציין את הפרמטר location_coordinate בפורמט "latitude,longitude,radius (in km)"
      הנתונים יסופקו עבור המדינה שהקואורדינטות שצוינו שייכות אליה
      דוגמה:
      29.6821525,-82.4098881,100

    • location_name
      סוג: string

      השם המלא של מיקום מנוע החיפוש
      שדה חובה אם לא מציינים location_code או location_coordinate
      אם משתמשים בשדה הזה, אין צורך לציין location_code או location_coordinate
      אפשר לקבל את רשימת המיקומים הזמינים של מנוע החיפוש עם location_name שלהם על ידי שליחת בקשה נפרדת אל https://api.dataforseo.com/v3/keywords_data/bing/locations
      דוגמה:
      London,England,United Kingdom

תגובות
  • 200
    סוג: object | null · Response36Afe1097B20_KeywordsDataBingAudienceEstimationLiveResponseInfo
    • cost
      סוג: number | null פורמט: double

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

    • status_code
      סוג: integer | null

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

    • status_message
      סוג: string | null

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

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

      מערך משימות

      • סוג: object | null · Response36Afe1097B20_KeywordsDataBingAudienceEstimationLiveTaskInfo
        • 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

          מערך תוצאות

          • currency
            סוג: string | null

            שם המטבע

            דוגמה: USDollar

          • est_audience_size
            סוג: object | null · Response36Afe1097B20_AudienceEstimationInfo

            טווח מספר המשתמשים המוערך להגעה בחודש

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

              מציין את הגבול העליון של תוצאת הטווח

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

              מציין את הגבול התחתון של תוצאת הטווח

          • est_clicks
            סוג: object | null · Response36Afe1097B20_AudienceEstimationInfo

            טווח מספר הקליקים המוערך בחודש

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

              מציין את הגבול העליון של תוצאת הטווח

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

              מציין את הגבול התחתון של תוצאת הטווח

          • est_cost_per_event
            סוג: object | null · Response36Afe1097B20_AudienceEstimationInfo

            מציין את העלות המוערכת לאירוע עם תוצאה בטווח

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

              מציין את הגבול העליון של תוצאת הטווח

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

              מציין את הגבול התחתון של תוצאת הטווח

          • est_ctr
            סוג: object | null · Response36Afe1097B20_AudienceEstimationInfo

            טווח שיעור הקלקה מוערך

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

              מציין את הגבול העליון של תוצאת הטווח

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

              מציין את הגבול התחתון של תוצאת הטווח

          • est_impressions
            סוג: object | null · Response36Afe1097B20_AudienceEstimationInfo

            טווח החשיפות המוערך בחודש

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

              מציין את הגבול העליון של תוצאת הטווח

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

              מציין את הגבול התחתון של תוצאת הטווח

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

            מספר המשתמשים המוערך בחודש

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

            החשיפות המוערכות בחודש

          • est_spend
            סוג: object | null · Response36Afe1097B20_AudienceEstimationInfo

            טווח ההוצאה המוערך בחודש

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

              מציין את הגבול העליון של תוצאת הטווח

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

              מציין את הגבול התחתון של תוצאת הטווח

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

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

          • events_lost_to_budget
            סוג: integer | null

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

          • suggested_bid
            סוג: number | null

            ערך ההצעה המומלץ תחת המיקוד הנוכחי

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

            ערך התקציב היומי המומלץ תחת המיקוד וההצעה הנוכחיים

        • 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
Request Example for post/v1/beta/dataforseo/keywords_data/bing/audience_estimation/live
curl https://openapi.felo.ai/v1/beta/dataforseo/keywords_data/bing/audience_estimation/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "location_coordinate": "29.6821525,-82.4098881,100",
    "age": [
      "twenty_five_to_thirty_four",
      "eighteen_to_twenty_four",
      "unknown"
    ],
    "bid": 1,
    "daily_budget": 24,
    "gender": [
      "male"
    ],
    "industry": [
      "806303407",
      "806301758"
    ],
    "job_function": [
      "806298607"
    ]
  }
]'

{
  "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": [
        {
          "est_impressions": {
            "high": null,
            "low": null
          },
          "est_audience_size": {
            "high": null,
            "low": null
          },
          "est_clicks": {
            "high": null,
            "low": null
          },
          "est_spend": {
            "high": null,
            "low": null
          },
          "est_cost_per_event": {
            "high": null,
            "low": null
          },
          "est_ctr": {
            "high": null,
            "low": null
          },
          "suggested_bid": null,
          "suggested_budget": null,
          "events_lost_to_bid": null,
          "events_lost_to_budget": null,
          "est_reach_audience_size": null,
          "est_reach_impressions": null,
          "currency": null
        }
      ]
    }
  ]
}

פעולה מוצלחת

Setting Live ‘Bing Ads Audience Estimation’ Tasks