将 Facebook SDK 与 Singular SDK 结合使用
在同一应用程序中实施 Facebook SDK 和 Singular SDK 的综合指南,涵盖配置要求、数据准确性注意事项和集成最佳实践。
集成概述
Singular 作为移动测量合作伙伴
如果在应用程序中集成了 Singular SDK,则无需使用 Facebook SDK 在 Facebook 平台上跟踪 Facebook 归因或查看事件。作为 Facebook 认证的移动测量合作伙伴(MMP),Singular SDK 可处理所有归因和事件跟踪要求。
Singular MMP 功能:
- 归因跟踪:自动跟踪来自 Facebook 营销活动的安装和转化情况
- 事件转发:将应用内事件发送到 Facebook,以优化营销活动
- 数据报告:提供包括 Facebook 在内的所有渠道的统一归因数据
- 认证集成:经 Facebook 批准的测量解决方案,具有完整的 API 访问权限
何时使用 Facebook SDK
有效用例
虽然 Singular SDK 可处理归因和分析,但一些企业会选择集成 Facebook SDK,以获得除测量之外的其他 Facebook 特定功能。
社交功能
Facebook 登录
使用户能够使用 Facebook 凭据进行身份验证,简化入职流程并减少注册摩擦。
Facebook 分享
允许用户将应用程序内容直接分享到 Facebook,从而提高有机覆盖率和病毒式增长潜力。
高级广告功能
Facebook 移动应用程序安装广告
获取Facebook 移动应用安装广告的高级功能,包括
- 动态产品广告:通过个性化产品推荐重新定位用户
- 受众网络:将营销活动从 Facebook 平台扩展到合作伙伴应用程序
- 自定义受众:基于 Facebook 用户数据创建受众
- 高级定位:利用 Facebook 的详细定位选项
Facebook 平台集成
图 API 访问
与 Facebook Graph API 集成,以便向 Facebook 社交图读取和写入数据。
信使集成
通过 Facebook Messenger 实现客户支持或参与活动的沟通。
集成决定:只有当您的应用程序需要除归因和分析之外的特定 Facebook 平台功能时,才集成 Facebook SDK。仅出于测量目的,Singular SDK 可提供完整的功能。
数据准确性注意事项
在同一应用程序中同时使用 Facebook SDK 和 Singular SDK 时,必须进行适当配置,以保持数据准确性并防止出现差异。
常见数据问题
事件重复
如果没有适当的配置,事件可能会两次发送到 Facebook(一次来自 Facebook SDK,一次来自 Singular SDK),从而导致事件计数膨胀和报告不准确。
关键问题:重复事件跟踪会导致
- 膨胀的事件计数:Facebook 报告双倍的实际事件,使营销活动性能指标失真
- 会话计数不准确:会话数据在 Facebook 平台上出现人为偏高的情况
- 营销活动优化问题:Facebook 算法接收到不正确的活动优化信号
- 预算分配问题:不准确的数据会影响广告系列的预算分配
解决方案要求
配置策略
为了在使用两个 SDK 时保持数据的准确性,请禁用 Facebook SDK 中的自动事件记录,同时允许 Singular SDK 处理所有测量和转发到 Facebook 的事件。
集成架构:
| 组件 | 责任 | 配置 |
|---|---|---|
| 奇异 SDK |
|
标准配置 无需特殊更改 |
| Facebook SDK |
|
禁用自动日志记录 防止重复发送事件 |
实施步骤
按照以下步骤使用 Facebook SDK 和 Singular SDK,同时保持数据准确性并防止事件重复。
步骤 1:禁用 Facebook SDK 事件记录
特定平台配置
默认情况下,Facebook SDK 会自动将事件发送到 Facebook 平台。 必须禁用这种自动记录功能,以防止重复跟踪事件。
配置方法
按照《iOS 应用程序事件入门》中 "禁用自动记录事件 "一节中的 Facebook 官方说明操作。
Info.plist 配置
在Info.plist 文件中添加以下密钥,以禁用自动事件记录:
<key>FacebookAutoLogAppEventsEnabled</key>
<false/>
验证步骤
-
检查 Info.plist:验证密钥添加是否正确,值是否设置为
false - 测试构建:构建并运行应用程序以确保配置已应用
- 监控事件:使用 Facebook Analytics 面板验证 Facebook SDK 未发送事件
重要:禁用自动记录后,Facebook SDK 将不会向 Facebook 发送任何事件。Singular SDK 将处理所有转发到 Facebook 平台的事件。
配置方法
按照《Android 应用程序事件入门》中 "禁用自动记录事件 "一节中 Facebook 的官方说明进行操作。
AndroidManifest.xml 配置
在AndroidManifest.xml文件的<application> 标签中添加以下元数据:
<application>
...
<meta-data
android:name="com.facebook.sdk.AutoLogAppEventsEnabled"
android:value="false" />
...
</application>
Alternative:程序化配置
或者,在应用程序类中以编程方式禁用自动记录:
import com.facebook.FacebookSdk;
import com.facebook.appevents.AppEventsLogger;
public class MyApplication extends Application {
@Override
public void onCreate() {
super.onCreate();
// Disable automatic event logging
FacebookSdk.setAutoLogAppEventsEnabled(false);
}
}
import com.facebook.FacebookSdk
import com.facebook.appevents.AppEventsLogger
class MyApplication : Application() {
override fun onCreate() {
super.onCreate()
// Disable automatic event logging
FacebookSdk.setAutoLogAppEventsEnabled(false)
}
}
验证步骤
-
检查 AndroidManifest:验证元数据添加是否正确,值是否设置为
false - 构建应用程序:清理并重建应用程序,确保配置已应用
- 监控事件:使用 Facebook Analytics 面板验证 Facebook SDK 未发送事件
重要:选择 AndroidManifest 配置或编程配置,而不是两者兼而有之。为保持一致性,建议使用 Manifest 配置。
第 2 步:配置 Facebook 归因
奇异合作伙伴配置
禁用 Facebook SDK 事件记录后,按照标准设置步骤在 Singular 平台中配置 Facebook 归因。
设置说明:按照Facebook Ads Attribution Integration指南中的步骤 1-4 完成 Facebook 归因配置。
配置清单:
- 添加 Facebook 应用 ID:在 Singular 平台中,导航至归因 → 合作伙伴配置并添加 Facebook 应用 ID
- 配置归因设置:设置归因窗口和测量偏好
- 映射事件:配置Singular和Facebook之间的事件映射
- 启用回传:设置从 Singular 到 Facebook 的事件回传,以优化营销活动
第 3 步:验证配置
测试程序
完成配置后,使用 Singular 和 Facebook 测试工具验证正确实施。
奇异 SDK 验证
- 测试控制台:使用Singular 测试控制台验证事件跟踪是否正确
- 事件日志:检查 Singular 导出日志以确认记录的事件
- 归属验证:在 Singular 报告中验证 Facebook 安装的归因是否正确
Facebook 平台验证
- 事件管理器:打开 Facebook 事件管理器并验证 Singular 中出现的事件
- 事件计数比较:比较 Singular 和 Facebook 的事件计数,确保无重复
- 会话跟踪:验证会话计数是否与预期值一致,没有膨胀
数据准确性检查
| 检查 | 预期结果 |
|---|---|
| 事件计数 | 事件在 Facebook 中仅出现一次(来自 Singular),不重复 |
| 会话计数 | Facebook 显示正常的会话计数,不会人为膨胀 |
| 归因数据 | Singular 报告通过正确的营销活动数据显示 Facebook 安装情况 |
| Facebook 功能 | Facebook 登录、分享和其他功能在应用程序中正常工作 |
验证时间轴:初始设置后需要 24-48 小时才能使数据在两个平台上正确流动。 一些数据最初可能会出现延迟。
故障排除
同时使用 Facebook SDK 和 Singular SDK 时的常见问题和解决方案。
常见问题
症状
- Facebook 中的事件计数是预期值的两倍
- 同一事件以相同的时间戳出现多次
- Facebook 营销活动优化受到夸大指标的影响
原因
未禁用 Facebook SDK 自动事件记录功能,导致 Facebook SDK 和 Singular SDK 向 Facebook 平台发送相同的事件。
解决方法
-
在 iOS Info.plist 中验证
FacebookAutoLogAppEventsEnabled设置为false -
在 Android AndroidManifest.xml 中验证
com.facebook.sdk.AutoLogAppEventsEnabled设置为false - 清理并重建应用程序,确保配置已应用
- 监控 Facebook 事件管理器 24 小时,以确认问题已解决
症状
- Facebook 安装未出现在 Singular 报告中
- 安装归因于 "有机 "而非 Facebook 营销活动
- 在 Singular 分析中缺少活动数据
原因
在 Singular 平台中未将 Facebook 配置为归因合作伙伴,或 Facebook 应用程序 ID 丢失/不正确。
解决方法
- 导航至 Singular → 归因 → 合作伙伴配置并搜索 Facebook
- 验证输入的 Facebook 应用 ID 是否正确
- 确认 Facebook 集成已启用并处于活动状态
- 检查归因窗口设置是否符合营销活动要求
- 查看Facebook 广告归因整合指南以了解完整设置
症状
- Facebook 登录失败或返回错误
- Facebook 分享按钮不起作用
- 应用程序中无法使用 Facebook SDK 功能
原因
自动事件日志已禁用,但 Facebook SDK 未正确初始化或配置。
解决方法
- 确认应用程序中的 Facebook SDK 已正确初始化(禁用自动事件记录不会影响 SDK 初始化
- 检查应用程序设置中的 Facebook 应用程序 ID 和配置
- 查看 Facebook SDK 文档,了解具体功能要求
- 独立测试 Facebook 功能,以隔离集成问题
注意:禁用自动事件日志只会影响事件跟踪,而不会影响登录和共享等 Facebook 平台功能。 这些功能应能继续正常工作。
其他资源
Facebook 和 Singular SDK 集成的完整文档。
文档链接
Singular 资源
- Singular SDK/S2S 入门--完整的 SDK 集成指南
- Facebook 广告归因整合- Facebook 合作伙伴配置
- Facebook 数据连接器- 成本和营销活动数据汇总
- 测试 Singular SDK 集成- 验证和故障排除程序
Facebook 开发人员资源
- 适用于 iOS 的 Facebook 应用程序事件- iOS SDK 配置和事件记录
- 适用于 Android 的 Facebook 应用程序事件- Android SDK 配置和事件记录
- Facebook 移动应用程序安装广告- 高级广告特性和功能
支持
获取帮助
有关 Facebook 和 Singular SDK 集成的其他帮助,请联系 Singular 支持部门或咨询您的客户成功经理。