Hãy sử dụng hướng dẫn này để khắc phục tỷ lệ khớp thấp và các lỗi thường gặp có thể xảy ra trong quá trình tích hợp tính năng So khớp khách hàng.
Xác thực tỷ lệ khớp
Đảm bảo rằng bạn đã hoàn tất quy trình tải lên trước khi cố gắng xác thực tỷ lệ trùng khớp.
Tỷ lệ khớp của bạn có thể thấp hơn dự kiến vì một số lý do, bao gồm:
- Dữ liệu chưa được băm trước khi tải lên.
- Dữ liệu không được định dạng đúng cách trước khi được băm.
- Bạn đang so sánh với tỷ lệ trùng khớp trong một hệ thống khác.
- Bạn đang cố gắng thêm nhiều giá trị nhận dạng người dùng vào một đối tượng
UserIdentifierduy nhất. Thay vào đó, hãy thêm nhiều đối tượngUserIdentifiervào một đối tượngUserDataduy nhất như trong ví dụ về mã này.
Nhà quảng cáo có thể tiếp cận từ 1% đến 99% danh sách của họ, tuỳ thuộc vào mức độ hoạt động của người dùng trên Google Tìm kiếm, Gmail hoặc YouTube. Để xem hướng dẫn chi tiết hơn về cách khắc phục sự cố tỷ lệ khớp thấp, hãy truy cập vào Trung tâm trợ giúp.
Sự khác biệt giữa tỷ lệ khớp và quy mô danh sách
Kích thước danh sách và tỷ lệ trùng khớp phản ánh các giá trị khác nhau. Tỷ lệ khớp tính tất cả người dùng có Tài khoản Google, ngay cả khi bạn không thể tiếp cận họ bằng danh sách So khớp khách hàng. Số lượng người dùng trong danh sách là số người dùng đang hoạt động đã khớp với một Tài khoản Google và có thể được tiếp cận bằng tính năng cá nhân hoá quảng cáo.
Gỡ lỗi thường gặp
| Lỗi | |
|---|---|
USER_PERMISSION_DENIED
|
Bạn có thể gặp phải lỗi về quyền nếu cố gắng sửa đổi một danh sách do tài khoản khác tạo. Bạn chỉ có thể chỉnh sửa danh sách do tài khoản của chính mình tạo. |
EXTERNAL_UPDATE_ID_ALREADY_EXISTS
|
Lỗi này có thể xảy ra nếu bạn cố gắng tạo nhiều công việc có cùng
external_id.
|
CONFLICTING_OPERATION
|
Lỗi này có thể xảy ra nếu các thao tác remove được kết hợp với các thao tác create trong một công việc.
|
TOO_MANY_USER_IDENTIFIERS
|
Các thao tác create trong một công việc chứa tổng cộng hơn 100.000 user_identifiers. Chia yêu cầu thành nhiều yêu cầu không vượt quá giới hạn đó.
|
CONCURRENT_MODIFICATION
|
Lỗi này có thể xảy ra nếu bạn cố gắng thao tác trên cùng một danh sách cùng một lúc. |
RESOURCE_EXHAUSTED
|
Lỗi này có thể xảy ra nếu bạn cố gắng gửi quá nhiều yêu cầu. Bạn có thể giảm thiểu điều này bằng cách xử lý hàng loạt các thao tác theo quy trình sử dụng được đề xuất. Bạn cũng có thể tham khảo hướng dẫn về các phương pháp hay nhất đối với hạn mức và hạn ngạch API. |
CUSTOMER_NOT_ALLOWLISTED_FOR_THIS_FEATURE
|
Lỗi này xảy ra nếu dự án Google Cloud của bạn (hoặc mã thông báo nhà phát triển cũ, không được dùng nữa từ ngày 9 tháng 9 năm 2026) không có yêu cầu nào về tính năng So khớp khách hàng trong khoảng thời gian từ ngày 1 tháng 10 năm 2025 đến ngày 31 tháng 3 năm 2026. Bạn phải sử dụng Data Manager API cho quy trình So khớp khách hàng. |
Hỗ trợ khắc phục sự cố khác
Nếu bạn vẫn gặp vấn đề, hãy liên hệ với chúng tôi thông qua công cụ khắc phục sự cố So khớp khách hàng.