Android対象のMetaのローデータレポート

Metaのインストールリファラーを使用して、広告主はより充実したAndroidのローデータを取得できます。キャンペーンのメタデータは、暗号化された形式でインストールリファラーに追加されます。メタデータを読み取るには、Metaが提供するアプリのdecryption keyを使用することが必須です。

ローデータをより充実させるために、2つのインストールリファラーがサポートされています。

  • Google Playインストールリファラー(GPIR)
  • Metaインストールリファラー(MIR)

どちらのインストールリファラーも、FacebookやInstagramなどのMetaアプリケーションから始まったアプリインストールに関する詳細情報を提供します。ただし、ビュースルーおよび同一セッションではないクリックスルーアトリビューションをサポートするのは MIRのみ です。

事前準備

事前準備として、以下の内容をご確認ください。

要件

GPIR

GPIRを有効にするには、 Google Playインストールリファラーを設定する必要があります。

MIR

MIRプラグインを有効にするには、Adjust Android SDKをv5にアップデートし、Metaインストールリファラープラグインを設定する必要があります。

計測の仕組み

インストールリファラーソリューションを使用すると、ユーザーのアプリ内アクティビティをAndroidで配信される広告の獲得ソースにリンクさせることができます。これにより、キャンペーンの成果を継続的に計測し、主要なユーザー獲得傾向を特定することができます。

  1. ユーザーがアプリをインストールすると、インストールリファラーがインストールソースからリファラルデータを収集します。
  2. MetaはインストールリファラーのAPIを使用して、暗号化されたデータを共有します。
  3. Adjustはこのデータを抽出し、お客様のMeta dectyption keyを使用して復号化します。

復号化されたデータ文字列は次のようになります:

{
"ad_id":"12345",
"ad_objective_name":"APP_INSTALL",
"adgroup_id":"54321",
"adgroup_name":"Test Ad Group",
"campaign_id":"987654",
"campaign_name":"Test Campaign",
"campaign_group_id":"654321",
"campaign_group_name":"Test Campaign Group",
"account_id":"444444",
"publisher_platform":"Test Publisher Platform",
}

プレースホルダーを使用して、ローデータエクスポートで復号化されたデータを収集できます。

ヒント:
GPIRとMIRの両方を有効にすると、ローデータエクスポートで両方のソースから情報を受け取ります。AdjustはDatascape内でのみ、GPIRとMIR情報の重複排除を行います。一般的に GPIRを優先することが推奨されます。

どのデータが共有されませんか?

MetaはデバイスIDを送信しません。

以下のデータポイントは、 MIRを使用している場合にのみ​ 利用可能です。

  • ビュースルーコンバージョン。
  • Google Play以外のAndroidアプリストア(Galaxy StoreやAmazon Appstoreなど)で発生するアプリイベント

インストールリファラーを設定する

インストールリファラーソリューションを設定して、特定のキャンペーンレベルの詳細情報をMetaから受け取るには、以下の手順に従ってください。

Metaの認証情報をAdjustと共有する

Adjustがリファラーデータを復号化するには、Metaのインストールリファラー復号化キー(Decryption Key)が必要です。

Decryption Keyを確認する

Decryption Keyは、MetaのアプリIDに一意に割り当てられている64文字の文字列です。

例:9fc19e01a8ac4db1404c23b1ea656047f9fcd5cb3befb0cf650a32ed919893ce

復号化キーを確認するには、以下の手順に従ってください。

  1. アプリダッシュボード(App Dashboard)を開きます。
  2. 該当するアプリを選択します。
  3. 設定(Settings)> ベーシック(Basic)​ の順に選択します。
  4. Android​ のセクションまでスクロールします。
  5. Install Referrer Decryption Key(インストールリファラー復号化キー)​ をコピーします。
A screenshot from Meta's App Dashboard that shows where to find your Decryption Key. Refer to the textual instructions above.

Adjustに復号化キーを追加する

