伺服器事件參數

參數說明
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_idevent_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 以要求我們為該事件指定地理位置。


備註:

  • 如果您已設定國家/地區,則必須同時設定州份。否則,我們會將地理位置邏輯套用至整個事件。
  • 如果您在 data_processing_options 下傳送 LDU 而不提供 IP 位址,則此欄位為必填。

進一步了解資料處理選項。請參閱轉換 API 執行範例

app_data

物件

此為應用程式事件的必填項目

透過轉換 API 分享應用程式資料和裝置資訊時適用的參數。

extinfoapp_data 的子參數。

extinfo

物件

此為應用程式事件的必要項目
延伸裝置資訊,例如螢幕闊度和高度。此參數是一個陣列,各值以逗號分隔。在使用 extinfo 時,所有值均為必填項目,並且必須遵循下方的索引順序。如果缺少某個值,請填入空白字串以預留位置。


備註:


  • 針對 Android,version 必須為 a2

  • 針對 iOS,version 必須為 i2

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。請參閱原始事件參數以了解更多資訊。