リフト調査

Facebookキャンペーンの効率を測定するテストを作成して実行します。ビジネスへの影響が最も大きくなる広告戦略を決定します。広告調査、リファレンスをご覧ください。

リフト調査を作成する際には、該当広告を見るアカウントセンターアカウントのランダム化されたテストグループと、該当広告を見ないアカウントセンターアカウントのコントロールグループを作成します。

Facebook pixelsやApp Eventsを使用すると、広告キャンペーンのコンバージョンデータをFacebookと安全に共有することができます。Facebookは、キャンペーンから発生したコンバージョンの増分を特定します。その際には、テストグループとコントロールグループで、コンバージョン数、コンバージョンに至ったアカウントセンターアカウントの数、売上収益をそれぞれ比較します。

調査の設定

セルと呼ばれるグループが1つ以上含まれる調査を設定します。調査を設定すると、Facebookは広告のオーディエンスを無作為に抽出し、テストグループまたはコントロールグループのいずれかにアカウントセンターアカウントを割り当てます。調査を実行した後、テストグループとコントロールグループの差を計算することで、ビジネスの目的に対するFacebook広告の効果を評価します。

調査を設定するには、POST呼び出しを実行します。

'https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/ad_studies'

単一のテストグループで調査を設定すると、Facebook広告がどのように新たなビジネスにつながるかを確認できます。また、複数のテストグループによる調査を設定することもできます。この調査では、オーディエンスにとって最も効果的な広告アプローチを調べることができます。

例 - 1つのテストグループによるリフト調査を設定する

curl \
  -F 'name="new study"' \
  -F 'description="description of my study"' \
  -F 'start_time=1435622400' \
  -F 'end_time=1436918400' \
  -F 'cooldown_start_time=1433116800' \
  -F 'observation_end_time=1438300800' \
  -F 'viewers=[<USER_ID1>, <USER_ID2>]' \
  -F 'type=LIFT' \
  -F 'cells=[{name:"test group",description:"description of my test group",treatment_percentage:90,control_percentage:10,adaccounts:[<ACCOUNT_ID1>,<ACCOUNT_ID2>]}]' \
  -F 'objectives=[{name:"new objective",is_primary:true,type:"CONVERSIONS",applications:[{id:<APP_ID>}]}]' \
  -F 'access_token=<ACCESS_TOKEN>' \
  'https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/ad_studies'

新しい調査を作成するには、次の情報を指定します。

テストグループの作成

まず、広告を受け取るアカウントセンターアカウントの数と、受け取らないアカウントセンターアカウントの数を決定してください。調査を設定する際には、テストグループを作成する必要があります。ad_studiesの下のcellsにJSONオブジェクトのリストを渡します。広告調査セル、リファレンスをご覧ください。テストグループには以下の情報が含まれます。

例 - 調査においてテストグループを読み込む

curl -G \
  -d 'access_token=<ACCESS_TOKEN>' \
  'https://graph.facebook.com/<API_VERSION>/<STUDY_ID>/cells'

例 - cellsにセルIDを指定することにより、セル情報や処理率とコントロール率を更新したり変更したりする

curl \
  -F 'cells=[{id:<CELL_ID>,treatment_percentage:80,control_percentage:20}]' \
  -F 'access_token=<ACCESS_TOKEN>' \
  'https://graph.facebook.com/<API_VERSION>/<STUDY_ID>'

例 - 自分のビジネスのad_studiesで作成したすべての調査を読み取る

curl -G \
  -d 'access_token=<ACCESS_TOKEN>' \
  'https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/ad_studies'

また、{ad-account-ID/include_all_studies=true}において自分のアクセストークンを使用してGETリクエストを発行することにより、自分の広告アカウントに関連するすべての調査を表示することもできます。

複数のテストグループの設定

Facebookユーザーで構成される複数のテストグループで調査を設定します。これにより、さまざまな広告のターゲット設定オプションの使用など、ビジネスの目的における多様なFacebook戦略の効果の増加を測定できます。複数のテストグループによる調査を設定するには、cellsの中にテストグループのリストを指定します。

