Facebook

MMP Integration

Facebook MMP Integration

Track and measure Facebook mobile Ads, and forward your events to Facebook to optimize your ad campaigns or use them for your retargeting marketings.

Facebook MMP Integration consists of 'Facebook App ID registration' and 'In-app event postback setup'.

  • Facebook App ID: Facebook App ID is required to measure the app performance of your Facebook ads by allowing Airbridge to receive the last touchpoint of the converted event attributed to Facebook Ads.
  • In-app event postback setup: In-app event postback lets you forward Airbridge in-app events to a registered Facebook app, utilize them to optimize your Facebook campaigns, or create a lookalike audience for your retargeting campaigns.

Facebook App ID is mandatory for the Facebook MMP integration, but the 'In-app postback' setup can be optionally set depending on whether your app has implemented Facebook SDK or in-app events are logged via Facebook SDK.

๐Ÿ’ก  Facebook SDK is not mandatory to integrate Airbridge with Facebook. Without Facebook SDK, you can view and measure Facebook Ads performance or send in-app events tracked by Airbridge to Facebook. However, your app requires the Facebook SDK in addition to the Airbridge SDK if you want to configure the deeplink related features such as the 'Deferred Deeplink'.

 

Facebook MMP Integration Setup and Deactivation

To start setting Facebook MMP Integration, firstly turn on the 'Facebook MMP Integration' toggle to ON.

On the other hand, To disable 'Facebook MMP Integration', you can turn off the toggle. Once the toggle is off, Airbridge immediately stops tracking and measuring your Facebook ads. Also, it stops sending in-app events postback to Facebook. Unless you delete your setting, Airbridge saves your Facebook App ID and in-app event postback mapping. So just turn it back on to enable it at any time.

If any changes are made regards the Facebook MMP Integration, Airbridge will display it on the 'Update date' and 'Account' for your information. You can move to the Activity History page to directly check the modified information by clicking the arrow button.

mceclip2.png

 

Facebook App ID registration

Register Facebook App by entering your Facebook App ID. Please refer to the below instruction on how to register your Facebook App ID.

  1. Go to the Facebook AMM page to select your app and mark on the 'agree' checkbox.

    โš ๏ธ If you wish to obtain and use device-level data of Facebook attributed events, you must sign the Facebook AMM(Facebook Advanced Mobile App Measurement) terms.

  2. In the 'My App' page from Facebook for Developers, select and copy your Facebook App ID.
    mceclip5.png
  3. Paste Facebook App ID into the 'Facebook App ID' in the Airbridge dashboard and click the 'Register App' button. Once the integration is completed, Facebook App Id and App name registered in Facebook will be displayed.

    โš ๏ธ The deactivated or testing app cannot be integrated. If App restriction is set in the Facebook app dashboard, only the Facebook App ID will be displayed.

    mceclip8.png
  4. Once the Facebook App ID is registered, you are all done. Live your Facebook Ad campaigns.

From the Facebook App ID is registered, Airbridge sends converted events data (Install and Deeplink Open) to Facebook. For any events attributed to Facebook based on Facebook's attribution model, Airbridge receives the last valid touchpoint.

Therefore, there is no need to create an Airbridge tracking link to track and measure the app performance of Facebook ads besides registering your Facebook App ID.

 

In-App Event Postback Setting

In-App Event postback setting enables you to send in-app events tracked by Airbridge to a registered Facebook app and leverage these events to optimize your Facebook campaigns or create a lookalike audience for your retargeting campaigns.
You can find all the events forwarded to Facebook on the Facebook Event Manager page.

โš ๏ธ 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 'Note for In-app event postback setting' for more details.

 

In-app Event Postback Setup and Deactivation

Switch on the 'In-app event postback' toggle in the in-app event postback setting page.

โš ๏ธ 'Facebook MMP Integration' toggle must be switched on, and 'Facebook App ID' must be registered before setting in-app event postback.

 

To disable in-app event postback, switch off the 'in-app event postback' toggle. Once stopped, Airbridge stops sending the events to Facebook.

โš ๏ธ Note that deactivation may impact your Facebook ads campaign optimization or lookalike audience creation.

 

Mapping to Facebook Standard Event

Airbridge can transmit your Airbridge standard events or custom events by mapping to predefined Facebook events. For reference, the 24 predefined Facebook events names are:

Facebook Raw Value

Facebook Event Name

AdClick AdClick
AdImpression AdImpression
Contact Contact
CustomizeProduct Customize Product
Donate Donate
fb_mobile_achievement_unlocked Unlock Achievement
fb_mobile_activate_app Activate App
fb_mobile_add_payment_info Add Payment Info
fb_mobile_add_to_cart Add to Cart
fb_mobile_add_to_wishlist Add to Wishlist
fb_mobile_complete_registration Complete Registration
fb_mobile_content_view View Content
fb_mobile_initiated_checkout Initiate Checkout
fb_mobile_level_achieved Achieve Level
fb_mobile_purchase Purchase
fb_mobile_rate Rate
fb_mobile_search Search
fb_mobile_spent_credits Spend Credits
fb_mobile_tutorial_completion Complete Tutorial
FindLocation Find Location
Schedule Schedule
StartTrial Start Trial
SubmitApplication Submit Application
Subscribe Subscribe

 