AdjustでDecryption Keyを追加するには、以下の手順に従ってください。

  1. Campaign Lab > パートナー(Partner)​ の順に開きます。
  2. Facebook​ を検索し、選択してオーバービューのページを開きます。
  3. データ共有(Data Sharing)​ タブを選択し、アプリの一覧を表示します。
  4. 設定したいアプリを見つけ、その 編集(Edit)​ ボタン()を選択します。
  5. Facebookのデータ共有を有効化(Enable data sharing for Facebook)​ で、 編集(Edit)​ を選択します。
  6. Decryption Key (Optional)​ フィールドに、前の手順でコピーしたDecryption Key(復号化キー)をペーストします。
  7. 保存(SAVE)​ ボタンをクリックします。

コールバックにMetaリファラープレースホルダーを追加する

Adjustはプレースホルダーを使用して、復号化されたMetaからのデータを送信することができます。このデータをローデータエクスポートで受け取るには、関連するプレースホルダーをコールバックURLまたはCSVの定義に追加します。

利用可能なプレースホルダー

GPIR
MIR
プレースホルダー説明
{fb_install_referrer}暗号化形式のMetaインストールリファラー全体のコンテンツ。
{fb_install_referrer_campaign_group_name}Metaインストールリファラー全体のコンテンツから取得される「campaign_group_name」値。
{fb_install_referrer_campaign_group_id}Metaインストールリファラー全体のコンテンツから取得される「campaign_group_id」値。
{fb_install_referrer_campaign_name}Metaインストールリファラー全体のコンテンツから取得される「campaign_name」値。
{fb_install_referrer_campaign_id}Metaインストールリファラー全体のコンテンツから取得される「campaign_id」値。
{fb_install_referrer_adgroup_id}Metaインストールリファラー全体のコンテンツから取得される「adgroup_id」値。
{fb_install_referrer_adgroup_name}Metaインストールリファラー全体のコンテンツから取得される「adgroup_name」値。
{fb_install_referrer_ad_id}Metaインストールリファラー全体のコンテンツから取得される「ad_id」値。
{fb_install_referrer_account_id}Metaインストールリファラー全体のコンテンツから取得される「account_id」値。
{fb_install_referrer_ad_objective_name}Metaインストールリファラー全体のコンテンツから取得される「ad_objective_name」値。
{fb_install_referrer_publisher_platform}Metaインストールリファラー全体のコンテンツから取得される「publisher_platform」値。

レポートとプレースホルダーのマッピング

Adjustは、Metaのリファラープレースホルダーから受け取ったデータをAdjustのレポートに合わせるため、以下のようにマッピングしています。

GPIR
MIR
Adjust アトリビューション フィールドMetaレポートプレースホルダー値の例
network_nameパブリッシャー名 {fb_install_referrer_publisher_platform} Meta Installs
campaign_nameキャンペーン名
キャンペーンID
{fb_install_referrer_campaign_group_name}
({fb_install_referrer_campaign_group_id})
Android Meta campaign test (123456789)
adgroup_name広告セット名
広告セットID
{fb_install_referrer_campaign_name}
({fb_install_referrer_campaign_id})
Android - US - Basic Ad Set (234567890)
creative_name広告名
広告ID
{fb_install_referrer_adgroup_name}
({fb_install_referrer_adgroup_id})
Summer banner (345678901)

Adjustがnetwork_nameを表示する方法

Adjustは、以下のロジックを使用して network_nameをレポートします。

publisher_platformnetwork_nameのレポート表示
「facebook」、「unknown」、その他Facebook Installs
「instagram」Instagram Installs
「messenger」Facebook Messenger Installs
「audience_network」Off-Facebook Installs

コールバックの例

GPIR
MIR
https://app.my-random-server.com/?tracker={tracker_token}&tracker_name={tracker_name}referrer={referrer}&fb_referrer={fb_install_referrer}&PhFbInstallReferrerAdId={fb_install_referrer_ad_id}&PhFbInstallReferrerAdGroupId={fb_install_referrer_adgroup_id}&PhFbInstallReferrerAdGroupName={fb_install_referrer_adgroup_name}&PhFbInstallReferrerCampaignId={fb_install_referrer_campaign_id}&PhFbInstallReferrerCampaignName={fb_install_referrer_campaign_name}&PhFbInstallReferrerCampaignGroupId={fb_install_referrer_campaign_group_id}&PhFbInstallReferrerCampaignGroupName={fb_install_referrer_campaign_group_name}&PhFbInstallReferrerAccountId={fb_install_referrer_account_id}&PhFbInstallReferrerAdObjectiveName={fb_install_referrer_ad_objective_name}&PhFbInstallReferrerPublisherPlatform={fb_install_referrer_publisher_platform}

