常见问题

您集成 Facebook SDK 之后,如果未禁用应用事件自动记录功能,系统将为事件管理工具自动记录和收集特定的应用事件。如要关闭自动记录或收集功能,可在应用代码中作出相应更改或在应用面板(或事件管理工具)中的“应用事件”下切换相应开关。请注意,如果 AutoLogAppEventsEnabled 标记的值与开关值发生冲突,我们将以“为 Facebook SDK 自动记录事件”开关的值为准。如要详细了解系统会收集哪些信息以及如何禁用应用事件自动记录功能,请参阅应用事件自动记录

限制

一个应用最多可创建 1,000 个不重复的事件名称。如果超出此上限,在记录时,系统会显示 100 Invalid parameter 错误。

如果您想要移除废弃的事件,可以按照帮助中心的说明停用事件。

开发者创建的事件数量超出上限的一个典型原因在于:他们未充分利用参数,在应使用参数记录某项内容时,他们却使用了单个事件。例如,开发者应使用适用于关卡数的参数 level 来记录单个完成关卡的事件,而不是每当用户完成一个关卡(例如完成关卡 1、完成关卡 2 等)就记录一个单独的事件。

An event can have up to 25 parameters. This doesn't just mean for each call, but for all invocations using that event name.

If you need to remove obsolete parameters - you can deactivate parameters by following the instructions in our help center.

事件和参数的名称必须包含 2 至 40 个字母数字字符。

每个参数值的长度不得超过 100 个字符。

实现

应用事件为以下渠道提供 SDK: iOSAndroidFacebook 游戏平台以及 Unity。此外,应用事件还支持通过 图谱 API 在服务器之间传递事件。

您可以定义要捕获的自定义事件,然后就能在 Facebook 分析 面板中看到这些事件。系统最多支持记录 1,000 个自定义事件名称,而且能够记录的事件数量没有上限。但是,广告报告仅会显示标准应用事件。您创建的任何自定义应用事件都将记录为“移动应用其他操作”。

对于 Unity 游戏,您可以使用 Unity 版 SDK 来记录应用事件。对于在原生应用中使用网页视图的其他渠道,可选择利用 应用事件 API 将事件从您的服务器传递到 Facebook 服务器。

对于开发者,一般情况下使用 Facebook SDK 更易于集成应用事件。Facebook SDK 有助于减少所需的编码工作量,并且可以提供有关您应用的实用元数据,例如应用版本和应用名称。只需投入少量的开发时间,开发者便可使用 SDK 自动提供的多种指标,例如使用时间、会话数量和中断情况。该 SDK 也能够收集 Android 广告主编号或 IDFA(如果您将应用事件与广告归因关联使用),并为您处理限制广告追踪。但是,该 SDK 的不足之处在于,如果您想添加其他事件,则需要发布新版本应用。对绝大多数开发者而言,SDK 是最佳选择。

如果开发者不愿意因为集成应用事件或添加其他应用事件而发布经过更新的应用版本,API 解决方案可能更适合他们。对于混合型网页应用的开发者,与 API 集成可能也会更方便。但是,API 解决方案需要您亲自处理限制广告追踪,以及收集 IDFA 和 Android 广告主编号。另外,API 解决方案也不会提供应用使用情况指标,而在 SDK 解决方案中,系统会自动收集这些指标。如果开发者想追踪其他指标(例如应用版本、应用名称、使用时间、会话数和中断情况),则需要亲自确认这些指标,并通过 API 以自定义参数的形式传回这些指标。

If you are currently using an MMP to track installs or other actions in your app, you can request that your MMP passes those events server to server to Facebook.

您可以在您的应用中同时使用 MMP SDK 和 Facebook SDK,但您必须确保不会向这两个 SDK 传递同一事件两次,否则会造成重复计数。

通过 应用广告帮手 ,您可以测试应用内的应用事件,确保应用可以向 Facebook 发送事件。

a. 打开 应用广告帮手

b. 在“选择应用”中,选择您的应用,然后选择“提交”。

c. 前往页面底部,选择“测试应用事件”。

d. 启动应用,并发送事件。网页将显示该事件。

Facebook 会依照数据使用政策处理您的数据。我们会使用此信息来完善广告定位和投放功能,同时也会用于改善 Facebook 中的其他用户体验,包括动态和搜索内容的排名功能。

  • 忘记为购买或购买相关的事件传递货币或值
  • 将小数点放置在错误位置
  • 在数值中使用英文逗号而非小数点
  • 使用猜测的“平均”订单价值来硬编码转化价值,而非传递其实际价值

广告问题

如果您记录的是自定义事件,而不是标准事件,该事件会显示在广告报告的“移动应用其他操作”下,而不会往下细分。

是的,您可以使用应用事件构建自定义受众。您可以点击此处,了解操作说明。

可以,我们会以最低成本将您的广告投放给最有可能采取至少一次特定操作的用户。创建通过 API 针对特定应用事件进行优化的移动应用安装广告组。此类广告组与常规移动应用安装广告组或移动应用使用率广告组相似,但存在以下区别:

  • optimization_goal:设置为 OFFSITE_CONVERSIONS
  • billing_event:设置为 IMPRESSIONS
  • promoted_object:将 custom_event_type 设置为要优化的应用事件。
  • 对于移动应用使用率广告,建议针对除“启动应用”之外的标准应用事件进行优化。这些选项可通过广告管理工具和 API 使用。请参阅 市场营销 API > 广告组

    自动记录应用内购买事件

    首先,确保您在应用中已安装 Android 版 Facebook Core SDK v4.36 或更高版本。其次,前往应用面板中的“设置”>“基本”。在 Android 设置中,将自动记录应用内购买事件开关切换到

    对于 4.27 到 4.35 版本,请确保您在启用应用期间调用了 callbackManager.onActivityResult() ,并开启了自动记录应用内购买事件开关(位于 应用面板的 Android 设置部分)。

    First, ensure that you have v3.22 (or higher) of the Facebook iOS SDK installed within your app. Second, ensure that you are calling the ActivateApp method.

    1. 前往“ 我的应用”。
    2. 选择您的应用。
    3. 点击左侧导航栏中的“设置”选项卡。
    4. 找到标为“Android”的部分。
    5. 自动记录 Android 平台的应用内购买事件设置为
    1. 前往“ 我的应用”。
    2. 选择您的应用。
    3. 点击左侧导航栏中的“设置”选项卡。
    4. 找到标为“iOS”的部分。
    5. 启用“自动记录 iOS 平台的应用内购买事件”开关。

    启用应用内购买事件记录功能后,系统将追踪以下应用事件:发起结账、购买和取消购买。

    自动记录可以减少准确记录应用事件所需的时间。显式记录需要手动收集事件,并确认需要传递的参数,而自动记录可帮您处理这些内容。例如,系统会自动记录以下参数:产品编号、数量、总金额、货币、产品名称和产品说明。另外,如果您使用的是 3.22 或更高的版本,系统会为您自动启用此功能,无需您向 App Store 提交经过更新的客户端。

    如果您目前正在记录应用内购买事件,则无需启用此功能。但是,如果您希望采用此功能,您将需要停止显式记录应用内购买事件,否则您可能会在报告中看到重复计数。

    否,此功能仅适用于应用内购买事件。

    We recommend logging all events that are relevant to your app. You can use this best practices guide as a starting point to determine what events would be relevant for your business.