iOS 應用程式事件新手指南

本指南說明如何將應用程式事件加入全新或既有的應用程式，方法是先整合 Facebook SDK，然後記錄這些事件。

準備工作

必備資料：

• Facebook 開發人員帳號
• Facebook 廣告帳號
• Facebook 商家資產管理組合（如果您還沒有商家資產管理組合，請新建一個）
• Facebook 應用程式

步驟 1：設定 Facebook 應用程式

請前往應用程式主控板，然後點擊我的應用程式，如果您沒有任何應用程式，請建立新的應用程式。依序導覽至設定 > 基本，即可查看應用程式詳細資料面板，其中會顯示應用程式編號、應用程式密鑰及其他應用程式詳細資料。

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

若要設定應用程式以進行廣告刊登，請新增下列詳細資料：

• 應用程式網域：提供應用程式的 Apple App Store 網址。
• 隱私政策網址：提供隱私政策網址。若要公開發佈應用程式，就必須提供這項資訊。
• 服務條款網址：提供服務條款網址。
• 平台：捲動至設定面板底部，以新增 iOS 平台。

如需深入瞭解如何新增應用程式詳細資料（如圖示或類別），請參閱應用程式開發文件。

步驟 2：連結廣告和商家資產管理組合

若要在廣告管理員中刊登廣告並衡量安裝次數，應用程式必須至少連結一個廣告帳號和一個商家資產管理組合。

1. 在應用程式主控板中，點擊設定 > 進階。
2. 在已驗證的廣告帳號編號中，新增您的廣告帳號編號。您可在廣告管理員取得廣告帳號編號。
3. 在廣告帳號面板中，點擊開始使用，然後按照說明將應用程式連接到商家。

步驟 3：設定開發環境

下列程序使用 Swift 套件管理工具來設定 Xcode 開發環境。

1. 在 Xcode 中，點擊 File（檔案）> Add Packages...（新增套件…）。
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：新增應用程式事件

有三種方法可以追蹤應用程式中的事件：

• 自動記錄的事件：透過 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 Android SDK 和應用程式事件
• Meta Blueprint 課程：使用應用程式事件進行目標設定、最佳化和成效衡量

應用程式範例

我們已為不同應用程式類型製作一些範例，以讓您更容易瞭解如何使用應用程式事件。每個應用程式範例都會針對可蒐集的不同事件和參數，利用逐一畫面提供資料解析。各節結尾都會提供一個表格，列出建議用於各應用程式的事件和參數。如有必要，您也可以建立自己的事件和參數。