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
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:
- In Xcode, right click on your project’s
Info.plistfile and select Open As —> Source Code. - 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>);You need to call init and then set immediately afterward. The snippet provided by Facebook contains a track method. You can use this method to record a page view event right after you call the init method. To record the view event, you need to call set between init and track.
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 {
WKWebView *wkWebView = [[WKWebView alloc] initWithFrame:self.view.frame]; /// add @property (nonatomic, strong) AdjustBridge *adjustBridge; on your interface self.adjustBridge = [[AdjustBridge alloc] init]; [self.adjustBridge augmentHybridWebView]; [self.adjustBridge loadWKWebViewBridge:wkWebView];
}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 above example would match when tracking fbq('track', 'Search') and fbq('track', 'Purchase'). Adjust doesn’t have access to the full map between Facebook SDK and Javascript events.
| Pixel event name | Facebook app event name |
|---|---|
| ViewContent | fb_mobile_content_view |
| Search | fb_mobile_search |
| AddToCart | fb_mobile_add_to_cart |
| AddToWishlist | fb_mobile_add_to_wishlistt |
| InitiateCheckout | fb_mobile_initiated_checkout |
| AddPaymentInfo | fb_mobile_add_payment_info |
| Purchase | fb_mobile_purchase |
| CompleteRegistration | fb_mobile_complete_registration |
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.
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
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:
- In Xcode, right click on your project’s
Info.plistfile and select Open As —> Source Code. - 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>);You need to call init and then set immediately afterward. The snippet provided by Facebook contains a track method. You can use this method to record a page view event right after you call the init method. To record the view event, you need to call set between init and track.
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 above example would match when tracking fbq('track', 'Search') and fbq('track', 'Purchase'). Adjust doesn’t have access to the full map between Facebook SDK and Javascript events.
| Pixel event name | Facebook app event name |
|---|---|
| ViewContent | fb_mobile_content_view |
| Search | fb_mobile_search |
| AddToCart | fb_mobile_add_to_cart |
| AddToWishlist | fb_mobile_add_to_wishlistt |
| InitiateCheckout | fb_mobile_initiated_checkout |
| AddPaymentInfo | fb_mobile_add_payment_info |
| Purchase | fb_mobile_purchase |
| CompleteRegistration | fb_mobile_complete_registration |
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.