配置のターゲット設定

デスクトップフィードのみ、またはモバイルフィードとAudience Network動画リワードなど、特定の配置に広告を配信します。指定したキャンペーンの目的に応じて使用できる配置オプションは異なります。詳しくは、キャンペーン、目的、配置をご覧ください。

使用可能なプラットフォームと位置は、device_platforms、publisher_platforms、facebook_positions、audience_network_positions、instagram_positions、およびmessenger_positionsです。詳しくは、デバイス、パブリッシャー、位置のセクションをご覧ください。

curl -X POST \
  -F 'name="My AdSet"' \
  -F 'optimization_goal="REACH"' \
  -F 'billing_event="IMPRESSIONS"' \
  -F 'bid_amount=2' \
  -F 'daily_budget=1000' \
  -F 'campaign_id="<AD_CAMPAIGN_ID>"' \
  -F 'targeting={
       "geo_locations": {
         "countries": [
           "US"
         ]
       },
       "publisher_platforms": [
         "facebook"
       ],
       "facebook_positions": [
         "feed"
       ]
     }' \
  -F 'promoted_object={
       "page_id": "<PAGE_ID>"
     }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/adsets

特定の配置フィールドに何も指定しない場合、そのフィールドに対して可能なすべてのデフォルト位置が指定されたものと見なされます。例えば、publisher_platformsをfacebookに設定し、facebook_positionsには何も選択しない場合、feedやright_hand_columnなどのFacebookのすべてのデフォルト位置が指定されたものと見なされます。また、publisher_platformsを何も選択しない場合、すべてのデフォルトのpublisher_platformsが指定されたものと見なされます。さらに、新しい位置やプラットフォームが利用可能になると、それらも自動的に指定されたものと見なされます。

Audience Networkでは、広告を表示するパブリッシャーを制限することができます。カテゴリ別にパブリッシャーを除外するか、または除外するアプリストアURLやドメインURLのカスタムリストを作成します。

動画、コレクション、キャンバスの広告の配置に、right_hand_columnのみを使用することはできません。

FacebookインストリームとAudience Networkの各種コンテンツの横に広告を表示するかどうかを制御するには、インベントリーフィルターが便利です。これらのコンテンツカテゴリについて詳しくは、広告ヘルプセンター、インベントリーフィルターをご覧ください。Facebookインストリームの値を1つ、Audience Networkの値を1つ選ぶことができます。オプションには、Full、Standard、Limitedが含まれます。詳しくは、下記のbrand_safety_content_filter_levelsをご覧ください。

例えば、brand_safety_content_filter_levelsを使用する場合、次のようにします。

curl \
  -F 'name=My AdSet' \
  -F 'optimization_goal=REACH' \
  -F 'billing_event=IMPRESSIONS' \
  -F 'bid_amount=2' \
  -F 'daily_budget=1000' \
  -F 'campaign_id=CAMPAIGN_ID' \
  -F 'targeting= { "geo_locations":{"countries":["US"]}, "brand_safety_content_filter_levels":["FACEBOOK_STRICT","AN_STANDARD"]}' \
  -F 'status=ACTIVE' \
  -F 'access_token=ACCESS_TOKEN' \
  https://graph.facebook.com/VERSION/AD_ACCOUNT_ID/adsets

Audience Networkおよびインストリーム動画の場合は、カテゴリ別にパブリッシャーを除外することもできます。

デバイス、パブリッシャー、位置

論理演算子

• 同じパラメーター内の複数オプションは、論理演算子ORで結合されます。
  例えば、publisher_platforms=['facebook','instagram']は、広告をFacebookとInstagramに配信することを意味します。
• 複数パラメーター間の論理演算子はANDです。
  例えば、publisher_platforms=['facebook']&device_platforms=['mobile']は、Facebookのモバイルにのみ広告を配信することを意味します。
• publisher_platforms=['instagram']& device_platforms=['desktop']の場合のように、論理演算の結果としてターゲットがなくなる場合、エラーが表示されます。

制限

• Audience Networkを単独で使用することはできません。したがって、publisher_platforms: audience_networkを単独で選択することはできません。
• VIDEO_VIEWSを目的とするaudience_network配置は、最適化の目的をTHRUPLAYSとして使用する必要があります。
• facebook_positionsに対してstoryを単独で選択することはできません。facebook_positionsにstoryを選択する場合は、FacebookのfeedかInstagramのstoryも選択する必要があります。
• messenger_positionsに対してstoryを単独で選択することはできません。messenger_positionsにstoryを選択する場合は、FacebookのfeedかInstagramのstoryのいずれかを選択する必要があります。
• Instagramウェブフィード広告では、streamの配置を使用します。デスクトップとモバイルウェブフィードの両方に配信できるかどうかがチェックされます。対応している目的は、BRAND_AWARENESS、REACH、LINK_CLICKS、POST_ENGAGEMENT、VIDEO_VIEWS、CONVERSIONSです。

