Zielgruppen-Targeting

Du kannst bestimmten Zielgruppen das Ansehen deines Live-Videos erlauben oder verweigern.

Bevor du beginnst

Für Live-Videos auf einer Seite benötigst du Folgendes:

Einen Seiten-Zugriffsschlüssel, der von einer Person angefordert wurde, die auf der Seite die CREATE_CONTENT-Aufgabe ausführen kann.
Du benötigst die pages_read_user_content-Berechtigung.
Die Berechtigung pages_read_engagement
Die pages_show_list-Berechtigung
Die publish_video Berechtigung

Node

LiveVideo

Eine Zielgruppe erstellen

Um eine Zielgruppe festzulegen, sendest du eine POST-Anfrage an die /id-Anfrage, wobei die id die LiveVideo-ID ist, und der Parameter targeting auf ein Objekt mit einer durch Kommas getrennten Liste von Zielgruppenparametern festgelegt ist.

Wenn du einen API-Aufruf testest, kannst du den access_token-Parameter einbeziehen, der auf deinen Zugriffsschlüssel festgelegt ist. Wenn du jedoch sichere Aufrufe über deine App ausführst, verwende die Klasse des Zugriffsschlüssels.

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

Bei Erfolg erhält deine App eine JSON-Antwort mit einer Liste der festgelegten Zielgruppenparameter.

Beispielantwort

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

Informationen zur Zielgruppe abrufen

Um eine Liste mit Zielgruppeninformationen abzurufen, sendest du eine GET-Anfrage an den Endpunkt /LIVE_VIDEO_ID und legst dabei den Parameter platform auf field fest.

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

Bei Erfolg erhält deine App eine JSON-Antwort mit einer Liste der festgelegten Zielgruppenparameter.

Beispielantwort

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