廣告創意

多語言廣告

自訂廣告創意的不同部分（如圖像、影片、文字及廣告內文），以便接觸使用不同語言的用戶。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 廣告格式，則為必要項目。提供 url 或 hash。

url 或 hash 形式的圖像。您應提供廣告帳戶圖庫中的圖像。


{"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_url 和 deeplink_url 為選用項目。

連結網址陣列。


{"website_url": "<URL>", "adlabels": [{"name": "<LABEL>"}], "deeplink_url": "<DEEPLINK>", "display_url": "<URL>"} 的陣列。

call_to_action_types

類型：陣列

此為必要項目。

呼籲字句類型值組成的陣列。


以支援的呼籲字句陣列形式提供此欄位：["<CALL_TO_ACTION>"]。

ad_formats

此為必要項目。

Facebook 廣告格式的陣列，表示您想在建立廣告時使用的格式。支援的格式為：SINGLE_IMAGE、SINGLE_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

類型：布林值

此為必要項目。

用於識別預設規則的布林值標示。您應只設定一種標示為 true 的 is_default 規則。

可用語言

您在 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_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>

步驟 4（選用）：預覽廣告

使用 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

您可以在廣告的自動翻譯版本中加入自訂連結網址。

方法如下：將帶有 adlabel 的 language-specific 網址加至 link_urls 欄位，並將帶有相應地區代碼的新規則和此語言的 link_url_label 加至 asset_customization_rules。

限制

以下是對您素材摘要所設的限制。

廣告格式

  • 每個 asset_feed_spec 只能有一個廣告格式
  • 若為 SINGLE_IMAGE 格式，您須提供最少一張圖像。
  • 若為 SINGLE_VIDEO 格式，您須提供最少一段影片

素材的一般限制

  • 您可以為每種素材類型提供最多 49 個素材（call_to_action_types 除外）。
  • 您必須只為所有目標提供一個 call_to_action_type 素材。

文字素材

  • 您必須為素材摘要中的所有語言版本提供最少一個文字素材，如 title、內文、description 和 link_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