iOS 版应用事件入门指南

本指南介绍如何集成 Facebook SDK，然后记录应用事件，从而为新建应用和现有应用添加这些事件。

前期准备

您需要提供：

• Facebook 开发者账户
• Facebook 广告账户
• Facebook 业务资产组合（如果没有业务资产组合，请新建一个）
• Facebook 应用

第 1 步：配置 Facebook 应用

如果尚未拥有应用，请前往应用面板，点击我的应用以创建新应用。前往设置 > 基本，查看应用详情面板，这里包含应用编号、应用密钥以及应用的其他详细信息。

滚动到页面底部，然后点击添加平台。选择 iOS，添加您的应用详情，然后保存更改。

如要针对广告投放设置应用，请添加下列详细信息：

• 应用网域：提供应用的 Apple App Store 网址。
• 隐私权政策网址：提供隐私权政策的网址。必须提供此内容才能公开发布应用。
• 服务条款网址：提供服务条款的网址。
• 开放平台：滚动至“设置”面板底部，添加 iOS 开放平台。

如需详细了解如何为应用添加详情（例如图标或类别），请访问应用开发文档。

第 2 步：关联您的广告账户和业务资产组合

如需在广告管理工具中投放广告和衡量安装量，请将至少一个广告账户和一个业务资产组合与您的应用相关联。

1. 在应用面板中点击设置 > 高级。
2. 在授权的广告账户编号中，添加广告账户编号。您可以在广告管理工具中获取广告账户编号。
3. 在广告账户窗口中，点击开始并按照说明将应用与业务账户相关联。

第 3 步：设置开发环境

以下过程为在 Xcode 中使用 Swift 软件包管理工具设置开发环境。

1. 在 Xcode 中，点击 File（文件）> Add Package...（添加软件包...）。
2. 在出现的搜索栏中，输入存储库网址：https://github.com/facebook/facebook-ios-sdk。
3. 在 Dependency Rule（依赖项规则）中，选择 Up to Next Major Version（直到下一个重大版本），然后输入最近的版本。以下网站列有最新发布的版本：https://github.com/facebook/facebook-ios-sdk/releases/
4. 请选择要使用的库以及要将这些库添加到哪些目标中。
5. 点击 Add Package（添加软件包）以完成设置。

第 4 步：在 Facebook 注册和配置您的应用

添加捆绑包标识符，并为应用启用单点登录。

第 5 步：配置项目

第 6 步：关联应用委托和场景委托

    
// AppDelegate.swift
import UIKit
import FacebookCore

@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate {    
    func application(
        _ application: UIApplication,
        didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?
    ) -> Bool {          
        ApplicationDelegate.shared.application(
            application,
            didFinishLaunchingWithOptions: launchOptions
        )

        return true
    }
          
    func application(
        _ app: UIApplication,
        open url: URL,
        options: [UIApplication.OpenURLOptionsKey : Any] = [:]
    ) -> Bool {
        ApplicationDelegate.shared.application(
            app,
            open: url,
            sourceApplication: options[UIApplication.OpenURLOptionsKey.sourceApplication] as? String,
            annotation: options[UIApplication.OpenURLOptionsKey.annotation]
        )
    }  
}

// SceneDelegate.swift
import FacebookCore
  ...
func scene(_ scene: UIScene, openURLContexts URLContexts: Set<UIOpenURLContext>) {
    guard let url = URLContexts.first?.url else {
        return
    }

    ApplicationDelegate.shared.application(
        UIApplication.shared,
        open: url,
        sourceApplication: nil,
        annotation: [UIApplication.OpenURLOptionsKey.annotation]
    )
}

第 7 步：添加应用事件

系统会在应用内使用以下 3 种方式追踪事件：

• 自动记录事件：Facebook SDK 可自动记录应用安装、启动和应用内购买事件。
• 无代码应用事件工具：使用此工具在不向应用添加代码的情况下，添加标准事件。
• 手动记录事件：向应用添加代码以追踪标准事件和自定义事件。

自动记录的事件

获取设备同意

从 iOS 14.5 开始，您需要设置 isAdvertiserTrackingEnabled，并在每次为设备授予与 Facebook 分享数据的权限时，做好记录。

设备同意后，设为 Settings.shared.isAdvertiserTrackingEnabled = true。

设备禁止追踪时，设为 Settings.shared.isAdvertiserTrackingEnabled = false。

<key>FacebookAutoLogAppEventsEnabled</key>
<false/>

<key>FacebookAdvertiserIDCollectionEnabled</key>
<false/>

手动记录事件

要记录自定义事件，只需将事件名称作为 AppEvents.Name 传递即可：

AppEvents.shared.logEvent(AppEvents.Name("battledAnOrc"))

事件参数

Facebook 已创建一组与标准事件或自定义事件一起使用的实用事件参数。您也可以提供自己的参数。

这些预定义参数旨在指引您了解常见的记录模式，并让报告和其他用户界面中的表单更易阅读。记录您在查看细分数据时想了解的一系列参数。这些参数的推荐说明仅用作指南，您可以将这些参数用于对应用有意义的任何事件。

参数将通过字典传递，其中的键值会将参数名称记录为 AppEvents.ParameterName，且对应的值必须为 String 或 number（Int、Double 等）。

第 8 步：测试事件

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

1. 打开应用广告帮手。
2. 在选择应用部分选择您的应用，然后选择提交。
3. 滚动至页面底部，然后选择测试事件。
4. 启动应用，并发送事件。此事件应在页面中显示。

详细了解

• 最佳实践指南：查看种类广泛的示例应用，以及每个应用如何处理应用事件。
• 常见问题：查看常见问题。
• Meta Blueprint 课程：配置 iOS 版 SDK 和应用事件
• Meta Blueprint 课程：利用应用事件进行定位、优化和成效衡量

应用示例

为了让您能更轻松地了解如何使用应用事件，我们针对不同类型的应用创建了一些示例。每个应用示例提供了可收集的各类事件和参数的逐屏细分数据。每部分结尾都有一个表格，我们在其中列出了针对各个应用的推荐事件和参数。此外，如有必要，您也可以创建自己的事件和参数。