広告クリエイティブ

複数言語の広告

異なる言語を話す利用者にリーチするため、広告の画像、動画、テキスト、および本文など、広告クリエイティブのさまざまなパーツをカスタマイズします。利用者に合った言語のバージョンで表示されるよう、広告が自動的に最適化されます。

これにより、複数の言語で簡単に広告を設定でき、広告の幅広いターゲット設定を維持しつつ、視聴者に最も関連する言語バージョンの広告を配信できます。結果、視聴者の話す言語に基づいてパーソナライズされたコンテンツを保持しながら、コスト効率の高い広告を保守することが可能になります。

この機能の一般的な情報については、「広告ヘルプセンター、複数言語のオーディエンスに対して広告を行う」をご覧ください。サポートされている広告キャンペーンの目的をご覧ください。

複数言語広告は、アセットカスタマイズルールを使用するFacebookの3つのAPIのうちの1つです。

利用を開始

始める前に、この商品の制限を確認しましょう。Facebookの仕様に沿って使用する場合は、次のステップに移動してください:

広告を手動で翻訳するためのリソースがない場合、Facebookの自動翻訳サービスを検討してください。

ステップ2: クリエイティブをasset_feed_spec経由で提供する

複数言語広告クリエイティブは、asset_feed_specを使用して指定します。アセットフィードとは、画像、タイトル、本文などの広告素材エレメントのコレクションです。asset_feed_specを/adcreativeで作成します。

asset_feed_specを作成するには、異なる言語ごとにアセットの配列を提供します。アセットが属する言語を識別するため、アセットごとにタグ付けするラベルを追加します。Facebookは、asset_customization_rulesのラベルを使用して言語ごとにアセットをグループ化します。アセットのタイプごとに少なくとも1つのアセットを提供しなければなりません。

利用可能なパラメーター

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>"}]}の配列として提供します。説明が空白の場合は、1つのスペースがある空の文字列を使用します。

link_urls

型: 配列

必須。ただしdisplay_urlとdeeplink_urlは任意。

リンク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があり、これにより広告配信時にこれらのアセットを見る人のロケールを定義します。

デフォルトルールを1つだけ指定します。このルールには、利用者の選択した言語がアセットフィードで指定されたいずれのロケールにも一致しない場合に表示されるアセットが含まれていなければなりません。そうすることで、広告が配信されないことを防ぎます。

プロパティ名 説明

customization_spec

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

必須。

このルールでアセットを配信するロケールを定義します。サポートされるロケールについては、「利用可能な言語」をご覧ください。

image_label

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

SINGLE_IMAGE広告フォーマットの場合は必須。

アセットフィード内の画像アセットの1つに添付されるラベルです。

video_label

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

SINGLE_VIDEO広告フォーマットの場合は必須。

アセットフィード内の動画アセットの1つに添付されるラベルです。

body_label

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

必須。

アセットフィード内の本文アセットの1つに添付されるラベルです。

title_label

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

必須。

アセットフィード内のタイトルアセットの1つに添付されるラベルです。

description_label

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

必須。

アセットフィード内の説明アセットの1つに添付されるラベルです。

link_url_label

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

必須。

アセットフィード内のlink_urlアセットの1つに添付されるラベルです。

is_default

型: ブーリアン

必須。

デフォルトルール識別のためのブーリアンのフラグ。is_defaultフラグをtrueに指定した1つのルールだけを設定しなければなりません。

利用可能な言語

customization_specで指定するロケールは、広告のターゲット設定でサポートされているロケールIDでなければなりません。「ターゲット設定と配置、ロケール」をご覧ください。/searchエンドポイントを使用して特定の言語を検索できます。特定の言語名を検索するには、qパラメーターを使用します。次のようにこのパラメーターを空白にすると、サポートされているすべての言語のリストが表示されます:

curl -G 
  -d "type=adlocale"
  -d "q=en"
  -d "limit=2"
  -d "access_token=<ACCESS_TOKEN>" 
  https://graph.facebook.com/<API_VERSION>/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": "J45p3r5m4RK374VOc4DO2",
         },
       ],
       "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/API_VERSION/act_AD_ACCOUNT_ID/adcreatives

成功すると、次の広告クリエイティブのIDが返されます:

{"id":"238474593777777"}

指定したasset_feed_specが下記の制限に合致していない場合は、エラーになります。

