Rozwiązywanie problemów z listą klientów

Ten przewodnik pomoże Ci rozwiązać problemy z niskimi współczynnikami dopasowania i typowymi błędami, które mogą wystąpić podczas integracji kierowania na listę klientów.

Sprawdzanie współczynnika dopasowania

Przed próbą sprawdzenia współczynnika dopasowania upewnij się, że zadanie przesyłania zostało zakończone.

Współczynnik dopasowania może być niższy od oczekiwanego z kilku powodów, takich jak:

  • Dane nie zostały zahaszowane przed przesłaniem.
  • Dane nie zostały prawidłowo sformatowane przed zaszyfrowaniem.
  • Porównujesz współczynniki dopasowania w innym systemie.
  • Próbujesz dodać wiele identyfikatorów użytkowników do jednego obiektu UserIdentifier. Zamiast tego dodaj wiele obiektów UserIdentifier do pojedynczego obiektu UserData, jak pokazano w tym przykładzie kodu.

Reklamodawca może dotrzeć do 1–99% użytkowników z listy, w zależności od tego, jak aktywnie korzystają oni z wyszukiwarki Google, Gmaila lub YouTube. Bardziej szczegółowy przewodnik po rozwiązywaniu problemów z niskimi współczynnikami dopasowania znajdziesz w Centrum pomocy.

Różnice między współczynnikiem dopasowania a rozmiarem listy

Rozmiar listy i współczynnik dopasowania odzwierciedlają różne wartości. Współczynnik dopasowania uwzględnia 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 zostali dopasowani do konta Google i do których można dotrzeć dzięki personalizacji reklam.

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 uprawnień. 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ć wiele zadań z tym samym external_id.
CONFLICTING_OPERATION Ten błąd może wystąpić, jeśli w jednym zadaniu operacje remove są połączone z operacjami create.
TOO_MANY_USER_IDENTIFIERS Operacje create w pojedynczym zadaniu zawierają łącznie więcej niż 100 000 user_identifiers. Podziel żądanie na kilka żądań, 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 procesem użytkowania. Możesz też zapoznać się z przewodnikiem po sprawdzonych metodach dotyczącym limitów interfejsu API.
CUSTOMER_NOT_ALLOWLISTED_FOR_THIS_FEATURE Ten błąd występuje, jeśli w Twoim projekcie Google Cloud (lub w starszym tokenie programisty, który został wycofany 9 września 2026 r.) nie było żadnych żądań kierowania na listę klientów między 1 października 2025 r. a 31 marca 2026 r. W przypadku procesów związanych z kierowaniem na listę klientów musisz używać interfejsu Data Manager 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 z kierowaniem na listę klientów.