マーケティングAPI
日本語に戻す
このドキュメントが更新されました。
日本語への翻訳がまだ完了していません。
英語の最終更新: 2021/05/06

トラッキング設定とコンバージョン設定

トラッキング設定により、広告に対する利用者のアクションを記録できます。この機能は、アクションに合わせて広告配信を最適化するものではなく、発生したアクションに基づいて広告アカウントに課金することもありません。

マーケティングAPI v2.3以前では、コンバージョン設定が最適化CPMの広告設定です。特定のアクションに合わせて広告配信を最適化し、コンバージョンレポートでそれらのアクションを表示します。v2.4以降では、conversion_specsは読み取り専用です。広告セットにoptimization_goalを使用して広告配信の最適化を選択します。

トラッキング設定の指定

任意の入札タイプとクリエイティブで使用します。トラッキング設定を指定するには、広告にtracking_specsという名前の追加フィールドが必要です。tracking_specsフィールドは、アクション設定と同じ引数を取ります。広告の作成については、広告の作成をご覧ください。

デフォルトのトラッキング設定

次の広告の目的では、デフォルトのトラッキング設定が適用されます。デフォルトの設定に変更すると、既存の設定を上書きするのではなく、既存の設定の末尾に追加されます。

目的がNONEまたはApp Install/Engagement Adsである場合は、デフォルトのトラッキング設定が上書きされます。デフォルトの設定を適用する場合は、それをカスタム設定に追加する必要があります。

'APPLICATION_ID'や['APPLICATION_ID']などの設定では、文字列表記と配列表記の両方を使用できます。

  • CPMは、billing_event=IMPRESSIONS、optimization_goal=IMPRESSIONSを参照します
  • CPCは、billing_event=CLICKS、optimization_goal=CLICKSを参照します
  • oCPMはbilling_event=IMPRESSIONSを参照し、optimization_goalはアクションに設定されます
  • CPAは、billing_eventと、アクションに設定されたoptimization_goalの両方を参照します
目的 クリエイティブ、入札タイプ トラッキング設定 説明

CANVAS_APP_
ENGAGEMENT

optimization_goal= APP_INSTALLSが設定されたキャンバスアプリエンゲージメント広告

[{'action.type':
'app_engagement',
'application':
'APPLICATION_ID'}, {'action.type':
'post_engagement',
'post':'POST_ID', 'page':'PAGE_ID'}]

app_engagementおよびpost_engagementのメタ設定を参照

CANVAS_APP_
INSTALLS

最適化がoptimization_goal= APP_INSTALLSに設定されていないキャンバスアプリインストール広告

[{'action.type':
'app_engagement',
'application':
'APPLICATION_ID'}, {'action.type':
'post_engagement',
'post':'POST_ID', 'page':'PAGE_ID'}]

app_engagementおよびpost_engagementのメタ設定を参照

CONVERSIONS

promoted_objectがピクセルIDに設定され、optimization_goal= OFFSITE_CONVERSIONSが設定されたページ投稿リンク広告および写真広告

{'action.type':
'post_engagement',
'post':'POST_ID', 'page':'PAGE_ID'},
{'action.type':'like',
'page':PAGE_ID}

投稿のエンゲージメント、ページへの「いいね！」の設定。リンクが1つしかない場合の特定のページ投稿のリンククリック数、投稿のエンゲージメント数、およびユーザーによるストーリーズの生成またはページへのエンゲージメントの回数

CONVERSIONS

最適化がoptimization_goal= OFFSITE_CONVERSIONSに設定されていないページ投稿リンク広告および写真広告