例

ストーリーズ

配置としてFacebookストーリーズを使用するには、次のようにします。

curl \
  -F 'name=My Ad Set' 
  -F 'optimization_goal=CONVERSIONS' 
  -F 'billing_event=IMPRESSIONS' 
  -F 'bid_amount=2' 
  -F 'daily_budget=1000' 
  -F 'campaign_id=<AD_CAMPAIGN_ID>' 
  -F 'targeting={"geo_locations":{"countries":["US"]}, "publisher_platforms":["messenger", "facebook"], "facebook_positions":["story"], "messenger_positions":["story"]}' 
  -F 'status=ACTIVE'
  -F 'access_token=<ACCESS_TOKEN>' 
  https://graph.facebook.com/API_VERSION/act_AD_ACCOUNT_ID/adsets

インストリーム動画

配置がinstream_videoのみで、上記のリストにあるサポート対象の国をターゲットとする広告セットを作成するには、次のようにします。

curl \
  -F 'name=My AdSet' \
  -F 'optimization_goal=REACH' \
  -F 'billing_event=IMPRESSIONS' \
  -F 'bid_amount=2' \
  -F 'daily_budget=1000' \
  -F 'campaign_id=CAMPAIGN_ID' \
  -F 'targeting={"geo_locations":{"countries":["US"]},"publisher_platforms":["facebook"], "facebook_positions":["instream_video"]}' \
  -F 'status=ACTIVE' \
  -F 'access_token=ACCESS_TOKEN' \
  https://graph.facebook.com/API_VERSION/act_AD_ACCOUNT_ID/adsets

Audience Network

Audience Network動画リワードの配置のターゲットを設定するには、次のようにします。

curl \
  -F 'name=My Ad Set' \
  -F 'optimization_goal=OFFSITE_CONVERSIONS' \
  -F 'billing_event=IMPRESSIONS' \
  -F 'is_autobid=true' \
  -F 'daily_budget=40000' \
  -F 'campaign_id=<AD_CAMPAIGN_ID>' \
  -F 'targeting={"app_install_state": "not_installed","geo_locations":{"countries":["US"]},"facebook_positions":["feed"],"device_platforms": ["mobile"],"audience_network_positions": ["classic","rewarded_video"],"user_device": ["Android_Smartphone","Android_Tablet"],"user_os": ["Android_ver_4.4_and_above"]}' \
  -F 'promoted_object={"application_id": "<APPLICATION_ID>","custom_event_type": "PURCHASE","object_store_url": "<OBJECT_STORE_URL>"}' \
  -F 'status=ACTIVE' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/<APIVERSION>/<AD_ACCOUNT_ID>/adsets

これにより、以下が返されます。

{
  "targeting": {
    "audience_network_positions": [
      "classic",
      "rewarded_video"
    ],
    "effective_audience_network_positions": [
      "classic",
      "rewarded_video"
    ]
  },
  "id": "<AD_SET_ID>"
}

リール

配置としてFacebookリールを使用するには、次のようにします。

curl \
  -F 'name=My AdSet' \
  -F 'optimization_goal=REACH' \
  -F 'billing_event=IMPRESSIONS' \
  -F 'bid_amount=2' \
  -F 'daily_budget=1000' \
  -F 'campaign_id=CAMPAIGN_ID' \
  -F 'targeting={"geo_locations":{"countries":["US"]},"publisher_platforms":["facebook"], "facebook_positions":["facebook_reels"]}' \
  -F 'status=ACTIVE' \
  -F 'access_token=ACCESS_TOKEN' \
  https://graph.facebook.com/API_VERSION/act_AD_ACCOUNT_ID/adsets

Instagram発見ホーム

サポートされている国(例: "US")をターゲットに設定して、explore_home配置に表示される広告セットを作成するには、次のようにします。

curl -X POST \
  -F 'name="My AdSet"' \
  -F 'optimization_goal="LINK_CLICKS"' \
  -F 'billing_event="IMPRESSIONS"' \
  -F 'bid_amount=2' \
  -F 'daily_budget=1000' \
  -F 'campaign_id="<AD_CAMPAIGN_ID>"' \
  -F 'targeting={
       "geo_locations": {
         "countries": [
           "US"
         ]
       },
       "publisher_platforms": [
         "instagram"
       ],
       "instagram_positions": [
         "stream",
         "explore",
         "explore_home"
       ],
     }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/adsets

Instagramの検索結果

