多國語言廣告

自訂廣告創意的不同部分，如廣告的圖像、影片、文字和正文，以觸及不同語言的用戶。Facebook 可最佳化您的廣告，向適當的用戶顯示適當的語言版本。

如此可協助您輕鬆設定具多種語言的廣告，並在廣告中向瀏覽者提供最相關的語言版本，同時為廣告保持廣泛的目標設定。這使您能夠根據瀏覽者的口語進行個人化內容，同時讓廣告維持經濟效益。

關於這項功能的一般資訊，請參閱廣告使用說明：對多語分享對象投放廣告。參閱可以支援的廣告行銷活動目標。

我們有三種 API 使用素材客製化規則，多國語言廣告是其中之一。

立即開始

開始之前，請先參閱這項產品的限制。如果您的用途符合我們的規格，請繼續進行以下步驟：

• 步驟 1：建立一則廣告行銷活動和廣告組合
• 步驟 2：透過 asset_feed_spec 提供廣告創意—另請參閱支援語言。
• 步驟 3：使用 asset_feed_spec，在 creative_spec 中建立一則廣告
• 步驟 4（可略過）：預覽廣告

若您沒有能夠人工翻譯廣告內容的人手，請參閱我們的自動翻譯服務。

步驟 2：透過 asset_feed_spec 提供廣告創意

要指定多國語言廣告創意，需使用 asset_feed_spec。廣告素材摘要是一系列不同的廣告創意元素，例如圖像、標題、正文等等。請在 /adcreative 建立 asset_feed_spec。

要建立 asset_feed_spec，請提供素材，每種語言各一組。新增標籤標註每項素材，用於辨別該項素材屬於何種語言。Facebook 使用 asset_customization_rules 中的標籤，按語言將素材分組。請您以素材類型為準，每種類型至少提供一項素材。

支援參數

應在 asset_feed_spec 中提供的參數包括：

素材客製化規則

定義會同時對說特定語言的觀眾顯示的素材。每項規則各有一個 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",
    }
  }
}

素材客製化規則的地區設定應使用上述搜尋結果中的索引鍵。如需詳細資訊，請參閱目標設定搜尋。

步驟 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

您可以在自動翻譯的廣告版本新增一個自訂連結網址。

要新增網址，請將 language-specific 網址新增至 link_urls 欄位，再標註一個 adlabel，接著 asset_customization_rules 中加入一個新規則和相關的地區設定代碼，以及這個語言的 link_url_label。

限制

廣告素材摘要的限制如下。

廣告格式

• 每個 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 - 所有目的地類型

支援的購買類型

• REACH - 觸及率與頻率
• AUCTION

支援的翻譯方向

支援以下翻譯方向。請在 autotranslate 欄位中使用對應的方言代碼：