Meta 像素集成

Meta 像素是 Meta 推出的仅限网页的分析工具。自Facebook SDK v4.34 起，您可以在应用的 webview 中跟踪像素事件。您也可以将 Meta 像素事件转化为 Meta 应用事件。为此，请使用 Hybrid Mobile App Events。

现在，您可以在 Adjust SDK 中使用 Meta 像素，无需集成 Facebook SDK。

操作前须知

适用条件

您需要针对平台下载并设置 Adjust SDK。按照下方链接中的说明操作，开始使用功能。

⚙️ iOS / 安卓

示例应用

Meta 集成

Meta App ID

要开始使用 Meta 像素请，按照下列步骤操作：

iOS Web View
安卓 Web View

如Meta 的 iOS SDK 指南中所述，您需要进行下列操作，将 Meta App ID 添加至应用中

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

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

Meta 像素配置

请参阅 Meta 指南，了解如何集成 Meta 像素。Javascript 代码形式如下：

<!-- id="sl-md26371c0"                   ><script>
  !function(f,b,e,v,n,t,s)
    ...
  fbq('init', <YOUR_PIXEL_ID>);
  fbq('track', 'PageView');
</script>
...
<!-- id="sl-mddb6d10b"                       >

下一步更新 Meta 像素代码。您可以在Hybrid Mobile App Events 指南中的 更新像素​ 部分找到相关说明。

fbq('init', <your_pixel_id>);
fbq('set', 'mobileBridge', <your_pixel_id>, <your_fb_app_id>);
重要提示:
您需要调用 init，随后立即调用set 。Meta 提供的代码片段包含一个track方法。您可以使用该方法在调用init方法后立刻跟踪页面查看事件。如需跟踪查看事件，您需要在init和track之间调用set。

Adjust SDK 集成

增强 (Augment) web view

iOS
安卓

请查看 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 会将 Meta 像素事件转化为 Adjust 事件。

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

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

adjustConfig.addFbPixelMapping('fb_mobile_search',adjustEventTokenForSearch);
adjustConfig.addFbPixelMapping('fb_mobile_purchase',adjustEventTokenForPurchase);
请注意:
在跟踪 fbq('track', 'Search')和fbq('track', 'Purchase')时，上述示例将发生匹配。Adjust 无法访问 Facebook SDK 与 Javascript 事件之间的完整映射。

已知像素事件

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

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

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