広告クリエイティブ

配置アセットのカスタマイズ

このソリューションは、さまざまな広告配置に表示されるクリエイティブアセットをカスタマイズするために使います。複数の異なる配置を使いながら、クリエイティブに対するコントロールを維持することができます。

配置アセットカスタマイズは、アセットカスタマイズルールを使う3つのAPIの1つです。アセットカスタマイズルールについて詳しくはこちらをご覧ください。

スタートガイド

既存の投稿による配置アセットのカスタマイズは、API経由ではサポートされなくなりました。このオプションは広告マネージャでのみ使うことができます。

ステップ2: クリエイティブを指定する

asset_feed_specを使ってクリエイティブを指定します。画像、動画、カルーセル、ヘッドライン、本文など、アセットのタイプごとに複数のクリエイティブアセットを指定できます。リンクの説明を配置ごとにカスタマイズすることはできないため、リンクの説明は1つだけにしてください。

カスタマイズを適用するには、次のようにします。

  1. asset_feed_specの中にasset_customization_rulesを設定します。
  2. 各ルールに、customization_specとアセットラベルを追加します。

配置アセットのカスタマイズでは、どのasset_feed_specにも複数のカスタマイズルールを指定する必要があります。

アセットカスタマイズルールをご覧ください。

サポートされるプロパティ


プロパティ名 説明

customization_spec

タイプ: サポートされるフィールド

必須。

アセットの表示場所となる配置。

image_label

フォーマット: {"name": "{LABEL_NAME}"}

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

表示する画像のラベル。これがasset_feed_specの中の画像アセットに添付されます。

video_label

フォーマット: {"name": "{LABEL_NAME}"}

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

表示する動画のラベル。これがasset_feed_specの動画アセットに添付されます。

carousel_label
フォーマット: {"name": "{LABEL_NAME}"}

CAROUSELSフォーマットの場合は必須。

表示するカルーセルのラベル。これがasset_feed_specのカルーセルアセットに添付されます。

注: 配置アセットのカスタマイズを通じてカルーセルを提供する場合は、すべての子添付物がアセットフィード内で定義されていなければならず、adlabelを通じて参照されていなければなりません。子添付物をインラインで定義することはできません。carouselsフォーマットについて詳しくは、アセットフィードの仕様のオプションをご覧ください。

customization_specでサポートされるフィールド


プロパティ名 説明

publisher_platforms

必須。

広告に対して可能な配置。オプションは、facebook、instagram、messenger、audience_networkです。

facebook_positions

任意。ただし、publisher_platformsでFacebookが選択されている場合は必須。

Facebook特有の配置。オプションは、feed、right_hand_column、marketplace、video_feeds、search、storyです。

instagram_positions

任意。ただし、publisher_platformsでInstagramが選択されている場合は必須。

Instagram特有の配置。オプションは、stream、story、explore、explore_home、profile_feed、ig_searchです。

注:explore_homeの配置でサポートされるフォーマットはSINGLE_IMAGEだけです。

messenger_positions

任意。ただし、publisher_platformsでMessengerが選択されている場合は必須。

Messenger特有の配置。オプションは、messenger_home、sponsored_messages、storyです。

audience_network_positions

任意。ただし、publisher_platformsでAudience Networksが選択されている場合は必須。

Audience Network特有の配置。オプションは、classic、instream_video、rewarded_videoです。

利用可能な配置オプションについて詳しくはこちらをご覧ください。

例 — フィードの設定

curl \
  -F 'object_story_spec={
       "page_id": "<PAGE_ID>",
       "instagram_actor_id": "<INSTAGRAM_ACTOR_ID>",
     }' \
  -F 'asset_feed_spec={
      "videos": [
      {
        "adlabels": [
          {
            "name": "labelfb"
          }
        ],
        "video_id": "<VIDEO_ID>"
      },
      {
        "adlabels": [
          {
            "name": "labelig"
          }
        ],
        "video_id": "<VIDEO_ID>"
      }
    ],
    "bodies": [
      {
        "text": "Begin Your Adventure"
      }
    ],
    "link_urls": [
      {
        "website_url": "<WEBSITE_URL>",
        "display_url": "<DISPLAY_URL>"
      }
    ],
    "titles": [
      {
        "text": "Level Up"
      }
    ],
    "ad_formats": [
      "SINGLE_VIDEO"
    ],
    "call_to_action_types": [
      "WATCH_MORE"
    ],
    "descriptions": [
      {
        "text": "Description"
      }
    ],
    "asset_customization_rules": [
      {
        "customization_spec": {          
          "publisher_platforms": [
            "facebook"
          ],          
          "facebook_positions": [
            "feed",
            "instream_video"
          ]
        },
        "video_label": {
          "name": "labelfb"
        }
      },
      {
        "customization_spec": {          
          "publisher_platforms": [
            "instagram"
          ],          
          "instagram_positions": [
            "stream"           
          ]
        },
        "video_label": {
          "name": "labelig"
        }
      }
    ]
  }' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

