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.

Before you begin

Here’s what you need to know before getting started.

Requirements

• A Meta Decryption Key for the app.
• Users with Admin and Editor permissions can update Meta credentials in Adjust.

GPIR

To enable GPIR, you need to configure the Google Play Install Referrer.

MIR

To enable the MIR plugin, you need to update the Adjust Android SDK to v5 and configure the Meta install referrer plugin.

How it works

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.

1. When a user installs your app, the install referrer collects referral data from the installation source.
2. Meta shares this encrypted data using the install referrer’s API.
3. 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.

What data isn't shared?

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).

Set up the install referrer

To set up the install referrer solution and receive campaign-level details from Meta, follow these steps.

Share your Meta credentials with Adjust

To enable Adjust to decrypt the referrer data, provide your install referrer Decryption Key.

Find your 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.

1. Open you App Dashboard.
2. Select the relevant app.
3. Select Settings > Basic.
4. Scroll to the Android section.
5. Copy the Install Referrer Decryption Key.

Add your Decryption Key in Adjust

To add your Decryption Key in Adjust, follow these steps.

1. Open Campaign Lab > Partners.
2. Search for Facebook and select it to open the overview page.
3. Select the Data Sharing tab for a list of apps.
4. Find the app you want to configure and select the Edit button ().
5. In the Enable data sharing for Facebook section, select Edit.
6. Paste the Decryption Key you copied in the previous step in the Decryption Key (Optional) field.
7. Click the Save button.

Add Meta referrer placeholders to your callbacks

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.

Available placeholders

Reports and placeholder mapping

Adjust uses the following mappings to align the data received from Meta's referrer placeholders with our reporting.

How Adjust displays network_name

Adjust uses the following logic to report the network_name:

Example callbacks

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