Rozwiązywanie problemów z listą klientów
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Ten przewodnik pomoże Ci rozwiązać problemy z niskim współczynnikiem dopasowania i typowe błędy, które mogą wystąpić podczas integracji kierowania na listę klientów.
Weryfikowanie współczynnika dopasowania
Zanim spróbujesz sprawdzić współczynnik dopasowania, upewnij się, że zadanie przesyłania zostało zakończone.
Współczynnik dopasowania może być niższy od oczekiwanego z wielu powodów, m.in.:
Dane nie zostały zahaszowane przed przesłaniem.
Dane nie zostały prawidłowo sformatowane przed zaszyfrowaniem.
Porównujesz dane z innego systemu.
Próbujesz dodać wiele identyfikatorów użytkowników do jednego obiektu UserIdentifier. Zamiast tego dodaj wiele elementów UserIdentifier do jednego obiektu UserData, jak pokazano w tym przykładzie kodu.
Reklamodawca może docierać do 1–99% użytkowników z listy w zależności od ich aktywności w wyszukiwarce Google, Gmailu lub YouTube. Bardziej szczegółowy przewodnik dotyczący rozwiązywania problemów z niskimi współczynnikami dopasowania znajdziesz w Centrum pomocy.
Różnice między wskaźnikiem dopasowania a rozmiarem listy
Pamiętaj, że rozmiar listy i współczynnik dopasowania odzwierciedlają różne wartości. Współczynnik dopasowania
obejmuje wszystkich użytkowników z kontem Google, nawet jeśli nie można do nich dotrzeć za pomocą listy kierowania na listę klientów. Rozmiar listy obejmuje aktywnych użytkowników, którzy pasują do konta Google i do których można dotrzeć za pomocą personalizacji reklam w Google Ads.
Debugowanie typowych błędów
| Błąd |
USER_PERMISSION_DENIED
|
Jeśli spróbujesz zmodyfikować listę utworzoną przez inne konto, mogą wystąpić błędy związane z uprawnieniami. Możesz edytować tylko listę utworzoną na Twoim koncie.
|
EXTERNAL_UPDATE_ID_ALREADY_EXISTS
|
Ten błąd może wystąpić, jeśli spróbujesz utworzyć kilka zadań z tym samym external_id.
|
CONFLICTING_OPERATION
|
Ten błąd może wystąpić, jeśli w ramach jednego zadania operacje remove są mieszane z operacjami create.
|
TOO_MANY_USER_IDENTIFIERS
|
Operacje create w ramach jednego zadania zawierają łącznie ponad 100 tys. user_identifiers. Podziel żądanie na kilka mniejszych, które nie przekraczają tego limitu.
|
CONCURRENT_MODIFICATION
|
Ten błąd może wystąpić, jeśli spróbujesz wykonać operację na tej samej liście w tym samym czasie.
|
RESOURCE_EXHAUSTED
|
Ten błąd może wystąpić, jeśli spróbujesz wysłać zbyt wiele żądań. Możesz temu zapobiec, grupując operacje zgodnie z zalecanym
sposobem użycia. Możesz też zapoznać się z przewodnikiem po sprawdzonych metodach dotyczącym limitów interfejsu API.
|
Dodatkowa pomoc w rozwiązywaniu problemów
Jeśli nadal masz problemy, skontaktuj się z nami za pomocą narzędzia do rozwiązywania problemów dotyczących kierowania na listę klientów.
O ile nie stwierdzono inaczej, treść tej strony jest objęta licencją Creative Commons – uznanie autorstwa 4.0, a fragmenty kodu są dostępne na licencji Apache 2.0. Szczegółowe informacje na ten temat zawierają zasady dotyczące witryny Google Developers. Java jest zastrzeżonym znakiem towarowym firmy Oracle i jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2025-08-27 UTC.
[null,null,["Ostatnia aktualizacja: 2025-08-27 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)."]]
