Facebook pixel

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

• Android example app

Facebook integration

Facebook App ID

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

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

1. Add a new string with the name facebook_app_id. Add your Facebook App ID as the value.

2. Open your strings.xml file. Example path: /app/src/main/res/values/strings.xml.

3. Open AndroidManifest.xml.

4. Add a uses-permission element to the manifest:

   <uses-permission android:name="android.permission.INTERNET"/>

5. Add a meta-data element to the application element:

   <application android:label="@string/app_name" ...>
   ...
   <meta-data android:name="com.facebook.sdk.ApplicationId" android:value="@string/facebook_app_id"/>
   ...
   </application>

Facebook pixel configuration

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

1
<!-- Facebook Pixel Code -->
2
<script>
3
   !function(f,b,e,v,n,t,s)
4
     ...
5
   fbq('init', {YOUR_PIXEL_ID});
6
   fbq('track', 'PageView');
7
</script>
8
...
9
<!-- 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.

1
<script>
2
   !function(f,b,e,v,n,t,s)
3
     ...
4
   fbq('init', {YOUR_PIXEL_ID});
5
   fbq('set', 'mobileBridge', {YOUR_PIXEL_ID}, {YOUR_FB_APP_ID});
6
</script>

Adjust SDK integration

Augment the web view

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

1
AdjustBridge.registerAndGetInstance(getApplication(), webview);

When you reach this step, save the returned instance as something like adjustBridgeInstance. You can then use this to register the Facebook interface like so:

1
adjustBridgeInstance.registerFacebookSDKJSInterface();

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.

1
adjustConfig.addFbPixelMapping("fb_mobile_search", adjustEventTokenForSearch);
2
adjustConfig.addFbPixelMapping(
3
   "fb_mobile_purchase",
4
   adjustEventTokenForPurchase,
5
);

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

1
There is not a default event token configured or a mapping found for event named: 'fb_mobile_search'. It won't be tracked 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.