多语言广告

自定义广告创意的不同部分(如图片、视频、文本和广告正文等),以便覆盖使用不同语言的用户。Facebook 会优化广告,向目标受众展示适当的语言版本。

这有助您轻松设置多语言广告,并向观看者投放最切合其需求的广告语言版本,同时为广告保留广泛的目标受众。这让您能在维持较低广告成本的同时,根据观看者所使用的语言为其展示个性化内容。

如需了解此功能的基本信息,请参阅广告帮助中心的“面向多语言受众发布广告”一文。您也可以参阅受支持的广告系列目标

我们提供了三种使用素材定制规则的 API,多语言广告便是其中之一。

入门指南

开始前,请查看关于此产品的限制。如果您的用例符合要求,请执行以下步骤:

如果您没有可手动翻译广告的资源,请查看我们的自动翻译服务

第 2 步:通过 asset_feed_spec 提供创意

使用 asset_feed_spec 指定多语言广告创意。素材信息库由一系列不同的创意元素组成,例如图片、标题和正文等。您可以在 /adcreative 处创建 asset_feed_spec

要创建 asset_feed_spec,请为每种不同语言提供一组素材。添加标签以标记各个素材,从而识别素材所属语言。Facebook 会在 asset_customization_rules 中使用标签,以便按语言对素材进行分组。您应为每种素材类型至少提供一个素材

可用参数

要在 asset_feed_spec 中提供的参数包括:

属性名称 描述

images

类型:数组

必须为 SINGLE_IMAGE 广告格式提供。提供 urlhash

作为 urlhash 的图片。您应提供广告帐户图片库中的图片。


为此字段提供如下所示的数组值:{"url": "<IMAGE_URL>", "hash": "<IMAGE_HASH>", "url_tags": "<TAG>", "adlabels": [{name: "<LABEL>"}]}

videos

类型:数组

必须为 SINGLE_VIDEO 广告格式提供。

video_ids 数组。视频应存放在广告帐户视频库中。


为此字段提供如下所示的数组值:{"video_id": "<VIDEO_ID>","thumbnail_url": "{<THUMBNAIL_URL>}", "url_tags": "{<TAG>}", "adlabels": [{"name": "<LABEL>"}]}

bodies

类型:数组

必须提供,但 url_tags 为选填项。

正文数组包含广告的主要信息。


为此字段提供如下所示的数组值:{"text": "<BODY_TEXT>", "url_tags": "<TAG>", "adlabels": [{"name": "<LABEL>"}]}

titles

类型:数组

必须提供,但 url_tags 为选填项。

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


为此字段提供如下所示的数组值:{"text": "<TITLE>", "url_tags": "<TAG>", "adlabels": [{"name": "<LABEL>"}]}

descriptions

类型:数组

必须提供,但 url_tags 为选填项。

辅助说明文本数组,相比正文或标题而言并不突出显示。


为此字段提供如下所示的数组值:{"text": "<DESCRIPTION>", "url_tags": "<TAG>", "adlabels": [{"name": "<LABEL>"}]}。对于空白说明,使用空字符串配搭单个空格。

link_urls

类型:数组

必须提供,但 display_urldeeplink_url 为选填项。

链接网址数组。


为此字段提供如下所示的数组值:{"website_url": "<URL>", "adlabels": [{"name": "<LABEL>"}], "deeplink_url": "<DEEPLINK>", "display_url": "<URL>"}

call_to_action_types

类型:数组

必要。

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


为此字段提供受支持的行动号召数组:["<CALL_TO_ACTION>"]

ad_formats

必要。

创建广告时想要使用的 Facebook 广告格式组成的数组。支持的格式:SINGLE_IMAGESINGLE_VIDEO


为此字段提供受支持的广告格式数组:["{<AD_FORMAT>}"]

asset_customization_rules

类型:请参阅素材定制规则下方的表格

必要。

素材定制规则数组。

素材定制规则

为使用特定语言的观看者定义一同显示的素材。每种规则均设有 customization_spec,用于在广告投放期间定义素材观看者的区域设置。

您应只提供一个默认规则。如果某用户的首选语言与素材信息库中指定的任意区域设置均不匹配,则该规则必须包含 Facebook 显示的素材。这有助于防止广告投放不足的问题。

属性名称 描述

customization_spec

类型:{"locales": [<LOCALE1>, <LOCALE2>]}

必要。

定义此规则中素材应投放的区域设置。如需查看支持的区域设置,请参阅可用语言

image_label

类型:{"name": "<LABEL>"}

必须为 SINGLE_IMAGE 广告格式提供。

附加到素材信息库中某个图片素材的标签。

video_label

类型:{"name": "<LABEL>"}

必须为 SINGLE_VIDEO 广告格式提供。

附加到素材信息库中某个视频素材的标签。

body_label

类型:{"name": "<LABEL>"}

必要。

附加到素材信息库中某个正文素材的标签。

title_label

类型:{"name": "<LABEL>"}

必要。

附加到素材信息库中某个标题素材的标签。

description_label

类型:{"name": "<LABEL>"}

必要。

附加到素材信息库中某个说明素材的标签。

link_url_label

类型:{"name": "<LABEL>"}

必要。

附加到素材信息库中某个 link_url 素材的标签。

is_default

类型:布尔型

必要。

用于识别默认规则的布尔标记。您应只设置一种规则,并将 is_default 标记设为 true

可用语言

您在 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",
    }
  }
}

您应将这些搜索结果中的关键值用作素材定制规则中的区域设置。如需了解更多信息,请参阅定位搜索

第 3 步:使用素材信息库规范创建广告

您可以在 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_specobject_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>

第 4 步(非必要):预览广告

使用 generatepreview 端点预览不同语言版本的广告。在规则中添加含有 adlabeldynamic_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、正文、descriptionlink_urls
  • 所有文本素材均应包含 adlabels 字段。
  • 标题最多为 255 个字符、正文为最多 4096 个字符、描述最多为 10000 个字符。

图片和视频素材

  • 如需了解按版位和目标推荐的图片尺寸,请参阅广告指南
  • 您最多可以使用一个不含 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 - 支持所有目标位置类型

支持的购买类型

支持的目标翻译语言

支持以下目标翻译语言。在 autotranslate 字段中使用相应的语言代码:

源语言目标翻译语言语言代码

英语

西班牙语

es_XX

英语

法语

fr_XX

英语

德语

de_DE

英语

葡萄牙语

pt_XX

英语

意大利语

it_IT

英语

阿拉伯语

ar_AR

英语

荷兰语

nl_XX

英语

马来语

ms_MY

英语

瑞典语

sv_SE

英语

印度尼西亚语

id_ID

英语

波兰语

pl_PL

英语

印地语

hi_IN

英语

丹麦语

da_DK

英语

土耳其语

tr_TR

英语

塔加拉族语

tl_XX

英语

罗马尼亚语

ro_RO

德语

英语

en_XX

阿拉伯语

英语

en_XX

希伯来语

英语

en_XX

西班牙语

英语

en_XX

日语

英语

en_XX

挪威语

英语

en_XX

法语

英语

en_XX

荷兰语

英语

en_XX

瑞典语

英语

en_XX