Skip to main content

Facebook Ads Integration & Meta Install Referrer

This article will guide you through integrating Facebook Ads with the Apptrove platform, allowing you to track and optimize your app promotion campaigns seamlessly.

Updated over a week ago

Overview

Start tracking the effectiveness of your Facebook mobile app ads with Apptrove’s simple one-time setup.
By following the steps below, you can enable attributions for any app you want to promote through your Facebook account.

Step 1: Retrieve your Facebook App ID

  • To create your Facebook app ID, you need to log in to your Meta for Developers portal.

  • Navigate to the My Apps section and click Create App. Choose 'Business' as the app type and fill in the required details.

  • Once created, select the app from the dashboard and copy the App ID displayed at the top of the screen.

    Integration with Facebook Ads

    Integration with Facebook Ads

Step 2: Add App ID and Decryption Key to Trackier

  • In Apptrove, go to Integrated Partner > Facebook and click Continue with Facebook.

  • A pop-up will appear where you need to enter your Facebook user ID and password.

  • Navigate to App Settings > Advanced in the Facebook Developer portal to locate the decryption key. Add the decryption key you find here to the Apptrove panel.

    Integration with Facebook Ads

    Integration with Facebook Ads

Note:

It is important to provide a Decryption Key for Meta Ads integration. If a Decryption Key is not generated already, please go to the link mentioned below to generate one from the Meta dashboard:

Tracking Events in Facebook Ads

If you want to track in-app events in addition to installs, follow these steps:

  • Log in to your Meta Business Suite.

  • Navigate to Data Sources > Events Manager > Settings.

  • Click on “Add” and create a new dataset.

  • Open the Event Manager and locate your dataset ID under the Settings tab.

    Integration with Facebook Ads

  • Dataset ID will be reflected in the topmost portion of “Settings”.

    Integration with Facebook Ads

  • To generate an access token, scroll to “Set Up Direct Integration” and click “Generate Access Token”.

    Integration with Facebook Ads

Your dataset ID will be the same as your existing pixel ID if an existing pixel is linked to your dataset. Examples of when an existing pixel is linked to your dataset include when your pixel was automatically converted to a dataset.

To learn more about datasets, visit Meta Business Help.
​​

Note:

  • Please make sure to link your application inside the settings for this arrangement to work as expected.

  • Also, please make sure the "Activate partner" button is active on Trackier's Facebook integration page.

Agencies Integrating with Facebook on Behalf of Advertisers

Agencies can now integrate with Facebook on behalf of an advertiser. All they need to do is:

  • Take the details of the App ID, Decryption Key, and Dataset ID (if needed).

  • Log in to their Facebook Ad Account.

  • Create a campaign in the format "campaign name_agencyid". This will ensure that the agency is attributed on a campaign basis.

Integration with Facebook Ads

Optimizing Your Facebook Ad Campaigns

Each campaign has a specific goal, such as increasing app installs or maximizing an in-app event (e.g., purchases). When creating an Ad Set:

  • Choose the optimization goal.

  • ​If optimizing for in-app events, select "Maximize Number of Events".

  • Under App Event, choose the relevant event name to improve targeting and results.

Integration with Facebook Ads

Once you complete these steps, your integration with Facebook Ads will be fully set up, and you will be able to track conversions in Apptrove.


Meta Install Referrer Setup in Apptrove

Apptrove supports Meta Install Referrer to improve install attribution accuracy for Meta (Facebook) campaigns. This integration allows Apptrove to decrypt and read install referrer data provided by Meta via the Google Play Store.

Important:

Meta Install Referrer support is available only from Apptrove React Native SDK version 1.6.75 and above.
Older SDK versions do not support this feature.

Step 1: Update the Apptrove SDK

Ensure that your app is using a supported Apptrove SDK version.

  • React Native SDK: Version 1.6.75 or later is required

  • If your app is using an older SDK version, Meta Install Referrer will not work

We strongly recommend upgrading to the latest SDK version before proceeding.

Step 2: Configure Facebook App ID in Apptrove SDK

To enable Meta Install Referrer attribution, you must configure your Facebook App ID in the Apptrove SDK.

Apptrove introduced a new method to support this configuration.

Implementation example (React Native):

trackierConfig.setFacebookAppId("your_facebook_app_id")

This step is mandatory for Meta Install Referrer attribution to function correctly.

Step 3: Android App Configuration

Depending on your app setup, additional Android configuration may be required to allow Meta Install Referrer data to be passed correctly.

If your app uses custom Android configurations or wrappers, ensure that:

  • The Apptrove SDK initialization is correctly applied

  • No restrictions block install referrer data from being received

If unsure, validate the setup with your engineering team.

Step 4: Share Install Referrer Decryption Key with Apptrove

To allow Apptrove to decrypt Meta Install Referrer metadata, you must share the Install Referrer Decryption Key from Meta.

Steps to retrieve the key from Meta:

  1. Log in to Meta for Developers

  2. Go to My Apps

  3. Select the relevant app

  4. Navigate to App Settings → Basic

  5. Scroll to the Android section

  6. Locate Install Referrer Decryption Key

  7. Share this key securely with the Apptrove team

Admin access to the Meta Business Manager that owns the app is required to perform this step.

Summary

To enable Meta Install Referrer with Apptrove:

  • Update to React Native SDK v1.6.75+

  • Configure your Facebook App ID using setFacebookAppId()

  • Ensure Android app setup supports referrer data

  • Share the Install Referrer Decryption Key from Meta with Apptrove

Once completed, Apptrove will be able to accurately decrypt and attribute the Meta install referrer data.

Broaden your knowledge:


We are delighted to have assembled a world-class team of experienced professionals who are ready to take care of your queries and answer any questions you may have.
Feel free to reach out to us at any time by emailing us at support@apptrove.com or by using the in-platform chat feature. We'd love to hear from you!

Did this answer your question?