AndroidにおけるFacebookのローデータレポート 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 で、 アドネットワーク(Ad Networks) を選択します。Facebook を検索し、リンクを選択してオーバービューのページに進みます。データ共有(Data Sharing) タブを選択し、アプリのリストを確認します。設定したいアプリを見つけ、その 編集(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リファラーのプレースホルダーから受け取ったデータを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})
iOS Facebook campaign test (123456789) adgroup_name 広告セット名 広告セットID
{meta_install_referrer_campaign_name}({meta_install_referrer_campaign_id})
iOS - 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={link_token}&tracker_name={link_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}
値が入力されたコールバックの例
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
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