em 電郵 字串或清單<string> | 必須雜湊。 去除所有頭尾空格。將所有字元轉換為小楷。
範例: 輸入:John_Smith@gmail.com 標準化格式:john_smith@gmail.com 預期的 SHA256 輸出:62a14e44f765419d10fea99367361a727c12365e2520f32218d505ed9aa0f62f |
ph 手機號碼 字串或清單<string> | 必須雜湊。 移除符號、字母及任何開頭為 0 的數字的第一個 0 字。手機號碼必須包含用於配對的國碼/區碼(例如,美國手機號碼前面必須包含數字 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 雙字母代碼表示方式輸入小楷的雙字母國碼/區碼。 重要備註:請一律加入顧客的國碼/區碼,即使所有國碼/區碼均來自同一個國家/地區亦然。由於我們會配對全球的資料,因此您只要完成上述簡單步驟,我們就能儘可能為您的名單配對更多帳戶管理中心帳戶資料。
範例: 輸入: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, like 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 互動的用戶。Instagram 範圍用戶編號可在此 Webhook 取得。 |