event_name 字串 | 此為必要項目。 標準事件或自訂事件的名稱。此欄位用於刪除經網站(透過 Meta 像素)或應用程式(透過 SDK 或應用程式事件 API)傳送的重複事件,以及經轉換 API 傳送的重複事件。event_id 參數也會用於刪除重複事件。
如果是相同的顧客動作,來自瀏覽器或應用程式事件的 event 會與來自伺服器事件的 event_name 相符。如果我們在 48 小時內傳送的事件之間找到相符項目,則只會考慮第一項事件。如果伺服器事件和瀏覽器/應用程式事件幾乎同時到達(即兩者相差 5 分鐘以內),我們將優先考慮瀏覽器/應用程式事件。進一步了解如何刪除重複的像素和伺服器事件。 |
event_time 整數 | 此為必要項目。 以秒為單位的 Unix 時戳,表示實際事件的發生時間。所註明的時間可能會早於您將事件傳送至 Facebook 的時間。這個做法是為了支援批量處理和伺服器成效優化。您必須以格林威治標準時間時區格式傳送此日期。
event_time 最早可以是您向 Facebook 傳送事件的 7 天前。如果 data 中的任何 event_time 早於 7 天前,我們會為整個要求傳回錯誤訊息,且不處理任何事件。
|
user_data 物件 | 此為必要項目。 包含顧客資訊數據的對應表。請參閱顧客資訊參數了解有關選項。請參閱進階配對,了解適用於透過 Meta 像素傳送的數據之選項並作出比較。 |
custom_data 物件 | 此為選用項目。 包含事件額外企業數據的對應表。請參閱自訂資料參數以了解更多資訊。 |
event_source_url 字串 | 此為選用項目。 事件發生時的相關瀏覽器網址。網址應與已驗證的網域相符。
備註:event_source_url 是透過轉換 API 所分享的網站事件之必填欄位。 |
opt_out 布林值 | 此為選用項目。 這個標示說明我們不應將此事件用於廣告刊登優化設定。設定為 true 時,該事件僅能用作歸因條件。 |
event_id 字串 | 此為選用項目。 此編號可以是廣告客戶選定的任何不重複字串。event_id 和 event_name 參數用於刪除經網站(透過 Meta 像素)或應用程式(透過 SDK 或應用程式事件 API)傳送的重複事件,以及經轉換 API 傳送的重複事件。請注意,雖然 event_id 列為選用項目,但仍建議在刪除重複事件時使用。
刪除重複事件時,來自瀏覽器或應用程式事件的 eventID 必須與相應伺服器事件的 event_id 相符。進一步了解如何處理重複的像素和轉換 API 事件。
訂單號碼或交易編號均是可用於 event_id 的識別資料。舉例來說,如果顧客在您的網站進行兩次購買交易,訂單號碼分別為 123 和 456,則每個轉換 API 呼叫中的 event_id 均需要包括相應的訂單號碼。這樣有助我們正確地將這兩次購買事件區別為不同的訂單。兩項相應的瀏覽器像素購買事件亦需在 eventID 參數中傳送相同的訂單號碼,讓我們知道只發生了兩項事件,而不是 4 次不重複購買。
其他沒有固有編號的事件可使用隨機號碼,但瀏覽器和伺服器事件之間亦需要傳送相同的隨機號碼。 |
action_source 字串 | 此為必要項目。 此欄位讓您指定轉換發生的位置。了解事件發生的位置,有助您確保廣告可展示給理想的廣告受眾。使用轉換 API,即表示您同意 action_source 參數據您所知正確無誤。
您可以在 action_source 欄位傳送以下值:
email —透過電郵發生的轉換。
website —在您網站上發生的轉換。
app —在您流動應用程式上發生的轉換。
phone_call —透過手機發生的轉換。
chat —透過訊息應用程式、短訊或網上訊息收發功能發生的轉換。
physical_store —在您的實體店內透過真人操作發生的轉換。
system_generated —自動發生的轉換,例如用戶設定每月自動付款以續訂訂閱項目。
business_messaging —轉換來自 Messenger、Instagram 或 WhatsApp 發訊廣告。
other —以上述沒有提及的方式發生之轉換。
備註:所有用戶操作來源值均支援廣告成效衡量和自訂廣告受眾建立功能。physical_store 以外的所有用戶操作來源都支援廣告優化功能。 |
data_processing_options 陣列 | 此為選用項目。 您要為特定事件啟用的處理選項。目前適用於「有限資料使用」的可接受值為 LDU 。您可以傳送空白陣列,以清楚註明不應使用「有限資料使用」限制來處理此事件。進一步了解資料處理選項。請參閱轉換 API 執行範例。 |
data_processing_options_country 整數 | 此為必要項目(如果您在 data_processing_options 下傳送 LDU )。 您想在哪個國家/地區使用此資料處理選項。目前適用於美國的可接受值為 1 ;或者,您可使用 0 以要求我們為該事件指定地理位置。進一步了解資料處理選項。請參閱轉換 API 執行範例。 |
data_processing_options_state 整數 | 部分情況下的必要項目。(查看以下備註來了解詳情。) 您想在哪個州份使用此資料處理選項。目前適用於加州的可接受值為 1000 ;或者,您可使用 0 以要求我們為該事件指定地理位置。
備註: 進一步了解資料處理選項。請參閱轉換 API 執行範例。 |
app_data
物件 | 此為應用程式事件的必填項目 透過轉換 API 分享應用程式資料和裝置資訊時適用的參數。 |
extinfo
物件 | 此為應用程式事件的必要項目 延伸裝置資訊,例如螢幕闊度和高度。此參數是一個陣列,各值以逗號分隔。在使用 extinfo 時,所有值均為必填項目,並且必須遵循下方的索引順序。如果缺少某個值,請填入空白字串以預留位置。
備註:
針對 Android,version 必須為 a2
|
0
字串 | 必要項目 extinfo 版本
範例:i2 |
1
字串 | 應用程式套件名稱
範例:com.facebook.sdk.samples.hellofacebook |
2
字串 | 精簡版(整數或字串)
範例:1.0 |
3
字串 | 長版本
範例:1.0 long |
4
字串 | 必要項目 作業系統版本
範例:13.4.1 |
5
字串 | 裝置型號名稱
範例:iPhone5,1 |
6
字串 | 語言設定
範例:En_US |
7
字串 | 時區縮寫
範例:PDT |
8
字串 | 電訊商
範例:AT&T |
9
int64 | 螢幕闊度
範例:320 |
10
int64 | 螢幕高度
範例:568 |
11
字串 | 螢幕密度
範例:2 |
12
int64 | CPU 核心
範例:2 |
13
int64 | 外置儲存空間大小(以 GB 為單位)
範例:13 |
14
int64 | 外置儲存空間的可用空間(以 GB 為單位)
範例:8 |
15
字串 | 裝置所在時區
範例:USA/New York |
referrer_url 字串 | 此為選用項目。 頁面觸發轉換 API 或 Meta 像素事件時獲得的 HTTP 轉介標頭。這通常是瀏覽器中上一個頁面的網址。 |
original_event_data 物件 | 此為選用項目。 可供廣告客戶使用的全部中繼資料欄位,在指定「延遲」事件與過往招攬事件的關聯方式時使用。 若事件傳送時間與其應關聯的過往招攬事件之間有延遲,我們強烈建議使用 original_event_data 。請參閱原始事件參數以了解更多資訊。 |