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 課程：使用應用程式事件以作目標指定、優化和衡量

應用程式範例

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