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.

Sprawdzanie 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, 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ć kilka 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 od 1% do 99% osób z listy w zależności od tego, jak aktywni są użytkownicy w wyszukiwarce Google, Gmailu lub YouTube. Bardziej szczegółowy przewodnik dotyczący rozwiązywania problemów z niskimi współczynnikami dopasowania znajdziesz w Centrum pomocy.

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

Rozmiar listy i odsetek dopasowań 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 listy utworzone 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 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 i przydziałów.
CUSTOMER_NOT_ALLOWLISTED_FOR_THIS_FEATURE Ten błąd występuje, jeśli w okresie od 1 października 2025 r. do 31 marca 2026 r. w Twoim projekcie Google Cloud (lub w przypadku starszego tokena dewelopera, który zostanie wycofany 9 września 2026 r.) nie było żadnych próśb dotyczących kierowania na listę klientów. 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.