Audience Targeting

Include and exclude specific audiences from viewing your Live Video.

Before You Start

For live videos on a Page, you will need:

A Page access token requested by a person who can perform the CREATE_CONTENT task on the Page
The pages_read_user_content permission
The pages_manage_engagement permission
The pages_show_list permission
The publish_video permission

Node

LiveVideo

Create a Target Audience

To set a target audience, send a POST to the /id request where id is the LiveVideo ID and set the targeting parameter to an object with a comma separated list of audience parameters.

When testing an API call, you can include the access_token parameter set to your access token. However, when making secure calls from your app, use the access token class.

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

On success your app receives a JSON response with a list of audience parameters that have been set.

Sample Response

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

Get Target Audience Information

To get a list of audience target information, send a GET request to the /LIVE_VIDEO_ID endpoint with the field parameter set to targeting.

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

On success your app receives a JSON response with a list of audience parameters that have been set.

Sample Response

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