Channel Integration - Meta Ads

Airbridge supports various implementation methods to integrate with Meta ads. Follow the instructions below to implement the Meta ads channel integration.

Integration Setup

With the Meta ads channel integration, you can measure the performance of Facebook and Instagram ads. You can also send in-app events collected by Airbridge to Meta ads for retargeting and campaign optimization.

For the channel integration, you must provide your App ID to Airbridge. The in-app event postback settings can be configured optionally depending on whether the Meta SDK is installed on your app or not.

Attention

Meta SDK installation is not required to implement Meta ads channel integration with Airbridge. However, if you want to use deferred deep linking, the Meta SDK must be installed on your app.

Also note that deferred deep linking is available for campaigns targeting Android apps or iOS apps with versions earlier than 14.5 only. Due to Apple's App Tracking Transparency framework, deferred deep linking won't work on iOS versions 14.5 and later, regardless of the Meta SDK installation or the user's response to the ATT prompt on data tracking.

Provide the App ID and the decryption key to Airbridge

The 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]>[Meta ads]. In the [Channel Integration] tab, switch on the [Meta ads Channel 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.

App ID

App IDs of deactivated apps or testing apps cannot be used for integration.

4. Providing the Install Referrer Decryption Key is optional. Refer to this article to learn how to find the Decryption Key.

Attention

To collect the Meta Install Referrer, the Airbridge Android SDK setup must be completed by your developer before entering the Decryption Key into the Airbridge dashboard.

In-app event postback setup

Attention

The in-app event postback setting allows the Airbridge SDK to send in-app events to Meta ads. If you have already set up app event tracking in your Facebook SDK, event duplication may occur.

With the postback setup, you can send in-app events collected by Airbridge to Meta and use the Airbridge data to optimize your Meta campaigns.

Enable in-app event postback 

To enable the in-app event postback, the [In-app Event Postback] toggle must be switched on. Note that the [Meta ads Channel Integration] toggle must be switched on, and the App ID must be entered to enable the in-app event postback.

To disable the postback, switch off the [In-app Event Postback] toggle. When the toggle is switched off, Airbridge stops sending in-app events to Meta.

Attention

Note that disabling the postback may impact your Meta ad campaign optimization.

Event mapping

Note

When the MMP Integration toggle is switched on, and the App ID is submitted to the Airbridge dashboard, the following event 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 you send via postbacks must be mapped with Meta ad events. Airbridge provides a pre-set mapping list. They can be identified with the "Preset" tags. To edit the event mapping, click Edit.

You can 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 [Preset] button at any time.

 

Sending Airbridge events to Meta ads using custom event names

You can send Airbridge events to Meta using a custom event name if there is no Meta Standard Event that corresponds to the particular Airbridge event. To do so, select an Airbridge event from the list and choose "Meta ads Custom Event," located at the bottom of the Meta ads event drop-down.

The Meta ads custom event names are made available in the Meta ads event drop-down list for all Airbridge events. The following rules apply to converting the Airbridge event name to the Meta ads custom event name.

  1. The prefix abr_ is added.

    (e.g., Airbridge event name: complete_tutorial → Meta ads custom event name: abr_complete_tutorial)

  2. Periods will be replaced with an underscore.
    (e.g., Airbridge event name: complete.tutorial → Meta ads custom event name: abr_complete_tutorial)

Note that Meta ads cannot process event names with special characters or contain more than 40 characters.

 

How to prevent event duplication

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 event logging via Meta SDK, follow these steps:

1. Sign in to your Meta for Developers account and find your app.

2. Navigate to [Setting]>[Basic Setting].

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.

Aggregated Event Measurement (AEM)

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 measuring 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.

Attribution Rule Setup

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.

How to View Meta Ads Campaign Data in Airbridge

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.

Attention

Was this page helpful?

Have any questions or suggestions?