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 Meta Install Referrer (MIR)
  • The Google Play Install Referrer (GPIR)
Note:
Both install referrers provide more information about app installations originating from Meta applications such as Facebook and Instagram. However, MIR supports view-through and non-same session click-through attribution, which isn't supported by GPIR. Using MIR is highly recommended to get the most out of your Meta campaigns.

Before you begin

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

Requirements

MIR

GPIR

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.

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

Warning:
If you enable both MIR and GPIR, you will receive information from both sources. Adjust deduplicates MIR and GPIR information in Datascape, but you will still receive both sets of data in your raw data exports. You should prioritize MIR data over GPIR data.

What data isn't shared?

Meta does not send any of the following metadata:

The following metadata are available only when using MIR:

  • View-through conversions.
  • App events happening in Android app stores outside of the Google Play Store (for example, Galaxy Store and Amazon Appstore).

Set up the Install Referrer solution

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

1. Update your Meta credentials in Adjust

To enable Adjust to decrypt the referrer metadata, you need to share your Install Referrer Decryption Key. This is a 64-character string made up of lowercase letters (a-f) and numbers (0-9). One decryption key is available per Meta app ID.

Example: 9fc19e01a8ac4db1404c23b1ea656047f9fcd5cb3befb0cf650a32ed919893ce

Find your Decryption Key

To find your Decryption Key, follow these steps.

  1. Log into the Meta developer portal.
  2. Navigate to My Apps in the top right corner.
  3. Select the app for which you would like to access your decryption key.
  4. Select Settings > Basic.
  5. Scroll to the Android section.
  6. Look for Install Referrer Decryption Key under the Google Play header.

Add your Decryption Key in Adjust

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

  1. Under Campaign Lab, select Ad Networks.
  2. Search for Facebook and select the link to go to the overview page.
  3. Select the Data Sharing tab to see a list of apps.
  4. Find the app you want to configure and select the Edit button ().
  5. Enter your Decryption key for each platform you want to configure.

2. Add Meta referrer placeholders to your callbacks

Adjust can use certain placeholders to send decrypted data from Meta in your raw data exports. To receive this information, update your callback URL or CSV definition with the necessary placeholders.

Available placeholders

MIR
GPIR
PlaceholderDescription
{meta_install_referrer}The whole content of Meta install referrer, in decrypted format.
{meta_install_referrer_campaign_group_name}The "campaign_group_name" value from the whole Meta install referrer content.
{meta_install_referrer_campaign_group_id}The "campaign_group_id" value from the whole Meta install referrer content.
{meta_install_referrer_campaign_name}The "campaign_name" value from the whole Meta install referrer content.
{meta_install_referrer_campaign_id}The "campaign_id" value from the whole Meta install referrer content.
{meta_install_referrer_adgroup_id}The "adgroup_id" value from the whole Meta install referrer content.
{meta_install_referrer_adgroup_name}The "adgroup_name" value from the whole Meta install referrer content.
{meta_install_referrer_ad_id}The "ad_id" value from the whole Meta install referrer content.
{meta_install_referrer_account_id}The "account_id" value from the whole Meta install referrer content.
{meta_install_referrer_ad_objective_name}The "ad_objective_name" value from the whole Meta install referrer content.
{meta_install_referrer_publisher_platform}The "publisher_platform" value from the whole Meta install referrer content.

Reports and placeholder mapping

To align the data received from Meta referrer placeholders to our reporting, Adjust uses the following mappings.

MIR
GPIR
Adjust attribution fieldMeta reportingPlaceholderExample value
network_namePublisher platform
  • {meta_install_referrer_publisher_platform}
Meta Installs
campaign_nameCampaign name
Campaign ID
  • {meta_install_referrer_campaign_group_name}({meta_install_referrer_campaign_group_id})
 Android Facebook campaign test (123456789)
adgroup_nameAd Set Name
Ad Set ID
  • {meta_install_referrer_campaign_name}({meta_install_referrer_campaign_id})
 Android - US - Basic Ad Set (234567890)
creative_nameAd Name
Ad ID
  • {meta_install_referrer_adgroup_name}({meta_install_referrer_adgroup_id})
 Summer banner (345678901)

How Adjust displays network_name

Example callbacks

Example callback URL

MIR
GPIR
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}

Example callback populated with values

MIR
GPIR
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

For installs not attributed to Meta

If a referrer is attached to an install and the final attribution is awarded to another partner that is not Meta, you still receive the referrer information in your data.

MIR
GPIR
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