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で配信される広告の獲得ソースにリンクさせることができます。これにより、キャンペーンの成果を継続的に計測し、主要なユーザー獲得傾向を特定することができます。
ユーザーがアプリをインストールすると、インストールリファラーがインストールソースからリファラルデータを収集します。 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",
}
プレースホルダーを使用して、ローデータエクスポートで復号化されたデータを収集できます。
GPIRとMIRの両方を有効にすると、ローデータエクスポートで両方のソースから情報を受け取ります。AdjustはDatascape内でのみ、GPIRとMIR情報の重複排除を行います。一般的に
GPIR を優先することが推奨されます。
MetaはデバイスIDを送信しません。
以下のデータポイントは、 MIRを使用している場合にのみ 利用可能です。
ビュースルーコンバージョン。 Google Play以外のAndroidアプリストア(Galaxy StoreやAmazon Appstoreなど)で発生するアプリイベント インストールリファラーソリューションを設定して、特定のキャンペーンレベルの詳細情報をMetaから受け取るには、以下の手順に従ってください。
Adjustがリファラーデータを復号化するには、Metaのインストールリファラー復号化キー(Decryption Key)が必要です。
Decryption Keyは、MetaのアプリIDに一意に割り当てられている64文字の文字列です。
例:9fc19e01a8ac4db1404c23b1ea656047f9fcd5cb3befb0cf650a32ed919893ce
復号化キーを確認するには、以下の手順に従ってください。
アプリダッシュボード(App Dashboard) を開きます。該当するアプリを選択します。 設定(Settings)> ベーシック(Basic) の順に選択します。Android のセクションまでスクロールします。Install Referrer Decryption Key(インストールリファラー復号化キー) をコピーします。AdjustでDecryption Keyを追加するには、以下の手順に従ってください。
Campaign Lab > パートナー(Partner) の順に開きます。Facebook を検索し、選択してオーバービューのページを開きます。データ共有(Data Sharing) タブを選択し、アプリの一覧を表示します。設定したいアプリを見つけ、その 編集(Edit) ボタン( )を選択します。 Facebookのデータ共有を有効化(Enable data sharing for Facebook) で、 編集(Edit) を選択します。Decryption Key (Optional) フィールドに、前の手順でコピーしたDecryption Key(復号化キー)をペーストします。保存(SAVE) ボタンをクリックします。Adjustはプレースホルダーを使用して、復号化されたMetaからのデータを送信することができます。このデータをローデータエクスポートで受け取るには、関連するプレースホルダーをコールバックURLまたはCSVの定義に追加します。
{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のレポートに合わせるため、以下のようにマッピングしています。
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
をレポートします。
「facebook」、「unknown」、その他 Facebook Installs 「instagram」 Instagram Installs 「messenger」 Facebook Messenger Installs 「audience_network」 Off-Facebook Installs
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}
値が入力されたコールバックの例
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以外のパートナーによる場合でも、リファラー情報を受信できます。
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