マーケティングAPI

動画広告とカルーセル広告

APIを使用すれば、Facebookの動画広告とカルーセル広告を簡単に作成し、成果を測定し、最適化できます。Facebook for Business、カルーセル広告をご覧ください。広告に使用できる動画形式については、広告主様向けヘルプセンター、動画をご覧ください。

動画広告

参考ドキュメント

VIDEO_VIEWSの目的で動画を作成し、リーチのために入札を最適化するには、以下の手順に従ってください。

ステップ1: 広告クリエイティブを提供する

既存の動画IDとFacebookにアップロード済みの動画を使用した動画広告を作成します。

以下が必要になります。

curl \
  -F 'name=Sample Creative' \
  -F 'object_story_spec={ 
  "page_id": "<PAGE_ID>", 
  "video_data": {"image_url":"<THUMBNAIL_URL>","video_id":"<VIDEO_ID>"} 
  }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives
  
Open In Graph API Explorer

スライドショー

新興市場でフィーチャーフォン向けのブランドキャンペーンを拡大する、または開始する場合、あるいはシンプルな動画を作成する場合には画像のスライドショーをお試しください(少なくとも3枚の画像が必要です)。画像は動画アセットにアップロードします。以下はその例です。

curl \
  -F 'slideshow_spec={ 
  "images_urls": [ 
  "<IMAGE_URL_1>", 
  "<IMAGE_URL_2>", 
  "<IMAGE_URL_3>" 
  ], 
  "duration_ms": 2000, 
  "transition_ms": 200 
  }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph-video.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/advideos
 
  Open In Graph API Explorer

動画クリエイティブのベストプラクティスおよびリファレンス: 広告動画をご覧ください。

ステップ2: 広告キャンペーンを作成する

目的をVIDEO_VIEWSに設定します。

curl -X POST \
  -F 'name="Video Views campaign"' \
  -F 'objective="OUTCOME_ENGAGEMENT"' \
  -F 'status="PAUSED"' \
  -F 'special_ad_categories=[]' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/campaigns
  
Open In Graph API Explorer

リファレンス: キャンペーン、PHPのAdObjectives、PythonのAdObjectivesをご覧ください

ステップ3: 広告セットを作成する

再生1回あたりのコストをできるだけ低く抑えることが目的の場合、動画再生キャンペーンの目的と、広告セットのoptimization_goal=THRUPLAYをペアにしてください。bidding_eventをIMPRESSIONSまたはTHRUPLAYに設定することで、インプレッションごと、または動画再生ごとの支払いを実施できます。CPV入札をご覧ください。

curl \
  -F 'name=A CPV Ad Set' \
  -F 'campaign_id=<CAMPAIGN_ID>' \
  -F 'daily_budget=500' \
  -F 'start_time=2024-05-06T04:45:29+0000' \
  -F 'end_time=2024-06-06T04:45:29+0000' \
  -F 'billing_event=THRUPLAY' \
  -F 'optimization_goal=THRUPLAY' \
  -F 'bid_amount=100' \
  -F 'targeting={ 
  "device_platforms": ["mobile"], 
  "geo_locations": {"countries":["US"]}, 
  "publisher_platforms": ["facebook"] 
  }' \
  -F 'status=PAUSED' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adsets


  Open In Graph API Explorer

再生1回あたりのコスト(CPV) は、optimization_goal=THRUPLAYを指定した広告セットのほうが、動画再生用に最適化したリーチ&フリークエンシー購入によるCPVより低くなります。終了日は将来の日付にする必要があります。リファレンス: 広告セットをご覧ください。

ステップ4: 広告を作成する

既存の広告セットと広告クリエイティブを使用します。

curl -X POST \
  -F 'name="My Ad"' \
  -F 'adset_id="<AD_SET_ID>"' \
  -F 'creative={
  "creative_id": "<CREATIVE_ID>"
  }' \
  -F 'status="PAUSED"' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/ads
  
Open In Graph API Explorer

キャンペーンの目的がVIDEO_VIEWSの場合、広告についてトラッキングされるアクションを定義する適切なトラッキング仕様がデフォルトで広告に割り当てられます。以下は、動画の再生数の例です。

