em 電子郵件地址 字串或清單<string> | 需雜湊處理。 去除開頭和結尾的任何空格。將所有字元轉換成小寫。
範例: 輸入:John_Smith@gmail.com 標準化格式:john_smith@gmail.com 預期的 SHA256 輸出:62a14e44f765419d10fea99367361a727c12365e2520f32218d505ed9aa0f62f |
ph 電話號碼 字串或清單<string> | 需雜湊處理。 移除符號、字母和開頭的任何數字零。電話號碼必須包含用於配對的國碼/區碼(例如,美國的電話號碼前面必須加上數字 1)。即使所有資料都來自同一個國家/地區,一律在顧客的電話號碼前面加上國碼/區碼。
範例: 輸入:美國電話號碼 (650)555-1212 標準化格式:16505551212 預期的 SHA256 輸出: e323ec626319ca94ee8bff2e4c87cf613be6ea19919ed1364124e16807ab3176 |
fn 名字 字串或清單<string> | 需雜湊處理。 建議使用羅馬字母 a-z 字元。僅限小寫,不包含標點符號。如果使用特殊字元,必須以 UTF-8 格式將文字編碼。
範例: 輸入:Mary 標準化格式:mary 預期的 SHA256 輸出:6915771be1c5aa0c886870b6951b03d7eafc121fea0e80a5ea83beb7c449f4ec
輸入:정 標準化格式:UTF-8 字元「정」 預期的 SHA256 輸出:8fa8cd9c440be61d0151429310034083132b35975c4bea67fdd74158eb51db14
輸入:Valéry 標準化格式:valéry 預期的 SHA256 輸出:08e1996b5dd49e62a4b4c010d44e4345592a863bb9f8e3976219bac29417149c |
ln 姓氏 字串或清單<string> | 需雜湊處理。 建議使用羅馬字母 a-z 字元。僅限小寫,不包含標點符號。如果使用特殊字元,必須以 UTF-8 格式將文字編碼。
請參閱「名字」(fn )的範例。 |
db 出生日期 字串或清單<string> | 需雜湊處理。 我們接受 YYYYMMDD 格式,可包含各種月、日、年的組合,有無標點符號皆可。
範例: 輸入:2/16/1997 標準化格式:19970216 預期的 SHA256 輸出:01acdbf6ec7b4f478a225f1a246e5d6767eeab1a7ffa17f025265b5b94f40f0c |
ge 性別 字串或清單<string> | 需雜湊處理。 我們接受小寫首字母形式的性別。
範例: |
ct 城市 字串或清單<string> | 需雜湊處理。 建議使用羅馬字母 a-z 字元。僅限小寫,不包含標點符號、特殊字元和空格。如果使用特殊字元,必須以 UTF-8 格式將文字編碼。
範例: paris london newyork |
st 州/省 字串或清單<string> | 需雜湊處理。 使用小寫的 2 個字元 ANSI 縮寫代碼。標準化美國以外的州名,使用小寫,不包含標點符號、特殊字元和空格。
範例: az ca |
zp 郵遞區號 字串或清單<string> | 需雜湊處理。 使用小寫,不包含空格和破折號。美國郵遞區號僅使用前 5 位數。英國使用郵域、郵區和郵政部門格式。
範例: 美國郵遞區號:94035 澳洲郵遞區號:1987 法國郵遞區號:75018 英國郵遞區號:m11ae |
country 國家/地區 字串或清單<string> | 需雜湊處理。 使用 ISO 3166-1 alpha-2 格式的小寫、2 個字母國碼/區碼。 重要注意事項:即使所有國碼/區碼皆來自同一個國家/地區,一律填寫每個顧客的國家/地區。我們是以全球為範圍進行配對,這個簡單的步驟可以協助我們從您的名單中配對出更多帳號管理中心帳號。
範例: 輸入:United States 標準化格式:us 預期的 SHA256 輸出:79adb2a2fce5c6ba215fe5f27f532d4e7edbac4b6a5e09e1ef3a08084a904621 |
external_id 外部編號 字串或清單<string> | 建議進行雜湊處理。 廣告主的任何專屬編號,例如忠實會員編號、用戶編號和外部 Cookie 編號。您可以針對特定事件傳送一或多個外部編號。 如果您已透過其他管道傳送外部編號,其格式應與透過轉換 API 傳送時相同。 |
client_ip_address 用戶端 IP 位址 字串 | 不進行雜湊處理。 對應事件之瀏覽器的 IP 位址必須是有效的 IPV4 或 IPV6 位址。針對可使用 IPV6 的用戶,IPV6 優於 IPV4。client_ip_address 用戶資料參數切勿進行雜湊處理。 不應包含空格。請一律提供真實 IP 位址,以確保事件分析報告的準確性。 注意:此資訊會自動加入透過瀏覽器傳送的事件中,但是針對透過伺服器傳送的事件,則必須手動配置。
範例: IPV4:168.212.226.204 IPV6:2001:0db8:85a3:0000:0000:8a2e:0370:7334 |
client_user_agent 用戶端用戶代理程式 字串 | 不進行雜湊處理。 對應事件之瀏覽器的用戶代理程式。使用轉換 API 分享網站事件時,client_user_agent 為必要項目。 針對透過轉換 API 傳送的所有事件,若 client_ip_address 和 client_user_agent 參數皆傳送,可能有助於改善事件配對,也有助於改善廣告投遞,讓任何廣告行銷活動都可最佳化透過轉換 API 傳送的事件。 注意:此資訊會自動加入透過瀏覽器傳送的事件中,但是針對透過伺服器傳送的事件,則必須手動配置。
範例: Mozilla/5.0(Windows NT 10.0、Win64、x64) AppleWebKit/537.36(KHTML,例如 Gecko) Chrome/87.0.4280.141 Safari/537.36 |
fbc 點擊編號 字串 | 不進行雜湊處理。 Facebook 點擊編號值儲存在網域下的 _fbc 瀏覽器 Cookie 中。請參閱管理 fbc 和 fbp 參數,瞭解如何取得這個值,或是從 fbclid 查詢參數產生這個值。 格式為 fb.${subdomain_index}.${creation_time}.${fbclid} 。
範例: fb.1.1554763741205.AbCdEfGhIjKlMnOpQrStUvWxYz1234567890 |
fbp 瀏覽器編號 字串 | 不進行雜湊處理。 Facebook 瀏覽器編號值儲存在網域下的 _fbp 瀏覽器 Cookie 中。請參閱管理 fbc 和 fbp 參數,瞭解如何取得這個值。 格式為 fb.${subdomain_index}.${creation_time}.${random_number} 。
範例: fb.1.1596403881668.1116446470 |
subscription_id 訂閱編號 字串 | 不進行雜湊處理。 此交易中的用戶訂閱編號,類似個別產品的訂單編號。 |
fb_login_id Facebook 登入編號 整數 | 不進行雜湊處理。 用戶第一次登入應用程式執行個體時,Meta 所核發的編號,又稱為應用程式範圍編號。 |
lead_id 潛在顧客編號 整數 | 不進行雜湊處理。 與潛在顧客相關聯的編號,由 Meta 的名單型廣告產生。 |
anon_id 字串 | 不進行雜湊處理。 您的安裝編號。此欄位表示不重複的應用程式安裝實例。
注意:此參數僅適用於應用程式事件 |
madid 字串 | 您的行動廣告主編號(亦即 Android 裝置的廣告編號或 Apple 裝置的廣告識別碼(IDFA))。 |
page_id 字串 | 不進行雜湊處理。 您的粉絲專頁編號。指定與事件連結的粉絲專頁編號。使用與 Bot 連結的 Facebook 粉絲專頁編號。 |
page_scoped_user_id 字串 | 不進行雜湊處理。 指定與記錄事件的 Messenger Bot 連結的粉絲專頁範圍用戶編號。使用提供給 Webhook 的粉絲專頁範圍用戶編號。 |
ctwa_clid 字串 | 不進行雜湊處理。 Meta 針對 WhatsApp 發訊廣告所產生的點擊編號。 |
ig_account_id 字串 | 不進行雜湊處理。 與商家連結的 Instagram 帳號編號。 |
ig_sid 字串 | 不進行雜湊處理。 與 Instagram 互動的用戶,由 Instagram 範圍用戶編號(IGSID)所識別。您可以從這個 Webhook 取得 IGSID。 |