應用程式事件新手指南（iOS 版）

本指南會講解如何透過整合 Facebook SDK 及記錄應用程式事件，以將這些事件加入新的應用程式或現有應用程式。

準備工作

您需要準備以下項目：

• Facebook 開發人員帳戶
• Facebook 廣告帳戶
• Facebook 商業帳戶（若您尚未有商業帳戶，則可以建立新帳戶）
• Facebook 應用程式

第 1 步：配置 Facebook 應用程式

如果您尚未擁有 Facebook 應用程式，請前往應用程式管理中心，點擊我的應用程式，然後建立新的應用程式。前往設定 > 基本，在此查看應用程式詳細資料面板，當中列有您的應用程式編號、應用程式密鑰以及有關您應用程式的其他詳細資料。

向下捲動到頁面底部，然後點擊新增平台。選擇 iOS 並加入您的應用程式詳細資料，然後儲存變更。

若要將應用程式設為廣告用途，請加入以下詳細資料：

• 應用程式網域：提供您應用程式的 Apple App Store 網址。
• 私隱政策網址：提供私隱政策網址。您必須提供此項目，才能公開您的應用程式。
• 服務條款網址：提供服務條款網址。
• 平台：捲動至「設定」面板底部，新增 iOS 平台。

如欲進一步了解如何在應用程式新增圖示或類別等詳細資料，請瀏覽應用程式開發文件。

第 2 步：連結廣告與商業帳戶

若要在廣告管理員中刊登廣告並衡量安裝次數，您必須將最少一個廣告帳戶與您的商業帳戶連結。

1. 在應用程式管理中心內，點擊設定 > 進階。
2. 在已驗證的廣告帳戶編號中加入您的廣告帳戶編號。您可以從廣告管理員中取得廣告帳戶編號。
3. 在廣告帳戶面板中，點擊開始使用，然後按照指示連結應用程式與企業。

第 3 步：設定開發環境

以下程序會使用 Swift 套件管理工具，以在 Xcode 中設定開發環境。

1. 在 Xcode 中，點擊檔案 > 新增套件…。
2. 在畫面出現的搜尋欄位中輸入資料庫網址：https://github.com/facebook/facebook-ios-sdk。
3. 在相依項目規則中，選取 Up to Next Major Version 並輸入最新版本。最新發佈版本載於 https://github.com/facebook/facebook-ios-sdk/releases/。
4. 選擇您要使用的資料庫，以及您希望新增這些資料庫的目標位置。
5. 點擊新增套件以完成設定。

第 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 步：新增應用程式事件

在應用程式內追蹤事件的方法有三種：

• 自動記錄事件：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 或數字（Int、Double 等）。

第 8 步：測試事件

應用程式廣告協助工具可讓您在應用程式中測試應用程式事件，以確保應用程式能傳送事件至 Facebook。

1. 開啟應用程式廣告協助工具。
2. 在選擇應用程式中，選擇您的應用程式並選擇提交。
3. 捲動至頁面底部，然後選擇測試事件。
4. 啟動應用程式並傳送事件。事件會出現在頁面中。

了解詳情

• 最佳操作實例指南：查看多個應用程式範例，以及每個應用程式處理應用程式事件的方式。
• 常見問題：查看我們的常見問題。
• Meta Blueprint 課程：配置 iOS SDK 和應用程式事件
• Meta Blueprint 課程：使用應用程式事件以作目標指定、優化和衡量

應用程式範例

為了讓您能更輕鬆地了解如何使用應用程式事件，我們為不同應用程式類型建立了一些範例。每個應用程式範例都為不同的事件及可蒐集的參數，提供獨立的資料細節畫面解說。每個區塊的結尾部分都有一個表格，當中列出各個應用程式適用的建議事件及參數。若有需要，您也可以建立自訂事件及參數。