Khắc phục các vấn đề về danh sách khách hàng
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
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 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 được định dạng không chính xác 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 UserIdentifier duy nhất. Thay vào đó, hãy thêm nhiều 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% 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
Xin lưu ý rằng 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 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
đang hoạt động khớp với một Tài khoản Google và có thể được tính năng cá nhân hoá của Google Ads tiếp cận.
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 một 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 tác vụ.
|
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 vấn đề này bằng cách gộp 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 chế về API.
|
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ố về tính năng So khớp khách hàng.
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-09-05 UTC.
[null,null,["Cập nhật lần gần đây nhất: 2025-09-05 UTC."],[[["\u003cp\u003eThis guide helps you troubleshoot low Customer Match rates and debug common errors during integration.\u003c/p\u003e\n"],["\u003cp\u003eLow match rates can stem from data formatting issues, hashing problems, or comparing against different systems.\u003c/p\u003e\n"],["\u003cp\u003eMatch rate and list size differ: match rate includes all matched Google Accounts, while list size only includes active, reachable users.\u003c/p\u003e\n"],["\u003cp\u003eCommon errors like permission issues, conflicting operations, and exceeding user identifier limits are addressed with solutions.\u003c/p\u003e\n"],["\u003cp\u003eFor persistent issues, consult the Customer Match troubleshooter or Help Center for detailed guidance.\u003c/p\u003e\n"]]],[],null,["# Troubleshoot customer list issues\n\nUse this guide to help you troubleshoot low match rates and common errors that\nmight come up in your Customer Match integration.\n\nValidate match rate\n-------------------\n\nEnsure that your upload job has completed before attempting to validate your\nmatch rate.\n\nYour match rate might be lower than expected for a number of reasons, including:\n\n- The data was not hashed before it was uploaded.\n\n- The data was not correctly formatted before it was hashed.\n\n- You are comparing against match rates in a different system.\n\n- You are trying to add multiple user identifiers to a single `UserIdentifier`\n object. Instead, add multiple `UserIdentifier`s to a single `UserData`\n object as shown in this\n [code example](/google-ads/api/docs/remarketing/audience-segments/customer-match/get-started#code_example).\n\nIt's possible for an advertiser to reach anywhere from 1% to 99% of their list,\nbased on how active their users are on Google Search, Gmail, or YouTube. For a\nmore detailed guide on troubleshooting low match rates, visit the [Help\nCenter](//support.google.com/google-ads/answer/7474166).\n\n### Differences between match rate and list size\n\nNote that list size and match rate reflect different values. Match rate\ncounts all users with a Google Account even if they are not actually able to be\nreached with the Customer Match list. List size counts\n[active](//support.google.com/google-ads/answer/7474166?#zippy=%2Ctroubleshoot-low-traffic)\nusers that matched a Google Account and are able to be reached by Ads\npersonalization.\n\nDebug common errors\n-------------------\n\n| Error ||\n|----------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| [`USER_PERMISSION_DENIED`](/google-ads/api/reference/rpc/v21/AuthorizationErrorEnum.AuthorizationError#user_permission_denied) | You might run into permissions errors if you attempt to modify a list that was created by another account. You can only edit a list that your own account created. |\n| [`EXTERNAL_UPDATE_ID_ALREADY_EXISTS`](/google-ads/api/reference/rpc/v21/OfflineUserDataJobErrorEnum.OfflineUserDataJobError#external_update_id_already_exists) | This error can occur if you attempt to create multiple jobs with the same [`external_id`](/google-ads/api/reference/rpc/v21/OfflineUserDataJob#external_id). |\n| [`CONFLICTING_OPERATION`](/google-ads/api/reference/rpc/v21/OfflineUserDataJobErrorEnum.OfflineUserDataJobError#conflicting_operation) | This error can occur if `remove` operations are mixed with `create` operations in a single job. |\n| [`TOO_MANY_USER_IDENTIFIERS`](/google-ads/api/reference/rpc/v21/OfflineUserDataJobErrorEnum.OfflineUserDataJobError#too_many_user_identifiers) | The `create` operations in a single job contain more than 100,000 `user_identifiers` in total. Split the request into multiple requests that don't exceed that limit. |\n| [`CONCURRENT_MODIFICATION`](/google-ads/api/reference/rpc/v21/DatabaseErrorEnum.DatabaseError#concurrent_modification) | This error can occur if you try to operate on the same list at the same time. |\n| [`RESOURCE_EXHAUSTED`](/google-ads/api/reference/rpc/v21/QuotaErrorEnum.QuotaError#resource_exhausted) | This error can occur if you try to send too many requests. You can mitigate this by batching your operations as per the recommended [usage flow](/google-ads/api/docs/remarketing/audience-segments/customer-match/get-started#usage-flow). You can also refer to the best practices guide for [API limits and quotas](/google-ads/api/docs/best-practices/quotas). |\n\nAdditional troubleshooting support\n----------------------------------\n\nIf you're still having issues, reach out to us through the Customer Match\n[troubleshooter](//support.google.com/google-ads/troubleshooter/10028577)."]]
