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

Z tego przewodnika dowiesz się, jak rozwiązywać problemy z niskim współczynnikiem dopasowania i typowymi błędami, które mogą wystąpić podczas integracji z kierowaniem na listę klientów.

Sprawdzanie współczynnika dopasowania

Zanim sprawdzisz współczynnik dopasowania, upewnij się, że zadanie przesyłania zostało ukończone.

Współczynnik dopasowania może być niższy niż oczekiwany z kilku powodów, m.in.:

  • dane nie zostały zaszyfrowane 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 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 tego, jak aktywni są oni w wyszukiwarce Google, Gmailu lub YouTube. Bardziej szczegółowy przewodnik dotyczący rozwiązywania problemów z niskim współczynnikiem 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ę, która została utworzona przez inne konto, mogą wystąpić błędy uprawnień. Możesz edytować tylko listę utworzoną przez Twoje konto.
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 operacje remove są mieszane z create operacjami w jednym zadaniu.
TOO_MANY_USER_IDENTIFIERS Operacje create w jednym zadaniu zawierają łącznie ponad 100 tys. 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 sposobem użycia. Zapoznaj się też z przewodnikiem po sprawdzonych metodach dotyczącym limitów i limitów przydziału interfejsu API.
CUSTOMER_NOT_ALLOWLISTED_FOR_THIS_FEATURE Ten błąd występuje, jeśli token dewelopera nie wysłał wcześniej żądań kierowania na listę klientów przed 1 kwietnia 2026 r. Zamiast tego musisz używać interfejsu Data Manager API do procesów związanych z kierowaniem na listę klientów.

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 .