curl \
  -F 'name="new study"' \
  -F 'description="description of my study"' \
  -F 'start_time=1435622400' \
  -F 'end_time=1436918400' \
  -F 'cooldown_start_time=1433116800' \
  -F 'observation_end_time=1438300800' \
  -F 'viewers=[<USER_ID1>, <USER_ID2>]' \
  -F 'type=LIFT' \
  -F 'cells=[{name:"group A",description:"description of group A",treatment_percentage:50,control_percentage:20,campaigns:[<CAMPAIGN_ID1>]},{name:"group B",description:"description of group B",treatment_percentage:20,control_percentage:10,campaigns:[<CAMPAIGN_ID2>]}]' \
  -F 'objectives=[{name:"new objective",is_primary:true,type:"CONVERSIONS",applications:[{id:<APP_ID>}]}]' \
  -F 'access_token=<ACCESS_TOKEN>' \
  'https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/ad_studies'

control_percentageは、合計母集団との比較で、各テストグループのホールドアウトを判別します。例えば、処理率50%でコントロール率20%のグループAと、処理率20%でコントロール率10%のグループBという2つのテストグループを設定します。この結果、グループAの母集団の28.6%まで (20%/70%)とグループBの母集団の33.3%まで (10%/30%)がコントロールグループの利用者になります。

通常、テストグループ全体での処理率とコントロール率の合計は100になります。ただし、100未満になる特定の使用事例があります。例えば、3つのテストグループを33%ずつ均等に分割して設定する場合です。

調査のテストグループは更新、追加、削除できます。

• 既存のテストグループを更新するには、テストグループのIDを参照します。
• 新しいテストグループを追加するには、新しいテストグループオブジェクトを指定します。
• テストグループを削除するには、調査を更新する際にcellsからそのテストグループを除外するだけです。

curl \
  -F 'cells=[{id:<CELL_ID1>,treatment_percentage:60,control_percentage:10},{name:"group C",description:"replacing group B",treatment_percentage:25,control_percentage:5,campaigns:[<CAMPAIGN_ID3>]}]' \
  -F 'access_token=<ACCESS_TOKEN>' \
  'https://graph.facebook.com/<API_VERSION>/<STUDY_ID>'

広告の目的の定義

測定する広告の目的と、コンバージョンデータをFacebookに渡す方法を定義します。リフト調査には、少なくとも1つの目的が必要です。調査実行開始後に目的に変更を加えることはできません。広告調査の目的、リファレンスをご覧ください。

例 - CONVERSIONSの目的を作成し、調査に追加します

curl \
  -F 'name="new study"' \
  -F 'description="description of my study"' \
  -F 'start_time=1435622400' \
  -F 'end_time=1436918400' \
  -F 'cooldown_start_time=1433116800' \
  -F 'observation_end_time=1438300800' \
  -F 'viewers=[<USER_ID1>, <USER_ID2>]' \
  -F 'type=LIFT' \
  -F 'cells=[{name:"test group",description:"description of my test group",treatment_percentage:90,control_percentage:10,adaccounts:[<ACCOUNT_ID1>,<ACCOUNT_ID2>]}]' \
  -F 'objectives=[{name:"new objective",is_primary:true,type:"CONVERSIONS",applications:[{id:<APP_ID>}]}]' \
  -F 'access_token=<ACCESS_TOKEN>' \
  'https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/ad_studies'

CONVERSIONSを使用し、イベントソースとしてFacebookピクセルまたはモバイルアプリを使用する場合は、目的のためにキャプチャするイベント名のリストを指定する必要があります。こうすることで、Facebookでは、そのような特定のコンバージョンイベントに基づいて結果を報告することができます。

目的の作成

目的を作成するには、新しい調査を作成する際に、JSONオブジェクトのリストobjectivesを渡します。目的には以下の情報が含まれます。