例 — Instagram発見ホームアセットのカスタマイズ

curl \
  -F 'object_story_spec={
       "page_id": "<PAGE-ID>",
       "instagram_actor_id": "<INSTAGRAM-ID>",
     }' \
  -F 'asset_feed_spec={
        "ad_formats": [
          "SINGLE_IMAGE"
        ],
        "asset_customization_rules": [
          {
            "image_label": {
              "name": "<IMAGE-LABEL>"
            },
            "customization_spec": {
              "publisher_platforms": [
                "instagram"
              ],
              "instagram_positions": [
                "explore_home"
              ]
            }
          }
        ],
        "bodies": [
          {
            "text": "",
            "adlabels": [
              {
                "name": "adlabel1"
              },
              {
                "name": "adlabel2"
              }
            ]
          }
        ],
        "call_to_action_types": [
          "LEARN_MORE"
        ],
        "images": [
          {
            "hash": "<IMAGE-HASH>",
            "adlabels": [
              {
                "name": "adlabel1"
              }
            ]
          },
          {
            "hash": "<IMAGE-HASH>",
            "image_crops": {
              "100x100": [
                [
                  604,
                  0
                ],
                [
                  1659,
                  1055
                ]
              ]
            },
            "adlabels": [
              {
                "name": "adlabel2"
              }
            ]
          }
        ],
        "link_urls": [
          {
            "website_url": "",
            "display_url": "",
            "deeplink_url": "",
            "adlabels": [
              {
                "name": "adlabel1"
              },
              {
                "name": "adlabel2"
              }
            ]
          }
        ],
        "optimization_type": "PLACEMENT",
        "titles": [
          {
            "text": "",
            "adlabels": [
              {
                "name": "adlabel1"
              },
              {
                "name": "adlabel2"
              }
            ]
          }
        ]
      }' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

例 - Instagram検索結果アセットのカスタマイズ

curl 
  -F 'object_story_spec={
       "page_id": "<PAGE-ID>",
       "instagram_actor_id": "<INSTAGRAM-ID>",
     }' \
  -F 'asset_feed_spec={
        "ad_formats": [
          "SINGLE_IMAGE"
        ],
        "asset_customization_rules": [
          {
            "image_label": {
              "name": "placement_asset_f1048d832ecd558_1661539731099"
            },
            "customization_spec": {
              "publisher_platforms": [
                "instagram"
              ],
              "instagram_positions": [
                "ig_search"
              ]
            }
          }
        ],
        "bodies": [
          {
            "text": "",
            "adlabels": [
              {
                "name": "adlabel1"
              },
              {
                "name": "adlabel2"
              }
            ]
          }
        ],
        "call_to_action_types": [
          "LEARN_MORE"
        ],
        "images": [
          {
            "hash": "9ffd7307eae1f9c6e5250fc8760d285f",
            "adlabels": [
              {
                "name": "adlabel1"
              }
            ]
          },
          {
            "hash": "9ffd7307eae1f9c6e5250fc8760d285f",
            "image_crops": {
              "100x100": [
                [
                  604,
                  0
                ],
                [
                  1659,
                  1055
                ]
              ]
            },
            "adlabels": [
              {
                "name": "adlabel2"
              }
            ]
          }
        ],
        "link_urls": [
          {
            "website_url": "<WEBSITE_URL>",
            "display_url": "<DISPLAY_URL>",
            "deeplink_url": "<DEEPLINK_URL>",
            "adlabels": [
              {
                "name": "adlabel1"
              },
              {
                "name": "adlabel2"
              }
            ]
          }
        ],
        "optimization_type": "PLACEMENT",
        "titles": [
          {
            "text": "",
            "adlabels": [
              {
                "name": "adlabel1"
              },
              {
                "name": "adlabel2"
              }
            ]
          }
        ]
      }' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

アセットフィード仕様で利用可能なオプションの一覧をご覧ください。

ステップ5 (任意): 広告クリエイティブを読み取る

配置アセットカスタマイズ広告の場合、Instagram関連のクリエイティブフィールドは、{ad-account-id}/adsを通じて取得してください。以下に例を示します。

https://graph.facebook.com/v21.0/{ad-account-id}/ads?fields=creative{effective_instagram_story_id,instagram_permalink_url}