{'action.type':'video_view','post':'POST_ID','post.wall':'PAGE_ID'}

広告マネージャ: マイキャンペーンおよびリファレンス: 広告をご覧ください。

ブランドの認知度のアップの例

ブランド認知度アップのための動画広告の作成については、ブランド認知度に関するブログをご覧ください。

リーチ&フリークエンシーの例

参考ドキュメント

さらに多くの人に動画をリーチさせるには、リーチ&フリークエンシーによる動画再生キャンペーンの目的を使用してください。予測を立て、予約し、広告セットに割り当てる必要があります。

動画再生の作成の説明に従いますが、広告セットにはリーチ&フリークエンシーを適用してください。以下のパラメーターを追加で指定します。

-F "rf_prediction_id=<RESERVATION_ID>" \

ダイレクトレスポンス用動画

認知した利用者にアクションを促す方法については、カルーセルフォーマットでの動画クリエイティブをご覧ください。

  • 動画を再生した人にリーチします。認知から親近感、そして検討へと利用者を動かします。リマーケティングをご覧ください。
  • ブランドと製品とのエンゲージメントを確保します。コールトゥアクションを追加し、ウェブサイトの特定のページに誘導します。コールトゥアクションをご覧ください。

リマーケティング

動画広告のリマーケティングを行うことで、広告主はFacebookとInstagramの両方でオーガニック動画またはペイド動画の特定のカスタムオーディエンスをターゲットに設定できます。この機能を使用して、認知している利用者を、親近感や検討などのマーケティングファネルの先の過程へと動かします。調査: 効果的なクリエイティブの組み合わせをご覧ください。

動画のオーディエンスを作成するには、その動画を配信するページへの広告主のアクセス許可が必要です。

オーディエンスについては、subtype=ENGAGEMENTを設定します。次に作成するオーディエンスのルールを書き込みます。各ルールには、動画IDなどのobject_id、およびevent_nameがあります。event_nameは次のいずれか1つになります。

  • video_watched: 動画が延べ3秒以上再生される、またはほぼ全長に渡って再生されるという、いずれかの条件が満たされた回数。
  • video_completed: 動画が全体の長さの95%まで再生された回数(その時点までスキップされた再生回数を含む)。
  • video_view_10s: 動画が延べ10秒以上再生される、またはほぼ全長に渡って再生されるという、いずれかの条件が満たされた回数。
  • video_view_15s: 動画が延べ15秒以上再生される、またはほぼ全長に渡って再生されるという、いずれかの条件が満たされた回数。
  • video_view_25_percent: 動画が全体の長さの25%まで再生された回数(その時点までスキップされた再生回数を含む)。
  • video_view_50_percent: 動画が全体の長さの50%まで再生された回数(その時点までスキップされた再生回数を含む)。
  • video_view_75_percent: 動画が全体の長さの75%まで再生された回数(その時点までスキップされた再生回数を含む)。

動画を組み合わせることで、さまざまな動画とアクションに基づいてオーディエンスを作成できます。例えば、動画Aを3秒再生した視聴者と、動画Bと動画Cを最後まで再生した視聴者をオーディエンスに含めることができます。

これにより、過去14日間に動画1を3秒以上再生した視聴者と、動画2を最後まで再生した視聴者から成るオーディエンスが作成されます。prefill=trueの指定により、オーディエンスの作成前に閲覧者のためにオーディエンスが自動入力されます。

curl \
  -F 'name=Video Ads Engagement Audience' \
  -F 'subtype=ENGAGEMENT' \
  -F 'description=Users who watched my video' \
  -F 'prefill=1' \
  -F 'rule=[ 
  {"object_id":"%video_id_1","event_name":"video_watched"}, 
  {"object_id":"%video_id_2","event_name":"video_completed"} 
  ]' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/customaudiences
  
Open In Graph API Explorer

バックフィルは、2015年10月16日より後の動画再生についてサポートされます。

コールトゥアクション

