Within Advantage+ catalog ads, you have the option to use Advantage+ creative for catalog. This feature displays different formats and ad creatives to different Accounts Center accounts, based on what they are most likely to respond to.
Currently, the available formats are collection ads and carousel ads. Both formats have different creative variation options. We make format and creative choices based on what is most likely to resonate with each Accounts Center account seeing your ad. We pick a format for each ad impression, whether to show a description, and which description to display, if shown.
To use Advantage+ creative for catalog, follow Steps 1 and 2 of the Advantage+ catalog ads setup, then continue with Step 3 below.
Let us know you want to use Advantage+ creative for catalog when providing your campaign's creative by specifying FORMAT_AUTOMATION
as an optimization_type
inside your asset_feed_spec
. Your API call must contain the following fields:
product_set_id
Provide the ID of the product set to be used. A product set is a group of related items in a product catalog that you advertise in Advantage+ catalog ads.
template_data
You can add template parameters for your ad creative. Those parameters properly render at run-time based on data in your product feed. Inside object_story_spec
, the template_data
object allows you to build your template.
For Advantage+ creative for catalog, template_data
has the following required fields:
Name | Description |
---|---|
| Whether an advertiser wants to use the end card in the carousel ad format. Set to |
| Optional. One template tag to be used as the product's name. See supported template tags. |
| Link for the offsite landing page. A user will be directed to this link if they click your call-to-action button. |
| Optional. Copy for your ad. |
| A call to action for the user seeing your ad. Use any call to action type compatible with Advantage+ catalog ads. |
asset_feed_spec
An asset feed is a collection of different creative elements, such as image, titles, bodies, etc. The asset_feed_spec
gives you the specifications for an asset feed.
For Advantage+ creative for catalog, asset_feed_spec
can include:
Name | Description |
---|---|
| Required. Type of optimization being used. Set to |
| Required. List of ad formats. Set to |
| Optional. Specify one description option. The text is used for ads served in the carousel format. You can use supported template tags or a free-form message. |
| Optional. Use this field to set a custom image as cover media for a collection ad. Example of an API call using this field. |
| Optional. Use this field to set a custom video as cover media for a collection ad. Example of an API call using this field. |
creative_features_spec
You can opt-in/opt-out optimizations using the creative_features_spec
and using fields supported by Advantage+ for catalog.
For Advantage+ for catalog creative_features_spec
can include:
Name | Description |
---|---|
| Optional. Opt-in if you want 9:16 images in your catalog to be displayed in supported placements (Instagram Stories/Instagram Reels/Facebook Stories/Facebook Reels). |
| Optional. Opt-in if you want videos from your catalog to be displayed (along with images) in supported placements. See Dynamic Media for more information. |
In this case, the cover media for collection ads defaults to an Advantage catalog video:
curl \ -F 'name=Advantage+ creative for catalog test' \ -F 'adset_id=<AD_SET_ID>' \ -F 'creative={ "name": "Creative for Advantage+ creative for catalog test", "product_set_id": "<PRODUCT_SET_ID>", "object_type": "SHARE", "object_story_spec": { "page_id": "<PAGE_ID>", "template_data": { "multi_share_end_card": "true", "name": "{{product.name}}", "link": "<OFFSITE_LANDING_PAGE>", "message": "<AD_COPY>", "call_to_action": {"type": "SHOP_NOW"}, }}, "asset_feed_spec":{ "optimization_type":"FORMAT_AUTOMATION", "ad_formats": ["CAROUSEL", "COLLECTION"]}, "descriptions": [{"text": "{{product.brand}}", "From {{product.current_price}}", ...]} }' \ -F 'url_tags=<URL_TAGS>' \ -F 'tracking_specs=[{"action.type":"offsite_conversion","fb_pixel":<PIXEL_ID>}]' \ -F 'access_token=<ACCESS_TOKEN>' \ https://graph.facebook.com/v<API_VERSION>/act_<AD_ACCOUNT>/ads
In this case, the cover media for collection ads is set to a custom image:
curl \ -F 'name=Advantage+ creative for catalog test - custom image' \ -F 'adset_id=<AD_SET_ID>' \ -F 'creative={ "name": "Creative For Advantage+ creative for catalog test - custom image", "product_set_id": "<PRODUCT_SET_ID>", "object_type": "SHARE", "object_story_spec": { "page_id": "<PAGE_ID>", "template_data": { "multi_share_end_card": "true", "name": "{{product.name}}", "link": "<OFFSITE_LANDING_PAGE>", "message": "<AD_COPY>", "call_to_action": {"type": "SHOP_NOW"}, } }, "asset_feed_spec":{ "optimization_type":"FORMAT_AUTOMATION", "ad_formats": ["CAROUSEL", "COLLECTION"], "images": [{"hash": "<customized_image_hash>"}], "descriptions": [{"text": "{{product.description}}", "From {{product.current_price}}", ...] } }' \ -F 'url_tags=<URL_TAGS>' \ -F 'tracking_specs=[{"action.type":"offsite_conversion","fb_pixel":<PIXEL_ID>}]' \ -F 'access_token=<ACCESS_TOKEN>' \ https://graph.facebook.com/v<API_VERSION>/act_<AD_ACCOUNT>/ads
In this case, the cover media for collection ads is set to a custom video:
curl \ -F 'name=Advantage+ creative for catalog test - custom video' \ -F 'adset_id=<AD_SET_ID>' \ -F 'creative={ "name": "Creative For Advantage+ creative for catalog test - custom video", "product_set_id": "<PRODUCT_SET_ID>", "object_type": "SHARE", "object_story_spec": { "page_id": "<PAGE_ID>", "template_data": { "multi_share_end_card": "true", "link": "<LINK>", "message": "<AD_COPY>", "call_to_action": {"type": "SHOP_NOW"}, } }, "asset_feed_spec":{ "optimization_type":"FORMAT_AUTOMATION", "ad_formats": ["CAROUSEL", "COLLECTION"], "videos": [{"video_id": "<VIDEO_ID>"}]}, "descriptions": [{"text": "{{product.description}}", "From {{product.current_price}}", ...]} }' \ -F 'tracking_specs=[{"action.type":"offsite_conversion","fb_pixel":<PIXEL_ID>}]' \ -F 'access_token=<ACCESS_TOKEN>' \ https://graph.facebook.com/v<API_VERSION>/act_<AD_ACCOUNT>/ads
In this case, the 9:16 images in your catalog will be used to display full screen images in supported placements.
For Instagram Stories, you can optionally remove the showcase card displaying 4 small images of products to have the 9:16 image of the first product displayed using NONE
instead of AUTO
for the showcase_card_display
customization parameter value.
curl \
-F 'name=Advantage+ creative for catalog test - active 9:16' \
-F 'adset_id=<AD_SET_ID>' \
-F 'creative={
"name": "Creative For Advantage+ creative for catalog test - active 9:16",
"product_set_id": "<PRODUCT_SET_ID>",
"object_type": "SHARE",
"object_story_spec": {
"page_id": "<PAGE_ID>",
"template_data": {
"multi_share_end_card": "true",
"link": "<LINK>",
"message": "<AD_COPY>",
"call_to_action": {"type": "SHOP_NOW"},
}
},
"asset_feed_spec":{
"optimization_type":"FORMAT_AUTOMATION",
"ad_formats": ["CAROUSEL", "COLLECTION"],
"descriptions": [{"text": "{{product.description}}", "From {{product.current_price}}", ...]
},
"degrees_of_freedom_spec" : {
"creative_features_spec": {
"adapt_to_placement": {
"enroll_status": "OPT_IN",
"customizations": {
"showcase_card_display": "AUTO"
}
}
}
}
}' \
-F 'tracking_specs=[{"action.type":"offsite_conversion","fb_pixel":<PIXEL_ID>}]' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0
/act_<AD_ACCOUNT>/ads
In this case, the videos in your catalog will be used in your ad on supported placements. See Dynamic Media for more information.
curl \
-F 'name=Advantage+ creative for catalog test - dynamic media' \
-F 'adset_id=<AD_SET_ID>' \
-F 'creative={
"name": "Creative For Advantage+ creative for catalog test - dynamic media",
"product_set_id": "<PRODUCT_SET_ID>",
"object_type": "SHARE",
"object_story_spec": {
"page_id": "<PAGE_ID>",
"template_data": {
"multi_share_end_card": "true",
"link": "<LINK>",
"message": "<AD_COPY>",
"call_to_action": {"type": "SHOP_NOW"},
}
},
"asset_feed_spec":{
"optimization_type":"FORMAT_AUTOMATION",
"ad_formats": ["CAROUSEL", "COLLECTION"],
"descriptions": [{"text": "{{product.description}}", "From {{product.current_price}}", ...]
},
"degrees_of_freedom_spec" : {
"creative_features_spec": {
"media_type_automation": {
"enroll_status": "OPT_IN"
}
}
}
}' \
-F 'tracking_specs=[{"action.type":"offsite_conversion","fb_pixel":<PIXEL_ID>}]' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0
/act_<AD_ACCOUNT>/ads
Format | Creative Variations |
---|---|
Cover media can be:
You must pick one option. | |
Description can be:
Both can be used at the same time. |
The collection format features three products under a hero image or video that opens into a fullscreen Instant Experience. The hero image or video is also called cover media. The Advantage+ creative for catalog API calls are different, depending on your choice for cover media.
The standard behavior is to add an Advantage catalog video as your ad's cover media. In this case, we automatically generate a personalized Advantage catalog video for each user that sees your ad. The video highlights products from the catalog that are most relevant to the user. Alternatively, you can provide your own custom image or video for the cover media position.
See Help Center: About Collection Ads for more information.
The carousel format lets you show two or more images and videos, descriptions and links or calls to action in a single ad. For Advantage+ creative for catalog, you can select possible description variations.
Specify your description variations in the API call with the descriptions
parameter under asset_feed_spec
. Add all your description options under descriptions
and list the first one under description
.
Your description options can contain catalog information or new free-form short message, like "Free Shipping".
To use information available on your catalog, you can use the following template tags:
{{product.price}}
{{product.current_price}}
{{product.description}}
{{product.short_description}}
{{product.brand}}
{{product.name}}
The following tags cannot be used at the same time:
{{product.price}}
and {{product.current_price}}
{{product.description}}
and {{product.short_description}}
Be mindful of the following:
See Help Center: About Carousel Ads for more information.