マーケティングAPI

広告クリエイティブ

Facebook広告で、既存の顧客に情報を発信し、新たな顧客にリーチしましょう。それぞれのガイドでは、広告の目的を達成するために役立つFacebook広告製品について説明します。広告ユニットにはいくつかの種類があり、さまざまなデザイン、配置、クリエイティブのオプションがあります。クリエイティブコンテンツに広告ユニットを使用する際のガイドラインについては、Facebook広告ガイドをご覧ください。

クリエイティブ

広告クリエイティブとは、広告そのものを視覚的にレンダリングするためのすべてのデータを含んだオブジェクトです。APIでは、こちらのリストに記載されているさまざまな種類の広告をFacebook上に作成できます。

ページ投稿のエンゲージメントを目的に設定したキャンペーンがある場合、その���ージが作成した投稿を宣伝する広告を作成できるようになりました。これはページ投稿広告とみなされます。ページ投稿広告には、object_story_idフィールドが必要です。このフィールドは、ページ投稿のidプロパティです。詳しくは、広告クリエイティブ、リファレンスをご覧ください。

広告クリエイティブは、次の3つの要素で構成されます。

  • 広告クリエイティブ自体: 広告クリエイティブオブジェクトのビジュアルに関する属性で定義されます
  • 配置: 広告の掲載場所です
  • プレビュー: 配置ごとの広告ユニットのプレビューです

広告クリエイティブオブジェクトを作成するには、以下の呼び出しを実行します。

curl -X POST \
  -F 'name="Sample Promoted Post"' \
  -F 'object_story_id="<PAGE_ID>_<POST_ID>"' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v20.0/act_<AD_ACCOUNT_ID>/adcreatives
  
Open In Graph API Explorer

API呼び出しには、クリエイティブオブジェクトのidが返されます。これは広告オブジェクトで必要になるので保存しておきます。

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/v20.0/act_<AD_ACCOUNT_ID>/ads
  
Open In Graph API Explorer

制限

クリエイティブのテキスト、画像サイズ、画像アスペクト比などには制約があります。詳しくは、「広告ガイド」をご覧ください。

読み取り

広告APIでは、id以外のフィールドを読み取るにはフィールド名を明示的に指定する必要があります。各オブジェクトのリファレンスには、オブジェクトの読み取りに関するセクションと、読み取り可能なフィールドのリストが掲載されています。クリエイティブの場合、オブジェクトの作成時に指定したものと同じフィールド、およびidになります。

curl -G \
  -d 'fields=name,object_story_id' \
  -d 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v20.0/<CREATIVE_ID>Open In Graph API Explorer

配置

配置とは、その広告をFacebook上のどこに掲載するかということです(デスクトップのフィード、モバイルデバイスのフィード、右側広告枠など)。広告プロダクトガイドをご覧ください。

使用可能なすべての配置を使って広告を実行することを推奨します。Facebookの広告の入札は、最も少ないコストで最も大きなキャンペーンの成果が得られる可能性が高い配置に広告インプレッションを配信することを目的としています。

この最適化を活用する最も簡単な方法は、このフィールドを空白のままにすることです。広告セットのtarget_specで具体的な配置を選択することもできます。

この例では、ページ投稿広告を使用しています。使用できる配置は、Facebookのモバイルフィード、デスクトップフィード、右側広告枠です。APIの配置オプションをご覧ください。page_typeにdesktopfeedとrightcolumnを選択すると、デスクトップフィード配置かつ右側広告枠配置で広告が掲載されます。この広告セットの下に作成される広告には、デスクトップ配置のみを使用できます。

curl -X POST \
  -F 'name=Desktop Ad Set' \
  -F 'campaign_id=<CAMPAIGN_ID>' \
  -F 'daily_budget=10000' \
  -F 'targeting={ 
    "geo_locations": {"countries":["US"]}, 
    "publisher_platforms": ["facebook","audience_network"] 
  }' \
  -F 'optimization_goal=LINK_CLICKS' \
  -F 'billing_event=IMPRESSIONS' \
  -F 'bid_amount=1000' \
  -F 'status=PAUSED' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v20.0/act_<AD_ACCOUNT_ID>/adsets
  

Open In Graph API Explorer

広告をプレビューする

広告をプレビューする場合は、広告プレビューAPIまたは広告プレビュープラグインのいずれかを使用します。

APIでは、次の3つの方法でプレビューを生成できます。

  1. 広告ID
  2. 広告クリエイティブID
  3. クリエイティブスペックを指定

プレビューAPIのリファレンスドキュメントによると、最低限必要なAPI呼び出しの形式は次のとおりです。

curl -G \
  --data-urlencode 'creative="<CREATIVE_SPEC>"' \
  -d 'ad_format="<AD_FORMAT>"' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v20.0/act_<AD_ACCOUNT_ID>/generatepreviews
  
Open In Graph API Explorer

クリエイティブスペックは、広告クリエイティブの作成に必要な各フィールドと値から構成される配列です。

現在、広告クリエイティブの呼び出しは次のようになっています。

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

Open In Graph API Explorer

次のようにobject_story_idを取得し、プレビューAPI呼び出しで使用します。

curl -G \
  -d 'creative={"object_story_id":"<PAGE_ID>_<POST_ID>"}' \
  -d 'ad_format=<AD_FORMAT>' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v20.0/act_<AD_ACCOUNT_ID>/generatepreviews


Open In Graph API Explorer

ad_formatに使用できる値は、page_typesとはわずかに異なります。このシナリオでは、デスクトップフィードおよびFacebookの右側広告枠が選択されています。配置ごとにプレビューを作成するため、この場合、2回のAPI呼び出しが必要になります。


curl -G \
  -d 'creative={"object_story_id":"<PAGE_ID>_<POST_ID>"}' \
  -d 'ad_format=DESKTOP_FEED_STANDARD' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v20.0/act_<AD_ACCOUNT_ID>/generatepreviews
  
Open In Graph API Explorer
curl -G \
  -d 'creative={"object_story_id":"<PAGE_ID>_<POST_ID>"}' \
  -d 'ad_format=RIGHT_COLUMN_STANDARD' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v20.0/act_<AD_ACCOUNT_ID>/generatepreviews

Open In Graph API Explorer

レスポンスの内容は、24時間有効なiFrameです。

もっと見る