コールトゥアクション(CTA)を設置した動画は、利用者に詳しい情報を提供したり、ウェブサイトの特定のページに利用者を誘導したりできます。主な目的が動画の再生数アップや認知度向上であり、オフサイトクリックの増加ではない場合のパフォーマンスを向上させます。後者の目的には動画リンク広告を使用しましょう。CTAの表示方法は以下のとおりです。

  • モバイルとデスクトップでは投稿の一部として表示されます。動画が一時停止されると、[再開]オプションの隣に表示されます。
  • モバイルでは、視聴者が動画をクリックしてフルスクリーンで表示させると、CTAは動画のオーバーレイとして画面上に浮いているように表示されます。
  • 外部の動画リンク投稿にCTAは表示されません。

動画にCTAを使用できるのは、以下のキャンペーンの目的を選択した場合のみです。

追加の目的のための動画の拡張をご覧ください。これにより、GET_DIRECTIONSコールトゥアクションを備えた動画広告が作成されます。

curl \
  -F 'object_story_spec={ 
  "page_id": "<PAGE_ID>", 
  "video_data": { 
  "call_to_action": { 
  "type": "GET_DIRECTIONS", 
  "value": { 
  "link": "fbgeo:\/\/37.48327, -122.15033, \"1601 Willow Rd Menlo Park CA\"" 
  } 
  }, 
  "image_url": "<THUMBNAIL_URL>", 
  "link_description": "Come check out our new store in Menlo Park!", 
  "video_id": "<VIDEO_ID>" 
  } 
  }' \
  -F 'access_token=<ACCESS_TOKEN>' \
   https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

Open In Graph API Explorer

動画の指標

動画投稿のインサイト、オーガニック

参考ドキュメント

Facebook上での動画のパフォーマンスを詳しく把握することで、より正しい情報に基づいて動画コンテンツに関する判断を下せます。現在、指標が確認できるのは利用者が動画の視聴を開始した場合のみです。確認できる指標には、動画の再生数、動画のユニーク再生数、動画の平均再生時間、オーディエンスリテンションなどがあります。視聴者がどこで動画の再生を中断したのか、動画のどの部分に最も興味を持ってくれたのか確認しましょう。

動画広告のインサイト、ペイド

広告インサイトAPIを使用します。応答にはさまざまな動画指標が含まれます。

動画タイプ

自動再生動画やクリック再生動画などの動画タイプでグループ分けされた動画広告の統計データを取得します。action_video_typeをaction_breakdownsの中に含めます。action_video_typeに指定可能な値は、total、click_to_play、およびauto_playです。

現在、action_video_typeオプションについての限定されたテストを実行中です。内訳によりクライアントを識別するには、広告アカウントのCAN_USE_VIDEO_METRICS_BREAKDOWNをチェックします。

curl -G \
  -d 'action_breakdowns=action_video_type' \
  -d 'date_preset=last_30_days' \
  -d 'fields=actions,video_avg_pct_watched_actions,video_complete_watched_actions' \
  -d 'access_token= <ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/insights
   
Open In Graph API Explorer

応答には、action_typeがvideo_viewであり、かつaction_video_typeキーを含むオブジェクトが含まれます。

{
  "data": [
    {
      "actions": [
        ...
        {
          "action_type": "video_play", 
          "value": 9898
        }, 
        {
          "action_type": "video_view", 
          "action_video_type": "total", 
          "value": 921129
        }, 
        {
          "action_type": "video_view", 
          "action_video_type": "auto_play", 
          "value": 915971
        }, 
        {
          "action_type": "video_view", 
          "action_video_type": "click_to_play", 
          "value": 5158
        }
      ], 
      "video_avg_pct_watched_actions": [
        {
          "action_type": "video_view", 
          "action_video_type": "total", 
          "value": 60.59
        }, 
        {
          "action_type": "video_view", 
          "action_video_type": "auto_play", 
          "value": 60.47
        }, 
        {
          "action_type": "video_view", 
          "action_video_type": "click_to_play", 
          "value": 80.63
        }
      ], 
      "video_complete_watched_actions": [
        {
          "action_type": "video_view", 
          "action_video_type": "total", 
          "value": 156372
        }, 
        {
          "action_type": "video_view", 
          "action_video_type": "auto_play", 
          "value": 154015
        }, 
        {
          "action_type": "video_view", 
          "action_video_type": "click_to_play", 
          "value": 2357
        }
      ], 
      "date_start": "2014-12-26", 
      "date_stop": "2015-03-25"
    }
  ], 
  "paging": {
    "cursors": {
      "before": "MA==", 
      "after": "MA=="
    }
  }
}

