アセットフィードの仕様のオプション

asset_feed_specで、以下のオプションを使用できます。詳しい参考情報は広告アセットフィードの仕様をご覧ください。

プロパティ名説明

プロパティ名	説明
`images` 型: リストの配列	`SINGLE_IMAGE`と`CAROUSEL_IMAGE` フォーマットに必須。対象になる画像の配列。この配列に指定された画像は、広告アカウントの画像ライブラリに収められていなければなりません。このフィールドは、`{"url": "{IMAGE_URL}", "hash": "{IMAGE_HASH}", "url_tags": "{TAG}"}`を含んでいるリストの配列として指定します。`url`または`hash`のいずれかが必須です。
`videos` 型: リストの配列	`SINGLE_VIDEO`フォーマットに必須。 `video_id`の配列。この配列に指定される`video_id`は広告アカウントに属するものでなければなりません。このフィールドは、`{"video_id": "{VIDEO_ID}", "thumbnail_url": "{THUMBNAIL_URL}", "url_tags": "{TAG}"}`を含んでいるリストの配列として指定します。
`carousels` 型: リストの配列	任意。 `multi_share_end_card`および`multi_share_optimized`ブーリアンが指定された`child_attachments`、`adlabels`の配列。この配列に指定する`child_attachments`は、広告アカウントに属するものでなければなりません。 `child_attachments`を、`{"image_label": {"name": "{IMAGE_LABEL}"}, "video_label": {"name": "{VIDEO_LABEL}"}, "title_label": {"name": "{TITLE_LABEL}"}, "description_label": {"name": "{DESC_LABEL}", "link_url_label": {"name": "{LINK_URL}"}}`が含まれるリストの配列として指定します。注:`image_label`または`video_label`のいずれかが必須です。詳しくは、フィールド仕様をご覧ください。
`bodies` 型: リストの配列	任意。本文の配列。広告のメインメッセージまたはコピー。このフィールドは、`{"text": "{BODY_TEXT}", "url_tags": "{TAG}"}`のリストの配列として指定します。
`call_to_action_types` 型: リストの配列	`OUTCOME_AWARENESS`を除くすべての目的で必須。コールトゥアクションタイプの値の配列。このフィールドは、`{"{CALL_TO_ACTION}"}`のリストの配列として指定します。複数(最大5つまで)の値を指定可能。
`titles` 型: リストの配列	任意。タイトルの配列。タイトルは広告の短い見出しであり、通常は、リンク、画像、動画の横に表示されます。このフィールドは、`{"text": "{TITLE}", "url_tags": "{TAG}"}`のリストの配列として指定します。
`descriptions` 型: リストの配列	任意。補足として使用する説明文の配列。本文やタイトルよりも目立たないように表示されます。一般的にリンク、画像、動画の横に表示されます。指定しなかった場合、Facebookが提供されたリンクをスクレイピングして生成します。スクレイピングされたテキストを使用したくない場合は、1つの空白文字で空の文字列を指定し、説明文を空にしてください。このフィールドは、`{"text": "{DESCRIPTION}", "url_tags": "{TAG}"}`のリストの配列として指定します。
`link_urls` 型: リストの配列	必須。リンクURLの配列。このフィールドは、`{"website_url": "{URL}"}`のリストの配列として指定します。
`ad_formats` 型: 文字列の配列	必須。広告を作成すべきFacebook広告フォーマットの配列。サポートされるフォーマットは`SINGLE_IMAGE`、`CAROUSEL`、`SINGLE_VIDEO`、`AUTOMATIC_FORMAT`です。このフィールドは、文字列`["{AD_FORMAT}"]`の配列として指定します。
`optimization_type` 型: 文字列	任意。アセットフィードで使用される最適化のタイプ。指定可能な値は`ASSET_CUSTOMIZATION`、`LANGUAGE`、`PLACEMENT`、`REGULAR`です。
`message_extensions` 型: 文字列の配列	任意。アセットフィードで使用されるメッセージ拡張機能のタイプ。指定可能な値: `whatsapp`
`onsite_destinations` 型: リストの配列	ショップ広告に必須。静的広告(`SINGLE_IMAGE`、`SINGLE_VIDEO`、または`CAROUSEL`フォーマット)で有効。このフィールドは、オンサイトショップのランディング先を指定するために、以下のいずれかの値を含むリストの配列として指定します。 {"storefront_shop_id": "<SHOP_STOREFRONT_ID>"} or {"shop_collection_product_set_id": "<PRODUCT_SET_ID>" or {"details_page_product_id": "<PRODUCT_ID>"}
`shops_bundle` 型: ブール値	ショップ広告に必須。Advantage+カタログ広告に有効。このフィールドは、ショップの最適化のために指定します。ショップ最適化タイプ`reasons_to_shop`と`automated_product_tags`の両方が含まれます。指定可能な値: `true`、`false`
`reasons_to_shop` 型: ブール値	ショップ広告に必須。Advantage+カタログ広告に有効。このフィールドは、ショップの最適化のために指定します。「送料無料」、「トレンド」、「在庫残りわずか」など、ショップの商品情報を自動的にハイライトします。指定可能な値: `true`、`false`

images

型: リストの配列

SINGLE_IMAGEとCAROUSEL_IMAGE フォーマットに必須。

対象になる画像の配列。この配列に指定された画像は、広告アカウントの画像ライブラリに収められていなければなりません。

このフィールドは、{"url": "{IMAGE_URL}", "hash": "{IMAGE_HASH}", "url_tags": "{TAG}"}を含んでいるリストの配列として指定します。urlまたはhashのいずれかが必須です。

videos

型: リストの配列

SINGLE_VIDEOフォーマットに必須。

video_idの配列。この配列に指定されるvideo_idは広告アカウントに属するものでなければなりません。

このフィールドは、{"video_id": "{VIDEO_ID}", "thumbnail_url": "{THUMBNAIL_URL}", "url_tags": "{TAG}"}を含んでいるリストの配列として指定します。

carousels
型: リストの配列

任意。
multi_share_end_cardおよびmulti_share_optimizedブーリアンが指定されたchild_attachments、adlabelsの配列。この配列に指定するchild_attachmentsは、広告アカウントに属するものでなければなりません。

child_attachmentsを、{"image_label": {"name": "{IMAGE_LABEL}"}, "video_label": {"name": "{VIDEO_LABEL}"}, "title_label": {"name": "{TITLE_LABEL}"}, "description_label": {"name": "{DESC_LABEL}", "link_url_label": {"name": "{LINK_URL}"}}が含まれるリストの配列として指定します。
注:image_labelまたはvideo_labelのいずれかが必須です。

詳しくは、フィールド仕様をご覧ください。

bodies

型: リストの配列

任意。

本文の配列。広告のメインメッセージまたはコピー。

このフィールドは、{"text": "{BODY_TEXT}", "url_tags": "{TAG}"}のリストの配列として指定します。

call_to_action_types

型: リストの配列

OUTCOME_AWARENESSを除くすべての目的で必須。

コールトゥアクションタイプの値の配列。

このフィールドは、{"{CALL_TO_ACTION}"}のリストの配列として指定します。複数(最大5つまで)の値を指定可能。

titles

型: リストの配列

任意。

タイトルの配列。タイトルは広告の短い見出しであり、通常は、リンク、画像、動画の横に表示されます。

このフィールドは、{"text": "{TITLE}", "url_tags": "{TAG}"}のリストの配列として指定します。

descriptions

型: リストの配列

任意。

補足として使用する説明文の配列。本文やタイトルよりも目立たないように表示されます。一般的にリンク、画像、動画の横に表示されます。指定しなかった場合、Facebookが提供されたリンクをスクレイピングして生成します。スクレイピングされたテキストを使用したくない場合は、1つの空白文字で空の文字列を指定し、説明文を空にしてください。

このフィールドは、{"text": "{DESCRIPTION}", "url_tags": "{TAG}"}のリストの配列として指定します。

link_urls

型: リストの配列

必須。

リンクURLの配列。

このフィールドは、{"website_url": "{URL}"}のリストの配列として指定します。

ad_formats

型: 文字列の配列

必須。

広告を作成すべきFacebook広告フォーマットの配列。サポートされるフォーマットはSINGLE_IMAGE、CAROUSEL、SINGLE_VIDEO、AUTOMATIC_FORMATです。

このフィールドは、文字列["{AD_FORMAT}"]の配列として指定します。

optimization_type

型: 文字列

任意。

アセットフィードで使用される最適化のタイプ。指定可能な値はASSET_CUSTOMIZATION、LANGUAGE、PLACEMENT、REGULARです。

message_extensions

型: 文字列の配列

任意。
アセットフィードで使用されるメッセージ拡張機能のタイプ。

指定可能な値: whatsapp

onsite_destinations
型: リストの配列

ショップ広告に必須。静的広告(SINGLE_IMAGE、SINGLE_VIDEO、またはCAROUSELフォーマット)で有効。
このフィールドは、オンサイトショップのランディング先を指定するために、以下のいずれかの値を含むリストの配列として指定します。

{"storefront_shop_id": "<SHOP_STOREFRONT_ID>"}
or 
{"shop_collection_product_set_id": "<PRODUCT_SET_ID>" 
or 
{"details_page_product_id": "<PRODUCT_ID>"}

shops_bundle
型: ブール値

ショップ広告に必須。Advantage+カタログ広告に有効。
このフィールドは、ショップの最適化のために指定します。ショップ最適化タイプreasons_to_shopとautomated_product_tagsの両方が含まれます。
指定可能な値: true、false

reasons_to_shop
型: ブール値

ショップ広告に必須。Advantage+カタログ広告に有効。
このフィールドは、ショップの最適化のために指定します。「送料無料」、「トレンド」、「在庫残りわずか」など、ショップの商品情報を自動的にハイライトします。
指定可能な値: true、false

アセットフィードの仕様の制限

広告フォーマット

ad_formats (SINGLE_IMAGE、CAROUSEL、SINGLE_VIDEO、AUTOMATIC_FORMAT)をサポート。
1つのアセットフィードで使用できるad_formatは1つだけです。
ad_formatはアセットフィードの1つのアセットとしてカウントされます。

アセットの数:

合計アセットの最大数は30です。例えば、10個のimages、5個のbodies、5個のtitles、5個のdescription、1個のad_format、1個のlink_url、1個のcall_to_action_typesで、合計28個のアセットを保持するなど。
画像の総数: 10個以内。
動画の総数: 10個以内。Instagramを配置として使用している場合は、正方形の動画または横型の動画のみ使用できます。
本文の総数: 5個以内。
コールトゥアクションの総数: 5個以内。
タイトルの総数: 5個以内。
リンクの総数: 5個以内。
説明の総数: 5個以内。

画像の要件:

推奨画像スペック: 1.9:1。
推奨画像サイズ: 1,200 x 628ピクセル。
CAROUSEL_IMAGEフォーマットの場合、2つ以上の画像を指定しなければなりません。
Instagramを配置として使用する場合、正方形の画像を使った方がパフォーマンスが向上します。

テキストの要件:

タイトルと説明テキスト: 最大255文字。
本文: 最大1,024文字。
説明を指定しないと、指定したリンクがスクレイピングされて説明が取得されます。
CAROUSEL_IMAGEの場合、タイトルは任意です。

url_tagsは任意であり、images、videos、bodies、descriptions、titlesにのみ使用できます。Facebookは広告内の各アセットのパラメーターとして、リンクURLにurl_tagsを追加します。

例えば、SINGLE_IMAGEフォーマットの有効なアセットフィードの組み合わせの設定は、次のようになります。

5個のimages
3個のbodies
3個のtitles
3個のdescriptions
1個のフォーマット(SINGLE_IMAGE)
2個のlink_urls

"link_urls=[{'website_url':'<WEBSITE_URL>'}, {'website_url':'<WEBSITE_URL>'}]"

ディープリンクを使用する

以下の目的を持つキャンペーンのアセットフィードの仕様で、ディープリンクを使用できます。

APP_INSTALLS
CONVERSIONS
LINK_CLICKS

asset_feed_specを作成するときに、link_urlsにdeeplink_urlを追加します。

curl \ -F 'object_story_spec={ "page_id": "<PAGE_ID>" "instagram_user_id" : "<IG_USER_ID>", }' \ -F "asset_feed_spec={ 'images': [{'hash':'<IMAGE_HASH>'}], 'bodies': [{'text':'<BODY_1>'}, {'text':'<BODY_2>'}], 'titles': [{'text':'<TITLE_1>'}, {'text':'<TITLE_2>'}], 'descriptions': [{'text':'<DESCRIPTION>'}], 'ad_formats': ['SINGLE_IMAGE'], 'link_urls': [{'website_url':'<APP_OBJECT_STORE_URL>','deeplink_url':'<DEEPLINK_URL>'}]}" \ -F 'access_token=<ACCESS_TOKEN>' \ https://graph.facebook.com/v25.0/act_<AD_ACCOUNT_ID>/adcreatives

ウェブサイトからWhatsApp広告へ

広告からウェブサイトに誘導された利用者がすぐに問い合わせられるよう、誘導先で画面下部にWhatsAppボタンが表示されるウェブサイト誘導広告を作成できるようになりました。これによって、ウェブサイト利用者が、WhatsAppで簡単にビジネスとつながれるようになります。

asset_feed_specを作成するときに、"type": "whatsapp"を指定したmessage_extensionsパラメーターを追加します。

curl \ -F 'object_story_spec={ "page_id": "<PAGE_ID>" "instagram_user_id" : "<IG_USER_ID>", }' \ -F 'asset_feed_spec={ "images": [{"hash":"<IMAGE_HASH>"}], "bodies": [{"text":"<BODY_1>"}, {"text":"<BODY_2>"}], "titles": [{"text":"<TITLE_1>"}, {"text":"<TITLE_2>"}], "descriptions": [{"text":"<DESCRIPTION>"}], "ad_formats": ["SINGLE_IMAGE"], "link_urls": [{"website_url":"<BUSINESS_URL>"}], "message_extensions": [{"type": "whatsapp"}]}' \ -F 'access_token=<ACCESS_TOKEN>' \ https://graph.facebook.com/v25.0/act_<AD_ACCOUNT_ID>/adcreatives