adjust-icon

Facebook Pixel集成

Facebook 像素是 Facebook 的网页专用数据分析工具。自 Facebook SDK v4.34 起,您可以在应用的 webview 中记录像素事件。您也可以将 Facebook 像素事件转化为 Facebook 应用事件。为此,请使用 Hybrid Mobile App Events。

您现在可以在 Adjust SDK 中使用 Facebook Pixel了,无需集成 Facebook SDK。

示例应用

Facebook 集成

Facebook App ID

要开始使用 Facebook Pixel,请按照下列步骤操作:

Facebook iOS SDK 指南中说明的一样,您需要进行下列操作,将 Facebook App ID 添加至应用:

  1. 在 Xcode 中,右键点击项目的Info.plist文件,然后选择 Open As -> Source Code
  2. 请在最终</dict>元素之前将下列 XML 片段插入文件正文:
Info.plist
<dict>
<key>FacebookAppID</key>
<string>{your-app-id}</string>
</dict>

用应用的 App ID 替换{your-app-id} 。您可以在 Facebook 应用面板中找到 App ID。

Facebook Pixel 配置

请参阅 Facebook 的 Pixel 集成指南,按照其中说明操作。Javascript 代码应当以如下形式呈现:

<!-- 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 -->

下一步,更新您的 Facebook Pixel代码。请前往 Update Your Pixel 一节,找到 Hybrid Mobile App Events 指南 ,按照其中说明操作。

fbq('init', <your_pixel_id>);
fbq('set', 'mobileBridge', <your_pixel_id>, <your_fb_app_id>);

Adjust SDK 集成

增强 (Augment) web view

请查看 iOS web view应用集成指南进行操作。在加载 Web View bridge时,添加对 augmentHybridWebView 方法的调用。

- (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];

事件名称注册

Adjust web bridge SDK 会将 Facebook Pixel 事件转化为 Adjust 事件。

要使用该功能,请将 Facebook 像素映射到具体的 Adjust 事件。您也可以配置一个默认 Adjust 事件识别码。要使用默认识别码,您需要在启动 Adjust SDK 及记录任何像素事件之前添加识别码。这包括从 Facebook 像素配置中复制粘贴的 fbq('track', 'PageView'); 事件。

要映射事件,请在 config 实例上调用addFbPixelMapping方法。将 Facebook 事件名称和 Adjust 事件识别码用作参数。您需要在初始化 Adjust SDK 前进行该调用。

adjustConfig.addFbPixelMapping("fb_mobile_search", adjustEventTokenForSearch);
adjustConfig.addFbPixelMapping(
"fb_mobile_purchase",
adjustEventTokenForPurchase,
);
Pixel 事件名称Facebook 应用事件名称
View Contentfb_mobile_content_view
搜索fb_mobile_search
AddToCartfb_mobile_add_to_cart
Add To Wishlistfb_mobile_add_to_wishlistt
InitiateCheckoutfb_mobile_initiated_checkout
AddPaymentInfofb_mobile_add_payment_info
Purchasefb_mobile_purchase
CompleteRegistrationfb_mobile_complete_registration

如果 Adjust SDK 无法找到特定事件的默认事件识别码,就会记录下警告信息。

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.

如果您没有设置映射,则可以设置默认 Adjust 事件。为此,请在初始化 Adjust SDK 之前调用adjustConfig.setFbPixelDefaultEventToken(defaultEventToken);