広告インサイトAPIをご覧ください

フィードのスペースをよりクリエイティブにすることで、利用者をウェブサイトやモバイルアプリに誘導し、コンバージョンをアップさせます。カルーセル広告を作成する方法は2つあります。

カルーセル広告は、Facebookストーリーズではサポートされていません。

インラインを作成する

広告クリエイティブを作成すると同時に、カルーセル広告のページ投稿を作成します。object_story_specにページ投稿のコンテンツを指定します。それにより、adcreativesに基づく未公開ページ投稿が作成されます。広告クリエイティブをご覧ください。以下はその例です。

curl \
  -F 'name=Sample Creative' \
  -F 'object_story_spec={ 
    "link_data": { 
      "child_attachments": [ 
        { 
          "description": "$8.99", 
          "image_hash": "<IMAGE_HASH>", 
          "link": "https:\/\/www.link.com\/product1", 
          "name": "Product 1", 
          "video_id": "<VIDEO_ID>" 
        }, 
        { 
          "description": "$9.99", 
          "image_hash": "<IMAGE_HASH>", 
          "link": "https:\/\/www.link.com\/product2", 
          "name": "Product 2", 
          "video_id": "<VIDEO_ID>" 
        }, 
        { 
          "description": "$10.99", 
          "image_hash": "<IMAGE_HASH>", 
          "link": "https:\/\/www.link.com\/product3", 
          "name": "Product 3" 
        } 
      ], 
      "link": "<URL>" 
    }, 
    "page_id": "<PAGE_ID>" 
  }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives
  
Open In Graph API Explorer

応答は、クリエイティブIDです。

{"id":"<CREATIVE_ID>"}

投稿を作成し、次に広告を作成する

未公開ページ投稿を作成します。child_attachmentsは、リンクオブジェクトの配列です。各リンクオブジェクトで、picture、name、およびdescriptionは任意指定です。ページとして投稿できるのは、ページアクセストークンがある場合のみです。

curl -X GET \
  -d 'message="Browse our latest products"' \
  -d 'published=0' \
  -d 'child_attachments=[
       {
         "link": "<APP_STORE_URL>",
         "name": "Product 1",
         "description": "$4.99",
         "image_hash": "<IMAGE_HASH>"
       },
       {
         "link": "<APP_STORE_URL>",
         "name": "Product 2",
         "description": "$4.99",
         "image_hash": "<IMAGE_HASH>"
       },
       {
         "link": "<APP_STORE_URL>",
         "name": "Product 3",
         "description": "$4.99",
         "image_hash": "<IMAGE_HASH>"
       },
       {
         "link": "<APP_STORE_URL>",
         "name": "Product 4",
         "description": "$4.99",
         "image_hash": "<IMAGE_HASH>"
       }
     ]' \
  -d 'caption="WWW.EXAMPLE.COM"' \
  -d 'link="http://www.example.com/products"' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/<PAGE_ID>/posts
  
Open In Graph API Explorer

次に、広告クリエイティブに未公開のページ投稿を指定します。広告クリエイティブのobject_story_idにはidを使用します。

curl -X POST \
  -F 'object_story_id="<PAGE_ID>_<POST_ID>"' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

Open In Graph API Explorer

動画カルーセル広告を作成する

動画カルーセル広告の子添付には「キャプション」があり、終了画面のディスプレイURLをカスタマイズできます。

"child_attachments": [
 {
   "link": "https://www.facebookmarketingdevelopers.com/",
   "name": "Facebook Marketing Developers",
   "description": "Facebook Marketing Developers",
   "call_to_action": {
     "type": "APPLY_NOW",
     "value": {
      "link_title": "Facebook Marketing Developers"
     }
   },
   "video_id": "123",
   "caption": "mycustomlinkcaption.com"
  },
]

