顧客資訊參數

顧客資訊參數是您隨事件資訊一同分享的一組用戶識別資料。如需進一步了解必要參數和建議參數,請參閱「最佳操作實例:轉換 API」一文中的「傳送必要參數和建議參數」部分

Graph API v13.0 版加入了一些新要求,內容主要關於我們視為有效的顧客資訊參數組合。請參閱相關的最佳操作實例,以確保您的轉換 API 整合功能不會中斷。

請瀏覽 Meta 私隱和數據使用指南,了解使用轉換 API 時傳送的資料。

我們系統設計的原則,是不接受將未經雜湊處理的聯絡資料作為顧客資訊,惟下文另有說明者除外。「聯絡資料」包括可識別個人身分的資料,如姓名,電郵地址及手機號碼,我們僅作配對之用。如果您在使用 Meta Business SDK,系統會自動完成雜湊處理。

像素比較

您可以透過 Meta 像素傳送多個顧客資訊參數,但在互聯網運作期間,一些參數(例如 client_user_agent)會由系統自動傳送。例如,如要透過像素傳送 external_id,可以使用以下程式碼:

fbq('init', 'PIXEL_ID', {'external_id': 12345});

請參閱進階配對文件,了解其他可以透過像素傳遞的參數。

反之亦然,請確保將系統目前分享至瀏覽器端的同一組顧客資訊參數套用至伺服器端。

設定 user_data 參數的格式

發出要求時,您必須以正確格式提供以下最少一項 user_data 參數。

請下載這個 CSV 檔案

,查看下方經正確標準化和雜湊資料處理的參數範例。



下載(點擊右鍵 > 另存連結為)
參數說明
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 格式,可以涵蓋多個月、日、年組合,有無標點符號皆可。

  • 年份:使用 YYYY 格式,範圍為 1900 年至目前年份。
  • 月份:使用 MM 格式,範圍為 01 至 12。
  • 日子:使用 DD 格式,範圍為 01 至 31。

範例:

輸入:2/16/1997
標準化格式:19970216
預期的 SHA256 輸出:01acdbf6ec7b4f478a225f1a246e5d6767eeab1a7ffa17f025265b5b94f40f0c

ge

性別

字串或清單<string>

必須雜湊。
我們接受以小楷首字母表示性別。


範例:

  • f 表示女性
  • m 表示男性
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_addressclient_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 中。請參閱管理 fbcfbp 參數,了解如何獲取此值或從 fbclid 查詢參數產生此值。

格式為 fb.${subdomain_index}.${creation_time}.${fbclid}


範例:
fb.1.1554763741205.AbCdEfGhIjKlMnOpQrStUvWxYz1234567890

fbp

瀏覽器編號

字串

請勿雜湊。
Facebook 瀏覽器編號值儲存在您網域下的 _fbp 瀏覽器 Cookie 中。請參閱管理 fbcfbp 參數,了解如何獲取此值。

格式為 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 取得。