Khắc phục các vấn đề về danh sách khách hàng

Hãy tham khảo 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 công việc tải lên của bạn đã hoàn tất trước khi bạn xác thực tỷ lệ 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 chính xác trước khi băm.
  • Bạn đang so sánh với tỷ lệ 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 UserIdentifier. Thay vào đó, hãy thêm nhiều đối tượng UserIdentifier vào một đối tượng UserData duy 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% người dùng trong 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

Quy mô danh sách và tỷ lệ 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 họ không thể tiếp cận được bằng danh sách So khớp khách hàng. Quy mô danh sách tính số người dùng đang hoạt động khớp với một Tài khoản Google và có thể tiếp cận được thông qua 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 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 bạn 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. Hãy 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 tại cùng một thời điểm.
RESOURCE_EXHAUSTED Lỗi này có thể xảy ra nếu bạn cố gửi quá nhiều yêu cầu. Bạn có thể giảm thiểu vấn đề này bằng cách phân lô 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 cho hạn mức và giới hạn của API.
CUSTOMER_NOT_ALLOWLISTED_FOR_THIS_FEATURE Lỗi này xảy ra nếu dự án Google Cloud (hoặc mã của nhà phát triển cũ, ngừng hoạt động 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. Thay vào đó, 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 trình khắc phục sự cố của tính năng So khớp khách hàng.