子添付の詳細を取得するには、IDを使用し、グラフAPI、動画、リファレンスを呼び出します。

モバイルアプリ広告を作成する

制限

  • カルーセルモバイルアプリ広告がサポートするのは1つのアプリのみです
  • 3点以上の画像が必要です(アプリ以外のカルーセル広告では2点以上)
  • カルーセルモバイルアプリ広告にはコールトゥアクションが必要です。
  • 一般的にページのプロフィール写真が表示されるエンドカードは、カルーセルモバイルアプリ広告では表示されません。各child_attachmentには、同じApp Storeリンクを指定する必要があることに注意してください。call_to_action:{'value':{'link':... }}}で再度リンクを指定する必要はありません

モバイルアプリのインストールのカルーセル広告を作成する場合

\

curl -X POST \
  -F 'name="Carousel app ad"' \
  -F 'object_story_spec={
       "page_id": "<PAGE_ID>",
       "link_data": {
         "message": "My message",
         "link": "http://www.example.com/appstoreurl",
         "caption": "WWW.ITUNES.COM",
         "name": "The link name",
         "description": "The link description",
         "child_attachments": [
           {
             "link": "http://www.example.com/appstoreurl",
             "image_hash": "<IMAGE_HASH>",
             "call_to_action": {
               "type": "USE_MOBILE_APP",
               "value": {
                 "app_link": "<DEEP_LINK>"
               }
             }
           },
           {
             "link": "http://www.example.com/appstoreurl",
             "image_hash": "<IMAGE_HASH>",
             "call_to_action": {
               "type": "USE_MOBILE_APP",
               "value": {
                 "app_link": "<DEEP_LINK>"
               }
             }
           },
           {
             "link": "http://www.example.com/appstoreurl",
             "image_hash": "<IMAGE_HASH>",
             "call_to_action": {
               "type": "USE_MOBILE_APP",
               "value": {
                 "app_link": "<DEEP_LINK>"
               }
             }
           },
           {
             "link": "http://www.example.com/appstoreurl",
             "image_hash": "<IMAGE_HASH>",
             "call_to_action": {
               "type": "USE_MOBILE_APP",
               "value": {
                 "app_link": "<DEEP_LINK>"
               }
             }
           }
         ],
         "multi_share_optimized": true
       }
     }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

投稿は、モバイルアプリに関連付けられているFacebookページとしてのみ公開できます。さらに、ページアクセストークンを使用する必要があります。

curl \
  -F 'message=My description' \
  -F 'link=<APP_STORE_URL>' \
  -F 'caption=WWW.ITUNES.COM' \
  -F 'child_attachments=[ 
    { 
      "link": "<APP_STORE_URL>", 
      "image_hash": "<IMAGE_HASH_I>", 
      "call_to_action": { 
        "type": "USE_MOBILE_APP", 
        "value": {"app_link":"<DEEP_LINK_I>","link_title":"<LINK_TITLE_I>"} 
      } 
    }, 
    { 
      "link": "<APP_STORE_URL>", 
      "image_hash": "<IMAGE_HASH_I>", 
      "call_to_action": { 
        "type": "USE_MOBILE_APP", 
        "value": {"app_link":"<DEEP_LINK_I>","link_title":"<LINK_TITLE_I>"} 
      } 
    }, 
    { 
      "link": "<APP_STORE_URL>", 
      "image_hash": "<IMAGE_HASH_I>", 
      "call_to_action": { 
        "type": "USE_MOBILE_APP", 
        "value": {"app_link":"<DEEP_LINK_I>","link_title":"<LINK_TITLE_I>"} 
      } 
    }, 
    { 
      "link": "<APP_STORE_URL>", 
      "image_hash": "<IMAGE_HASH_I>", 
      "call_to_action": { 
        "type": "USE_MOBILE_APP", 
        "value": {"app_link":"<DEEP_LINK_I>","link_title":"<LINK_TITLE_I>"} 
      } 
    } 
  ]' \
  -F 'multi_share_optimized=1' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/<PAGE_ID>/feed