1つの調査に複数の目的を設定することもできます。結果は目的に基づいて集計されます。以下は、複数の目的がある調査の例です。

curl \
  -F 'name="another study"' \
  -F 'description="description of another study"' \
  -F 'start_time=1435622400' \
  -F 'end_time=1436918400' \
  -F 'cooldown_start_time=1433116800' \
  -F 'observation_end_time=1438300800' \
  -F 'viewers=[<USER_ID1>, <USER_ID2>]' \
  -F 'type=LIFT' \
  -F 'cells=[{name:"test group",description:"description of my test group",treatment_percentage:90,control_percentage:10,adaccounts:[<ACCOUNT_ID1>,<ACCOUNT_ID2>]}]' \
  -F 'objectives=[{name:"first objective objective",is_primary:true,type:"CONVERSIONS",applications:[{id:<APP_ID1>},{id:<APP_ID2>}]},{name:"scond  objective",type:"CONVERSIONS",applications:[{id:<APP_ID3>,event_names:["fb_mobile_purchase"]}],adspixels:[{id:<FB_PIXEL_ID>,event_names:["fb_pixel_purchase","fb_pixel_lead"]}]}]' \
  -F 'access_token=<ACCESS_TOKEN>' \
  'https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/ad_studies'

調査の目的の更新、追加、削除は、テストグループの変更と同様に調査レベルで行うことができます。既存の目的を更新するには、objectivesオブジェクト内でそのIDを参照します。新しい目的を追加するには、新しい目的オブジェクトを指定します。目的を削除するには、objectivesパラメーターを更新する際に該当する目的を除外するだけで削除できます。

例 - ある目的のapplications測定ソースを更新し、そのadspixels測定ソースを削除する

curl \
  -F 'objectives=[{id:<OBJECTIVE_ID>,name:"new objective name",applications:[{id:<APP_ID>}],adspixels:[]}]' \
  -F 'access_token=<ACCESS_TOKEN>' \
  'https://graph.facebook.com/<API_VERSION>/<STUDY_ID>'

例 - ある調査の目的を読み取る

curl -G \
  -d 'access_token=<ACCESS_TOKEN>' \
  'https://graph.facebook.com/<API_VERSION>/<STUDY_OBJECTIVE_ID>?fields=results&breakdowns=["cell_id"]'

レポート機能

目的の取得

調査の目的は、調査の設定時に定義されます。調査の目的を定義する方法については、設定ガイドをご覧ください

調査のobjectivesエッジに対してGET呼び出しを実行すると、その調査のために作成された目的を読み取ることができます。

curl -G \
  -d 'access_token=<ACCESS_TOKEN>' \
  'https://graph.facebook.com/<API_VERSION>/<STUDY_OBJECTIVE_ID>?fields=results&breakdowns=["cell_id"]'

結果の取得

フィールドパラメーターにresultsを指定して、目的ノードに対してGET呼び出しを実行すると、目的に関する調査を取得できます。また、last_updated_resultsフィールドを確認すれば、この特定の目的の結果データの前回の更新日時も分かります。

応答の例は、読みやすいように解析済みのJSONで表示されています。

コマンド

curl -G \
  -d 'access_token=<ACCESS_TOKEN>' \
  'https://graph.facebook.com/<API_VERSION>/<STUDY_OBJECTIVE_ID>?fields=results&breakdowns=["cell_id"]'

結果データは、指標名と値の文字列を含むJSONオブジェクトです。Facebookリフト指標用語集を参照してください。

「buyers」を含む

