- User Guide
- Integration
- Meta Ads
Channel Integration - Meta Ads
Track and measure your Meta ads and send postbacks to Meta for campaign optimization.
The Facebook MMP Integration consists of 2 steps: providing the Facebook App ID to Airbridge and setting up the in-app event postback.
Facebook App ID: The Facebook App ID is required to measure the app performance of your Meta ads by allowing Airbridge to receive the last touchpoint of the converted event attributed to Facebook Ads.
In-app event postback setup: The in-app event postback lets you forward Airbridge in-app events to a registered Facebook app, use them to optimize your Facebook campaigns, or create a lookalike audience for your retargeting campaigns.
Providing the Facebook App ID to Airbridge is required for the MMP integration, but the postback setup is optional.
Attention
Facebook MMP integration can be conducted without Facebook SDK integration. However, the deferred deep linking only works with Facebook SDK integration.
Deferred deep linking is available for Android apps or iOS apps with versions earlier than 14.5. Due to the ATT(App Tracking Transparency) privacy guidelines, deferred deep linking won't work on iOS versions 14.5 and later, regardless of the Facebook SDK integration or the ATT state of the user.
The Facebook App ID is required for the integration, whereas the Install Referrer Decryption Key is optional. By providing the Install Referrer Decryption Key to Airbridge, you can implement the Google Play Install Referrer (GPIR) and the Meta install referrer (MIR) to gain enhanced visibility into your meta campaign performance.
1. Navigate to [Integrations]>[Ad Channel Integration]>[Facebook Business]>[Integration]. Switch on the [Facebook MMP integration] toggle.
2. Sign in to your Meta for Developers account and find your app. Copy the App ID.
3. Paste the App ID into the Facebook App ID field in Airbridge. Once the App ID is submitted, you can measure your meta ad campaigns in Airbridge.
4. Providing the Install Referrer Decryption Key is optional. Refer to this article to learn about the Install Referrer.
Attention
To collect the Meta install referrer data, the Airbridge Android SDK must be properly configured by your developer before entering the decryption key.
With the postback setup, you can send in-app events tracked by Airbridge to Meta and leverage Airbridge data to optimize your Meta campaigns and create audiences for retargeting campaigns.
You can find the events sent via postback on the Facebook Event Manager page.
Attention
The in-app event postback setting allows the Airbridge SDK to send in-app events to Facebook without implementing Facebook SDK. If you have already set up app event tracking in your Facebook SDK, this may duplicate your event data on Facebook.
Please check out this article for more details.
Switch on the [In-app event postback] toggle on the in-app event postback setting page.
Note
The Facebook MMP Integration toggle must be switched on, and the Facebook App ID must be provided before setting up the in-app event postback.
To disable the postback, switch off the toggle. When the toggle is switched off, Airbridge stops sending data to Facebook.
Attention
Note that disabling the postback may impact your Meta ad campaign optimization.
Airbridge events you send via postbacks must be mapped with Meta ad events. Airbridge provides a pre-set mapping list.
Note
When the MMP Integration toggle is switched on and the Facebook App ID is provided to Airbridge, the following data is automatically sent to Meta ads. This is not a configurable option. The event names in the parenthesis are the Meta ad event names.
Install (Install App)
Deeplink Open (Activate App)
Deeplink Pageview (abr_deeplink-pageview)
Airbridge events (Preset) | Meta ads events |
|---|---|
Open (App) | Activate App |
Add To Cart (App) | Add to Cart |
Sign-up (App) | Complete Registration |
Product View (App) | View Content |
Order Complete (App) | Purchase |
Search Results (App) | Search |
Sign-in (App) | abr_sign_in |
Sign-out (App) | abr_sign_out |
Home Screen (App) | abr_home_screen |
Product Catalog (App) | abr_product_catalog |
Order Cancel (App) | abr_order_cancel |
Note
When the MMP Integration toggle is switched on and the Facebook App ID is provided to Airbridge, the following data is automatically sent to Meta ads. This is not a configurable option. The event names in the parenthesis are the Meta ad event names.
Install (Install App)
Deeplink Open (Activate App)
Deeplink Pageview (abr_deeplink-pageview)
You can keep the default mapping of Airbridge standard events, modify the mapping setting, or delete unnecessary event mappings. Even if you change any of the default mapping settings, you can revert to the default version by clicking the [reset] icon at any time.
If your Airbridge events don't match with any existing Meta ads standard events, Airbridge can send these events by mapping them with Meta ads custom events.
To do so, select Airbridge standard or custom event to map and choose "Facebook Custom Event," which is located at the bottom of the Meta ads event list.
When Airbridge events are mapped to Facebook custom events, they are sent to Meta with the event name modified by the two rules below.
The prefix
abr_is added to your event name to distinguish it from Airbridge events.(e.g., Your event name: complete_tutorial → Meta ads custom event name: abr_complete_tutorial)
Meta doesn't allow a period in the event name, so any event names containing a period will be replaced with an underscore before forwarding to Meta.
(e.g., Your event name: complete.tutorial → Meta ads custom event name: abr_complete_tutorial)
Airbridge events forwarded to Meta must adhere to the Meta ads event name rules:
Maximum 40 characters.
Only letters, numbers, spaces, underscores, and hyphens are allowed.
Airbridge events that don't adhere to the naming rules won't be mapped properly or not sent to Facebook.
In situations where you can't follow Meta's naming rules, you may map your events to one of the unused Facebook standard events as an alternative option.
If you are already using in-app event tracking via Facebook SDK, duplicate events will occur. Therefore, use either of the below methods to avoid duplicate reporting on Facebook.
Stop event tracking via Facebook SDK.
Disable in-app event postback from the Airbridge dashboard.
Install event deduplication supported by Meta ads
Meta supports deduplication for app installs only. Even if you have installed the Meta SDK, the installs won't be duplicated when Airbridge sends app install events to Meta.
We highly recommend that you track your app events via Airbridge SDK only, as this allows you to send them to other ad networks besides Facebook. To disable event logging via Facebook SDK, follow these steps in the Facebook App dashboard:
Go to the Facebook App Dashboard, and select your app.
On the left-hand menu, click [Setting]>[Basic Setting].
Select the OS type, and switch off the "Log In-App Events Automatically" toggle.
To disable Automatic Event Logging in the Facebook SDK in your app code, follow these instructions below:
Attention
User data sent to Meta may include IP Addresses. Before switching on the AEM toggle, check whether the AEM protocol does not violate any data-sharing policies of the third-party platforms you are using.
The Aggregated Event Measurement (AEM) is Meta’s protocol that allows for the measurement of web and app events from iOS 14 and later devices.
When the toggle is switched on in Airbridge, Airbridge sends user data to Meta regardless of whether a user has opted in or out for data tracking to enable Meta’s AEM for App Promotion Campaigns.
To learn more about AEM, refer to the section.
If you have installed the Meta SDK, duplicate events may be aggregated. You can choose from the following methods to prevent event duplication.
Disable automatic event logging of the Meta SDK
Switch off the [In-app Event Postback] toggle in the Airbridge dashboard
Using the Airbridge SDK to collect app events allows for easier sharing of event data with other ad channels. Therefore, we recommend collecting app events through the Airbridge SDK instead of the Meta SDK.
To disable automatically logged events using the Meta SDK, follow the steps below.
1. Sign in to Meta for Developers and select your app.
2. Navigate to [Settings]>[Basic Settings].
3. Navigate to your app OS and disable automatically logged events. For more guidance, refer to the Meta ads documentation for iOS and Android.
Install event deduplication supported by Meta ads
Meta supports deduplication for app installs only. Even if you have installed the Meta SDK, the installs won't be duplicated when Airbridge sends app install events to Meta.
Select the [Attribution Rules] tab to configure the attribution rules, including the lookback window and attribution window. Click Go to edit page to edit the settings.
Refer to this article to learn about the attribution window in Airbridge.
You can track engaged views from Meta ads campaigns in Airbridge. Select “facebook.business” as the channel to access any Meta ads campaign data.
Engaged views are available for video ads. For more information about engaged views, refer to this article.
Meta provides different data sets for different campaigns. The scope of data available is subject to change depending on Meta’s data policy. Refer to the following.
Airbridge Data | Facebook Data | Example |
|---|---|---|
Channel | facebook.business | facebook.business |
Campaign | Facebook Campaign Name | AOS Install Campaign |
CampaignType | In the case of AAA campaign operation, 'Automated App Campaign' will be displayed. | Automated App Campaign |
AdGroup | Facebook Ad Set Name | Female user purchased in last 7 days |
AdCreative | Facebook Ad Name | Video |
CampaignID | Facebook Campaign ID | 23847486484930218 |
AdGroupID | Facebook Ad Set ID | 23847486490951350 |
AdCreativeID | Facebook Ad ID | 23847486494102155 |
Content | Campaign goal | PRODUCT_CATALOG_SALES |
SubPublisher | Platform name | |
SubSubPublisher1 | Ad format within the platform | instagram_stories |
SubSubPublisher2 | Ad-related unique ID that the user clicked or viewed | 23848170884980258 |
SubSubPublisher3 | Whether the install was from a Facebook paid channel | TRUE |
IsViewThrough | Whether the attributed touchpoint was view-through (impression) | FALSE |
Airbridge Event | Facebook Standard Event | Facebook |
|---|---|---|
Open (App) | Activate App | abr_open |
Sign-up (App) | Complete Registration | abr_sign_up |
Sign-in (App) | abr_sign_in | abr_sign_in |
Sign-out (App) | abr_sign_out | abr_sign_out |
Home Screen (App) | abr_home_screen | abr_home_screen |
Product Catalog (App) | abr_product_catalog | abr_product_catalog |
Search Results (App) | Search | abr_search_results |
Product View (App) | View Content | abr_product_view |
Add To Cart (App) | Add to Cart | abr_add_to_cart |
Order Complete (App) | Purchase | abr_order_complete |
Order Cancel (App) | abr_order_cancel | abr_order_cancel |
Airbridge Event | Facebook Standard Event | Facebook |
|---|---|---|
CUSTOM_EVENT_NAME | - | abr_CUSTOM_EVENT_NAME |
Note that the Airbridge events, the Sign-in (App), Sign-out (App), Home Screen (App), Product Catalog (App), and Order Cancel (App) events are mapped to Facebook custom events as there are no matching Facebook standard events to map.
Note
Sending uninstall event data to Meta is currently not supported.
You can view the engaged view data from Meta ads campaigns in Airbridge. The engaged view data is available for video ads. For more information about engaged views, refer to this article.
In the Airbridge reports
In the Actuals Report and Trend Report, select an app event as a metric. Then, configure the filter like the following:
Channelisfacebook.businessTouchpoint Interaction TypeisEngaged View
When Touchpoint Interaction Type is not selected as a GroupBy or filter, the engaged view data is aggregated with the impression data for reporting.
Engaged View is not available as a metric.
Note that as per Meta’s privacy policy, some of the Meta ads campaign data for the set date range is masked in Airbridge. For more information, refer to this article.
In raw data file
As per Meta’s privacy policy, the attribution data cannot be accessed in its raw data format.
Note
The Meta ads AEM attribution data will be made available from October 10, 2024.
You can view Meta’s Aggregated Events Measurement (AEM) attribution data in Airbridge, which is the data used by Meta to attribute conversions that occurred on devices of users who opted into Apple’s ATT framework by the AEM protocol. For more details, refer to this section of this article.
In the Airbridge reports
In the Actuals Report and Trend Report, select an app event as a metric. Then, configure the filter like the following:
Channelisfacebook.businessTouchpoint Identity Matching Typeisprobabilistic
When Touchpoint Identity Matching is not selected as a GroupBy or filter, the AEM attribution data is aggregated as part of your Meta ad campaigns' click data for reporting. Therefore, if you want to visualize the Meta ad campaign click data by whether the user who converted opted in to or out of ATT, select Touchpoint Identity Matching as a GroupBy or filter.
Note that as per Meta’s privacy policy, some of the Meta ads campaign data for the set date range is masked in Airbridge. As a result, the AEM attribution data may not be aggregated in the Airbridge reports. For more information, refer to this article.
In raw data file
As per Meta’s privacy policy, the attribution data cannot be accessed in its raw data format.
Following Meta’s privacy policy, Meta ads campaign data that meet both conditions below for the set date range is masked in Airbridge:
If the sum of impressions and engaged views from Meta ads campaigns is smaller than 1,000
If the meta ads campaign data is imported to Airbridge through channel integration and cost integration
The masked data will be displayed as follows instead:
Display | Description |
|---|---|
Privacy Block | All data is masked; only "Privacy Block" will be displayed |
+α, ±α | Data is partially masked |
Below are some approaches you may try if you want the masked data to be made visible in the Airbridge reports.
Change or extend the data range of the report.
Change GroupBys and filters or remove some of them.
With the deprecation of Meta's Advanced Mobile Measurement (AMM) program, user-level attribution data is no longer available in raw data and only available in aggregate data on Airbridge reports.
When switching on the AEM toggle in Airbridge, Airbridge starts sending user data to Meta. The user data may include IPs. It is advised to check the data-sharing policies of your third-party platforms.
If you are sending data via server-to-server integration, make sure the user identifiers and IPs are sent. Otherwise, the AEM won’t be available for your Meta campaigns.
The AEM can be used for Meta re-engagement campaigns regardless of whether the AEM toggle is switched on or off in Airbridge.
Was this page helpful?