サポートされている国(例: "US")をターゲットに設定して、ig_search配置に表示される広告セットを作成するには、次のようにします。

curl -X POST \
  -F 'name="My AdSet"' \
  -F 'optimization_goal="LINK_CLICKS"' \
  -F 'billing_event="IMPRESSIONS"' \
  -F 'bid_amount=2' \
  -F 'daily_budget=1000' \
  -F 'campaign_id="<AD_CAMPAIGN_ID>"' \
  -F 'targeting={
       "geo_locations": {
         "countries": [
           "US"
         ]
       },
       "publisher_platforms": [
         "instagram"
       ],
       "instagram_positions": [
         "stream",
         "ig_search"
       ],
     }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/adsets

ターゲット設定に有効な配置

ターゲット設定の仕様で配置を決めて広告セットを作成しても、指定した配置にFacebookがあなたの広告を実際に配信したかどうかは、常に分かるわけではありません。というのは、選択した配置が、選択した広告の目的に適用されない場合があるからです。ターゲット設定に有効な配置API使用して、特定のターゲット設定オプションに関して広告の配信先がどの配置になるのかを確認したり、検証メッセージによって一部の配置がフィルターにより除外された理由を確認したりすることができます。ターゲット設定を指定しなくても、広告セットと広告キャンペーンの設定を基に、効果的な配置を見極めることができます。

ターゲット設定に応じた効果的な配置を読み取るには、配置フィールド名の前にeffective_を置いてください。例:

curl -G \
  -d "fields=targeting{effective_publisher_platforms,effective_facebook_positions,effective_device_platforms,effective_audience_network_positions,effective_instagram_positions}" \
  -d "access_token=<access_token>" \
  https://graph.facebook.com/<VERSION>/<AD_SET_ID>

一部の配置がフィルターで除外された理由を調べるには、recommendationフィールドを使用します。

curl -G \
  -d "fields=recommendations" \
  -d "access_token=<access_token>" \
  https://graph.facebook.com/<VERSION>/23842573364570019

効果的な配置により、広告セットのbilling_event、optimization_goal、promoted_objectに加え、広告キャンペーンのbuying_typeとobjectiveに基づいて、広告がどの配置に配信されるかが分かります。/ad_campaign_placementのすべてのパラメーターを以下に示します。

• 広告account_idとアクセストークン
• billing_event(IMPRESSIONSなど)
• 購入タイプ(AUCTIONなど)
• 目的(POST_ENGAGEMENTなど)
• 最適化の目的(任意。POST_ENGAGEMENTなど)
• 宣伝対象のオブジェクト(PIXEL_IDなど)

promoted_objectとoptimization_goalを除くすべてのパラメーターが必須です。ターゲット設定を指定する場合であっても、マーケティングAPIを使用して、自分の設定で許可されている配置に基づいて効果的な配置を判断できます。ターゲット設定で効果的な配置をご覧ください。例:

curl -G \
-d 'account_id=<ACCOUNT_ID>' \
-d 'billing_event=IMPRESSIONS' \
-d 'buying_type=AUCTION' \
-d 'objective=PAGE_LIKES' \
-d 'optimization_goal=IMPRESSIONS' \
https://graph.facebook.com/<VERSION>/ad_campaign_placement?access_token=<TOKEN>

この呼び出しは次の結果を返します。

{
   "effective_device_platforms": [
      "mobile",
      "desktop"
   ],
   "effective_facebook_positions": [
      "feed",
      "right_hand_column"
   ],
   "effective_publisher_platforms": [
      "facebook"
   ],
   "recommendations": [
      {
         "title": "Placement Not Supported By Objective",
         "message": "Ads with PAGE_LIKES objective do not support facebook.instream_video, facebook.suggested_video, facebook.marketplace, audience_network.classic, audience_network.instream_video, audience_network.rewarded_video, instagram.stream, instagram.story, messenger.messenger_home.",
         "code": 1815609,
         "importance": "LOW",
         "confidence": "HIGH",
         "blame_field": "targeting"
      },
      {
         "title": "Device Platform Not Supported By Objective",
         "message": "Ads with PAGE_LIKES objective do not support connected_tv.",
         "code": 1815610,
         "importance": "LOW",
         "confidence": "HIGH",
         "blame_field": "targeting"
      }
   ],     
   }
}

この結果で得たcodeフィールドを/ad-recommendationへの呼び出しで使用して、詳細な理由を確認することができます。例えば、次のような情報を取得できます。

[{“code”: 1815610, “summary”: “Device Platform Not Supported By Objective”},]

詳しくは、広告の推奨事項、リファレンス、およびターゲット設定で効果的な配置をご覧ください。