Promoted Object describes the object an ad set is promoting, such as the Page in a Page Like campaign. It's a generalized way of specifying a broad range of objects that are related to advertising objectives.
Together, the campaign's
objective and the ad set's
promoted_object should be enough to answer the question: "What is this ad set/campaign all about?". For example, "This campaign is meant to get more page likes for my Page X", or "This ad set is driving mobile app installs for my app Y".
When you create ad sets inside of campaigns using the certain objectives, a
promoted_object field is required. Learn more about Ad Set: Creating.
Promoted Object Validation
When you specify an
application_id and an
object_store_urlMUST be associated with that application. You can configure this on developers.facebook.com under your application settings.
- The mobile OS/device targeting on the ad set must match the supported platforms of the specified app.
- The creative must link to the specified
- You cannot specify an
object_store_urlon its own without an
application_id. This is only available via our native interfaces.
- When specifying a
page_id, the creative must promote that same
- You must have permissions for
pixel_id. If these objects aren't accessible when using your access token, you can't promote them.
- When specifying a
pixel_idto Facebook pixel, you must provide the
custom_event_typeyou want to optimize.
Promoted Object Restrictions
If you use
promoted_object, be aware of the following:
promoted_object is immutable for most cases. For most cases, it's set on creation and can't be changed. To promote a different object, you need to create a new ad set. The only exceptions are: 1) giving the
product_catalog_id a value if it was not set before and 2) changing the
custom_event_type to a new value.
- Existing ad sets without a
promoted_objectwill not be allowed to set a
promoted_object. You must create a new ad set except for the exceptions above.
- When there is a
conversion_specswill be inferred automatically for the specified objectives. You may not manually configure the
conversion_specs. Any value you pass in is ignored.
- Existing ads within a legacy ad set without a
promoted_objectset can update all ad fields.