在提供广告系列的创意时,请在 asset_feed_spec
中将 optimization_type
指定为 FORMAT_AUTOMATION
,告诉我们您想使用进阶赋能型目录素材。API 调用中必须包含以下字段:
product_set_id
提供要使用的商品系列的编号。商品系列是指您在进阶赋能型目录广告中推广的商品目录中的一组相关商品。
template_data
您可以为广告创意添加模板参数。系统会根据您商品信息库中的数据,在投放广告期间正确显示这些参数。您可以在 object_story_spec
中使用 template_data
对象,构建模板。
对于进阶赋能型目录素材,template_data
包含以下必要字段:
名称 | 描述 |
---|---|
| 表明广告主是否要在轮播广告格式中使用结束图卡。如果您要使用结束图卡,请将此字段设置为 |
| 可选。 一个要用作商品名称的模板标签。请参阅支持的模板标签。 |
| 站外落地页的链接。如果点击行动号召按钮,用户便会跳转到此链接。 |
| 可选。 广告文案。 |
| 为看到您广告的用户而设的行动号召。使用与进阶赋能型目录广告兼容的任何行动号召类型。 |
asset_feed_spec
素材信息库由一系列不同的创意元素组成,例如图片、标题和正文等。您可以在 asset_feed_spec
中提供素材信息库参数。
对于进阶赋能型目录素材,asset_feed_spec
可以包含以下内容:
名称 | 描述 |
---|---|
| 必要。 正在使用的优化类型。设置为 |
| 必要。 由广告格式组成的清单。设置为 |
| 可选。 指定一个描述选项。此文本用于以轮播格式投放的广告。您可以使用受支持的模板标签或自由格式消息。 |
| 可选。 使用此字段将自定义图片设置为精品栏广告的封面素材。使用此字段的 API 调用示例。 |
| 可选。 使用此字段将自定义视频设置为精品栏广告的封面素材。使用此字段的 API 调用示例。 |
在这种情况下,精品栏广告的封面素材默认使用进阶赋能型目录视频:
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
在这种情况下,精品栏广告的封面素材被设置为自定义图片:
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
在这种情况下,精品栏广告的封面素材被设置为自定义视频:
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
精品栏格式的广告会在主图或主视频下方展示 3 款商品,主图和主视频可用于开启全屏即时体验。主图或主视频又称为封面素材。进阶赋能型目录素材 API 的调用方式各不相同,具体取决于您选择的封面素材。
标准行为是添加赋能型目录视频作为您广告的封面素材。在这种情况下,系统会自动为看到您广告的每位用户生成个性化的赋能型目录视频。该视频会突显目录中与该用户最相关的商品。或者,您也可以为封面素材位置提供自己的自定义图片或视频。
详情请参阅帮助中心:关于精品栏广告。
利用轮播格式,您可以在单条广告中展示至少 2 个图片和视频、标题、链接或行动号召。对于进阶赋能型目录素材,您可以选择适用的描述版本。
在 API 调用中,使用 asset_feed_spec
下的 descriptions
参数指定描述版本。在 descriptions
下添加所有描述选项,并在 description
下列出第一个选项。
您的描述选项可以包含目录信息或新的自由格式消息,例如“包邮”。
如要使用目录中提供的信息,您可以使用以下模板标签:
{{product.price}}
{{product.current_price}}
{{product.description}}
{{product.short_description}}
{{product.brand}}
{{product.name}}
不能同时使用以下标签:
{{product.price}}
和 {{product.current_price}}
{{product.description}}
和 {{product.short_description}}
请注意以下事项:
详情请参阅帮助中心:关于轮播广告。