استهداف الجمهور

يمكنك تضمين جماهير محددة واستبعادها من مشاهدة فيديو البث المباشر.

قبل البدء

بالنسبة لمقاطع الفيديو المباشرة في الصفحة، ستحتاج إلى ما يلي:

العقدة

إنشاء جمهور مستهدف

لتعيين جمهور مستهدف، أرسل POST إلى طلب /id حيث يكون id هو معرف LiveVideo وقم بتعيين المعلمة targeting على كائن بقائمة مفصولة بفاصلة لمعلمات الجمهور.

عند اختبار استدعاء API، يمكنك تضمين المعلمة access_token وتعيينها على رمز الوصول. مع ذلك، عند إجراء استدعاءات آمنة من التطبيق، استخدم فئة رمز الوصول.

  
curl -i -X POST \
  "https://graph.facebook.com/v20.0/<LIVE_VIDEO_ID>
    ?targeting={
      age_min:17, 
      geo_locations:{
        countries:["US","CA","MX"]
      }
    }"

عند نجاح العملية، يستلم التطبيق استجابة JSON بقائمة معلمات الجمهور التي تم تعيينها.

عينة من الاستجابة

{
  "targeting": {
    "age_max": 65,
    "age_min": 17,
    "geo_locations": {
      "countries": [
        "US",
        "CA",
        "MX"
      ]
    }
  },
  "id": "<LIVE_VIDEO_ID>"   
}

الحصول على معلومات الجمهور المستهدف

للحصول على معلومات الجمهور المستهدف، أرسل طلب GET إلى نقطة النهاية /LIVE_VIDEO_ID مع تعيين المعلمة field على targeting.

curl -i -X GET \
  "https://graph.facebook.com/v20.0/<LIVE_VIDEO_ID>
    ?fields=targeting"

عند نجاح العملية، يستلم التطبيق استجابة JSON بقائمة معلمات الجمهور التي تم تعيينها.

عينة من الاستجابة

{
  "targeting": {
    "age_max": 65,
    "age_min": 17,
    "geo_locations": {
      "countries": [
        "US"
        "CA",
        "MX"
      ]
    }
  },
  "id": "<LIVE_VIDEO_ID>"       
}