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 安卓 SDK 指南中说明的一样，您需要进行下列操作，将 Facebook App ID 添加至应用：

1. 添加名为facebook_app_id的新字符串。将 Facebook App ID 添加为值。

2. 打开strings.xml文件。路径示例：/app/src/main/res/values/strings.xml .

3. 打开AndroidManifest.xml 。

4. 向 manifest 添加一个 uses_permission 元素：

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

5. 将一个 meta-data 元素添加至 application 元素：

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

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 指南 ，按照其中说明操作。

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

Adjust SDK 集成

增强 (Augment) web view

请查看 安卓 web view 应用集成指南，按照其中说明操作。在加载 Web View bridge时，添加对 augmentHybridWebView 方法的调用。

AdjustBridge.registerAndGetInstance(getApplication(), webview);

到达该步骤时，请将返回的实例保存为adjustBridgeInstance的形式。然后借助保存的实例像这样注册 Facebook 界面：

adjustBridgeInstance.registerFacebookSDKJSInterface();

事件名称注册

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,
);

如果 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); 。