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から特定のキャンペーンレベルの詳細を受け取るには、以下の手順に従ってください。
Adjustがリファラーメタデータを復号化できるようにするには、インストールリファラーDecryption Keyを共有する必要があります。これは、小文字(a〜f)と数字(0〜9)で構成される64文字の文字列です。Meta App IDごとに1つのdecryption keyを使用できます。
例:9fc19e01a8ac4db1404c23b1ea656047f9fcd5cb3befb0cf650a32ed919893ce
復号化キーを確認するには、以下の手順に従ってください。
Meta開発者ポータル にログインします。右上隅の My Apps に移動します。 復号化キーにアクセスしたいアプリを選択します。 設定(Settings)> ベーシック(Basic) の順に選択します。Android のセクションまでスクロールします。Google Play のヘッダーの下にある インストールリファラーDecryption Key を探します。AdjustでDecryption Keyを追加するには、以下の手順に従ってください。
Campaign Lab にて、 パートナー(Partner) を選択します。Facebook を検索し、リンクを選択してオーバービューのページに進みます。データ共有(Data Sharing) タブを選択し、アプリのリストを確認します。設定したいアプリを見つけ、その 編集(Edit) ボタン( )を選択します。 Facebookのデータ共有を有効化(Enable data sharing for Facebook) で、 編集(Edit) を選択します。設定する各プラットフォームの Decryption Key を入力します。 Adjustは、ローデータエクスポートで特定のプレースホルダーを使用して、Metaからの復号化されたデータを送信することができます。この情報を受け取るには、必要なプレースホルダーを使用してコールバックURLまたはCSVの定義を更新します。
{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は以下のマッピングを使用します。
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を表示する方法 Adjustは、以下のロジックを使用して network_name
をレポートします。
「facebook」、「unknown」などその他 Facebook Installs 「instagram」 Instagram Installs 「messenger」 Facebook Messenger Installs 「audience_network」 Off-Facebook Installs
コールバックURLの例
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}
値が入力されたコールバックの例
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ではない別のパートナーに付与された場合でも、データにはリファラー情報が含まれます。
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