顧客資訊參數

顧客資訊參數是您在分享事件資訊時所包含的一組用戶識別資料。如需有關必要和建議參數的更多資訊,請參閱最佳作法 - 轉換 API:傳送必要和建議的參數

在圖形 API 第 13.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>

需雜湊處理。
移除符號、字母和開頭的任何數字零。電話號碼必須包含用於配對的國碼/區碼(例如,美國的電話號碼前面必須加上數字 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 格式,可包含各種月、日、年的組合,有無標點符號皆可。

  • 年:使用從 1900 到目前年份的 YYYY 格式。
  • 月:使用 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 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_addressclient_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 中。請參閱管理 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 範圍用戶編號(IGSID)所識別。您可以從這個 Webhook 取得 IGSID。