When enabling the 'in-app event postback' toggle for the first time, Airbridge provides Airbridge standard events pre-mapped with Facebook standard events and custom events. This pre-mapping gives you an easy and quick mapping option.

 

mceclip0.png

๐Ÿ’ก Airbridge automatically sends Install and Deeplink Open events when Facebook App Id is registered and 'Facebook MMP Integration' is activated. This mapping setting is default and can't be changed.

 

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 setting by clicking the 'Reset' icon at any time.

2021-09-29_23-08-50.2021-09-29_23_10_23.gif

Mapping to Facebook Custom Event

Even if your Airbridge events don't match any existing Facebook standard events, Airbridge can forward these events by mapping them to the Facebook custom event.
To do so, select Airbridge standard or custom event to map and choose the category of 'Facebook Custom Event' located at the bottom of the Facebook event list.

mceclip0.png

 

When mapping Airbridge events to Facebook custom events, it is sent to Facebook with the event name modified by the two rules below.

  1. The prefix 'abr_' is added to your event name to distinguish it is Airbridge events.
    e.g.) your event name: complete_tutorial โ†’ Facebook custom event name: abr_complete_tutorial
  2. Facebook doesn't allow to have a period dot(.) on the event name, so any event names contain a period dot(.) will be replaced to underscore(_before forwarding to Facebook. 
    e.g.) your event name: complete.tutorial โ†’ Facebook custom event name: abr_complete_tutorial

 

Limitation on In-app event Postback Setup

Facebook requires to follow the below rules; for any Airbridge events forwarded to Facebook that violate the below rules, Facebook will disregard the data.

[Facebook Event Name Rules]

  1. Maximum 40 characters
  2. Alphabet, number, space, underscores, and hyphens

Therefore, if any Airbridge events with the prefix added violate the above rules, they cannot be mapped nor passed to Facebook.

mceclip1.png

๐Ÿ’ก Want to send events that violated the Facebook event name rule? Alternatively, you can still map your events to one of the unused Facebook standard events.

 

Important Note for In-app Event Postback Setup

If your app has already set up in-app event tracking in your Facebook SDK, this will duplicate your event data in Facebook. Therefore, use either of the below methods to avoid duplicate reporting on Facebook.

  1. Stopping event tracking via Facebook SDK
  2. Disable In-app event postback from the Airbridge dashboard.

๐Ÿ’ก If both Facebook SDK and Airbridge report on a new user installing an app, Facebook will de-duplicate this app install event and count only once.

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:

  1. Go to the Facebook App Dashboard, and select your app.
  2. On the left-hand menu, click ['Setting' > 'Basic Setting'].
  3. 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:

 

Data Mapping between Airbridge and Facebook

Campaign Parameter Mapping

Last touchpoint data from Facebook are mapped to Airbridge data as follows:

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 INSTAGRAM
SubSubPublisher1 Ad format within the platform 
instagram_stories
SubSubPublisher2 Ad related unique ID that user clicked or viewed
23848170884980258
SubSubPublisher3 Whether the install was from Facebook paid channel  TRUE
IsViewThrough Whether the attributed touchpoint was view-through(impression) FALSE

 

Event Name Mapping

Airbridge standard and custom events are mapped to the Facebook custom event as follows:

Event Type

Airbridge Event

Facebook Mapping Default Event 

Facebook Custom Event

Airbridge
Standard Event
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
Custom Event
CUSTOM_EVENT_NAME -
abr_CUSTOM_EVENT_NAME

 

Note that Airbridge Sign-in (App), Sign-out (App), Home Screen (App), Product Catalog (App), and Order Cancel (App) are mapped to Facebook custom events as there are no matching Facebook standard events to map.

Forwarding Uninstall (App) event to Facebook is currently not supported.

 

Viewing Facebook Ad App Performance

You can see Facebook attributed data on the Actuals report and other aggregated reports filtered by 'facebook.business' channel. For device-level(raw data) can be exported via App Raw Data.

See the Campaign Parameter Mapping guide for full details of Facebook touchpoint data.

 

Aggregate-level Data

In line with Facebook Privacy Policy, Airbridge can provide only the data that satisfy certain conditions; Facebook impression data more than 1,000 and Facebook install data more than 100.

If you add 'Group by' to refine your Facebook attributed data, it may violate the above conditions. And if so, the data will be displayed as 'Privacy Block' in your report.

You can remove some of those 'Group By's or extend the date range to satisfy the above condition and avoid data being privacy blocked.

 

mceclip1.png

 

Device-level Data

If you wish to get Facebook attributed device-level data via Airbridge, you must sign the terms for Facebook AMM(Advanced Mobile Measurement).

However, this only includes attributed click-through touchpoint, not view-through(impression) touchpoint. In other words, view-through(impression) touchpoint is provided in aggregated-level only.

โš ๏ธ  Effective October 29th, 2021, Facebook discontinues AMM program and stops providing Facebook attributed click-through data in any device-level data. You can still access aggregated level data on both click-through and view-through data.

 

