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

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 dotrzeć 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 rozwiązywania problemów z niskimi współczynnikami dopasowania znajdziesz w Centrum pomocy.

Różnice między współczynnikiem 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.

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 jednym zadaniu operacje remove są mieszane z operacjami create.
TOO_MANY_USER_IDENTIFIERS Operacje create w jednym zadaniu 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 przepływem użycia. 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 Twój token programisty nie wysyłał wcześniej żądań kierowania na listę klientów przed 1 kwietnia 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.