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.
Step 2: Add App ID and Decryption Key to Apptrove
In Apptrove, go to Partner Directory > 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 > Basic in the Facebook Developer portal to locate the decryption key. Add the decryption key you find here to the Apptrove panel.
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.
Dataset ID will be reflected in the topmost portion of “Settings”.
To generate an access token, scroll to “Set Up Direct Integration” and click “Generate Access Token”.
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.
Deduplication of Events on Meta by Event ID
If your app sends the same in-app event to Meta through multiple sources (such as the Meta SDK and Apptrove via CAPI, Meta may receive duplicate copies of the same event. This can lead to discrepancies in event counts between Meta Ads and Apptrove.
To help prevent this, Apptrove supports Event Deduplication by allowing you to pass a unique Event ID to Meta through CAPI.
How It Works
During the Meta integration setup, you can configure:
Deduplication Prop Event ID
Deduplication Prop Event Time
When an in-app event is triggered:
Your app sends the event to Apptrove along with a unique Event ID.
Apptrove forwards the same Event ID to Meta.
If Meta receives another copy of the same event (for example, from the Meta SDK) with the same Event ID, it automatically identifies them as the same event and deduplicates them.
This helps ensure that the same conversion is counted only once in Meta reporting.
Please refer to the screenshot on how the event ID and timestamp should be passed in the SDK.
Note: You can pass the Event ID and Event Time using either the dedicated macros or SDK Param 1-10, provided the same parameter is selected in Facebook partner integration.
Configuring Event Deduplication
Navigate to your Meta Ads partner integration.
Under the Event Deduplication section, select:
Deduplication Prop Event ID – Choose the event parameter that contains the unique Event ID.
Deduplication Prop Event Time – Choose the event parameter that contains the event timestamp.
Save the integration settings.
Important: The selected Event ID parameter must be the same unique identifier that your application sends to Apptrove for each event. Meta uses this value to identify and deduplicate duplicate event copies received from multiple sources.
Default Behavior
If no Deduplication Prop Event ID is selected, Apptrove automatically sends its own Event Log ID as the Event ID.
Similarly, if no Deduplication Prop Event Time is selected, Apptrove sends the Event Log Time by default.
For the most accurate event reporting, configure the Deduplication Event ID and Event Time using the same parameters that are sent from your application to both the Meta SDK and Apptrove. This enables Meta to reliably identify duplicate events and minimize reporting discrepancies.
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.
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.
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:
Log in to Meta for Developers
Go to My Apps
Select the relevant app
Navigate to App Settings → Basic
Scroll to the Android section
Locate Install Referrer Decryption Key
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.
Meta Install Referrer is used to attribute installs that occur after users interact with view-through impressions (ad views without clicks) from Meta campaigns, helping ensure accurate impression-based attribution.
For Datasets, no manual event mapping or event export is required from the user’s end. The flow works automatically: once postbacks are sent from our platform to Meta and Meta starts recognizing those events, all events configured on our panel will automatically begin appearing in the Meta dataset.
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!
