الإصدار 2 من واجهة API إعداد التقارير

يوضح هذا الدليل كيفية تنفيذ الإصدار 2 من API إعداد تقارير Audience Network للحصول بيانات الأداء للنشاط التجاري.

المتطلبات الأساسية

• تطبيق Meta بحالة استخدام تسجيل دخول فيسبوك والإذن `read_audience_network_insights`
• تسجيل دخول فيسبوك في التطبيق
• استعلام اختباري ناجح لنقطة نهاية Graph API والإذن read_audience_network_insights
• إكمال ناجح لمراجعة تطبيق Meta
• رمز وصول مستخدم طويل الأجل

التوصيات

• نظرًا إلى الكميات الكبيرة من البيانات التي تم إرجاعها في كل استعلام، يوصى بتقسيم الصفحات استنادًا إلى المؤشر . يتم إرجاع النتائج المقسمة فورًا للطلبات المتزامنة وهو الأسلوب المفضل لاسترجاع التقسيمات.

التقييدات

• يتم إرجاع كل البيانات بتنسيق المنطقة الزمنية بتوقيت جرينتش
• يتم إرجاع أدوات قياس الإيرادات استنادًا إلى عدد مرات ظهور الإعلان

  • إذا لم تتوفر البيانات، فنوصي بالاستعلام عن إجمالي عدد مرات ظهور الإعلان والإيرادات
• لا يمكن استخدام رموز وصول المستخدم التي تم إنشاؤها في مدير الأرباح أو مدير الأعمال

تحديثات التجميع

مرات الظهور والإيرادات اليومية

يمكنك الاستعلام عن عدد مرات الظهور والإيرادات للموضع من1-4 مايو 2022 من خلال التقسيم اليومي.

التغييرات التي قد تحدث: قد ترى أن بعض البيانات غير متوفرة بعد التغيير.

لن يتم تضمين الإيرادات ونقاط بيانات التكلفة لكل ألف ظهور غير المتوفرة في حقل results من استجابة واجهة API نتيجةً لعدد مرات ظهور الإعلانات غير الكافي. بدلاً من ذلك، ستتم إضافة الإدخالات المقابلة إلى حقل omitted_results. ستتضمن حقول الوقت وأداة القياس والتقسيمات، ولكن لن تتضمن القيمة، يُرجى الرجوع إلى عينة من الاستجابة في الجزء السفلي من هذه الصفحة.

بنية الطلب

استخدم نقطة نهاية GET ID > adnetworkanalytics للحصول على رؤى audience network لأي نشاط تجاري أو خاصية أو تطبيق.

GET /<ID>/adnetworkanalytics

مثال على طلب GET

للحصول على رؤى، أرسل طلب GET إلى نقطة النهاية /<ID>/adnetworkanalytics مع قائمة مفصولة بفاصلة لأدوات القياس وقائمة مفصولة بفاصلة اختيارية للتقسيمات حيث يكون <ID> هو معرف النشاط التجاري أو معرف الخاصية أو معرف التطبيق من Meta. يحصل المثال التالي على أدوات القياس على مدار مدة 24 ساعة فردية مع تقييد النتائج إلى استجابتين لكل أداة قياس.

curl -X GET https://graph.facebook.com/v19.0/BUSINESS_ID/adnetworkanalytics
  ?metrics=["fb_ad_network_request","fb_ad_network_imp","fb_ad_network_click","fb_ad_network_revenue"]
  &breakdowns=["placement","country"]
  &since=2021-08-06
  &until=2021-08-06
  &limit=2

مثال على الاستجابة

{
  "data": [
    {
      "query_id": "531234567890123456789012345683d6",
      "results": [
        {
          "time": "2021-08-06T07:00:00+0000",
          "metric": "fb_ad_network_imp",
          "breakdowns": [
            {
              "key": "placement",
              "value": "123456789012345"
            },
            {
              "key": "country",
              "value": "AE"
            }
          ],
          "value": "1200"
        },
        {
          "time": "2021-08-06T07:00:00+0000",
          "metric": "fb_ad_network_imp",
          "breakdowns": [
            {
              "key": "placement",
              "value": "123456789012345"
            },
            {
              "key": "country",
              "value": "AU"
            }
          ],
          "value": "35"
        },
        {
          "time": "2021-08-06T07:00:00+0000",
          "metric": "fb_ad_network_revenue",
          "breakdowns": [
            {
              "key": "placement",
              "value": "123456789012345"
            },
            {
              "key": "country",
              "value": "AE"
            }
          ],
          "value": "21.212345"
        },
        {
          "time": "2021-08-06T07:00:00+0000",
          "metric": "fb_ad_network_request",
          "breakdowns": [
            {
              "key": "placement",
              "value": "123456789012345"
            },
            {
              "key": "country",
              "value": "AD"
            }
          ],
          "value": "1"
        },
        {
          "time": "2021-08-06T07:00:00+0000",
          "metric": "fb_ad_network_request",
          "breakdowns": [
            {
              "key": "placement",
              "value": "123456789012345"
            },
            {
              "key": "country",
              "value": "AE"
            }
          ],
          "value": "12"
        },
        {
          "time": "2021-08-06T07:00:00+0000",
          "metric": "fb_ad_network_click",
          "breakdowns": [
            {
              "key": "placement",
              "value": "123456789012345"
            },
            {
              "key": "country",
              "value": "AE"
            }
          ],
          "value": "1"
        },
        {
          "time": "2021-08-06T07:00:00+0000",
          "metric": "fb_ad_network_click",
          "breakdowns": [
            {
              "key": "placement",
              "value": "123456789012345"
            },
            {
              "key": "country",
              "value": "CA"
            }
          ],
          "value": "2"
        }
      ],
      "omitted_results": [
        {
          "time": "2021-08-06T07:00:00+0000",
          "metric": "fb_ad_network_revenue",
          "breakdowns": [
            {
              "key": "placement",
              "value": "123456789012345"
            },
            {
              "key": "country",
              "value": "AU"
            }
          ]
        }
      ]
    }
  ],
  "paging": {
    "cursors": {
      "before": "MAZDZD",
      "after": "MQZDZD"
    },
    "next": "https://graph.facebook.com/v10.0/142440604406900/adnetworkanalytics?access_token=<ACCESS_TOKEN>&since=2021-08-06&until=2021-08-06&breakdowns=%5B%22placement%22%2C%22country%22%5D&limit=2&metrics=%5B%22fb_ad_network_request%22%2C%22fb_ad_network_imp%22%2C%22fb_ad_network_click%22%2C%22fb_ad_network_revenue%22%5D&after=MQZDZD"
  }
}

المرجع

معلمات الاستعلام

أدوات القياس المتوفرة

استكشاف الأخطاء وإصلاحها

مصحح أخطاء رمز الوصول

استخدم أداة تصحيح رمز الوصول للحصول على المعلومات التفصيلية حول رمز الوصول، بما في ذلك الأذونات والصلاحية والوصول إلى الأصول ومعرف التطبيق المرتبط بالرمز.

رسائل الخطأ