跳到主要内容

配置 Facebook 上报

本文旨在介绍如何设置 Facebook 分析平台，让您的游戏可以直接将分析数据上报至 Facebook。

前提条件​

1. 配置 Facebook 登录

根据以下文旨的步骤为您的游戏配置 Facebook 登录：

2. 获得追踪用户及设备信息的用户许可

在 iOS 14.5 及更高版本中，Apple 要求应用程序在收集 IDFA 时获得用户许可，以加强对 iOS 用户的隐私管理。

  1. 在 iOS 的 AppTrackingTransparency.framework 中添加依赖关系。

  2. 在 Info.plist 文件中，为显示的玩家同意提示文本和配置添加 NSUserTrackingUsageDescription。

  3. 调用 static void RequestTrackingAuthorization(); 来实现获取玩家同意收集 IDFA 的提示。

    注意

    此界面专为 iOS 设计并使用 Xcode 12 或更高版本开发，与运行 iOS 14.5 或更高版本的设备兼容。该界面会发出一次性请求，系统会保存用户的选择。除非用户卸载并重新安装应用程序，否则不会再出现任何通知。

步骤1：配置事件上报​

Facebook SDK 会默认开启自动的事件追踪功能（包括应用安装，应用启动等）和客户端 ID（Android 为 Google 提供的广告 ID，iOS 为 IDFA）采集功能。上报的数据一般只有事件名，也可以自行添加参数，在管理端可以看到上报数据的时间，设备系统，应用版本，价值，参数信息。管理端地址

自动报告事件​

以便自动报告注册和登录事件，启用 INTLConfig.ini 里的 ANALYTICS_AUTH_REPORT_ENABLE，在 Facebook App Dashboard 的 Android 和 iOS 平台中启用 自动登录应用内事件。 图片：Facebook 事件 图片：Facebook 事件2

如果想要关闭自动上报和采集，请参见 Facebook 官网的 Android 文档 和 iOS 文档 进行关闭。

手动报告事件​

Facebook 要求事件和参数必须由 2 至 40 个字母数字字符组成，且每个参数值的长度不能超过 100 个字符。

入门指引 – Android 版/入门指引 – iOS 版

详细信息，请参见 Facebook 官网的 参考说明。

漏斗事件​

注意

从 Player Network SDK V1.20 开始支持

在 INTLConfig.ini 的 ANALYTICS_REPORT_FUNNEL_CHANNEL 配置中增加 Facebook 渠道，Player Network SDK 会将漏斗事件同步上报至 Facebook 渠道。

[ANALYTICS]
ANALYTICS_REPORT_FUNNEL_CHANNEL = Facebook

可以参考 管理端查看上报数据 查看上报事件。

步骤2：初始化分析模块​

初始化分析模块，再调用 ReportEvent 开始 Facebook 上报数据。

数据上报验收​

管理端查看上报数据​

注意

调用事件上报接口，上报的事件会有一定程度的延迟（跟网络环境，Facebook 侧网络波动等因素有关），所以经常会出现有上报事件名称，但是没有详细数据的情况。这个是正常现象，一般建议收到上报成功的回调后半小时左右再查看。

进入 Facebook Events Manager，根据上报的事件名称点进对应的上报事件查看数据。

图片：Facebook 事件报告

事件具体信息可以点击对应事件下方的 查看近期事件。

图片: facebook_app-ad_error 图片: facebook_app-ad_error

Facebook 事件分为标准事件与自定义事件。

  • 标准事件：目前可查看的标准事件有应用安装和启动应用事件，在成功初始化后会进行数据上报，可在标准事件中看到对应事件的事件总数增加。
  • 自定义事件：在通过应用进行自定义事件的上报后，可以在自定义事件中找到对应的事件名称，并且事件总数增加。

验收用例 1​

  • 子功能模块：Reporting
  • 特性点：Event Reporting
  • 测试点：Facebook 管理端登录，填写自定义事件，安装 app，启动 app
  • 前提条件：前提条件：初始化分析模块
  • 操作步骤/输入
    1. 首次进行 Facebook 登录
    2. 填写自定义事件名及参数
    3. 初次安装成功进入 app
    4. 启动 app
    5. 管理端，导出数据查看上报事件
  • 预期输出信息上报成功，检查如下：
    1. 填写自定义事件名及参数事件：上报数量 +1
    2. 初次安装成功进入 app 事件：上报数量 +1
    3. 启动 app 成功事件：上报数量 +1

验收用例 2​

  • 子功能模块：ReportRevenue
  • 特性点：Facebook 支付事件上报
  • 测试点：请求 ReportRevenue 后查询上报（Facebook）
  • 前提条件：网络连接正常
  • 操作步骤/输入
    1. 请求 ReportRevenue
    2. eventName = （可自定义）, spChannels = Facebook, Currency = USD, Revenue = 100
    3. Facebook查询上报事件
    4. DD平台 查询 AnalyticsReportRevenue 事件
  • 预期输出信息上报成功，检查如下：
    1. 联网后 Facebook 相关事件统计 +1，点击事件详情展示可展示 USD100 相关 value.
    2. DD平台 成功查询 methodName 为 AnalyticsReportRevenue 与 method_id=715 事件上报。

验收用例 3​

  • 子功能模块：ReportRevenue
  • 特性点：Facebook 支付事件上报
  • 测试点：断网状态下请求 ReportRevenue 后查询上报（Facebook）
  • 前提条件：断开网络状态
  • 操作步骤/输入
    1. 请求 ReportRevenue
    2. eventName = （可自定义）, spChannels = Facebook, Currency = USD, Revenue = 1000
    3. 重新连接网络
    4. Facebook查询上报事件
    5. DD平台 查询 AnalyticsReportRevenue 事件
  • 预期输出信息上报成功，检查如下：
    1. 联网后 Facebook 相关事件统计 +1，点击事件详情展示可展示 USD1000 相关 value
    2. DD平台 成功查询 methodName 为 AnalyticsReportRevenue 与 method_id=715 事件上报。

错误码​

错误码错误信息
1未知错误
4应用程序请求限制已达到
10应用程序没有此操作的权限。
17用户请求限制已达到
100无效参数
200权限错误

更多信息，请参见 Facebook 错误码。

最后于 更新