iOS 版应用事件入门指南

使用包含应用数据的 XML 代码片段配置 Info.plist 文件。

1. 右键点击 Info.plist，然后选择 Open As（打开方式）▸ Source Code（源代码）。
2. 将下列 XML 代码片段复制并粘贴到文件正文中 (<dict>...</dict>)。

   <key>CFBundleURLTypes</key><array><dict><key>CFBundleURLSchemes</key><array><string>fbAPP-ID</string></array></dict></array><key>FacebookAppID</key><string>APP-ID</string><key>FacebookClientToken</key><string>CLIENT-TOKEN</string><key>FacebookDisplayName</key><string>APP-NAME</string>

3. 在 [CFBundleURLSchemes] 键内的 <array><string> 中，将 APP-ID 替换为您的应用编号。
4. 在 FacebookAppID 键内的 <string> 中，将 APP-ID 替换为您的应用编号。
5. 在 FacebookClientToken 键内的 <string> 中，将 CLIENT-TOKEN 替换为您在应用面板设置 > 高级 > 客户端口令中找到的值。
6. 在 FacebookDisplayName 键内的 <string> 中，将 APP-NAME 替换为您的应用名称。
7. 如要使用任何 Facebook 对话框（如登录、分享、应用邀请等），实现将应用切换至 Facebook 应用的功能，则应用程序的 Info.plist 还需包含以下代码：

   <key>LSApplicationQueriesSchemes</key><array><string>fbapi</string><string>fb-messenger-share-api</string></array>

您需为项目添加 Keychain Sharing 功能，才能使登录功能在 Mac Catalyst 应用程序中正常运作。

1. 配置应用目标时，选择 Signing & Capabilities（签名和功能）选项卡中的 + Capability（添加功能）按钮。
2. 找到并选择 Keychain Sharing 功能。
3. 确保已将 Keychain Sharing 功能列为应用目标。

将 AppDelegate.swift 方法中的代码替换为以下代码。此代码会在启动应用时初始化 SDK，并在您执行登录或分享操作时，允许 SDK 处理原生 Facebook 应用的登录及分享。否则，用户便须登录 Facebook 才能使用应用内浏览器进行登录。

  
// AppDelegate.swift
import UIKit
import FBSDKCoreKit

@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]
        )
    }  
}

iOS 13 版本的系统中，将打开网址的功能移到了 SceneDelegate 中。如果您使用的是 iOS 13 版本，请将以下方法添加到 SceneDelegate 中，以便相关操作（如登录或分享等功能）可按照预期运作：

 
// SceneDelegate.swift
import FBSDKCoreKit
  ...
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]
    )
}

iOS 14 版 App Store Connect

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

使用 Facebook SDK 时，除非禁用事件自动记录功能，否则系统会为 Facebook 事件管理工具自动记录并收集应用中的某些事件。这些事件与所有用途相关，例如定位、成效衡量和优化。

应用事件自动记录功能收集的事件包括三个主要事件：应用安装、应用启动和购买。启用自动记录功能时，广告主可禁用这些事件，以及登录展示事件等其他 Facebook 内部事件。但是，如果已禁用自动记录功能，但仍想记录特定事件（例如安装或购买事件），则可在应用中手动记录这些事件。