この広告クリエイティブIDを使って広告を作成するには、POST act_AD_ACCOUNT_ID/adsを呼び出します。また、広告に別の言語を表示するには、asset_feed_specとobject_story_specを広告のcreativeパラメーターで指定します。

新規asset_feed_specを認証するには、次のように広告IDまたは広告クリエイティブIDでGETを呼び出します:

curl -G
-d 'fields=object_story_spec,asset_feed_spec'
-d 'access_token=<ACCESS_TOKEN>'
https://graph.facebook.com/API_VERSION/<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/<API_VERSION>/act_<AD_ACCOUNT_ID>/generatepreviews

自動翻訳

広告を手動で翻訳するためのリソースがない場合は、Facebookの自動翻訳サービスを使用できます。この機能はデフォルトの広告コピーを別の言語に翻訳するので、複数言語のオーディエンスにリーチできます。

自動翻訳のソースは、デフォルトアセットカスタマイズルールで指定されたテキストアセットで確認できます。自動的に翻訳された広告コピーには、「自動翻訳」のラベルが付きます。

広告コピーの自動翻訳されたバージョンを作成するには、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"],
       "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/<API_VERSION>/act_<AD_ACCOUNT_ID>/adcreatives/?fields=asset_feed_spec

自動翻訳されたコピーは、クリエイティブのasset_feed_specフィールドの呼び出しで確認できます。

自動翻訳されたコピーを仕様で編集した場合、同じ言語をautotranslateフィールドで指定すると、編集箇所がなくなります。これらの編集内容は、デフォルト広告コピーから新たに翻訳されたバージョンに置き換えられます。編集したものが絶対に必要な場合は、該当する言語をautotranslateフィールドから削除してください。

link_urls

カスタムリンクURLを広告の自動翻訳されたバージョンに追加できます。

そのためには、language-specific URLをlink_urlsフィールドにadlabelと共に追加し、asset_customization_rulesにこの言語の関連するロケールコードとlink_url_labelを指定した新規ルールを追加します。

制限

アセットフィードの制限は以下のとおりです。

広告フォーマット

  • asset_feed_specごとに広告フォーマットは1つだけです
  • SINGLE_IMAGEフォーマットの場合、少なくとも1つの画像を提供しなければなりません。
  • SINGLE_VIDEOフォーマットの場合、少なくとも1つの動画を提供しなければなりません。

アセット、一般

  • call_to_action_typesを例外として、各アセットタイプには最大49個のアセットを提供できます。
  • すべての目的に対して、call_to_action_typeアセットを1つだけ提供しなければなりません。

テキストアセット

  • 少なくとも1つのテキストアセット(title、本文、description、link_urlsなど)を、アセットフィードの各言語バージョンに提供しなければなりません。
  • すべてのテキストアセットにadlabelsフィールドが必要です。
  • 最大長: タイトルでは255文字、本文では4,096文字、説明では10,000文字です。

画像アセットと動画アセット

  • 配置と目的ごとの推奨されている画像サイズについては「広告ガイド」をご覧ください。
  • adlabelのない画像アセットまたは動画アセットは最大で1つしか使用できません。この画像や動画はすべての言語バージョンで使用されます。
  • それに加えて他の動画または画像を提供する場合は、adlabelを含めアセットカスタマイズルールにこれらのラベルを提供しなければなりません。

リンクURLアセット

  • url_tagsが提供された場合、広告内の各アセットのパラメーターとしてlink_urlに追加します。
  • APP_INSTALLS目的を使用する場合、link_urlは広告セットのpromoted_object.object_store_urlと同じでなければなりません。

アセットのカスタマイズルール

  • asset_feed_specのすべての言語バージョンのアセットカスタマイズルールを提供しなければなりません。
  • 1つのデフォルトルールを提供しなければなりません。これは、is_defaultをtrueに設定したアセットカスタマイズルールです。これはバックアップルールとして機能し、いずれかの利用者のロケールがasset_feed_specのどの言語とも一致していなくても広告を表示できるようにします。

配置

  • 複数言語広告はすべての配置をサポートします。

利用可能な目的とデスティネーションタイプ

  • LINK_CLICKS - Webサイトとアプリ(Messenger以外)。
  • APP_INSTALLS - デスクトップアプリまたはモバイルアプリ。
  • CONVERSIONS - Webサイトとアプリ(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