{'action.type':
'offsite_conversion',
'fb_pixel':
'FACEBOOK_PIXEL_ID'}, {'action.type':{'action.type':
'post_engagement',
'post':'POST_ID', 'page':'PAGE_ID'},
{'action.type':'like',
'page':PAGE_ID}

コンバージョン、投稿のエンゲージメント、ページへの「いいね！」の設定。リンクが1つしかない場合の特定のページ投稿のリンククリック数、投稿のエンゲージメント数、およびユーザーによるストーリーズの生成またはページへのエンゲージメントの回数

CONVERSIONS

promoted_objectがピクセルIDに設定され、optimization_goal= OFFSITE_CONVERSIONSが設定されたドメイン広告

{'action.type':
'link_click',
'object':'URL'}, {'action.type':'like',
'page':PAGE_ID}

ページへの「いいね！」、リンククリックの設定。リンクが1つしかない場合の特定のページ投稿のリンククリック数、投稿のエンゲージメント数、およびユーザーによるストーリーズの生成またはページへのエンゲージメントの回数。

CONVERSIONS

最適化がoptimization_goal= OFFSITE_CONVERSIONSに設定されていないドメイン広告

{'action.type':
'offsite_conversion',
'fb_pixel':
'FACEBOOK_PIXEL_ID'}, {'action.type':
'link_click',
'object':'URL'}, {'action.type':'like',
'page':PAGE_ID}

コンバージョン、ページへの「いいね！」、リンククリックの設定。リンクが1つしかない場合の特定のページ投稿のリンククリック数、投稿のエンゲージメント数、およびユーザーによるストーリーズの生成またはページへのエンゲージメントの回数。

EVENT_RESPONSES

最適化がoptimization_goal= EVENT_RESPONSESに設定されていないイベント広告

[{'action.type':'rsvp' ,
'response':'yes', 'event':'EVENT_ID'},
{'action.type':'rsvp' ,
'response':'maybe', 'event':'EVENT_ID'},
[{'action.type':'rsvp' ,
'response':'no', 'event':'EVENT_ID'}]

イベントの出欠回答(出席、出席予定、欠席)の数。

EVENT_RESPONSES

optimization_goal= EVENT_RESPONSESが設定されたイベント広告

空白(コンバージョン設定がトラッキング対象のアクションをカバーします)

イベントの出欠回答(出席、出席予定、欠席)の数。

LINK_CLICKS

任意の入札オプションが設定されたページ投稿リンク広告と写真広告

{'action.type':
'post_engagement',
'post':'POST_ID', 'page':'PAGE_ID'}

投稿のエンゲージメント。
外部サイトのURLリンク、特定のURLドメインへのリンク、ページ上の外部サイトリンク、投稿上の外部サイトリンクがクリックされた回数。

LINK_CLICKS

optimization_goal= LINK_CLICKSが設定されたドメイン広告

{'action.type':'like',
'page':PAGE_ID}]

ページへの「いいね！」。
外部サイトのURLリンク、特定のURLドメインへのリンク、ページ上の外部サイトリンク、投稿上の外部サイトリンクがクリックされた回数。

LINK_CLICKS

最適化がoptimization_goal= LINK_CLICKSに設定されていないドメイン広告

{'action.type':
'link_click',
'object':'URL'}, {'action.type':'like',
'page':PAGE_ID}

ウェブサイトクリック、ページへの「いいね！」。
外部サイトのURLリンク、特定のURLドメインへのリンク、ページ上の外部サイトリンク、投稿上の外部サイトリンクがクリックされた回数。

MOBILE_APP_
ENGAGEMENT

任意の入札オプションが設定されたモバイルアプリのエンゲージメント広告

{'action.type':
'post_engagement',
'post':'POST_ID', 'page':'PAGE_ID'}
アプリエンゲージメント広告の場合は、FacebookアプリIDを使用してトラッキング設定を明示的に指定する必要があります:
[{'action.type': 'mobile_app_install', 'application': 'APP_ID'}, {'action.type':
'app_custom_event',
'application':APP_ID}]

post_engagementのメタ設定を参照。アプリイベントが発生した回数も含む。

MOBILE_APP_
INSTALLS

任意の入札オプションが設定されたモバイルアプリインストール広告

{'action.type':
'post_engagement',
'post':'POST_ID', 'page':'PAGE_ID'}
アプリインストール広告の場合は、FacebookアプリIDを使用してトラッキング設定を明示的に指定する必要があります:
[{'action.type':
'app_custom_event',
'application':APP_ID}, {'action.type': 'mobile_app_install', 'application': 'APP_ID'}]

post_engagementのメタ設定を参照。また、iOS/Androidバージョンが存在する場合にユーザーがモバイルアプリインストール広告を介してアプリをインストールした回数と、アプリイベントが発生した回数も含む。

NONE

任意の広告タイプ

デフォルトのトラッキング設定
(広告タイプ別)を参照

PAGE_LIKES

任意の入札オプションが設定されたページへの「いいね！」広告またはページ投稿広告

{'action.type':
'page_engagement', 'page':'PAGE_ID'}

ページエンゲージメントのメタ設定を参照

POST_ENGAGEMENT

最適化がoptimization_goal= POST_ENGAGEMENTに設定されていないページ投稿広告

{'action.type':
'post_engagement',
'post':'POST_ID', 'page':'PAGE_ID'}

ページ投稿のエンゲージメントのメタ設定を参照

POST_ENGAGEMENT

optimization_goal= POST_ENGAGEMENTが設定されたページ投稿広告

空白

ページ投稿のエンゲージメントのメタ設定を参照

POST_ENGAGEMENT (テスト)

任意

{'action.type':
'dwell',
'post':'POST_ID', 'page':'PAGE_ID'}

このタイプの広告のごく一部では、広告に1分以上費やしている利用者に焦点を当てたdwellトラッキングタイプが設定されます。

PRODUCT_ CATALOG_SALES

製品のダイナミック広告

{'action.type': 'post_engagement', 'page': PAGE_ID, 'post': POST_ID}

リンクが1つしかない場合の特定のページ投稿のリンククリック数、投稿のエンゲージメント数、およびユーザーによるストーリーズの生成またはページへのエンゲージメントの回数。宣伝対象オブジェクトの製品セットとは異なる製品セットを指定できますが、デフォルトは宣伝対象オブジェクトで指定された製品セットです。

メタ設定

単一の設定を使用して、単一のオブジェクトに複数のタイプのアクションを指定できます。

オブジェクト コンバージョン設定 説明

アプリ

{"action.type":["app_engagement"], "application":["APPLICATION_ID"]}

ユーザーがストーリーズapp_storyを生成した回数、またはapp_use、app_install、credit_spentを介してコンテンツにエンゲージした回数。

ページ

{"action.type":["page_engagement"], "page":["PAGE_ID"]}

指定されたページのコンテキストでユーザーが次のアクションのいずれかを実行した回数: チェックイン、コメント、フォロー、「いいね！」、ページ投稿への「いいね！」、メンション、ページへの投稿、投稿のシェア、質問への回答。さらに、指定されたページのコンテキストでユーザーが次のアクションのいずれかを実行した回数も含みます: リンクのクリック、写真の表示、ネイティブFB動画の再生。

ページ投稿

{"action.type":["post_engagement"], "post":["POST_ID"], "page":["PAGE_ID"]}

指定された投稿のコンテキストでユーザーが次のアクションのいずれかを実行した回数: コメント、質問のフォロー、「いいね！」、シェア、質問への回答。さらに、ユーザーが次のアクションのいずれかを実行した回数も含みます: リンクのクリック、ページへの「いいね！」、写真の表示、Facebookでホストされている動画またはインラインYoutube動画の再生。埋め込み動画でない動画の場合は、link_clickを使用します。

カスタムトラッキング設定

独自のトラッキング設定を定義するには、アクション設定フレームワークを使用します。アクション設定のリファレンスをご覧ください。

アクション(オブジェクトタイプ) 説明、トラッキング設定の詳細 トラッキング設定またはコンバージョン設定

app_custom_event (アプリ)

アプリのカスタムイベント。
モバイルアプリのカスタムイベントの数。

{'action.type':
'app_custom_event',
'application':APP_ID}

app_install (アプリ)

アプリのインストール。
キャンバスアプリまたはモバイルアプリの
インストール数

[{'action.type':'app_install',
'application':APP_ID},
{'action.type':
'mobile_app_install',
'application':APP_ID}]

app_use (アプリ)

アプリが使用された回数。

{'action.type':'app_use',
'application':APP_ID}

checkin (場所)

場所へのチェックイン。
このページのスポットまたは子のスポットへのチェックインの数。

{'action.type':'checkin',
'page': PAGE_ID},
{'action.type':'checkin',
'page.parent:PAGE_ID}

comment (投稿)

投稿へのコメント。
任意または特定のページ投稿へのコメントの数。

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

credit_spend (アプリ)

アプリでのクレジット利用のインスタンス。

'action.type':'credit_spent',
'application':APP_ID}

follow (質問)

オブジェクトのサブスクリプション登録。
質問への回答またはフォローの数。

{'action.type':'vote', 'question':QUESTION_ID, 'question.creator':PAGE_ID}, {'action.type':'follow', 'question':QUESTION_ID, 'question.creator':PAGE_ID}

leadgen_quality_conversion (ピクセル)

ダウンファネルリードコンバージョン(CRM)イベント。

{'action.type': 'leadgen_quality_conversion', 'fb_pixel': 'FACEBOOK_PIXEL_ID'}, {'action.type': 'leadgen_quality_conversion', 'dataset': 'OFFLINE_EVENT_SET_ID'}

like
(ページ、投稿)

オブジェクトへの「いいね！」。
ページまたは投稿への「いいね！」の数。

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

link_click (ページ、投稿、URL、URLドメイン)

リンクのクリック。
外部サイトのURLリンク、特定のURLドメインへのリンク、ページ上の外部サイトリンク、投稿上の外部サイトリンクがクリックされた回数。

{'action.type':['link_click'],
'object':['URL']},
{'action.type':['link_click'],
'object.domain':
['URL_DOMAIN']},
{'action.type':['link_click'],
'post.wall':['PAGE_ID']},
{'action.type':['link_click'],
'post':['POST_ID'],
'post.wall':['PAGE_ID']}

mention (ページ)

ページのメンション。
ページのメンションの数。

{'action.type':'mention',
'object':PAGE_ID'}

offsite_conversion (ピクセル)

外部サイトのコンバージョン数と累積収益。

{'action.type':
'offsite_conversion',
'fb_pixel':
'FACEBOOK_PIXEL_ID'}

photo_view (ページ)

写真の表示。
写真の表示の数、
ページ上の任意または特定の投稿の写真/動画/リンクシェアのvideo_playsまたはlink_clicksの数。

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

post (投稿)

ストーリーのシェア。
ページへのユーザー投稿の数。

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

receive_offer (クーポン)

クーポンの取得。
特定のクーポンを取得した人数。

{'action.type':'receive_offer',
'offer':OFFER_ID}

rsvp (イベント)

イベントの出欠回答。
イベントの出欠回答(出席と出席予定)の数。有効な値は、yes、maybe、noです。

{'action.type':'rsvp',
'event': EVENT_ID},

{'action.type':'rsvp',
'response':'yes',
'event': EVENT_ID},

{'action.type':'rsvp',
'response':'no',
'event': EVENT_ID},
{'action.type':'rsvp',
'response':'maybe',
'event': EVENT_ID}

tab_view (ページ)

ページタブの表示
特定のページタブの表示回数。すべてのタブの表示回数が必要な場合は、単にページを指定します。

{'action.type':'tab_view',
'page.tab.name':
'PAGE_TAB_NAME', 'page':PAGE_ID},
{'action.type':'tab_view',
'page':PAGE_ID}

video_play (投稿)

動画の再生。
ページ上の任意または特定の動画投稿の再生回数。

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

例

ピクセルトラッキング

広告のtracking_specsフィールドにトラッキングピクセルを指定して、広告内のさまざまなピクセルのパフォーマンスをトラッキングします。たとえば、次のようにします:

tracking_specs="[
  {'action.type':'offsite_conversion','fb_pixel':1},
  {'action.type':'offsite_conversion','fb_pixel':2},
  {'action.type':'offsite_conversion','fb_pixel':3}
]"

この例では、ピクセル「1」、「2」、「3」のパフォーマンスがトラッキングされます。ピクセル「1」のみを最適化する場合は、親広告セットのpromoted_objectを定義します。これは、CHECKOUTを最適化する場合だけでなく、REGISTRATIONとADD_TO_CARTの数もトラッキングする場合に役立ちます。

promoted_objectにピクセルIDを指定して最適化されたピクセルは自動的にトラッキングされるので、tracking_specsで同じピクセルを指定する必要はありません。

コンバージョン設定の使用

conversion_specsは広告のフィールドです。形式は{'action.type':'{ACTION}', ... }で、各アクションが1つのオブジェクトに適用されます。さまざまな広告タイプのコンバージョン設定の例を次に示します。

広告タイプ コンバージョン設定

ソーシャルコンテキスト付きのドメイン広告

{'action.type':'link_click', 'object':'URL'}

ページへの「いいね！」広告

{'action.type':'like', 'page':PAGE_ID}

ページ投稿リンク広告

{'action.type':['link_click'], 'post': [POST_ID], 'post.wall':[PAGE_ID]}

その他すべてのページ投稿広告

{'action.type':'post_engagement', 'post':'POST_ID', 'page':'PAGE_ID'}

イベント広告

{'action.type':'rsvp' , 'response':'yes', 'event':'EVENT_ID'}

クーポン広告

{'action.type':'receive_offer', 'offer':OFFER_ID, 'offer.creator':PAGE_ID}

モバイルアプリインストール広告

該当なし - このような広告を目的を設定せずに作成することはできません。

モバイルアプリエンゲージメント広告

該当なし - CPCとCPMの入札タイプのみがサポートされています

キャンバスアプリインストール広告

該当なし - このような広告を目的を設定せずに作成することはできません

キャンバスアプリエンゲージメント広告

該当なし - このような広告を目的を設定せずに作成することはできません

一部のコンバージョン設定には、単一のオブジェクトに適用される複数のアクションが含まれます。そのような設定をメタ設定と呼びます。次に例を示します。

オブジェクト コンバージョン設定 説明

ページ

{"action.type":["page_engagement"], "page":["PAGE_ID"]}

特定のページで次のアクションが実行された回数: チェックイン、コメント、フォロー、「いいね！」、ページ投稿への「いいね！」、メンション、ページへの投稿、投稿のシェア、質問への回答。特定のページで次のアクションが実行された回数も含みます: 写真の表示、ネイティブFacebook動画の再生。

ページ投稿

{"action.type":["post_engagement"], "post":["POST_ID"], "page":["PAGE_ID"]}

特定の投稿で次のアクションのいずれかが実行された回数: コメント、質問のフォロー、「いいね！」、シェア、クーポンの取得、質問への回答。次のアクションが実行された回数も含みます: リンクのクリック、ページへの「いいね！」、写真の表示、Facebookでホストされている動画またはインラインYoutube動画の再生。埋め込み動画でない動画の場合は、link_clickを使用します。

アプリ

{"action.type":["app_engagement"], "application":["APPLICATION_ID"]}

ユーザーがapp_storyを生成した回数、またはapp_use、app_install、credit_spentでコンテンツにエンゲージした回数。