應用程式事件轉換 API

轉換 API 可讓廣告主透過單一端點（而不需要透過多個來源），將網路、應用程式、實體商店和商家訊息事件傳送到 Meta。這種整合可以簡化廣告主的技術堆疊，並使用資料集在 Meta 事件管理工具中建立更全面的視圖。

本文件提供將應用程式事件整合至轉換 API 的指南。

必要條件

1. 資料集

透過轉換 API 傳送的應用程式事件必須與資料集相關聯。

您可以發出 GET 呼叫至 https://graph.facebook.com/v16.0/{ads-pixel-id}/is_consolidated_container，偵測廣告主的資料集是否已整合，因而有資格透過轉換 API 來傳遞應用程式事件。

2. 權限

• 若要以廣告主身分實作直接整合，請按照這裡的必備條件和權限相關指示操作。

• 若要實作合作夥伴平台整合，請按照這裡的必備條件和權限相關指示操作。

配置

將應用程式事件傳送到轉換 API

a.連結資料集編號和應用程式編號

在事件管理工具中，有兩種​​方法可以將您的應用程式與資料集連結：

• 選擇「資料來源」頁籤，找到應用程式的「設定」頁籤，並執行連結。
• 選擇「資料來源」頁籤，在應用程式的「總覽」頁籤中，使用「所有活動」區塊中的「連結到資料集」按鈕。

完成連結後，資料集就會包含所連接的應用程式。

b.必要欄位

您可以參閱此文件，瞭解可透過轉換 API 傳送的最新參數組合。若要傳送應用程式事件，可以在裝載中分享下列 server_event 欄位：

• 參數 action_source 必須包含代表應用程式事件的值 app。
• event_id 是進行刪除重複項目設定時的必要項目。
• app_data 欄位
• user_data 欄位
• custom_data 欄位

應用程式資料欄位

顧客資訊參數

自訂資料

總體而言，使用轉換 API 來分享的應用程式事件會需要下列資料參數：

• action_source：必須設定為「app」。（使用轉換 API 即表示您同意 action_source 參數就您所知是正確的）
• event_id：進行刪除重複項目設定時的必要項目，如需詳細資訊，請參閱「針對多管道進行刪除重複項目設定」一節。
• advertiser_tracking_enabled
• application_tracking_enabled
• extinfo

以下是 extinfo 的範例。請確認以下所有子參數均已依序填寫。如果缺少任何項目，請使用空白字串做為預留位置。

c.針對多管道進行刪除重複項目設定

若要將轉換 API 整合與包含應用程式事件（包括 SDK、MMP 和應用程式事件 API）的所有其他現有整合之間的重複事件流量移除，就會需要刪除重複項目機制。

針對應用程式事件，我們會套用本來就已用於網路事件的相同刪除重複項目功能。此邏輯利用以欄位 event_id 和 event_name 為基礎的刪除重複項目功能（承載相同 event_id 的轉換 API 和 SDK／應用程式事件 API 等事件）。event_id 參數是可以區別類似事件獨一性的識別碼。不正確的事件編號可能導致轉換遭到錯誤的重複項目刪除，進而影響轉換分析報告和行銷活動成效。

您可以參考下列開發人員說明文件來實作刪除重複項目設定：

• 如何設定應用程式事件
• 刪除重複項目設定範例

以下是記錄自訂事件的作法範例。若要行此作業，請在 iOS SDK 中以 AppEvents.Name 的形式來傳遞事件名稱：

AppEvents.shared.logEvent(.achievedLevel, parameters: [AppEvents.ParameterName(rawValue: "event_id"): "123"])

針對應用程式安裝事件，已經有一種刪除重複項目機制，可確保在過去 90 天期間，僅歸因一次安裝。我們保留第一個事件，並刪除後續的事件，無論其集客力動作來源為何。不需要為與安裝事件相關的應用程式事件實作刪除重複項目。

d.傳送事件

若要傳送新的事件，請從下列路徑發出 POST 要求至轉換 API：https://graph.facebook.com/{API_VERSION}/{DATASET_ID}/events?access_token={TOKEN}。當您發佈到此關係連線時，Meta 會建立新的應用程式伺服器事件。如需詳細資訊，請參閱此開發人員文件。

以下概述這些參數在裝載整體架構中的適當位置：

{
    "data": [
        {
            "event_name": "Purchase",
            "event_time": 1684389752,
            "action_source": "app",
            "user_data": {
                "em": [
                    "30a79640dfd8293d4f4965ec11821f640ca77979ca0a6b365f06372f81a3f602"
                ],
                "ph": [
                    "74234e98afe7498fb5daf1f36ac2d78acc339464f950703b8c019892f982b90b",
                    "74234e98afe7498fb5daf1f36ac2d78acc339464f950703b8c019892f982b90b"
                ],
                "madid": "bbbbbbbbbbbb",
      "anon_id": "cccccccc"
            },
            "custom_data": {
                "currency": "USD",
                "value": "142.52"
            },
            "app_data": {
                "advertiser_tracking_enabled": "True",
                "application_tracking_enabled": "True",
                "campaign_ids": "aaaaaaaaa",
                "extinfo": [
                    "a2",
                    "com.some.app",
                    "771",
                    "Version 7.7.1",
                    "10.1.1",
                    "OnePlus6",
                    "en_US",
                    "GMT-1",
                    "TMobile",
                    "1920",
                    "1080",
                    "2.00",
                    "2",
                    "128",
                    "8",
                    "USA/New York"
                ]
            }
        }
    ]
}

疑難排解

您可以使用裝載協助工具來產生裝載資料：

• 選擇 app 集客力動作來源（若適用）
• 針對將傳送到 Meta 的事件填寫資料
• 這會產生事件裝載，可用來做為轉換 API 整合的範本

請使用事件管理工具中的測試事件工具進行測試。

另請參閱

• 轉換 API 總覽
• 使用轉換 API
• 轉換 API 參數
• 最佳作法