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

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

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

  • Metaインストールリファラー(MIR)
  • Google Playインストールリファラー(GPIR)
注意:
どちらのインストールリファラーも、FacebookやInstagramなどのMetaアプリケーションから発生したアプリインストールに関する詳細情報を提供します。ただし、MIRはビュースルーおよび同じセッションではないクリックスルーアトリビューションをサポートしており、GPIRではサポートされていません。Metaキャンペーンを最大限に活用するために、MIRの使用を強くお勧めします。

事前準備

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

要件

MIR

GPIR

計測の仕組み

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

ユーザーがアプリをインストールすると、インストールリファラーがインストールソースからリファラルコンテンツを収集します。Metaは、インストールリファラーのAPIを使用して、このデータを暗号化して共有します。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",
}

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

警告:
MIRとGPIRの両方を有効にすると、両方のソースから情報を受け取ります。AdjustはDatascapeでMIRとGPIRの情報を重複排除しますが、ローデータエクスポートでは両方のデータセットが送信されます。GPIRデータよりも MIR データを優先するようにしてください。

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

Metaは以下のメタデータを送信しません。

以下のメタデータは、MIRを使用している場合に のみ​ 利用可能です:

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

インストールリファラーソリューションの設定

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

1. AdjustでMeta認証情報を更新する

Adjustがリファラーメタデータを復号化できるようにするには、インストールリファラーDecryption Keyを共有する必要があります。これは、小文字(a〜f)と数字(0〜9)で構成される64文字の文字列です。Meta App IDごとに1つのdecryption keyを使用できます。

例:9fc19e01a8ac4db1404c23b1ea656047f9fcd5cb3befb0cf650a32ed919893ce

Decryption Keyを確認する

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

  1. Meta開発者ポータルにログインします。
  2. 右上隅の My Apps​ に移動します。
  3. 復号化キーにアクセスしたいアプリを選択します。
  4. 設定(Settings)> ベーシック(Basic)​ の順に選択します。
  5. Android​ のセクションまでスクロールします。
  6. Google Play​ のヘッダーの下にある インストールリファラーDecryption Key​ を探します。

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​ を入力します。

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

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

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

MIR
GPIR
プレースホルダー説明
{meta_install_referrer}暗号化形式のMetaインストールリファラー全体のコンテンツ。
{meta_install_referrer_campaign_group_name}Metaインストールリファラー全体のコンテンツから取得される「campaign_group_name」値。
{meta_install_referrer_campaign_group_id}Metaインストールリファラー全体のコンテンツから取得される「campaign_group_id」値。
{meta_install_referrer_campaign_name}Metaインストールリファラー全体のコンテンツから取得される「campaign_name」値。
{meta_install_referrer_campaign_id}Metaインストールリファラー全体のコンテンツから取得される「campaign_id」値。
{meta_install_referrer_adgroup_id}Metaインストールリファラー全体のコンテンツから取得される「adgroup_id」値。
{meta_install_referrer_adgroup_name}Metaインストールリファラー全体のコンテンツから取得される「adgroup_name」値。
{meta_install_referrer_ad_id}Metaインストールリファラー全体のコンテンツから取得される「ad_id」値。
{meta_install_referrer_account_id}Metaインストールリファラー全体のコンテンツから取得される「account_id」値。
{meta_install_referrer_ad_objective_name}Metaインストールリファラー全体のコンテンツから取得される「ad_objective_name」値。
{meta_install_referrer_publisher_platform}Metaインストールリファラー全体のコンテンツから取得される「publisher_platform」値。
{meta_install_referrer_is_click}エンゲージメントの種類がクリックであるかどうかを示す。クリックの場合は 1、クリックでない場合は0
{meta_install_referrer_actual_timestamp}Metaインストールリファラー全体のコンテンツから取得される、Unixタイムスタンプ形式の「actual_timestamp」値。

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

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

MIR
GPIR
Adjust アトリビューション フィールドMetaレポートプレースホルダー値の例
network_nameパブリッシャー名
  • {meta_install_referrer_publisher_platform}
Meta Installs
campaign_nameキャンペーン名
キャンペーンID
  • {meta_install_referrer_campaign_group_name}({meta_install_referrer_campaign_group_id})
 Android Facebook campaign test (123456789)
adgroup_name広告セット名
広告セットID
  • {meta_install_referrer_campaign_name}({meta_install_referrer_campaign_id})
 Android - US - Basic Ad Set (234567890)
creative_name広告名
広告ID
  • {meta_install_referrer_adgroup_name}({meta_install_referrer_adgroup_id})
 Summer banner (345678901)

Adjustがnetwork_nameを表示する方法

コールバックの例

コールバックURLの例

MIR
GPIR
https://app.my-random-server.com/?tracker={tracker_token}&tracker_name={tracker_name}referrer={referrer}&meta_referrer={meta_install_referrer}&PhMetaInstallReferrerAdId={meta_install_referrer_ad_id}&PhMetaInstallReferrerAdGroupId={meta_install_referrer_adgroup_id}&PhMetaInstallReferrerAdGroupName={meta_install_referrer_adgroup_name}&PhMetaInstallReferrerCampaignId={meta_install_referrer_campaign_id}&PhMetaInstallReferrerCampaignName={meta_install_referrer_campaign_name}&PhMetaInstallReferrerCampaignGroupId={meta_install_referrer_campaign_group_id}&PhMetaInstallReferrerCampaignGroupName={meta_install_referrer_campaign_group_name}&PhMetaInstallReferrerAccountId={meta_install_referrer_account_id}&PhMetaInstallReferrerAdObjectiveName={meta_install_referrer_ad_objective_name}&PhMetaInstallReferrerPublisherPlatform={meta_install_referrer_publisher_platform}&PhMetaInstallReferrerIsClick={meta_install_referrer_is_click}&PhMetaInstallReferrerActualTimestamp={meta_install_referrer_actual_timestamp}

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

MIR
GPIR
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&meta_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&PhMetaInstallReferrerAdId=12345&PhMetaInstallReferrerCampaignId=%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&PhMetaInstallReferrerCampaignName=Adams+Test+Campaign&PhMetaInstallReferrerCampaignGroupId=654321&PhMetaInstallReferrerCampaignGroupName=Adams+Test+Campaign+Group&PhMetaInstallReferrerAccountId=444444&PhMetaInstallReferrerAdObjectiveName=APP_INSTALLS &PhMetaInstallReferrerAdObjectiveName=APP_INSTALLS&MetaInstallReferrerPublisherPlatform=facebook&PhMetaInstallReferrerIsClick=1&PhMetaInstallReferrerActualTimestamp=1234567890

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

リファラーがインストールに付与され、最終的なアトリビューションがMetaではない別のパートナーに付与された場合でも、データにはリファラー情報が含まれます。

MIR
GPIR
https://myserver.com?tracker=def456&tracker_name=NetworkA&meta_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