応答からのidを使用して、AdCreativeを作成します。

curl -X POST \
  -F 'object_story_id="<PAGE_ID>_<POST_ID>"' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

Open In Graph API Explorer

フィールドの仕様

これはiOSに配信されるカルーセル広告です。フィールドの説明と使用方法を示しています。

名前 説明

child_attachments

型: オブジェクト

カルーセル広告に必要な2～10点のリンクオブジェクトの配列です。パフォーマンスを最高にするには、少なくとも3つのオブジェクトを使用する必要があります。2つのオブジェクトは軽量統合を可能にするためであり、2つのオブジェクトを使用することで、最適なキャンペーン結果が得られない可能性があります。

child_attachments.link

型: 文字列

投稿に添付されるリンクURLまたはアプリストアのURLです。必須。

child_attachments.picture

型: URL

リンクに関連付けられた画像のプレビューです。最も効果的に表示できるのは、458x458ピクセル以上のアスペクト比1:1です。pictureまたはimage_hashのいずれかを指定する必要があります。

child_attachments.image_hash

型: 文字列

画像ライブラリからのリンクに関連するプレビュー画像のハッシュ。最も効果的に表示するには、1:1のアスペクト比、458×458ピクセル以上を使用します。pictureまたはimage_hashのいずれかを指定する必要があります。

child_attachments.name

型: 文字列

リンクのプレビューのタイトルです。指定しない場合、リンクされたページのタイトルが使用されます。一般的に35文字以内です(超過分はカットされます)。Facebookのインターフェイスにはnameによって報告されるアクションが表示されるため、固有のnameを設定する必要があります。

child_attachments.description

型: 文字列

価格、割引情報、ウェブサイトのドメインのいずれかです。指定しない場合、リンクされたページのコンテンツが抽出され使用されます。一般的に30文字以内です(超過分はカットされます)。

child_attachments.call_to_action

型: オブジェクト

任意のコールトゥアクションです。コールトゥアクションをご覧ください。call_to_action:{'value':{'link':... }}}で再度リンクを指定する必要はありません

child_attachments.video_id

型: 文字列

広告動画のID。任意の子要素で使用できます。指定する場合、image_hashまたはpictureも設定する必要があります。

message

型: 文字列

投稿の本文です。ステータスメッセージとも呼ばれます。

link

型: 文字列

[もっと見る]へのリンクのURLです。必須。

caption

型: 文字列

[もっと見る]のリンクに表示されるURLです。カルーセルモバイルアプリ広告では利用できません。

multi_share_optimized

型: ブーリアン

trueに設定した場合、画像とリンクは自動的に選択され、並べ替えられます。それ以外では、子要素は元の順序で並べられます。デフォルトはtrueです。

multi_share_end_card

型: ブーリアン

falseに設定した場合、ページアイコンを表示するエンドカードが削除されます。デフォルトはtrueです。

製品ごとの広告の統計データ

actions_breakdown=['action_carousel_card_id', 'action_carousel_card_name']の製品ごとのカルーセル広告のためのグループアクション。child_attachmentごとに異なるカードIDを持ちます。action_carousel_card_idとaction_carousel_card_nameは、カルーセル広告の場合のみ指定します。

カードごとに以下の統計データを取得します。

  • website_ctr: fields=['website_ctr']を指定する場合に使用可能
  • app_install、app_use、apps.uses、credit_spent、mobile_app_install、tab_view、link_click、mobile_app_install、app_custom_event.*、offsite_conversion.*: fields=['actions']を指定する場合に使用可能。その他のアクションは、カードの内訳では取得できません。
curl -G \
  -d 'action_breakdowns=["action_type","action_carousel_card_id"]' \
  -d 'level=ad' \
  -d 'date_preset=last_30_days' \
  -d 'time_increment=all_days' \
  -d 'breakdowns=placement' \
  --data-urlencode 'filtering=[ 
    { 
      "field": "action_type", 
      "operator": "IN", 
      "value": ["link_click"] 
    } 
  ]' \
  -d 'fields=impressions,inline_link_clicks,actions,website_ctr' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/insights
  
