マーケティングAPI

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

このソリューションを使って、どのクリエイティブアセットを広告に表示するか定義します。広告の作成時に、アセットカスタムルールに基づいて、表示するアセットの組合せを選択できます。クリエイティブアセットの例としては、画像、動画、テキスト、広告の本文があります。

アセットカスタマイズルールを使うAPIが3つ提供されています。

  • 配置アセットカスタマイズ: さまざまなる広告配置で表示されるクリエイティブアセットをカスタマイズします。
  • 複数言語広告: 異なる言語を話す利用者にリーチするため、広告の画像、動画、テキスト、本文など、広告クリエイティブのさまざまなパーツをカスタマイズします。
  • セグメントアセットカスタマイズ: ターゲット設定のタイプに従って広告アセットをカスタマイズします。

asset_feed_specを使うすべての広告には、少なくとも2つのターゲットカスタマイズルールが含まれていることが必要です。クリエイティブでasset_feed_specを使っており、かつ、含まれているルールが2つに満たない場合、その広告を作成することはできません。

利用を開始する

ステップ1: キャンペーンと広告セットを作成する

アセットカスタムルールのための標準広告キャンペーンを作成することができます。ただし、いくつか制限があります。

API サポートされるキャンペーンの目的

セグメントアセットカスタマイズ

APP_INSTALLS、BRAND_AWARENESS、CONVERSIONS、LINK_CLICKS、REACH、VIDEO_VIEWS。

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

APP_INSTALLS、BRAND_AWARENESS、CONVERSIONS、LEAD_GENERATION、LINK_CLICKS、REACH、VIDEO_VIEWS。

複数言語の広告

APP_INSTALLS、BRAND_AWARENESS、CONVERSIONS、LINK_CLICKS、REACH、VIDEO_VIEWS。

広告セットの場合、標準広告セットエンドポイントを使い、is_dynamic_creativeをfalseに設定します。

optimization_goalがconversionsに設定されているキャンペーンの中の広告セットを作成するには、次のようにします。

curl \
  -F 'status=PAUSED'
  -F 'name=Sample Ad Set'
  -F 'campaign_id=<CAMPAIGN_ID>'
  -F 'optimization_goal=OFFSITE_CONVERSIONS'
  -F 'is_dynamic_creative=false'
  -F 'lifetime_budget=1000'
  -F 'promoted_object={"pixel_id": "<PIXEL_ID>", "custom_event_type": "PURCHASE"}'
  -F 'billing_event=IMPRESSIONS'
  -F 'bid_strategy=LOWEST_COST_WITHOUT_CAP'
  -F 'targeting={"geo_locations": {"countries": ["US"]}}'
  -F 'start_time=2019-04-02'
  -F 'end_time=2019-04-09'
  -F access_token=<ACCESS_TOKEN>
  https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/adsets

asset_feed_specをAPP_INSTALLS用に最適化された広告セットと一緒に使う場合、link_url (http://www.abc.comなど)を指定する必要があります。link_urlは、promoted_objectのobject_store_urlと同じものにしてください。asset_feed_specに指定できるlink_urlパラメーターは1つだけです。

asset_feed_specは、ダイナミッククリエイティブ、配置アセットカスタマイズ、複数言語の広告、セグメントアセットカスタマイズのためのクリエイティブを提供します。仕様のフォーマットは、ソリューションごとに違います。

ステップ2: 広告クリエイティブを用意する

asset_feed_specを通じてクリエイティブを用意します。アセットフィードとは、画像、タイトル、本文などの広告素材エレメントのコレクションです。アセットタイプごとに複数のクリエイティブアセットを指定できます。

/adcreativeでasset_feed_specを作成します。カスタマイズオプションを適用するには、asset_feed_spec内にasset_customization_rulesを設定します。

設定後、asset_feed_specを確認します。

curl -G 
-d "access_token=<ACCESS_TOKEN>"
-d "fields=asset_feed_spec" 
https://graph.facebook.com/<API_VERSION>/<AD_CREATIVE_ID>

広告を作成する際、クリエイティブIDへの参照を提供します。1つの広告セットに複数の広告を作成できます。

curl 
  -F 'name=Asset Custom Rule Ad' 
  -F 'adset_id=<ADSET_ID>' 
  -F 'access_token=<ACCESS_TOKEN>' 
  -F 'creative={
      "creative_id": <CREATIVE_ID>,
   }' 
https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/ads

作成後、