Cost Integration

Enabling Facebook cost integration gets you the click, impression, and cost data for your Facebook Campaign, Adset, and Ad level.

 

Cost Integration Setup and Deactivation

When an update related to Facebook cost integration occurs, the most recent modification date and the last modified account information that performed the corresponding action are displayed. You can click the arrow icon to quickly move to the Activity History page filtered by its date and 'facebook.business' channel.

 

To Setup Cost Integration

  1. Switch on 'Facebook Cost Integration' toggle.

    ๐Ÿ’ก Only app owner and marketers can access Facebook MMP integration setup.

  2. Click 'Facebook Login' button, then enter your login credentials

  3. Grant Airbridge access your Facebook ads and related stats.
    mceclip2.png

  4. Select and sync ad accounts you wish to pull cost data.
    mceclip3.png

    โš ๏ธ Once you log in to Facebook, make sure to select ONLY the ad accounts you want to sync.

    โš ๏ธ Among the ad accounts accessible from the logged-in account, the currently linked ad accounts are not shown in the list.

     

  5. After selecting the ad account to be integrated, Airbridge will start getting the data according to the update schedule.

 

To disable Cost Integration

Switching off 'Facebook Cost Integration' toggle will stop pulling cost data from associated ad accounts. Disabling the connection does not impact historical data.

You can always reactivate the cost sync by toggling back on the ' Facebook Cost Integration' as long as you haven't deleted the linked ad accounts; you may have to log in again if you delete the Facebook account from the Airbridge dashboard.

 

To Delete Connected Ad Accounts

If you need to delete any connected ad accounts for any reason, delete them by clicking [ 'Action' > 'Delete' ] on the right-hand menu.

mceclip4.png

 

To Connect Additional Ad Accounts

If you want to connect additional ad accounts to the current account list, click 'Facebook Login' to add. The rest of the process remains the same as the 'Cost Integration Setup' guide.

 

Cost Data

Cost Data Update Cycle

Airbridge gets cost data from Facebook once the 'Facebook Cost Integration' toggle is ON.

Cost data updates every 4 hours(12AM, 4AM, 8AM, 12PM, 4PM, and 8PM), and Airbridge receives data from the last 7 days.

 

Cost Data Sync Status

  • Waiting: New ad account is added and is now waiting for the cost data to be updated. Cost data updates every 4 hours(12AM, 4AM, 8AM, 12PM, 4PM, and 8PM).
  • Active: The integration is up and running. The last time Airbridge successfully updated cost data is displayed.
  • Error: Cost data can't be updated if one of the following happens.
    • Invalid Credential: Login error. Login info changes such as password change may cause this type of error. To resolve this issue, delete the account and re-register it again.
    • No Matching Data: In the latest update, the API has not returned any cost data matching Airbridge campaign attribution data in the last seven days.
    • Facebook API is not responding: In the latest update, Facebook API is not responding to Airbridge.
  • Expired: Cost data will not be updated if one of the following happens.
    • Facebook Token is expired
    • The user deletes access to the Airbridge dashboard app within Facebook.
    • The connected ad account is deactivated

 

Cost Data Type

To view your Facebook cost data, add the below metrics in the Actuals report.

blobid2.png

  • Touchpoint
    • Impression (Channel)
    • Clicks (Channel)
  • Cost
    • Cost (Channel)

๐Ÿ’ก 'Impressions' and 'Clicks' metrics are touchpoint data collected via Airbridge tracking link, and 'Impression (Channel)' and 'Click (Channel)' metrics are touchpoint data directly received from ad-network(Facebook).

 

Notes

When viewing Facebook cost data, be aware of the following:

  • Privacy Block: Due to the Facebook privacy policy, Impression (Channel) data of fewer than 1,000 is masked 'Privacy Block' in the aggregate reports. Refer to 'Note for Aggregate-level Data' for more details.
  • Cost Data Discrepancy: Slight data discrepancy may occur due to its update cycle(every 4 hours). Also, while Airbridge pulls the cost data of the last seven days, Facebook may update the cost older than seven days for various reasons such as ad spend payback and so on.
  • Campaign parameter name change: After cost integration, changing your campaign, ad set, or ad name may impact conversion data mapping. We highly recommend you not modifying campaign parameter names.
  • Currency: We recommend setting up the same currency type between Airbridge and Facebook. Otherwise, Cost (Channel) data reflects the currency type you set in your Facebook Ad account.
  • Unexposed cost data: Facebook cost data is available in the campaign, ad set, and ad level. So it is natural that you won't find cost data for the fields not related to the campaign, ad set, and ad creative.
    blobid0.png
    Group by Campaign ID

    blobid1.png
    Group by Campaign ID and Event Category

 

Agency Access

App owners and marketers are accessible to the Facebook setup menu, but agencies cannot access or control any of the Facebook settings in the Airbridge dashboard at the moment.
Airbridge plans to support a function where an app owner or marketer can grant agencies access to the Facebook setup menu.

 

 

 

 

 

Was this article helpful?
0 out of 0 found this helpful