Open In Graph API Explorer

応答

{
...
   "website_ctr": [
      {
         "action_carousel_card_id": "1",
         "action_type": "link_click",
         "value": 51.401869158878
      },
      {
         "action_carousel_card_id": "2",
         "action_type": "link_click",
         "value": 50.980392156863
      }
   ],
   "placement": "mobile_feed",
   "date_start": "2015-05-25",
   "date_stop": "2015-05-28"
}

アクションタイプ別の内訳を得るため、cost_per_action_typeをリクエストすることもできます。

curl -G \
  -d 'action_breakdowns=["action_type","action_carousel_card_name"]' \
  -d 'level=ad' \
  -d 'breakdowns=placement' \
  -d 'fields=impressions,campaign_name,cost_per_action_type' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/insights
  
Open In Graph API Explorer

応答の例

{
   "data": [
      {
         "impressions": "1862555",
         "campaign_name": "My Campaign",
         "cost_per_action_type": [
            {
               "action_carousel_card_name": "My Carousel Card 1",
               "action_type": "app_custom_event.fb_mobile_activate_app",
               "value": 0.093347346315861
            },
            {
               "action_carousel_card_name": "My Carousel Card 2",
               "action_type": "app_custom_event.fb_mobile_activate_app",
               "value": 0.38324089579301
            },
            ...
         ],
      }
   ]
}
  • 2015年6月20日より前のaction_report_time=impressionのカルーセル内訳指標は正確ではありません。
  • 2015年7月20日より前のaction_report_time=conversionのカルーセル内訳指標は正確ではありません。

配置

配置としてright_hand_columnのみ選択した場合、広告グループで使用できるのは単一動画またはカルーセルフォーマットのみになります。right_hand_column配置のみを選択した動画フォーマットはサポートされていません。高度なターゲット設定と配置をご覧ください。

例えば、唯一の配置としてright_hand_columnを指定した広告セットを作成する場合は、次のようになります。

curl \
  -F 'name=RHS only Ad Set' \
  -F 'campaign_id=<CAMPAIGN_ID>' \
  -F 'daily_budget=500' \
  -F 'start_time=2017-11-21T15:41:36+0000' \
  -F 'end_time=2017-11-28T15:41:36+0000' \
  -F 'billing_event=IMPRESSIONS' \
  -F 'optimization_goal=LINK_CLICKS' \
  -F 'bid_amount=100' \
  -F 'targeting={ 
    "device_platforms": ["mobile"], 
    "geo_locations": {"countries":["US"]}, 
    "publisher_platforms": ["facebook"] ,
    "facebook_positions": ["right_hand_column"] ,  
  }' \
  -F 'status=PAUSED' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adsets
  
Open In Graph API Explorer

広告クリエイティブに動画を指定します。

curl \
  -F 'name=Sample Creative' \
  -F 'object_story_spec={ 
    "page_id": "<PAGE_ID>", 
    "video_data": {"image_url":"<THUMBNAIL_URL>","video_id":"<VIDEO_ID>"} 
  }' \
  -F 'access_token=ACCESS_TOKEN' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives
  
Open In Graph API Explorer

あるいは、広告クリエイティブにキャンバス広告フォーマットを指定します。

curl \
  -F 'image_hash=<IMAGE_HASH>' \
  -F 'object_story_spec={ 
    "link_data": { 
      "call_to_action": {"type":"LEARN_MORE"}, 
      "image_hash": "<IMAGE_HASH>", 
      "link": "CANVAS_LINK", 
      "name": "Creative message" 
    }, 
    "page_id": "<PAGE_ID>" 
  }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives
  
Open In Graph API Explorer

広告セットと広告クリエイティブを使用して広告を作成する場合

curl \
  -F 'name=My Ad' \
  -F 'adset_id=<AD_SET_ID>' \
  -F 'creative={"creative_id":"<CREATIVE_ID>"}' \
  -F 'status=ACTIVE' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/ads
  
Open In Graph API Explorer

エラーコードが表示される場合は、サポートされているクリエイティブを指定するか、ターゲット設定を変更する必要があります。

参考情報