iOS 應用程式事件新手指南

使用包含您應用程式資料的 XML 程式碼片段來設定 Info.plist 檔案。

1. 在 Info.plist 上點擊右鍵，然後選擇以原始碼形式開啟。
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 內部事件，例如登入瀏覽事件。不過，如果您已停用自動記錄功能，但仍想記錄安裝或購買事件等特定事件，則可手動在應用程式中記錄這些事件。