値が入力されたコールバックの例

GPIR
MIR
https://app.my-random-server.com/?tracker=unattr&tracker_name=Unattributed&referrer=adjust_reftag%3DceJTzfSP7kyVV%26utm_source%3Dfacebook%26utm_content%3D%257B%2522source%2522%253A%257B%2522data%2522%253A%2522afe56cf6228c6ea8c79da49186e718e92a579824596ae1d0d4d20d7793dca797bd4034ccf467bfae5c79a3981e7a2968c41949237e2b2db678c1c3d39c9ae564c5cafd52f2b77a3dc77bf1bae063114d0283b97417487207735da31ddc1531d5645a9c3e602c195a0ebf69c272aa5fda3a2d781cb47e117310164715a54c7a5a032740584e2789a7b4e596034c16425139a77e507c492b629c848573c714a03a2e7d25b9459b95842332b460f3682d19c35dbc7d53e3a51e0497ff6a6cbb367e760debc4194ae097498108df7b95eac2fa9bac4320077b510be3b7b823248bfe02ae501d9fe4ba179c7de6733c92bf89d523df9e31238ef497b9db719484cbab7531dbf6c5ea5a8087f95d59f5e4f89050e0f1dc03e464168ad76a64cca64b79%2522%252C%2522nonce%2522%253A%2522b7203c6a6fb633d16e9cf5c1%2522%257D%257D&fb_referrer=%7B%22ad_id%22%3A%2212345%22%2C%22ad_objective_name%22%3A%22APP_INSTALLS%22%2C%22adgroup_id%22%3A%2254321%22%2C%22adgroup_name%22%3A%22Adams+Test+Ad+Group%22%2C%22campaign_id%22%3A%22987654%22%2C%22campaign_name%22%3A%22Adams+Test+Campaign%22%2C%22campaign_group_id%22%3A%22654321%22%2C%22campaign_group_name%22%3A%22Adams+Test+Campaign+Group%22%2C%22account_id%22%3A%22444444%22%7D&PhFbInstallReferrerAdId=12345&PhFbInstallReferrerCampaignId=%7B%22ad_id%22%3A%2212345%22%2C%22ad_objective_name%22%3A%22APP_INSTALLS%22%2C%22adgroup_id%22%3A%2254321%22%2C%22adgroup_name%22%3A%22Adams+Test+Ad+Group%22%2C%22campaign_id%22%3A%22987654%22%2C%22campaign_name%22%3A%22Adams+Test+Campaign%22%2C%22campaign_group_id%22%3A%22654321%22%2C%22campaign_group_name%22%3A%22Adams+Test+Campaign+Group%22%2C%22account_id%22%3A%22444444%22%7D&PhFbInstallReferrerCampaignName=Adams+Test+Campaign&PhFbInstallReferrerCampaignGroupId=654321&PhFbInstallReferrerCampaignGroupName=Adams+Test+Campaign+Group&PhFbInstallReferrerAccountId=444444&PhFbInstallReferrerAdObjectiveName=APP_INSTALLS &PhFbInstallReferrerAdObjectiveName=APP_INSTALLS&FbInstallReferrerPublisherPlatform=facebook

Metaにアトリビュートされていないインストールの場合

インストールにリファラーが紐付けられており最新アトリビューションがMeta以外のパートナーによる場合でも、リファラー情報を受信できます。

GPIR
MIR
https://myserver.com?tracker=def456&tracker_name=NetworkA&fb_install_referrer=%7B%22ad_id%22%3A%2212345%22%2C%22ad_objective_name%22%3A%22APP_INSTALLS%22%2C%22adgroup_id%22%3A%2254321%22%2C%22adgroup_name%22%3A%22Test+Ad+Group%22%2C%22campaign_id%22%3A%22987654%22%2C%22campaign_name%22%3A%22Test+Campaign%22%2C%22campaign_group_id%22%3A%22654321%22%2C%22campaign_group_name%22%3A%22Test+Campaign+Group%22%2C%22account_id%22%3A%22444444%22%7D