Audiences

Advantage+ Audience

Enable Advantage+ audience on your campaigns to create the broadest possible audience to search within. Non-negotiable business constraints are NOT expanded, these include location constraints, minimum age, language and custom audience exclusions.

  • To opt in, set the advantage_audience parameter within targeting_automation to 1.
  • To opt out, set the advantage_audience parameter within targeting_automation to 0.

Prior to v23.0, the advantage_audience parameter within targeting_automation was optional and wasn't explicitly required to be set in the targeting spec when creating a new ad set or updating an existing one.

Beginning with v23.0, the advantage_audience parameter within targeting_automation will automatically default to 1 or require explicit setting to either 1 or 0. This behavior applies only when creating a new ad set; updating an existing ad set will not exhibit this behavior on any version.

Enable Advantage+ Audience

When Advantage+ audience is enabled you can set the age_range parameter within targeting_spec.

"targeting": {
  "age_range": [25, 35],
  "geo_locations": {
  	"countries": ["GB"]
  },
  "targeting_automation": {
  	"advantage_audience": 1
  }
}
  • When age_range is not passed, the age range will be created from age min/max.
  • When Advantage+ audience is enabled the values of age min/max are reset to default values.
  • When Advantage+ audience is enabled advertisers can pass age_min values ranging between 18 - 25 only.
  • When Advantage+ audience is enabled advertisers cannot set age_max values. It is set to 65 only.

Example request

curl -X POST \
  -F 'name="advantage audience test"' \
  -F 'is_autobid="true"' \
  -F 'daily_budget="100"' \
  -F 'billing_event="IMPRESSIONS"' \
  -F 'campaign_id="<CAMPAIGN ID>"' \
  -F 'targeting={"age_max": 65, "age_min": 18, "age_range": [25,35], "geo_locations": {"countries": ["US", "GB"]},"targeting_automation": {"advantage_audience": 1 }}' \
  -F 'access_token="<ACCESS_TOKEN>"' \
https://facebook.com/v23.0/act_<AD_ACCOUNT_ID>/adsets

Default Opted-in Cases

The advantage_audience parameter within targeting_automation will default to 1 unless explicitly specified in the following scenarios:

  • Default Targeting Setup: When passing default values for Age, Gender, Custom Audience Inclusion, and Detailed Targeting Inclusion, or omitting these fields.
  • Relaxed Targeting Setup: When using a relaxed setup by applying individual relaxation settings for Age, Gender, Custom Audience Inclusion, and Detailed Targeting Inclusion.

Examples

Default setup

{
   "targeting":{
      "geo_locations":{
         "countries":[
            "US"
         ]
      },
      "age_max":65,
      "age_min":18,
   }
}

Relaxed setup

{
   "targeting":{
      "age_max":65,
      "age_min":18,
      "custom_audiences":[
         {
            "id":"<CUSTOM_AUDIENCE_ID>"
         },
         {
            "id":"<LOOKALIKE_ID>"
         }
      ],
      "flexible_spec":[
         {
            "interests":[
               {
                  "id":"<INTEREST_ID>"
               }
            ]
         }
      ],
      "geo_locations":{
         "countries":[
            "US"
         ],
         "location_types":[
            "home",
            "recent"
         ]
      },
      "targeting_relaxation_types":{
         "custom_audience":1,
         "lookalike":1
      },
      "targeting_optimization":"expansion_all"
   }
}

Troubleshooting

An error will be returned when creating an ad set if your setup is not either default or relaxed, which means you have:

  • Used non-default settings for any of Age, Gender, Custom Audience Inclusion, and Detailed Targeting Inclusion.
  • Not used individual relaxation settings for these parameters.

Example

{
   "targeting":{
      "age_max":50,
      "age_min":30,
      "custom_audiences":[
         {
            "id":"<CUSTOM_AUDIENCE_ID>"
         }
      ],
      "geo_locations":{
         "countries":[
            "US"
         ],
         "location_types":[
            "home",
            "recent"
         ]
      }
   }
}

To resolve this, you must explicitly set the advantage_audience parameter within targeting_automation to either 1 or 0.

Learn More