Set up Meta in Adjust
With Adjust’s Meta integration, you can measure the performance of your marketing efforts on Facebook, Facebook Messenger, Instagram, and Facebook Audience Network.
Before you begin
Here's what you need to know before getting started.
Requirements
- A registered Meta app
- Adjust SDK v4.0.0 and later to map SDK parameters to network parameters. Follow the guides linked below to use this feature.
iOS / Android / Windows / Unity / React Native / Flutter / Adobe Air / Cordova / Marmalade / Xamarin / Cocos2d-x / Titanium / Corona
Initial setup and review
To set up Facebook for your app:
- Under Campaign Lab, select Partners.
- Select New partner.
- In the Partner selection screen, choose Facebook, and select Next.
- In the App selection screen, choose your app, and select Next.
You can now set your data sharing options and map Adjust events and parameters for Facebook to receive.
Data sharing
Share data with Meta to optimize your campaigns. In the Data sharing screen, follow these steps.
Enable data sharing for Meta
- In the App ID field, enter your Facebook Developer App ID. Your Facebook Developer App ID comes from your Facebook Developer account. This App ID should be the same for all your apps in Adjust, regardless of platform.
- Follow the steps in Meta documentation to find your Meta App ID.
- (Optional) In the Decryption key field, enter your decryption key. This enriches your raw data with certain campaign details for Android apps.
- Follow the steps in Meta documentation to find your Decryption key.
Set your data sharing options
Once you enable data sharing, Adjust sends data from all attribution sources to Meta, by default. This includes data attributed to Meta, data attributed to other networks, and organic data.
You can select to send additional data to Meta. This inclues:
- Ad revenue (from ad views): to send your ad revenue callbacks to Facebook. Your ad revenue data will display in Meta Ads Manager under
fb_mobile_purchase
. This value is hardcoded and cannot be changed. - Uninstalls and reinstalls: to send uninstall and reinstall data to Meta. This is available only if you have purchased Adjust's Uninstall and Reinstall Growth Solution.
- In-app revenue (from in-app purchases): to send detailed revenue data to your Meta Ads Manager dashboard. You need to map events that generate revenue to share this data.
- Parameters: to share all partner parameters configured in the Adjust SDK for any activity you share with Meta. You usually need to map parameters to share this data.
(iOS apps only) Aggregated Event Measurement
Meta's Aggregated Event Measurement (AEM) is a protocol that measures app events from iOS 14.5 and later.
With AEM, you can set up two types of campaign:
Mobile App Install (MAI): for new user acquisition campaigns.
Mobile App Re-Engagement (MAE): for retargeting and re-engagement campaigns directed at existing users.
Adjust's Meta integration automatically supports MAI campaigns. So to get set up for MAI, you need to:
- Set up Meta as a partner.
- Map events that you want to send to Meta for measurement.
If you want to run MAE campaigns, you need to complete these two additional steps:
- Configure an app scheme and enable universal linking in your app.
- Turn on the toggle for Enable AEM for MAE. This indicates to Meta that they can use the Aggregated Event Measurement protocol to measure events from your app.
Once dashboard setup is complete and you're ready to launch your campaign, make sure to also set up your raw data to receive MAE campaign information.
Configure additional integration settings
- Adjust measures reattributions for Meta automatically. With the toggle for Enable reattribution measurement ON, Adjust sends all app sessions to Meta. If Meta can show a qualifying engagement, it will be awarded a reattribution.
- With the toggle for Enable limited data use (CCPA) ON, you stay compliant with CCPA. This signals to Meta when California-based users opt out of having their data disclosed or shared with third parties.
Map events
You can share in-app event data with Meta directly for precise targeting. This is required for event-based bid optimization.
Standard events
To optimize your Meta campaigns on Adjust events, you must link each event to one of the standard Meta events. Below you can see how each available Meta event appears in Adjust. Read Meta's documentation for more information about events.
fb_mobile_level_achieved
fb_mobile_add_payment_info
fb_mobile_add_to_cart
fb_mobile_add_to_wishlist
fb_mobile_complete_registration
fb_mobile_tutorial_completion
fb_mobile_initiated_checkout
fb_mobile_purchase
fb_mobile_rate
fb_mobile_search
fb_mobile_spent_credits
fb_mobile_achievement_unlocked
fb_mobile_content_view
Subscribe
StartTrial
AdClick
AdImpression
Contact
CustomizeProduct
Donate
FindLocation
Lead
PageView
Schedule
SubmitApplication
Custom events
With Meta’s custom event optimization, you can directly optimize custom app events from your campaign in Meta. These custom events are available to most App Install campaigns, including Automated App Ads and Manual App Ads.
All you need to do is link your Adjust events as custom events, and Adjust passes them to Meta for optimization.
If you selected In-app revenue (from in-app purchases) to send detailed revenue data to your Meta Ads Manager dashboard, you need to map events that generate revenue. To map your events, follow these steps.
- Select Map event.
- In the Adjust event list, select the Adjust event that you want to share with Meta.
- In the Partner event list, select the Meta event that corresponds to your Adjust event, or else enter a custom event name.
- Select Apply.
Map parameters
If the raw data parameters you collect in the SDK differ from the values supported by Meta, you can define mappings so that Meta can receive that data.
You can view this section only if you have selected Parameters under Set your data sharing options.
To map your parameters, follow these steps.
- Select Map parameter.
- In the SDK parameter field, enter the name of your Adjust partner parameter as written in the Adjust SDK.
- In the Partner parameter field, enter the corresponding Meta parameter name.
- Select Apply.
Adjust forwards custom event details directly to Meta for any of your linked events.
Review setup
Once you're done, review your selection and enable Adjust measurement for Meta on your app.
- In the Setup review screen, review your settings and make any necessary changes.
- Select Enable network to enable Meta measurement for your app.
Campaign setup in Meta
Now that you've enabled Adjust measurement with Meta for your app, you need to set up your campaign in Meta.
- Set up your campaign in the Meta Ads Manager dashboard.
- Corresponding links are created automatically and appear on the network details page.
- (Optional) Customize your attribution settings from the network details page. This is available only after you set up your campaign in the Meta Ads Manager dashboard.
- Meta only claims click-based sessions in their API, not impression-based sessions. For this reason, Adjust can only measure click-based reattributions for Meta, not impression-based reattributions.