Facebook pixel integration

A Facebook pixel is a web-only analytics tool from Facebook. As of v4.34 of the Facebook SDK, you can record pixel events in an app’s webview. You can also convert Facebook Pixel events into Facebook App events. To do this, use Hybrid Mobile App Events.

It’s also now possible to use a Facebook pixel with the Adjust SDK, without integrating the Facebook SDK.

Example app

• iOS example app

Facebook integration

Facebook App ID

To start working with Facebook pixels, follow the steps below:

As described in Facebook’s iOS SDK guide you will need to add your Facebook App ID to the app by doing the following:

1. In Xcode, right click on your project’s Info.plist file and select Open As —> Source Code.
2. Insert the following XML snippet into the body of your file just before the final </dict> element:

<dict>
  <key>FacebookAppID</key>
  <string>{your-app-id}</string>
</dict>

Replace {your-app-id} with your app’s App ID. You can find this in the Facebook App Dashboard.

Facebook pixel configuration

Follow Facebook’s guide on how to integrate the Facebook pixel. The Javascript code should look something like this:

<!-- Facebook Pixel Code -->
<script>
   !function(f,b,e,v,n,t,s)
   fbq('init', <YOUR_PIXEL_ID>);
   fbq('track', 'PageView');
</script>
<!-- End Facebook Pixel Code -->

Next, update your Facebook pixel code. You can find the instructions in the Hybrid Mobile App Events guide under Update Your Pixel.

fbq('init', <YOUR_PIXEL_ID>);
fbq('set', 'mobileBridge', <YOUR_PIXEL_ID>, <YOUR_FB_APP_ID>);

Adjust SDK integration

Augment the web view

Follow the integration guide for iOS web view apps. Add a call to the augmentHybridWebView method when loading the Web View bridge.

- (void)viewWillAppear:(BOOL)animated {
    UIWebView *webView = [[UIWebView alloc] initWithFrame:self.view.bounds];
    /// or with WKWebView:
    /// WKWebView *webView = [[WKWebView alloc] initWithFrame:self.view.bounds];

    /// add @property (nonatomic, strong) AdjustBridge *adjustBridge; on your interface
    self.adjustBridge = [[AdjustBridge alloc] init];
    [self.adjustBridge loadUIWebViewBridge:webView];
    /// optionally you can add a web view delegate so that you can also capture its events
    /// [self.adjustBridge loadUIWebViewBridge:webView webViewDelegate:(UIWebViewDelegate*)self];

    /// or with WKWebView:
    /// [self.adjustBridge loadWKWebViewBridge:webView];
    /// optionally you can add a web view delegate so that you can also capture its events
    /// [self.adjustBridge loadWKWebViewBridge:webView wkWebViewDelegate:(id<WKNavigationDelegate>)self];
    [self.adjustBridge augmentHybridWebView];

Event name registration

The Adjust web bridge SDK translates Facebook pixel events into Adjust events.

To use this feature, you need to map Facebook pixels to specific Adjust events. You can also configure a default Adjust event token. To use a default token, you need to add the token before starting the Adjust SDK and recording any pixel event. This includes the copy-pasted fbq('track', 'PageView'); event from the Facebook pixel configuration.

To map events, call the addFbPixelMapping method on your config instance. Use the Facebook event name and Adjust event token as parameters. You need to call this before you initialize the Adjust SDK.

adjustConfig.addFbPixelMapping("fb_mobile_search", adjustEventTokenForSearch);
adjustConfig.addFbPixelMapping(
   "fb_mobile_purchase",
   adjustEventTokenForPurchase,
);

The Adjust SDK logs warnings if it can’t find a default event token for certain events.

There is not a default event token configured or a mapping found for event named: 'fb_mobile_search'. It won't be measured as an adjust event.

You can also set a default Adjust event if you don’t have mapping configured. To do this, call adjustConfig.setFbPixelDefaultEventToken(defaultEventToken); before initializing the Adjust SDK.