Marketing API Version

PlacementAdSets

Provides operations to create, read, update and delete PlacementAdSets.

Read PlacementAdSets

Permissions

A user access token with Atlas API capability is required to request placement ad sets details.

Read Campaign Assignment

You can get details of placement ad sets associated with an ad set by making an HTTP GET request.

An example of the request and response:

Request:

https://graph.facebook.com/<API_VERSION>/<AD_SET_ID>/placement_ad_sets

Response:

{
  "data": [
    {
      "ad_set_id": "11002200632600",
      "created_date": "2014-09-09T11:02:27-07:00",
      "id": "11002200632900",
      "is_default_ad_set": false,
      "last_modified_date": "2014-09-09T11:02:27-07:00",
      "placement_id": "11002200632400",
      "priority": "0",
      "version": "1"
    }
  ]
}

Curl Example

A curl example to get campaign assignments:

curl -G \
  -d 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/<API_VERSION>/<AD_SET_ID>/placement_ad_sets

Create PlacementAdSets

Permissions

A user access token with Atlas API capability is required to create or update placementadsets details.

Fields

Publishing this endpoint returns a single or an array of PlacementAdSet objects.

Create PlacementAdSet

You can create assignments by making an HTTP POST request. It will update the placement adset if it already exists.

An example of the request and response:

Request:

https://graph.facebook.com/<API_VERSION>/<PLACEMENT_ID>/placement_ad_sets?assignments=[{  "placement_id": "11002200632400", "ad_set_id": "11002200632600",  "version": "5", "is_default_ad_set": false,  "priority": "1" }]

Response:

{
  "data": [
    {
      "id": "11002200632900", 
      "success": true
    }
  ]
}

Curl Example

A curl example to create placementadset:

curl \
  -F 'assignments=[{  "placement_id": "11002200632400", "ad_set_id": "11002200632600",  "version": "5", "is_default_ad_set": false,  "priority": "1" }]' \
  -F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/<API_VERSION>/<PLACEMENT_ID>/placement_ad_sets