Thông số thông tin khách hàng

Thông số thông tin khách hàng là nhóm thông tin nhận dạng người dùng mà bạn chia sẻ cùng với thông tin sự kiện của mình. Để biết thêm thông tin về các thông số bắt buộc và được đề xuất, hãy xem phần Cách làm tốt nhất - API Chuyển đổi: Gửi các thông số bắt buộc và được đề xuất.

Bản phát hành API Đồ thị v13.0 có một số yêu cầu mới về những cách kết hợp thông số thông tin khách hàng được xem là hợp lệ. Vui lòng xem lại cách làm tốt nhất để đảm bảo tiện ích tích hợp API Chuyển đổi của bạn không bị gián đoạn.

Vui lòng truy cập vào Hướng dẫn của Meta về quyền riêng tư và việc sử dụng dữ liệu để tìm hiểu dữ liệu nào được gửi khi sử dụng API Chuyển đổi.

Các hệ thống của chúng tôi được thiết kế để không chấp nhận thông tin khách hàng là Thông tin liên hệ chưa băm, trừ khi được nêu bên dưới. Thông tin liên hệ là những thông tin xác định danh tính của cá nhân, chẳng hạn như tên, địa chỉ email và số điện thoại. Chúng tôi chỉ dùng những thông tin này cho mục đích so khớp. Nếu bạn đang sử dụng Meta Business SDK, quá trình băm sẽ được thực hiện tự động.

So sánh pixel

Bạn có thể gửi nhiều thông số thông tin khách hàng qua Meta Pixel, mặc dù một vài thông số (ví dụ: client_user_agent) sẽ được gửi tự động trong cách thức hoạt động của Internet. Ví dụ: sử dụng mã dưới đây để gửi external_id qua Pixel:

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

Hãy đọc tài liệu về tính năng So khớp nâng cao để biết các thông số khác mà bạn có thể chuyển qua Pixel.

Ngược lại, hãy nhớ áp dụng cho phía máy chủ chính nhóm thông số thông tin khách hàng mà hệ thống của bạn đang chia sẻ với phía trình duyệt.

Định dạng thông số `user_data`

Bạn phải cung cấp ít nhất một trong các thông số user_data sau đây ở định dạng chính xác trong yêu cầu của mình.

Vui lòng tải file CSV này xuống

để xem các ví dụ về dữ liệu được băm và chuẩn hóa đúng cách cho các thông số bên dưới.

Tải xuống (Nhấp chuột phải > Lưu liên kết dưới dạng)

