Probleme mit der Kundenliste beheben

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 eines anderen Systems.
  • Sie versuchen, einem einzelnen UserIdentifier-Objekt mehrere Nutzerkennungen hinzuzufügen. Fügen Sie stattdessen mehrere UserIdentifier-Objekte zu einem einzelnen UserData-Objekt 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 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 mit der Liste zum Kundenabgleich nicht erreicht werden können. Bei der Listengröße werden aktive Nutzer gezählt, die einem Google-Konto zugeordnet sind und für 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, treten möglicherweise Berechtigungsfehler auf. 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 demselben 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 Best Practices für API-Limits und ‑Kontingente.
CUSTOMER_NOT_ALLOWLISTED_FOR_THIS_FEATURE Dieser Fehler tritt auf, wenn in Ihrem Google Cloud-Projekt (oder Ihrem alten Entwicklertoken, das am 9. September 2026 eingestellt wurde) zwischen dem 1. Oktober 2025 und dem 31. März 2026 keine Anfragen zum Kundenabgleich gestellt wurden. Sie müssen stattdessen die Data Manager API für Workflows zum Kundenabgleich verwenden.

Zusätzliche Unterstützung bei der Fehlerbehebung

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