{
	"results": [
	"{"cell_id":"<cell_id>",
	"population_test":2334212,
	"population_control":123407,
	"population_reached":1862084,
	"impressions":19020874,
	"spend":26059,
	"buyers_control_raw_scaled":37672.615701199,
	"buyers_exposed":30085.482427228,
	"buyers_frequentist_pValue":0.00064950107027983,
	"conversions_control_raw_scaled":110918.27003534,
	"conversions_exposed":86961.044050743,
	"conversions_raw_pValue":0.12863848309723,
	"conversions_test":104412.89695396,
	"conversions_control_scaled":104575.81331581,
	"conversions_incremental":-162.91636184894,
	"conversions_notExposed":87123.960412592,
	"conversions_confidence":0.69291721817069,
	"conversions_multicell_confidence":null,
	"conversions_incremental_lower":-3470.6251396487,
	"conversions_incremental_upper":3235.0644420632,
	"conversions_multicell_rank":null,
	"conversions_incremental_share":-0.001873440730011,
	"conversions_CPiC":-159.95324044961,
	"buyers_test":40732.369934386,
	"buyers_control_scaled":41990.129061459,
	"buyers_incremental":-1257.7591270729,
	"buyers_notExposed":36617.935710157,
	"buyers_confidence":0.19318944031404,
	"buyers_multicell_confidence":null,
	"buyers_incremental_lower":-2905.5296282828,
	"buyers_incremental_upper":426.25813050358,
	"buyers_multicell_rank":null,
	"buyers_incremental_share":-0.041806181107957,
	"buyers_CPiB":-20.718593440578}"
	  ],
	  "id": "<objective_id>"
}

「buyers」を含まない

{
	"results": [
	"{"cell_id":"<cell_id>",
	"population_test":2334212,
	"population_control":123407,
	"population_reached":1862084,
	"impressions":19020874,
	"spend":26059,
	"conversions_control_raw_scaled":110918.27003534,
	"conversions_exposed":86961.044050743,
	"conversions_raw_pValue":0.12863848309723,
	"conversions_test":104412.89695396,
	"conversions_control_scaled":104575.81331581,
	"conversions_incremental":-162.91636184894,
	"conversions_notExposed":87123.960412592,
	"conversions_confidence":0.69291721817069,
	"conversions_multicell_confidence":null,
	"conversions_incremental_lower":-3470.6251396487,
	"conversions_incremental_upper":3235.0644420632,
	"conversions_multicell_rank":null,
	"conversions_incremental_share":-0.001873440730011,
	"conversions_CPiC":-159.95324044961}"
	  ],
	  "id": "<objective_id>"
}

結果の内訳

目的ごとの結果を取得することに加えて、breakdownsパラメーターを指定して結果の内訳を調べることもできます。

curl -G \
  -d 'access_token=<ACCESS_TOKEN>' \
  'https://graph.facebook.com/<API_VERSION>/<STUDY_OBJECTIVE_ID>?fields=results&breakdowns=["cell_id"]'

使用可能な内訳は次のとおりです。

結果では、使用可能な内訳に基づいて複数のJSONオブジェクトが配列で返されます。例えば、cell_idが指定されている場合、結果は調査のセル数に分割されます。1つ以上の内訳を指定できますが、結果を表示するには、内訳の組み合わせとして、テストグループとコントロールグループ合わせて100件以上のコンバージョンが必要です。

{
  "id": "<STUDY_OBJECTIVE_ID>",
  "results": [
  {
    "cell_id": "<CELL_ID1>",
    ...
    Default fields where the values are specific to the <CELL_ID1> breakdown
    ...
  },
  {
    "cell_id": "<CELL_ID2>",
    ...
    Default fields where the values are specific to the <CELL_ID2> breakdown
    ...
  }],
}

特定の日付スタンプの結果

API呼び出しの中で日付スタンプを指定すると、特定の日付の調査結果を入手できます。この呼び出しによって返される結果は、特定の日付に日付スタンプフィールドを指定せずに同じ呼び出しを実行した場合に得られる結果と同じです。過去30日以内の日付を指定する必要があります。

curl -G \
      -d 'access_token=<ACCESS_TOKEN>' \
      'https://graph.facebook.com/<API_VERSION>/<STUDY_OBJECTIVE_ID>?fields=results&ds=2020-03-01'