Penargetan Pemirsa

Sertakan dan kecualikan pemirsa tertentu untuk tayangan Video Siaran Langsung Anda.

Sebelum Memulai

Untuk video siaran langsung di Halaman, Anda akan memerlukan:

Token akses Halaman yang diminta oleh orang yang dapat melakukan tugas CREATE_CONTENT di Halaman
Izin pages_read_user_content
Izin pages_manage_engagement
Izin pages_show_list
Izin publish_video

Node

LiveVideo

Membuat Pemirsa Target

Untuk mengatur pemirsa target, kirimkan POST ke permintaan /id yang mempunyai ID LiveVideo id dan atur parameter targeting ke sebuah objek dengan daftar parameter pemirsa yang dipisahkan dengan koma.

Saat menguji panggilan API, Anda dapat menyertakan parameter access_token ke token akses Anda. Namun, saat melakukan panggilan aman dari aplikasi Anda, gunakan kelas token akses.

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

Jika berhasil, aplikasi Anda akan menerima tanggapan JSON dengan daftar parameter pemirsa yang telah diatur.

Contoh Tanggapan

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

Mendapatkan Informasi Pemirsa Target

Untuk mendapatkan daftar informasi target pemirsa, kirim permintaan GET ke endpoint /LIVE_VIDEO_ID dengan parameter field yang diatur ke targeting.

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

Jika berhasil, aplikasi Anda akan menerima tanggapan JSON dengan daftar parameter pemirsa yang telah diatur.

Contoh Tanggapan

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