Thông số	Mô tả
`em` Email string hoặc list<string>	Cần phải băm. Cắt khoảng trắng ở đầu và cuối. Chuyển đổi toàn bộ ký tự thành chữ thường. Ví dụ: Đầu vào: John_Smith@gmail.com Định dạng được chuẩn hóa: john_smith@gmail.com Đầu ra SHA256 dự kiến: 62a14e44f765419d10fea99367361a727c12365e2520f32218d505ed9aa0f62f
`ph` Số điện thoại string hoặc list<string>	Cần phải băm. Gỡ các biểu tượng, chữ cái và bất kỳ số 0 nào ở đầu. Số điện thoại phải chứa mã quốc gia sẽ được dùng cho mục đích so khớp (ví dụ: số 1 phải đứng trước số điện thoại ở Hoa Kỳ). Luôn thêm mã quốc gia vào số điện thoại của khách hàng, ngay cả khi tất cả dữ liệu của bạn đều thuộc cùng một quốc gia. Ví dụ: Đầu vào: Số điện thoại ở Hoa Kỳ (650)555-1212 Định dạng được chuẩn hóa: 16505551212 Đầu ra SHA256 dự kiến: e323ec626319ca94ee8bff2e4c87cf613be6ea19919ed1364124e16807ab3176
`fn` Tên string hoặc list<string>	Cần phải băm. Nên sử dụng các ký tự a-z theo bảng chữ cái La Mã. Chỉ dùng chữ thường, không có dấu câu. Nếu sử dụng ký tự đặc biệt, bạn phải mã hóa văn bản theo định dạng UTF-8. Ví dụ: Đầu vào: Mary Định dạng được chuẩn hóa: mary Đầu ra SHA256 dự kiến: 6915771be1c5aa0c886870b6951b03d7eafc121fea0e80a5ea83beb7c449f4ec Đầu vào: 정 Định dạng được chuẩn hóa: ký tự UTF-8 "정" Đầu ra SHA256 dự kiến: 8fa8cd9c440be61d0151429310034083132b35975c4bea67fdd74158eb51db14 Đầu vào: Valéry Định dạng được chuẩn hóa: valéry Đầu ra SHA256 dự kiến: 08e1996b5dd49e62a4b4c010d44e4345592a863bb9f8e3976219bac29417149c
`ln` Họ string hoặc list<string>	Cần phải băm. Nên sử dụng các ký tự a-z theo bảng chữ cái La Mã. Chỉ dùng chữ thường, không có dấu câu. Nếu sử dụng ký tự đặc biệt, bạn phải mã hóa văn bản theo định dạng UTF-8. Hãy xem ví dụ trong phần Tên (`fn`).
`db` Ngày sinh string hoặc list<string>	Cần phải băm. Chúng tôi chấp nhận định dạng YYYYMMDD cung cấp nhiều cách kết hợp tháng, ngày và năm, có hoặc không có dấu câu. Năm: Sử dụng định dạng YYYY từ năm 1900 đến năm hiện tại. Tháng: Sử dụng định dạng MM: từ 01 đến 12. Ngày: Sử dụng định dạng DD: từ 01 đến 31. Ví dụ: Đầu vào: 2/16/1997 Định dạng được chuẩn hóa: 19970216 Đầu ra SHA256 dự kiến: 01acdbf6ec7b4f478a225f1a246e5d6767eeab1a7ffa17f025265b5b94f40f0c
`ge` Giới tính string hoặc list<string>	Cần phải băm. Chúng tôi chấp nhận giới tính ở dạng chữ cái đầu tiên bằng chữ thường. Ví dụ: f là nữ m là nam
`ct` Thành phố string hoặc list<string>	Cần phải băm. Nên sử dụng các ký tự a-z theo bảng chữ cái La Mã. Chỉ dùng chữ thường không có dấu câu, không có ký tự đặc biệt và không có dấu cách. Nếu sử dụng ký tự đặc biệt, bạn phải mã hóa văn bản theo định dạng UTF-8. Ví dụ: paris london newyork
`st` Tiểu bang string hoặc list<string>	Cần phải băm. Sử dụng mã viết tắt ANSI gồm 2 ký tự ở dạng chữ thường. Chuẩn hóa các tiểu bang bên ngoài Hoa Kỳ bằng chữ thường không có dấu câu, không có ký tự đặc biệt và không có dấu cách. Ví dụ: az ca
`zp` Mã zip string hoặc list<string>	Cần phải băm. Sử dụng chữ thường không có dấu cách và dấu gạch ngang. Chỉ sử dụng 5 chữ số đầu tiên cho mã zip của Hoa Kỳ. Sử dụng định dạng vùng, quận và khu cho mã zip của Vương quốc Anh. Ví dụ: Mã zip của Hoa Kỳ: 94035 Mã zip của Úc: 1987 Mã zip của Pháp: 75018 Mã zip của Vương quốc Anh: m11ae
`country` Quốc gia string hoặc list<string>	Cần phải băm. Sử dụng mã quốc gia gồm 2 chữ cái viết thường theo tiêu chuẩn ISO 3166-1 alpha-2. Lưu ý quan trọng: Luôn thêm quốc gia của khách hàng ngay cả khi mọi mã quốc gia của bạn đều thuộc cùng một quốc gia. Chúng tôi so khớp trên phạm vi toàn cầu và bước đơn giản này sẽ giúp chúng tôi so khớp nhiều tài khoản trong Trung tâm tài khoản nhất có thể từ danh sách của bạn. Ví dụ: Đầu vào: Hoa Kỳ Định dạng được chuẩn hóa: us Đầu ra SHA256 dự kiến: 79adb2a2fce5c6ba215fe5f27f532d4e7edbac4b6a5e09e1ef3a08084a904621
`external_id` ID bên ngoài string hoặc list<string>	Nên băm. Bất kỳ ID duy nhất nào nhận được từ nhà quảng cáo, chẳng hạn như ID thành viên trong chương trình khách hàng thân thiết, ID người dùng và ID cookie bên ngoài. Bạn có thể gửi một hoặc nhiều ID bên ngoài cho một sự kiện cụ thể. Nếu đang được gửi qua các kênh khác, ID bên ngoài cần có định dạng giống như khi gửi qua API Chuyển đổi.
`client_ip_address` Địa chỉ IP máy khách string	Không băm. Địa chỉ IP của trình duyệt tương ứng với sự kiện phải là địa chỉ IPV4 hoặc IPV6 hợp lệ. IPV6 được ưu tiên hơn IPV4 đối với người dùng đã bật IPV6. Tuyệt đối không băm thông số dữ liệu người dùng `client_ip_address`. Không được thêm dấu cách. Luôn cung cấp địa chỉ IP thực để đảm bảo báo cáo sự kiện chính xác. Lưu ý: Thông tin này sẽ tự động được thêm vào các sự kiện được gửi qua trình duyệt. Tuy nhiên, bạn phải đặt cấu hình thủ công thông tin này đối với các sự kiện được gửi qua máy chủ. Ví dụ: IPV4: 168.212.226.204 IPV6: 2001:0db8:85a3:0000:0000:8a2e:0370:7334
`client_user_agent` Tác nhân người dùng của máy khách string	Không băm. Tác nhân người dùng cho trình duyệt tương ứng với sự kiện. Bắt buộc có `client_user_agent` đối với các sự kiện trên trang web được chia sẻ bằng API Chuyển đổi. Việc gửi cả thông số `client_ip_address` và `client_user_agent` đối với mọi sự kiện mà bạn đang gửi qua API Chuyển đổi có thể góp phần cải thiện khả năng so khớp sự kiện, đồng thời tăng hiệu quả phân phối quảng cáo cho bất kỳ chiến dịch quảng cáo nào tối ưu hóa cho sự kiện mà bạn gửi qua API Chuyển đổi. Lưu ý: Thông tin này sẽ tự động được thêm vào các sự kiện được gửi qua trình duyệt. Tuy nhiên, bạn phải đặt cấu hình thủ công thông tin này đối với các sự kiện được gửi qua máy chủ. Ví dụ: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, như Gecko) Chrome/87.0.4280.141 Safari/537.36
`fbc` ID lượt click string	Không băm. Giá trị ID lượt click trên Facebook được lưu trữ trong cookie trình duyệt `_fbc` thuộc miền của bạn. Hãy xem phần Quản lý thông số `fbc` và `fbp` để biết cách lấy giá trị này hoặc tạo giá trị này từ thông số truy vấn `fbclid`. Định dạng là `fb.${subdomain_index}.${creation_time}.${fbclid}`. Ví dụ: fb.1.1554763741205.AbCdEfGhIjKlMnOpQrStUvWxYz1234567890
`fbp` ID trình duyệt string	Không băm. Giá trị ID trình duyệt trên Facebook được lưu trữ trong cookie trình duyệt `_fbp` thuộc miền của bạn. Hãy xem phần Quản lý thông số `fbc` và `fbp` để biết cách lấy giá trị này. Định dạng là `fb.${subdomain_index}.${creation_time}.${random_number}`. Ví dụ: fb.1.1596403881668.1116446470
`subscription_id` ID đăng ký string	Không băm. ID đăng ký cho người dùng trong giao dịch này. ID này tương tự như ID đơn đặt hàng cho một sản phẩm riêng lẻ.
`fb_login_id` ID đăng nhập bằng Facebook integer	Không băm. ID do Meta cấp khi một người đăng nhập lần đầu vào một phiên bản của ứng dụng. ID này còn được gọi là ID người dùng trong ứng dụng.
`lead_id` ID khách hàng tiềm năng integer	Không băm. ID liên kết với một khách hàng tiềm năng do Quảng cáo tìm kiếm khách hàng tiềm năng của Meta tạo ra.
`anon_id` string	Không băm. ID lượt cài đặt. Trường này biểu thị phiên bản cài đặt ứng dụng duy nhất. Lưu ý: Thông số này chỉ dành cho các sự kiện trong ứng dụng
`madid` string	ID nhà quảng cáo di động, ID quảng cáo từ thiết bị Android hoặc Mã nhận dạng quảng cáo (IDFA) từ thiết bị Apple.
`page_id` string	Không băm. ID Trang của bạn. Chỉ định ID trang được liên kết với sự kiện. Sử dụng ID trang Facebook của trang được liên kết với bot.
`page_scoped_user_id` string	Không băm. Chỉ định ID người dùng trong trang được liên kết với bot Messenger ghi sự kiện. Sử dụng ID người dùng trong trang được cung cấp cho webhook của bạn.
`ctwa_clid` string	Không băm. ID lượt click do Meta tạo cho các quảng cáo click đến WhatsApp.
`ig_account_id` string	Không băm. ID tài khoản Instagram được liên kết với doanh nghiệp.
`ig_sid` string	Không băm. Người dùng tương tác với Instagram được xác định bằng ID người dùng trong Instagram (IGSID). Bạn có thể lấy IGSID từ webhook này.

Thông số thông tin khách hàng

So sánh pixel

Định dạng thông số user_data

Xem thêm

Định dạng thông số `user_data`