Probleme mit der Kundenliste beheben

In diesem Leitfaden finden Sie Informationen zur Behebung von Problemen mit niedrigen Abgleichsraten und häufigen Fehlern, die bei der Integration des Kundenabgleichs auftreten können.

Abgleichsrate prüfen

Der Uploadjob muss abgeschlossen sein, bevor Sie die Abgleichsrate validieren können.

Die Abgleichsrate kann aus verschiedenen Gründen niedriger als erwartet sein, 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 mehrere UserIdentifier-Objekte zu einem einzelnen UserData-Objekt hinzu, wie in diesem Codebeispiel gezeigt.

Werbetreibende können zwischen 1 % und 99 % der Nutzer auf ihrer Liste erreichen, je nachdem, wie aktiv diese in der Google Suche, in Gmail oder auf YouTube sind. Eine ausführliche Anleitung zur Fehlerbehebung bei niedrigen Übereinstimmungsraten finden Sie in der Hilfe.

Unterschiede zwischen Abgleichsrate und Listengröße

Listengröße und Abgleichsrate spiegeln unterschiedliche Werte wider. Bei der Abgleichsrate werden alle Nutzer mit einem Google-Konto berücksichtigt, auch wenn sie nicht über die Liste zum Kundenabgleich erreicht werden können. Die Listengröße entspricht der Anzahl der aktiven Nutzer, die einem Google-Konto zugeordnet wurden und über personalisierte Werbung erreicht werden können.

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 Sie mit Ihrem eigenen Konto erstellt haben.
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 mit create-Vorgängen in einem einzelnen Job gemischt 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 Vorgänge für dieselbe Liste auszuführen.
RESOURCE_EXHAUSTED Dieser Fehler kann auftreten, wenn Sie versuchen, zu viele Anfragen zu senden. Sie können dies minimieren, indem Sie Ihre Vorgänge gemäß dem empfohlenen Nutzungsablauf im Batch verarbeiten. Weitere Informationen finden Sie im Best-Practices-Leitfaden für API-Limits und -Kontingente.
CUSTOMER_NOT_ALLOWLISTED_FOR_THIS_FEATURE Dieser Fehler tritt auf, wenn Ihr Google Cloud-Projekt (oder Ihr Legacy-Entwicklertoken, das am 9. September 2026 eingestellt wird) zwischen dem 1. Oktober 2025 und dem 31. März 2026 keine Anfragen zum Kundenabgleich hatte. Sie müssen stattdessen die Data Manager API für Workflows zum Kundenabgleich verwenden.

Zusätzliche Unterstützung bei der Fehlerbehebung

Sollten weiterhin Probleme auftreten, wenden Sie sich bitte über die Fehlerbehebung für den Kundenabgleich an uns.