Meta raw data reporting for Android Meta enables advertisers to enrich their raw data for Android using install referrers. Campaign metadata is appended to the install referrer in an encrypted format. To read the metadata, you need to use a Meta-provided decryption key for your app.
There are two supported install referrers that you can use to enrich your raw data:
The Google Play Install Referrer (GPIR) The Meta Install Referrer (MIR) Both install referrers provide more information about app installations originating from Meta applications, such as Facebook and Instagram. However, only MIR supports view-through and non-same session click-through attribution.
Here’s what you need to know before getting started.
Requirements GPIR To enable GPIR, you must configure the Google Play Install Referrer .
MIR To enable the MIR plugin, you must update the Adjust Android SDK to v5 and configure the Meta install referrer plugin
Using the install referrer solution, you can link a user’s in-app activity to their acquisition source for ads served on Android. This enables you to continue to measure the success of campaigns and identify key acquisition trends.
When a user installs your app, the install referrer collects referral data from the installation source. Meta shares this encrypted data using the install referrer’s API. Adjust then extracts this data and decrypts it using your Meta decryption key. A decrypted data string might look like this:
{
"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",
}
You can use placeholders to collect decrypted data in your raw data exports.
If you enable both GPIR and MIR, you will receive information from both sources in your raw data exports. Adjust only deduplicates GPIR and MIR information in Datascape. Our general recommendation is to prioritize
GPIR .
Meta does not send device IDs.
The following data points are available only when you use MIR:
View-through conversions. App events from non-Google Play Android app stores (for example, Galaxy Store and Amazon Appstore). To set up the install referrer solution and receive campaign-level details from Meta, follow these steps.
To enable Adjust to decrypt the referrer data, provide your install referrer Decryption Key.
A Decryption Key is a 64-character string that's available per Meta app ID.
Example: 9fc19e01a8ac4db1404c23b1ea656047f9fcd5cb3befb0cf650a32ed919893ce
To find your Decryption Key, follow these steps.
Open you App Dashboard . Select the relevant app. Select Settings > Basic . Scroll to the Android section. Copy the Install Referrer Decryption Key . To add your Decryption Key in Adjust, follow these steps.
Open Campaign Lab > Partners . Search for Facebook and select it to open the overview page. Select the Data Sharing tab for a list of apps. Find the app you want to configure and select the Edit button ( ). In the Enable data sharing for Facebook section, select Edit . Paste the Decryption Key you copied in the previous step in the Decryption Key (Optional) field. Click the Save button. Adjust can use placeholders to send you decrypted data from Meta. To receive this in your raw data exports, add the relevant placeholders to your callback URL or CSV definition.
{fb_install_referrer}
The whole content of Meta install referrer, in decrypted format. {fb_install_referrer_campaign_group_name}
The "campaign_group_name" value from the whole Meta install referrer content. {fb_install_referrer_campaign_group_id}
The "campaign_group_id" value from the whole Meta install referrer content. {fb_install_referrer_campaign_name}
The "campaign_name" value from the whole Meta install referrer content. {fb_install_referrer_campaign_id}
The "campaign_id" value from the whole Meta install referrer content. {fb_install_referrer_adgroup_id}
The "adgroup_id" value from the whole Meta install referrer content. {fb_install_referrer_adgroup_name}
The "adgroup_name" value from the whole Meta install referrer content. {fb_install_referrer_ad_id}
The "ad_id" value from the whole Meta install referrer content. {fb_install_referrer_account_id}
The "account_id" value from the whole Meta install referrer content. {fb_install_referrer_ad_objective_name}
The "ad_objective_name" value from the whole Meta install referrer content. {fb_install_referrer_publisher_platform}
The "publisher_platform" value from the whole Meta install referrer content.
Adjust uses the following mappings to align the data received from Meta's referrer placeholders with our reporting.
network_name Publisher platform
{fb_install_referrer_publisher_platform}
Meta Installs campaign_name Campaign name Campaign ID
{fb_install_referrer_campaign_group_name} ({fb_install_referrer_campaign_group_id})
Android Meta campaign test (123456789) adgroup_name Ad Set Name Ad Set ID
{fb_install_referrer_campaign_name} ({fb_install_referrer_campaign_id})
Android - US - Basic Ad Set (234567890) creative_name Ad Name Ad ID
{fb_install_referrer_adgroup_name} ({fb_install_referrer_adgroup_id})
Summer banner (345678901)
Adjust uses the following logic to report the network_name
:
“facebook”, “unknown”, or anything else 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}
Example callback populated with values
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
Installs not attributed to Meta If a referrer is attached to an install and the final attribution is awarded to a partner that's not Meta, you still receive the referrer information in your data.
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