自定义广告创意的不同部分(如图片、视频、文本和广告正文等),以便覆盖使用不同语言的用户。Facebook 会优化广告,向目标受众展示适当的语言版本。
这有助您轻松设置多语言广告,并向观看者投放最切合其需求的广告语言版本,同时为广告保留广泛的目标受众。这让您能在维持较低广告成本的同时,根据观看者所使用的语言为其展示个性化内容。
如需了解此功能的基本信息,请参阅广告帮助中心的“面向多语言受众发布广告”一文。您也可以参阅受支持的广告系列目标。
我们提供了三种使用素材定制规则的 API,多语言广告便是其中之一。
开始前,请查看关于此产品的限制。如果您的用例符合要求,请执行以下步骤:
asset_feed_spec
提供创意 — 另请参阅可用语言。如果您没有可手动翻译广告的资源,请查看我们的自动翻译服务。
asset_feed_spec
提供创意使用 asset_feed_spec
指定多语言广告创意。素材信息库由一系列不同的创意元素组成,例如图片、标题和正文等。您可以在 /adcreative
处创建 asset_feed_spec
。
要创建 asset_feed_spec
,请为每种不同语言提供一组素材。添加标签以标记各个素材,从而识别素材所属语言。Facebook 会在 asset_customization_rules
中使用标签,以便按语言对素材进行分组。您应为每种素材类型至少提供一个素材。
要在 asset_feed_spec
中提供的参数包括:
属性名称 | 描述 |
---|---|
类型:数组 | 必须为 作为 为此字段提供如下所示的数组值: |
类型:数组 | 必须为
为此字段提供如下所示的数组值: |
类型:数组 | 必须提供,但 正文数组包含广告的主要信息。 为此字段提供如下所示的数组值: |
类型:数组 | 必须提供,但 标题数组。广告中的短标题,一般显示在链接、图片或视频旁边。 为此字段提供如下所示的数组值: |
类型:数组 | 必须提供,但 辅助说明文本数组,相比正文或标题而言并不突出显示。 为此字段提供如下所示的数组值: |
类型:数组 | 必须提供,但 链接网址数组。 为此字段提供如下所示的数组值: |
类型:数组 | 必要。 行动号召类型值组成的数组。 为此字段提供受支持的行动号召数组: |
| 必要。 创建广告时想要使用的 Facebook 广告格式组成的数组。支持的格式: 为此字段提供受支持的广告格式数组: |
类型:请参阅素材定制规则下方的表格 | 必要。 素材定制规则数组。 |
为使用特定语言的观看者定义一同显示的素材。每种规则均设有 customization_spec
,用于在广告投放期间定义素材观看者的区域设置。
您应只提供一个默认规则。如果某用户的首选语言与素材信息库中指定的任意区域设置均不匹配,则该规则必须包含 Facebook 显示的素材。这有助于防止广告投放不足的问题。
属性名称 | 描述 |
---|---|
类型: | 必要。 定义此规则中素材应投放的区域设置。如需查看支持的区域设置,请参阅可用语言。 |
类型: | 必须为 附加到素材信息库中某个图片素材的标签。 |
类型: | 必须为 附加到素材信息库中某个视频素材的标签。 |
类型: | 必要。 附加到素材信息库中某个正文素材的标签。 |
类型: | 必要。 附加到素材信息库中某个标题素材的标签。 |
类型: | 必要。 附加到素材信息库中某个说明素材的标签。 |
类型: | 必要。 附加到素材信息库中某个 |
类型:布尔型 | 必要。 用于识别默认规则的布尔标记。您应只设置一种规则,并将 |
您在 customization_spec
中提供的区域必须为广告定位中所支持的区域设置编号。详情请参阅定位和版位中的“区域设置”部分。您可以使用 /search
端点搜索特定语言。使用 q
参数搜索特定语言名称。将此参数留空可获得所有受支持语言的列表:
curl -G \
-d "type=adlocale" \
-d "q=en" \
-d "limit=2" \
-d "access_token=<ACCESS_TOKEN>" \
https://graph.facebook.com/v21.0
/search
成功时,您将获得如下语言列表:
{ "data": [ { "key": 6, "name": "English (US)" }, { "key": 24, "name": "English (UK)" } ], "paging": { "cursors": { "before": "MAZDZD", "after": "MAZDZD", } } }
您应将这些搜索结果中的关键值用作素材定制规则中的区域设置。如需了解更多信息,请参阅定位搜索。
您可以在 POST ad_account_ID/adcreatives
中使用 asset_feed_spec
字段创建素材信息库:
curl \
-F 'object_story_spec={
"page_id": "<PAGE_ID>",
"instagram_actor_id": "<INSTAGRAM_ACTOR_ID>",
}' \
-F 'asset_feed_spec={
"ad_formats": ["SINGLE_IMAGE"],
"bodies": [
{
"text": "Try our delicious guacamole recipe!",
"adlabels": [{"name": "english"}],
},
{
"text": "Essayez notre délicieuse recette de guacamole!",
"adlabels": [{"name": "french"}],
},
],
"titles": [
{
"text": "Jaspers Market",
"adlabels": [{"name": "english"}],
},
{
"text": "Jaspers Market",
"adlabels": [{"name": "french"}],
},
],
"descriptions": [
{
"text": "The best avocados!",
"adlabels": [{"name": "english"}],
},
{
"text": "Les meilleurs avocats!",
"adlabels": [{"name": "french"}],
},
],
"link_urls": [
{
"website_url": "www.jaspersmarket.com/en",
"adlabels": [{"name": "english"}],
},
{
"website_url": "www.jaspersmarket.com/fr",
"adlabels": [{"name": "french"}],
},
],
"images": [
{
"hash": "<IMAGE_HASH>",
},
],
"call_to_action_types": ["SHOP_NOW"],
"asset_customization_rules": [
{
"customization_spec": {
"locales": [9,44],
},
"title_label": {"name": "french"},
"body_label": {"name": "french"},
"description_label": {"name": "french"},
"link_url_label": {"name": "french"},
},
{
"is_default": true,
"customization_spec": {
"locales": [24]
},
"title_label": {"name": "english"},
"body_label": {"name": "english"},
"description_label": {"name": "english"},
"link_url_label": {"name": "english"},
},
]
}' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0
/act_<AD_ACCOUNT_ID>/adcreatives
成功后,您将获得广告创意的编号:
{"id":"238474593777777"}
如果您的 asset_feed_spec
确实符合下方限制,则您将看到错误消息。
如要使用此广告创意素材编号创建广告,请调用 POST act_AD_ACCOUNT_ID/ads
。或者,如要在广告中显示其他语言,您也可以在 creative
参数中为该广告提供 asset_feed_spec
和 object_story_spec
。
如要验证新 asset_feed_spec
,您需在广告编号或广告创意编号中调用 GET
:
curl -G \
-d 'fields=object_story_spec,asset_feed_spec' \
-d 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0
/<CREATIVE_ID>
使用 generatepreview
端点预览不同语言版本的广告。在规则中添加含有 adlabel
的 dynamic_asset_label
字段,即可查看特定语言版本。
例如,如要预览以上创意的法语版本:
curl -G \
--data-urlencode 'creative={
"object_story_spec": {
"page_id": "<PAGE_ID>"
},
"asset_feed_spec": {
...
}
}' \
-d 'ad_format=DESKTOP_FEED_STANDARD' \
-d 'dynamic_asset_label=french'
-d 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0
/act_<AD_ACCOUNT_ID>/generatepreviews
如果您没有可手动翻译广告的资源,可以使用我们的自动翻译服务。此功能会将您的默认广告文案翻译为其他语言,因此您可以为多语言受众提供内容。
自动翻译的来源位于默认素材定制规则指定的文本素材中。自动翻译的广告文案会带有“自动翻译”标签。
如要创建广告文案的自动翻译版本,请将 autotranslate
添加到 asset_feed_spec
。然后,您需要指定文案的目标翻译语言。查看示例:
curl \
-F 'object_story_spec={
"page_id": "<PAGE_ID>",
"instagram_actor_id": "<INSTAGRAM_ACTOR_ID>",
}' \
-F 'asset_feed_spec={
"ad_formats": ["SINGLE_IMAGE"],
"autotranslate": ["fr_XX"],
"bodies": [
{
"text": "Try our delicious guacamole recipe!",
"adlabels": [{"name": "english"}],
}
],
"titles": [
{
"text": "Jaspers Market",
"adlabels": [{"name": "english"}]
}
],
"descriptions": [
{
"text": "The best avocados!",
"adlabels": [{"name": "english"}]
}
],
"link_urls": [
{
"website_url": "www.jaspersmarket.com",
"adlabels": [{"name": "english"}]
}
],
"images": [
{
"hash": "<IMAGE_HASH>"
},
],
"call_to_action_types": ["SHOP_NOW"],
"optimization_type": "LANGUAGE",
"asset_customization_rules": [
{
"is_default": true,
"customization_spec": {
"locales": [6]
},
"title_label": {"name": "english"},
"body_label": {"name": "english"},
"description_label": {"name": "english"},
"link_url_label": {"name": "english"}
}
]
}' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0
/act_<AD_ACCOUNT_ID>/adcreatives
您可通过调用创意的 asset_feed_spec
字段查看自动翻译的文案。
如果 autotranslate
字段指定的语言相同,系统将删除自动翻译的规范副本的编辑内容。这些编辑内容将替换为默认广告文案的新翻译内容。如果您真的需要这些编辑内容,请从 autotranslate
字段中移除此语言。
link_urls
您可以向自动翻译的广告版本内容添加自定义链接网址。
为此,请将 language-specific
网址和 adlabel
添加到 link_urls
字段,将新规则添加到含有相关联地域代码的 asset_customization_rules
并为此语言添加 link_url_label
。
以下为您素材信息库的限制。
asset_feed_spec
仅使用一种广告格式SINGLE_IMAGE
格式,您必须至少提供一张图片。SINGLE_VIDEO
格式,您必须至少提供一个视频call_to_action_types
外,您最多可以为每种素材类型提供 49 个素材。call_to_action_type
素材。 title
、正文、description
和 link_urls
。adlabels
字段。adlabel
的图片或视频素材。我们会将此图片或视频用于所有语言版本。adlabel
,并在素材定制规则中提供这些标签。 url_tags
,我们会将其作为作为参数附加到广告中每个素材的 link_url
中。APP_INSTALLS
目标,您的 link_url
应与广告组的 promoted_object.object_store_url
保持一致。asset_feed_spec
中的每种语言变体提供素材定制规则。is_default
需设置为 true
。这可以作为备用规则,即使某用户的区域设置与 asset_feed_spec
中的任何语言都不相符,借助此规则也可显示广告。LINK_CLICKS
- 支持网站和应用程序,不支持 Messenger。APP_INSTALLS
- 支持桌面或移动应用程序。CONVERSIONS
- 支持网址和应用程序,不支持 Messenger。 REACH
- 支持所有目标位置类型。BRAND_AWARENESS
- 支持所有目标位置类型。VIDEO_VIEWS
- 支持所有目标位置类型REACH
- 覆盖和频次支持以下目标翻译语言。在 autotranslate
字段中使用相应的语言代码:
源语言 | 目标翻译语言 | 语言代码 |
---|---|---|
英语 | 西班牙语 |
|
英语 | 法语 |
|
英语 | 德语 |
|
英语 | 葡萄牙语 |
|
英语 | 意大利语 |
|
英语 | 阿拉伯语 |
|
英语 | 荷兰语 |
|
英语 | 马来语 |
|
英语 | 瑞典语 |
|
英语 | 印度尼西亚语 |
|
英语 | 波兰语 |
|
英语 | 印地语 |
|
英语 | 丹麦语 |
|
英语 | 土耳其语 |
|
英语 | 塔加拉族语 |
|
英语 | 罗马尼亚语 |
|
德语 | 英语 |
|
阿拉伯语 | 英语 |
|
希伯来语 | 英语 |
|
西班牙语 | 英语 |
|
日语 | 英语 |
|
挪威语 | 英语 |
|
法语 | 英语 |
|
荷兰语 | 英语 |
|
瑞典语 | 英语 |
|