伺服器事件參數

必填。
Unix 時間戳記（以秒為單位），指示實際事件發生的時間。指定的時間可能會早於您向 Facebook 傳送事件的時間，這樣系統才能進行批次處理和伺服器效能最佳化。您必須以 GMT 時區格式傳送此日期。

event_time 最早可以是您向 Facebook 傳送事件的 7 天前。如果 data 中的任何 event_time 大於過去 7 天，我們會針對整個要求傳回錯誤，且不會處理任何事件。

選填。
包含與事件相關的其他企業資料比對內容。如需更多資訊，請參閱自訂資料參數。

選填。
此標示指示 Meta 不應使用此事件進行廣告投遞最佳化。如果設為 true，我們只會使用事件做為歸因條件。

必填。
此欄位可讓您指定轉換發生的位置。瞭解事件發生的位置有助於確保向合適的用戶展示廣告。使用轉換 API，即表示您同意 action_source 參數就您所知是正確的。

您在 action_source 欄位中可傳送的值如下所示：

• email — 透過電子郵件完成的轉換。
• website — 在您的網站上完成轉換。
• app — 在您的行動應用程式上完成轉換。
• phone_call — 透過電話完成轉換。
• chat — 透過訊息應用程式、簡訊或網路訊息功能完成的轉換。
• physical_store — 用戶親自在實體店面完成的轉換。
• system_generated — 自動轉換，例如用戶設定每月自動付款來進行續訂。
• business_messaging — 透過 Messenger 發訊廣告、Instagram 發訊廣告或 WhatsApp 發訊廣告完成的轉換。
• other — 上述未提及的轉換方式。

如果您在 data_processing_options 下傳送 LDU，則為必填。
您要在哪個國家／地區使用此資料處理選項。目前可接受的值為 1，代表美國；或使用 0 要求我們為該事件指定地理位置。深入瞭解資料處理選項。另請參閱轉換 API 實作範例。

app_data

應用程式事件的必填欄位

此參數可用來與轉換 API 分享應用程式資料和裝置資訊。

extinfo

應用程式事件的必填欄位
延伸裝置資訊，例如螢幕寬度和高度。此參數是一個陣列，以逗號分隔值。使用 extinfo 時，所有值皆為必填，且必須按照下面的索引順序排列。如果缺少值，請以空白字串做為預留位置。

注意：

• Android 的 version 必須為 a2

• iOS 的 version 必須為 i2

選填。
觸發轉換 API 或 Meta 像素事件的頁面所觀察到的 HTTP 轉介網址標頭，通常是瀏覽器中的上一頁。

選填。
允許廣告主指定執行事件的用戶所屬的用戶族群，可用於提供更多關於用戶與商家關係的內容。

此欄位接受下列任一預先定義的列舉值：

• new_customer_to_business：用戶是商家的新顧客。
• new_customer_to_business_line：用戶是特定行業（例如產品或服務）的新顧客。
• new_customer_to_product_area：用戶是特定產品領域（例如電子商務、金融）的新顧客。
• new_customer_to_medium：用戶是特定行銷媒介（例如社群媒體、電子郵件）的新顧客。
• existing_customer_to_business：用戶是商家的現有顧客。
• existing_customer_to_business_line：用戶是特定行業（例如產品或服務）的現有顧客。
• existing_customer_to_product_area：用戶是特定產品領域（例如電子商務、金融）的現有顧客。
• existing_customer_to_medium：用戶是特定行銷媒介（例如社群媒體、電子郵件）的現有顧客。
• customer_in_loyalty_program：用戶是忠誠度計畫的一員。

JSON 裝載範例：

{
 "event_name": "Purchase",
 "event_time": 1643723400,
 "user_data": {
   "em": "user@example.com"
 },
 "custom_data": {
   "currency": "USD",
   "value": 100.00,
   "customer_segmentation": "new_customer_to_business"
 }
}