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.
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.
object_store_urlon its own without an
application_id. This is only available via our native interfaces.
page_id, the creative must promote that same
pixel_id. If these objects aren't accessible when using your access token, you can't promote them.
pixel_idto Facebook pixel, you must provide the
custom_event_typeyou want to optimize.
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.
promoted_objectwill not be allowed to set a
promoted_object. You must create a new ad set except for the exceptions above.
conversion_specswill be inferred automatically for the specified objectives. You may not manually configure the
conversion_specs. Any value you pass in is ignored.
promoted_objectset can update all ad fields.