无代码应用事件

无代码应用事件是 4.34 版中推出的一项功能,支持使用事件管理工具来添加或移除应用事件,而无需执行代码或发布新版应用。

Android

要求

您必须有下列其中一项:

请查阅 Android 版应用事件入门指南以安装最新版本的 Android 版 Facebook SDK;请查阅升级指南以升级至此 SDK 的最新版本;或者如果您安装的版本介于 4.34 和 4.37 版之间,请打开您的 <your_app> | Gradle Scripts | build.gradle (Module: app) 并将以下代码添加到 dependencies{} 部分,从而添加营销工具包。

implementation 'com.facebook.android:facebook-marketing:[4,5)' 

请务必重新构建项目。

实现无代码应用事件功能

如要启用无代码调试事件,请在 AndroidManifest.xml 中添加以下代码行:

<meta-data
    android:name="com.facebook.sdk.CodelessDebugLogEnabled"
    android:value="true" />

添加应用事件

请前往事件管理工具,通过无代码方式添加您想追踪的应用事件。

  1. 在事件管理工具中,点击新增数据源并在下拉菜单中选择应用事件
  2. 点击使用我们的无代码事件设置工具,然后选择您想添加事件的目标应用。
  3. 点击开始设置,然后选择相应的平台。
  4. 如果这是您第一次使用无代码流程,我们会提供简短教程。阅读教程后,请在移动设备上打开新的应用会话。
  5. 摇晃您的手机,直到屏幕上出现应用版本。
  6. 点击任何元素以便添加应用事件。前往应用的不同页面,选择应用中的各个元素。
  7. 在弹出式菜单中点击保存;您也可以点击“取消”,从而放弃添加事件。
  8. 添加所有事件后,点击检查并完成
  9. 点击测试事件或“保存并退出”。

注意:系统最多可能需要 30 分钟才会在事件管理工具中显示事件。

验证集成

前往应用广告帮手

  • 选择一个应用,然后点击提交
  • 向下滚动到开发者工具部分,然后点击测试应用事件
  • 如果您的应用正在发送 fb_codeless_debug 事件,系统会在表格中列出您选择的测试事件。

注意:仅适用于 Facebook SDK 4.35 及更高版本。

iOS

要求

  • Facebook iOS 完整版 SDK 4.34 至 7.1.1 版
  • Facebook iOS 核心版 SDK 4.38 至 7.1.1 版
  • Facebook iOS 核心版 SDK 4.34 — 4.37 版至 7.1.1 版和营销工具包

限制

请查看 iOS 版应用事件入门指南以安装最新版本的 iOS SDK;请查看升级指南以升级至此 SDK 的最新版本;或者如果您只安装了 4.34 和 4.37 版之间的核心版 SDK,请将以下代码添加到 Podfile,从而添加营销工具包。

pod 'FBSDKMarketingKit' 

请务必运行 pod update,然后运行 pod install --repo-update

实现无代码应用事件功能

如要启用无代码调试事件记录,请在 Xcode 中将应用程序的 .plist 作为代码打开,然后在属性目录中添加以下 XML:

<key>FacebookCodelessDebugLogEnabled</key>
<true/>

添加应用事件

iOS 14 版 App Store Connect

您的应用收集并发送到 Facebook 的事件可能需要您在 App Store Connect 问卷中披露这些数据类型。您应负责确保在应用程序的隐私权政策中反映出这一点。访问 Apple App Store 隐私详情一文,了解您需要披露的数据类型的更多相关信息。

请前往事件管理工具,通过无代码方式添加您想追踪的应用事件。

  1. 在事件管理工具中,点击新增数据源并在下拉菜单中选择应用事件
  2. 点击使用我们的无代码事件设置工具,然后选择您想添加事件的目标应用。
  3. 点击开始设置,然后选择相应的平台。
  4. 如果这是您第一次使用无代码流程,我们会提供简短教程。阅读教程后,请在移动设备上打开新的应用会话。
  5. 摇晃您的手机,直到屏幕上出现应用版本。
  6. 点击任何元素以便添加应用事件。前往应用的不同页面,选择应用中的各个元素。
  7. 在弹出式菜单中点击保存;您也可以点击“取消”,从而放弃添加事件。
  8. 添加所有事件后,点击检查并完成
  9. 点击测试事件或“保存并退出”。

注意:系统最多可能需要 30 分钟才会在事件管理工具中显示事件。

验证集成

前往应用广告帮手

  • 选择一个应用,然后点击提交
  • 前往底部,并选择应用事件测试工具
  • 如果您的应用正在发送 fb_codeless_debug 事件,系统会在表格中列出这些事件。

Unity

您需要使用 Facebook Unity SDK 4.34 或更高版本。

请查看 Facebook Unity SDK 入门指南以安装 Facebook Unity SDK 的最新版本,并采用 Unity iOSUnity Android 中针对特定平台的设置。

启用无代码应用事件

如要启用此选项,请在 Unity Editor 中选择 Facebook | Edit Settings,然后选择 Auto Logging App Events

添加应用事件

在此阶段,您可以按照以下步骤操作,以便通过事件管理工具添加应用事件:

  1. Add Data Source 下,选择 App Events

  2. 点击 User our codeless event setup tool

  3. 选择您要添加事件的目标应用。

  4. 点击 Start Setup,选择您的平台。如果这是您第一次使用无代码流程,我们会提供简短教程。

  5. 阅读教程后,请在移动设备上打开新的应用会话。

  6. 摇晃您的移动设备,直到屏幕上出现应用版本。

  7. 点击应用中的任何元素以便添加应用事件。前往应用的不同页面,选择应用中的各个元素。

  8. Unity Editor 中,点击 Save 以便添加事件。

  9. 添加所有事件后,点击 Review and Finish

  10. 点击 Test EventsSave and Exit

系统最多可能需要 30 分钟才会在事件管理工具中显示事件。在您游戏支持的每个平台(例如 iOS 或 Android 平台)中重复以上步骤。

验证集成

前往应用广告帮手

  • Select an App 下,点击 Submit

  • 选择 App Events Tester

  • 如果您的应用发送 fb_codeless_debug 事件,系统会在表格中显示这些事件。

常见问题

一般问题

1. 如何检查是否已正确集成无代码功能?

在测试设备上启动应用几分钟后,您会在事件管理工具中看到名为 fb_codeless_debug 的事件。

2. 如何关闭无代码功能?

如要关闭无代码应用事件记录功能,请使用无代码事件设置工具,然后移除所有事件。


Android

1. 看到以下构建错误时应该怎样做:
Android SDK build Error:Execution failed for task ':app:processDebugManifest'.> Manifest merger failed : 
Attribute activity#com.facebook.FacebookActivity@theme value=(@android:style/Theme.Translucent.NoTitleBar) 
from AndroidManifest.xml:69:13-72is also present at [com.facebook.android:facebook-android-sdk:4.16.0] 
AndroidManifest.xml:32:13-63 value=(@style/com_facebook_activity_theme).Suggestion: add
'tools:replace="android:theme"' to <activity> element at AndroidManifest.xml:66:9-70:47 to override.
将以下内容添加到 AndroidManifest.xml 文件中的 manifest 元素:
<manifest>
  ...
  xmlns:tools="http://schemas.android.com/tools"
  ...
</manifest>
将以下内容添加到 activity 元素:
<activity>
  ...
  tools:replace="android:theme"
  ...
</activity>

iOS

1. 看到以下警告时应该怎样做:
[!] Unable to find a specification for FBSDKMarketingKit
运行 pod update,然后运行 pod install --repo-update