素材信息库参数选项

您可以在 asset_feed_spec 中使用以下选项。请参阅广告素材信息库参数，获取更多参考信息。

属性名称描述

属性名称	描述
`images` 类型：清单数组	对 `SINGLE_IMAGE` 和 `CAROUSEL_IMAGE` 格式为必要项。由符合条件的图片组成的数组。在此数组中提供的图片应包含在广告账户的图片资源库中。以清单数组的形式提供此字段，而且数组中应包含以下内容：`{"url": "{IMAGE_URL}", "hash": "{IMAGE_HASH}", "url_tags": "{TAG}"}`。必须提供 `url` 或 `hash` 的其中之一。
`videos` 类型：清单数组	对于 `SINGLE_VIDEO` 格式为必要项。由 `video_id` 组成的数组。在此数组中提供的 `video_id` 应属于广告账户。以清单数组的形式提供此字段，而且数组中应包含以下内容：`{"video_id": "{VIDEO_ID}", "thumbnail_url": "{THUMBNAIL_URL}", "url_tags": "{TAG}"}`
`carousels` 类型：清单数组	非必要。由 `child_attachments`、`multi_share_end_card` 布尔值、`multi_share_optimized` 布尔值以及 `adlabels` 组成的数组。在此数组中提供的 `child_attachments` 应属于广告账户。以清单数组的形式提供 `child_attachments`，而且数组中应包含以下内容：`{"image_label": {"name": "{IMAGE_LABEL}"}, "video_label": {"name": "{VIDEO_LABEL}"}, "title_label": {"name": "{TITLE_LABEL}"}, "description_label": {"name": "{DESC_LABEL}", "link_url_label": {"name": "{LINK_URL}"}}`。必须提供 `image_label` 或 `video_label` 的其中之一。
`bodies` 类型：清单数组	非必要。由正文组成的数组。广告的主要信息或文案。以清单数组的形式提供此字段，而且数组中应包含以下内容：`{"text": "{BODY_TEXT}", "url_tags": "{TAG}"}`。
`call_to_action_types` 类型：清单数组	对于除 `OUTCOME_AWARENESS` 外的所有其他目标，为必要项。由行动号召类型值组成的数组。以清单数组形式提供此字段，而且数组中应包含以下内容：`{"{CALL_TO_ACTION}"}`。您可以提供多个值，这些值的数量上限为 5 个。
`titles` 类型：清单数组	非必要。由标题组成的数组。标题是指广告中的短标题，一般显示在链接、图片或视频旁边。以清单数组的形式提供此字段，而且数组中应包含以下内容：`{"text": "{TITLE}", "url_tags": "{TAG}"}`。
`descriptions` 类型：清单数组	非必要。由辅助描述文本组成的数组；与正文或标题相比，显示方式并不那么醒目。通常显示在链接、图片或视频旁边。如果您未指定此属性，Facebook 会抓取您提供的链接来生成此内容。如果您不想使用抓取的文本作为描述文本，请使用包含单一空格的空字符串，从而将描述设置为空白。以清单数组的形式提供此字段，而且数组中应包含以下内容：`{"text": "{DESCRIPTION}", "url_tags": "{TAG}"}`。
`link_urls` 类型：清单数组	必要。由链接网址组成的数组。以清单数组的形式提供此字段，而且数组中应包含以下内容：`{"website_url": "{URL}"}`。
`ad_formats` 类型：字符串数组	必要。由创建广告时应使用的 Facebook 广告格式组成的数组。支持的格式如下：`SINGLE_IMAGE`、`CAROUSEL`、`SINGLE_VIDEO`、`AUTOMATIC_FORMAT`。以字符串数组的形式提供此字段，而且数组中应包含以下内容：`["{AD_FORMAT}"]`。
`optimization_type` 类型：字符串	非必要。素材信息库中使用的优化类型。可能的值为 `ASSET_CUSTOMIZATION`、`LANGUAGE`、`PLACEMENT` 和 `REGULAR`。
`message_extensions` 类型：字符串数组	非必要。素材信息库中使用的消息插件类型。可能的值：`whatsapp`
`onsite_destinations` 类型：清单数组	对于店铺引流广告为必要项。适用于非动态广告；`SINGLE_IMAGE`、`SINGLE_VIDEO` 或 `CAROUSEL` 格式。以清单数组的形式提供此字段，而且数组中应包含以下值之一，以指定站内店铺的目标落地位置。 {"storefront_shop_id": "<SHOP_STOREFRONT_ID>"} or {"shop_collection_product_set_id": "<PRODUCT_SET_ID>" or {"details_page_product_id": "<PRODUCT_ID>"}
`shops_bundle` 类型：布尔值	对于店铺引流广告为必要项。适用于进阶赋能型目录广告。提供此字段，以用于店铺优化。包括 `reasons_to_shop` 和 `automated_product_tags` 店铺优化类型。可能的值：`true`、`false`
`reasons_to_shop` 类型：布尔值	对于店铺引流广告为必要项。适用于进阶赋能型目录广告。提供此字段，以用于店铺优化。自动突显您店铺中的商品信息，如“包邮”“热门”或“库存紧张”。可能的值：`true`、`false`

images

类型：清单数组

对 SINGLE_IMAGE 和 CAROUSEL_IMAGE 格式为必要项。

由符合条件的图片组成的数组。在此数组中提供的图片应包含在广告账户的图片资源库中。

以清单数组的形式提供此字段，而且数组中应包含以下内容：{"url": "{IMAGE_URL}", "hash": "{IMAGE_HASH}", "url_tags": "{TAG}"}。必须提供 url 或 hash 的其中之一。

videos

类型：清单数组

对于 SINGLE_VIDEO 格式为必要项。

由 video_id 组成的数组。在此数组中提供的 video_id 应属于广告账户。

以清单数组的形式提供此字段，而且数组中应包含以下内容：{"video_id": "{VIDEO_ID}", "thumbnail_url": "{THUMBNAIL_URL}", "url_tags": "{TAG}"}

carousels
类型：清单数组

非必要。
由 child_attachments、multi_share_end_card 布尔值、multi_share_optimized 布尔值以及 adlabels 组成的数组。在此数组中提供的 child_attachments 应属于广告账户。

以清单数组的形式提供 child_attachments，而且数组中应包含以下内容：{"image_label": {"name": "{IMAGE_LABEL}"}, "video_label": {"name": "{VIDEO_LABEL}"}, "title_label": {"name": "{TITLE_LABEL}"}, "description_label": {"name": "{DESC_LABEL}", "link_url_label": {"name": "{LINK_URL}"}}。必须提供 image_label 或 video_label 的其中之一。

bodies

类型：清单数组

非必要。

由正文组成的数组。广告的主要信息或文案。

以清单数组的形式提供此字段，而且数组中应包含以下内容：{"text": "{BODY_TEXT}", "url_tags": "{TAG}"}。

call_to_action_types

类型：清单数组

对于除 OUTCOME_AWARENESS 外的所有其他目标，为必要项。

由行动号召类型值组成的数组。

以清单数组形式提供此字段，而且数组中应包含以下内容：{"{CALL_TO_ACTION}"}。您可以提供多个值，这些值的数量上限为 5 个。

titles

类型：清单数组

非必要。

由标题组成的数组。标题是指广告中的短标题，一般显示在链接、图片或视频旁边。

以清单数组的形式提供此字段，而且数组中应包含以下内容：{"text": "{TITLE}", "url_tags": "{TAG}"}。

descriptions

类型：清单数组

非必要。

由辅助描述文本组成的数组；与正文或标题相比，显示方式并不那么醒目。通常显示在链接、图片或视频旁边。如果您未指定此属性，Facebook 会抓取您提供的链接来生成此内容。如果您不想使用抓取的文本作为描述文本，请使用包含单一空格的空字符串，从而将描述设置为空白。

以清单数组的形式提供此字段，而且数组中应包含以下内容：{"text": "{DESCRIPTION}", "url_tags": "{TAG}"}。

link_urls

类型：清单数组

必要。

由链接网址组成的数组。

以清单数组的形式提供此字段，而且数组中应包含以下内容：{"website_url": "{URL}"}。

ad_formats

类型：字符串数组

必要。

由创建广告时应使用的 Facebook 广告格式组成的数组。支持的格式如下：SINGLE_IMAGE、CAROUSEL、SINGLE_VIDEO、AUTOMATIC_FORMAT。

以字符串数组的形式提供此字段，而且数组中应包含以下内容：["{AD_FORMAT}"]。

optimization_type

类型：字符串

非必要。

素材信息库中使用的优化类型。可能的值为 ASSET_CUSTOMIZATION、LANGUAGE、PLACEMENT 和 REGULAR。

message_extensions

类型：字符串数组

非必要。
素材信息库中使用的消息插件类型。

可能的值：whatsapp

onsite_destinations
类型：清单数组

对于店铺引流广告为必要项。适用于非动态广告；SINGLE_IMAGE、SINGLE_VIDEO 或 CAROUSEL 格式。
以清单数组的形式提供此字段，而且数组中应包含以下值之一，以指定站内店铺的目标落地位置。

{"storefront_shop_id": "<SHOP_STOREFRONT_ID>"}
or 
{"shop_collection_product_set_id": "<PRODUCT_SET_ID>" 
or 
{"details_page_product_id": "<PRODUCT_ID>"}

shops_bundle
类型：布尔值

对于店铺引流广告为必要项。适用于进阶赋能型目录广告。
提供此字段，以用于店铺优化。包括 reasons_to_shop 和 automated_product_tags 店铺优化类型。
可能的值：true、false

reasons_to_shop
类型：布尔值

对于店铺引流广告为必要项。适用于进阶赋能型目录广告。
提供此字段，以用于店铺优化。自动突显您店铺中的商品信息，如“包邮”“热门”或“库存紧张”。
可能的值：true、false

素材信息库参数限制

广告格式

支持的 ad_formats：SINGLE_IMAGE、CAROUSEL、SINGLE_VIDEO 和 AUTOMATIC_FORMAT。
每个素材信息库中只允许有 1 种 ad_format。
在素材信息库中，ad_format 算作 1 项素材。

素材数量：

素材总量上限：30 个。例如，您总共拥有 28 个素材，其中 10 个 images、5 个 bodies、5 个 titles、5 个 description、1 个 ad_format、1 个 link_url 和 1 个 call_to_action_types。
图片总数：不超过 10 张。
视频总数：不超过 10 条。如果您使用 Instagram 作为版位，则只能选择方形视频或横向视频。
正文总数：不超过 5 个。
行动号召总数：不超过 5 个。
标题总数：不超过 5 。
链接总数：不超过 5 条。
描述总数：不超过 5 条。

图片要求：

推荐的图片参数：1.9:1。
推荐的图片尺寸：1,200 x 628 像素。
如果是 CAROUSEL_IMAGE 格式，您必须至少提供 2 张图片。
如果您使用 Instagram 作为版位，请使用方形图片，以获得更出色的效果。

文本要求：

标题和描述文本：长度上限为 255 个字符。
正文文本：长度上限为 1,024 个字符。
您并未指定任何描述，我们会抓取您提供的链接来获取描述。
对于 CAROUSEL_IMAGE，标题为非必要项。

url_tags 为非必要项，并且仅适用于 images、videos、bodies、descriptions 和 titles。Facebook 会在链接网址后附加 url_tags，作为广告中每项素材的参数。

例如，SINGLE_IMAGE 格式的有效素材信息库组合设置为：

5 个 images
3 个 bodies
3 个 titles
3 descriptions
1 种格式：SINGLE_IMAGE
2 个 link_urls

"link_urls=[{'website_url':'<WEBSITE_URL>'}, {'website_url':'<WEBSITE_URL>'}]"

使用深度链接

如果广告系列使用以下目标，您可以素材信息库参数中使用深度链接：

APP_INSTALLS
CONVERSIONS
LINK_CLICKS

创建 asset_feed_spec 时，在 link_urls 中添加 deeplink_url。

curl \
-F 'object_story_spec={
       "page_id": "<PAGE_ID>"
       "instagram_actor_id" : "<INSTAGRAM_ACTOR_ID>",
    }' \
-F "asset_feed_spec={'images': [{'hash':'image_hash'}], 'bodies': [{'text':'Body 1'}, {'text':'Body 2'}], 'titles': [{'text':'Title 1'}, {'text':'Title 2'}], 'descriptions': [{'text':' '}], 'ad_formats': ['SINGLE_IMAGE'], 'link_urls': [{'website_url':'App's object store URL','deeplink_url':'deeplink URL'}]}" \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

WhatsApp 广告的目标网站

您可以创建广告以将用户引导至您的网站，并在网站页面底部设置 WhatsApp 按钮，以便他们能够立即与您联系。这有助于用户在访问您的网站时，通过 WhatsApp 与您联系。

创建 asset_feed_spec 时，添加 message_extensions。

curl \
-F 'object_story_spec={
       "page_id": "<PAGE_ID>"
       "instagram_actor_id" : "<INSTAGRAM_ACTOR_ID>",
    }' \
-F 'asset_feed_spec={"images": [{"hash":"image_hash"}], "bodies": [{"text":"Body 1"}, {"text":"Body 2"}],"titles": [{"text":"Title 1"}, {"text":"Title 2"}], "descriptions": [{"text":" "}], "ad_formats": ["SINGLE_IMAGE"], "link_urls": [{"website_url":"business URL"}], "message_extensions": [{"type": "whatsapp"}]}' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives