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