Wenn Sie sich mit anderen Nutzern über unsere Produkte austauschen und Feedback geben möchten, können Sie dem offiziellen Google Ads-Discord-Kanal auf dem Server der
Google Advertising and Measurement Community beitreten.
Probleme mit der Kundenliste beheben
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
In diesem Leitfaden finden Sie Informationen zur Fehlerbehebung bei niedrigen Abgleichsraten und häufigen Fehlern, die bei der Integration des Kundenabgleichs auftreten können.
Abgleichsrate validieren
Warten Sie, bis der Upload abgeschlossen ist, bevor Sie versuchen, die Abgleichsrate zu validieren.
Dafür kann es verschiedene Gründe geben, z. B.:
Die Daten wurden vor dem Hochladen nicht gehasht.
Die Daten wurden vor dem Hashen nicht richtig formatiert.
Sie vergleichen die Abgleichsraten mit denen in einem anderen System.
Sie versuchen, einem einzelnen UserIdentifier-Objekt mehrere Nutzer-IDs hinzuzufügen. Fügen Sie stattdessen einem einzelnen UserData-Objekt mehrere UserIdentifier-Objekte hinzu, wie in diesem Codebeispiel gezeigt.
Je nachdem, wie aktiv die Nutzer in der Google Suche, in Gmail oder auf YouTube sind, kann ein Werbetreibender zwischen 1% und 99% seiner Liste erreichen. Eine ausführlichere Anleitung zur Fehlerbehebung bei niedrigen Übereinstimmungsraten finden Sie in der Hilfe.
Unterschiede zwischen Übereinstimmungsrate und Listengröße
Die Listengröße und die Abgleichsrate geben unterschiedliche Werte an. Bei der Abgleichsrate werden alle Nutzer mit einem Google-Konto berücksichtigt, auch wenn sie mit der Liste zum Kundenabgleich nicht erreicht werden können. Die Listengröße umfasst aktive Nutzer, die einem Google-Konto zugeordnet sind und für die die Anzeigenpersonalisierung aktiviert ist.
Häufige Fehler beheben
| Fehler |
USER_PERMISSION_DENIED
|
Wenn Sie versuchen, eine Liste zu ändern, die von einem anderen Konto erstellt wurde, können Berechtigungsfehler auftreten. Sie können nur Listen bearbeiten, die mit Ihrem eigenen Konto erstellt wurden.
|
EXTERNAL_UPDATE_ID_ALREADY_EXISTS
|
Dieser Fehler kann auftreten, wenn Sie versuchen, mehrere Jobs mit derselben external_id zu erstellen.
|
CONFLICTING_OPERATION
|
Dieser Fehler kann auftreten, wenn remove-Vorgänge in einem einzelnen Job mit create-Vorgängen kombiniert werden.
|
TOO_MANY_USER_IDENTIFIERS
|
Die create-Vorgänge in einem einzelnen Job enthalten insgesamt mehr als 100.000 user_identifiers. Teilen Sie die Anfrage in mehrere Anfragen auf, die dieses Limit nicht überschreiten.
|
CONCURRENT_MODIFICATION
|
Dieser Fehler kann auftreten, wenn Sie versuchen, gleichzeitig auf dieselbe Liste zuzugreifen.
|
RESOURCE_EXHAUSTED
|
Dieser Fehler kann auftreten, wenn Sie zu viele Anfragen senden. Sie können dieses Problem beheben, indem Sie Ihre Vorgänge gemäß dem empfohlenen
Nutzungsablauf in Batches zusammenfassen. Weitere Informationen finden Sie im Leitfaden zu API-Limits und ‑Kontingenten.
|
Zusätzliche Unterstützung bei der Fehlerbehebung
Wenn weiterhin Probleme auftreten, wenden Sie sich über die Fehlersuche für den Kundenabgleich an uns.
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-09-05 (UTC).
[null,null,["Zuletzt aktualisiert: 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)."]]
