Rozwiązywanie problemów

Zarządzanie konwersjami wymaga złożonej integracji, która często obejmuje wiele współzależnych narzędzi i procesów. W tym przewodniku znajdziesz szczegółowe instrukcje, które pomogą Ci rozwiązać problemy, niezależnie od tego, czy otrzymujesz z interfejsu API błędy, których nie rozumiesz, czy też nie masz pewności co do danych lub informacji diagnostycznych widocznych w interfejsie.

Odczytywanie danych w interfejsie Google Ads

Interfejs Google Ads nie porządkuje danych o konwersjach według daty importu, więc korzystanie z raportów kampanii w interfejsie do weryfikacji wyników importu może być mylące. Aby sprawdzić stan importu na poziomie żądania do interfejsu API, zacznij od diagnostyki danych offline. Diagnostyka danych offline nie ocenia asynchronicznego dopasowywania tagów ani jakości identyfikatorów użytkowników na potrzeby konwersji rozszerzonych. Aby sprawdzić stan dopasowania, zapoznaj się z raportami diagnostycznymi w interfejsie Google Ads dotyczącymi konwersji rozszerzonych dotyczących potencjalnych klientów i konwersji rozszerzonych w kampaniach internetowych. Instrukcje rozwiązywania problemów znajdziesz w artykule Alerty diagnostyczne w interfejsie po przesłaniu danych za pomocą interfejsu API.

Problemy z konwersjami rozszerzonymi dotyczącymi potencjalnych klientów

W tej sekcji znajdziesz rozwiązania typowych problemów, które mogą wystąpić podczas importowania konwersji rozszerzonych dotyczących potencjalnych klientów.

Typowe błędy

Poniższe wskazówki pomogą Ci diagnozować i rozwiązywać typowe błędy związane z konwersjami rozszerzonymi dotyczącymi potencjalnych klientów.

Błąd
NO_CONVERSION_ACTION_FOUND	Określone działanie powodujące konwersję nie jest włączone lub nie jest dostępne dla konta w polu customer_id żądania. Sprawdź, czy działanie powodujące konwersję w przesłanym pliku jest włączone i czy jego właścicielem jest klient Google Ads, który uzyskał konwersję z kliknięcia, lub konto w hierarchii śledzenia konwersji konta, z którego przesłano plik. Ten błąd może też wystąpić, jeśli identyfikator GCLID w żądaniu należy do konta klienta, które nie ma dostępu do działania powodującego konwersję określonego w żądaniu. Możesz sprawdzić, czy identyfikator kliknięcia Google należy do konta klienta, korzystając z zasobu click_view. W tym celu prześlij zapytanie, które filtruje według click_view.gclid i segments.date, gdzie data to data kliknięcia.
INVALID_CONVERSION_ACTION_TYPE	Określone działanie powodujące konwersję ma typ, który nie jest prawidłowy w przypadku konwersji rozszerzonych dotyczących potencjalnych klientów. Upewnij się, że element ConversionAction określony w żądaniu przesyłania ma typ UPLOAD_CLICKS.
CUSTOMER_NOT_ENABLED_ENHANCED_CONVERSIONS_FOR_LEADS	Upewnij się, że w ustawieniach konwersji masz włączone konwersje rozszerzone dotyczące potencjalnych klientów. Instrukcje znajdziesz w przewodniku dotyczącym wymagań wstępnych.
DUPLICATE_ORDER_ID	Nie udało się przetworzyć zaimportowanych zdarzeń, ponieważ zawierają one wiele konwersji z tym samym identyfikatorem zamówienia. Upewnij się, że identyfikatory zamówień są unikalne, i spróbuj ponownie.
CLICK_NOT_FOUND	Nie znaleziono kliknięcia pasującego do podanych identyfikatorów użytkowników. Jeśli konwersja wywoła to ostrzeżenie, interfejs Google Ads API uwzględni ją w polu successful_event_count w diagnostyce danych offline. Interfejs Google Ads API zawiera wpis dotyczący CLICK_NOT_FOUND w kolekcji alerts, dzięki czemu możesz sprawdzać, jak często pojawia się to ostrzeżenie. Ten błąd jest oczekiwany, jeśli kliknięcie nie pochodzi z kampanii Google Ads. Może on pochodzić np. z SA360 lub DV360. Inne możliwe przyczyny: Klient przesyłający dane jest inny niż klient, który dokonał konwersji Google Ads. Tagowanie w formularzu kontaktowym jest nieprawidłowo skonfigurowane. Przesłane dane nie zostały prawidłowo znormalizowane i zaszyfrowane. W rzadkich przypadkach, gdy klient przesyłający dane jest inny niż klient konwersji Google Ads, ten błąd może oznaczać, że klient przesyłający dane zaakceptował warunki korzystania z danych klientów, ale klient wyświetlający reklamy tego nie zrobił. Aby sprawdzić, czy konto zaakceptowało warunki dotyczące danych klienta, wyślij zapytanie do zasobu customer i sprawdź pole customer.conversion_tracking_setting.accepted_customer_data_terms.

Rozbieżności w danych

Pamiętaj o tych typowych problemach:

• Konwersje mogą zostać odrzucone przez nasz potok przetwarzania z różnych powodów i nie można ich odzyskać. Więcej informacji znajdziesz w sekcji Rozbieżności w danych po przesłaniu konwersji.

• Sprawdź, czy tag Google jest prawidłowo skonfigurowany na stronie i uruchamia się po przesłaniu formularza kontaktowego. Jeśli tag nie uruchamia się po przesłaniu formularza lub wysyła nieprawidłowe dane, prawdopodobnie zobaczysz niską atrybucję lub jej brak w przesłanych konwersjach. Zapoznaj się z artykułami w Centrum pomocy na temat konfigurowania tagu Google i konfigurowania Menedżera tagów Google na potrzeby konwersji rozszerzonych dotyczących potencjalnych klientów.

• Jeśli używasz konwersji rozszerzonych dotyczących potencjalnych klientów bez tagu Google na stronie internetowej, musisz uwzględnić identyfikator kliknięcia Google w importowanych konwersjach, ustawiając pole ClickConversion.gclid w każdej konwersji.

• Sprawdź, czy w przesyłanych plikach prawidłowo podajesz zgodę. Możesz to zrobić, ustawiając domyślne ustawienia zgody na koncie (w interfejsie Google Ads kliknij Narzędzia > Menedżer danych > Ustawienia zgody) lub ustawiając pole ClickConversion.consent w przypadku każdej przesłanej konwersji.

Problemy ze skutecznością kampanii

Jeśli nie masz problemów technicznych z przesyłaniem konwersji i odpowiadają Ci wyświetlane dane, ale po wdrożeniu konwersji rozszerzonych dotyczących potencjalnych klientów nie widzisz oczekiwanej poprawy skuteczności kampanii, skontaktuj się z zespołem pomocy Google Ads.

Problemy z konwersjami rozszerzonymi w kampaniach internetowych

W tej sekcji omawiamy typowe problemy, które mogą wystąpić podczas importowania konwersji rozszerzonych w kampaniach internetowych.

Typowe błędy

Poniższe wskazówki pomogą Ci diagnozować i rozwiązywać typowe błędy związane z konwersjami rozszerzonymi w kampaniach internetowych.

Błąd
CUSTOMER_NOT_ACCEPTED_CUSTOMER_DATA_TERMS	Warunki dotyczące danych klienta nie zostały zaakceptowane w przypadku customer_id żądania. Instrukcje znajdziesz w przewodniku dotyczącym wymagań wstępnych.
CONVERSION_ALREADY_ENHANCED	Ta konwersja otrzymała już dostosowanie ENHANCEMENT z podanymi polami order_id i conversion_action. Pamiętaj, aby dla każdej konwersji podać unikalną wartość order_id.
CONVERSION_ACTION_NOT_ELIGIBLE_FOR_ENHANCEMENT	Podany identyfikator conversion_action nie kwalifikuje się do korzystania z konwersji rozszerzonych w kampaniach internetowych. W interfejsie Google Ads zaznacz pole Włącz konwersje rozszerzone w przypadku działania powodującego konwersję, do którego odwołujesz się w żądaniu. Instrukcje znajdziesz w Centrum pomocy.
INVALID_USER_IDENTIFIER	Pole zaszyfrowanego identyfikatora użytkownika (hashed_email, hashed_phone_number, hashed_first_name, hashed_last_name lub hashed_street_address) nie jest prawidłowym 64-znakowym skrótem SHA-256 w systemie szesnastkowym. Znormalizuj i zaszyfruj dane przekazywane przez użytkowników, zanim je zaimportujesz. Instrukcje znajdziesz w artykule Normalizacja i haszowanie danych przekazywanych przez użytkowników.
CONVERSION_NOT_FOUND	Google Ads nie może znaleźć konwersji pasującej do podanego pola conversion_action i identyfikatora konwersji (order_id lub gclid_date_time_pair). Ten błąd dotyczy tylko dostosowań RESTATEMENT i RETRACTION. Więcej informacji znajdziesz w sekcji Wymagania w artykule Importowanie korekt konwersji. W przypadku korekt ENHANCEMENT interfejs API akceptuje żądanie bez zwracania błędu CONVERSION_NOT_FOUND i asynchronicznie ocenia dopasowanie tagu do interfejsu API order_id. Wysokie odsetki niedopasowanych wartości order_id powodują wyświetlanie alertu o niezgodności identyfikatora zamówienia w raporcie diagnostycznym konwersji rozszerzonych w interfejsie Google Ads. Instrukcje rozwiązywania problemów znajdziesz w artykule Alerty diagnostyczne w interfejsie po przesłaniu danych za pomocą interfejsu API.

Alerty diagnostyczne w interfejsie po przesłaniu danych przez interfejs API

Gdy przesyłasz dostosowania (ENHANCEMENT) za pomocą usługi ConversionAdjustmentUploadService, interfejs API sprawdza formatowanie żądania w momencie pozyskiwania i asynchronicznie dopasowuje ulepszenia do zdarzeń tagu witryny. W efekcie żądania do interfejsu API mogą się powieść bez błędów w polu partial_failure_error i wyświetlać stan EXCELLENT w diagnostyce danych offline. Jednocześnie w raporcie diagnostycznym dotyczącym konwersji rozszerzonych w interfejsie Google Ads mogą nadal pojawiać się alerty.

Jeśli po udanym przesłaniu danych za pomocą interfejsu API pojawią się alerty diagnostyczne w interfejsie, sprawdź, czy nie występują te przyczyny:

• Brak wymaganych pól adresu: obiekt OfflineUserAddressInfo w polu address_info wymaga 4 pól w tym samym wpisie: hashed_first_name, hashed_last_name, country_code i postal_code. Pola hashed_street_address, city i state są opcjonalne (jeśli wypełnisz pole hashed_street_address, musi ono zawierać prawidłowy 64-znakowy skrót szesnastkowy SHA-256). Interfejs API akceptuje niepuste częściowe obiekty address_info (np. tylko imię i nazwisko) bez zwracania błędu w polu partial_failure_error. Jednak dopasowywanie na dalszym etapie odrzuca niekompletne adresy i wywołuje alert o brakujących polach adresu. Jeśli którekolwiek z 4 wymaganych pól jest niedostępne, pomiń obiekt UserIdentifier w polu address_info.

• Brak identyfikatorów transakcji w zdarzeniach tagu witryny: pominięcie pola order_id w dostosowaniu ENHANCEMENT w interfejsie API powoduje zwrócenie synchronicznego błędu FieldError.REQUIRED. Gdy żądania do interfejsu API zawierają pole order_id, alert w interfejsie dotyczący braku identyfikatora transakcji w zdarzeniu konwersji odnosi się do tagu witryny. Ten alert pojawia się, gdy mniej niż 90% zdarzeń tagu konwersji w witrynie zawiera prawidłowy identyfikator transakcji (lub gdy tag wysyła ciągi znaków zastępczych, np. "undefined" lub "null"). Skonfiguruj tag konwersji w witrynie tak, aby wysyłał unikalny identyfikator transakcji dla każdego zdarzenia konwersji.

• Niezgodność identyfikatora zamówienia z tagu i z interfejsu API lub opóźnione przesyłanie: w przypadku korekt ENHANCEMENT interfejs API nie zwraca błędu CONVERSION_NOT_FOUND ani CONVERSION_EXPIRED w momencie przesyłania. Zamiast tego niedopasowane wartości order_id wywołują w interfejsie alert o niezgodności identyfikatora zamówienia, a ulepszenia przesłane po upływie ponad 24 godzin od konwersji wywołują alert o opóźnionym przesłaniu. Dopasuj pole order_id interfejsu API do dokładnego ciągu znaków identyfikatora transakcji wysyłanego przez tag konwersji w witrynie i prześlij ulepszenie w ciągu 24 godzin od zdarzenia konwersji.

• Nieznormalizowane dane użytkowników zaszyfrowane przed przesłaniem: zaszyfrowanie nieznormalizowanych wartości, takich jak wielkie litery, spacje na początku lub na końcu albo numery telefonów w formacie innym niż E.164, nadal daje prawidłowy 64-znakowy skrót szesnastkowy SHA-256. Interfejs API akceptuje przesłane dane bez zwracania błędu INVALID_USER_IDENTIFIER, ale dopasowywanie na dalszym etapie nie powiedzie się i zostaną wyświetlone alerty dotyczące formatowania lub niskiego współczynnika dopasowania. Postępuj zgodnie z regułami normalizacji opisanymi w artykule Normalizowanie i haszowanie danych przekazywanych przez użytkowników.

• Mała liczba ulepszeń interfejsu API w porównaniu z liczbą tagów witryny: diagnostyka interfejsu porównuje ulepszenia interfejsu API po usunięciu duplikatów, które zawierają identyfikatory użytkowników, ze zdarzeniami tagów witryny po usunięciu duplikatów, które zawierają zgodę użytkowników:

  • Konfiguracja trybu uzyskiwania zgody: gdy tryb uzyskiwania zgody w tagu Google sygnalizuje ustawienie ad_storage='denied', diagnostyka interfejsu wyklucza z porównania zdarzenia tagu witryny, na które użytkownik nie wyraził zgody, więc pominięcie tych zdarzeń w przesyłanych danych interfejsu API nie powoduje wyświetlenia alertu o małej liczbie zdarzeń. Jednak alerty o niezgodności między tagiem witryny a regułami backendu dotyczące obsługi zgody:

    • Tag nie zawiera parametru ad_storage='denied', backend pomija przesyłanie: diagnostyka interfejsu użytkownika zlicza zdarzenia tagu jako takie, na które użytkownik wyraził zgodę, i wyświetla alert o niskim zasięgu.
    • Sygnały tagów ad_storage='denied', ulepszenie przesyłania w backendzie: przesłane ulepszenia nie mają pasującego zdarzenia tagu, na które użytkownik wyraził zgodę, i powodują wyświetlanie alertów o niezgodności identyfikatora zamówienia.

    Zastosuj ten sam stan zgody użytkownika zarówno do tagu witryny, jak i do przesyłania ulepszeń przez interfejs API.

  • Anonimowe zdarzenia w witrynie: nie włączaj konwersji rozszerzonych w przypadku działań powodujących konwersję na początku ścieżki (np. wyświetleń strony lub produktu), gdy tag witryny uruchamia się w przypadku anonimowych użytkowników. Jeśli serwer wysyła ulepszenia interfejsu API tylko w przypadku zalogowanych użytkowników o znanych danych kontaktowych, niedopasowane zdarzenia tagów anonimowych wywołują alert o niskim zasięgu. Włączaj konwersje rozszerzone tylko w przypadku działań powodujących konwersję, w których dane przekazywane przez użytkowników są stale dostępne.

Ogólne problemy z zarządzaniem konwersjami

Pamiętaj o tych typowych problemach:

• Próba ustawienia dowolnego pola typu wyliczeniowego na UNKNOWN spowoduje błąd RequestError.INVALID_ENUM_VALUE. To częsty problem, gdy parametr consent jest określany, gdy reklamodawca może nie wiedzieć, czy zgoda została udzielona. Jeśli stan parametru consent jest nieznany, należy ustawić wartość DENIED.

• Podczas tworzenia działania powodującego konwersję w przypadku konwersji z aplikacji lub Firebase i analityki aplikacji innych firm możesz zmienić pole app_id tylko podczas tworzenia. Po utworzeniu działania powodującego konwersję nie można już zmienić tego pola.

• Podczas tworzenia działania powodującego konwersję możesz ustawić pole ConversionAction.attribution_model_settings.attribution_model tylko na GOOGLE_ADS_LAST_CLICK lub GOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVEN. Każda inna opcja spowoduje błąd CANNOT_SET_RULE_BASED_ATTRIBUTION_MODELS. Więcej informacji znajdziesz w poście na blogu, w którym ogłosiliśmy wycofanie innych modeli atrybucji.

• Dozwolony zakres wartości pola click_through_lookback_window_days to od 1 do 60 dni w przypadku działań powodujących konwersję typu AD_CALL i WEBSITE_CALL. W przypadku większości innych działań powodujących konwersję dozwolony zakres wynosi od 1 do 90 dni.

• W przypadku większości działań powodujących konwersję dozwolony zakres wartości w polu view_through_lookback_window_days wynosi od 1 do 30 dni. To pole musi być nieustawione w przypadku działań powodujących konwersję typu AD_CALL i WEBSITE_CALL.

• Ustawienie lub zaktualizowanie pola include_in_conversions_metric w działaniu powodującym konwersję spowoduje błąd FieldError.IMMUTABLE_FIELD. Zamiast tego ustaw pole primary_for_goal zgodnie z opisem w przewodniku po celach konwersji.

• Podczas tworzenia działania powodującego konwersję typu WEBSITE_CALL lub AD_CALL pole value_settings.always_use_default_value musi mieć wartość true. Podanie wartości false spowoduje błąd INVALID_VALUE.

Typowe błędy

Te wskazówki pomogą Ci diagnozować i rozwiązywać typowe błędy związane z importowaniem konwersji offline, w tym błędy dostępu do śledzenia konwersji dla wielu kont.

Błąd
INVALID_CONVERSION_ACTION_TYPE	Określone działanie powodujące konwersję ma typ, który nie jest prawidłowy w przypadku przesyłania konwersji po kliknięciu. Upewnij się, że ConversionAction określony w żądaniu przesyłania ma typ UPLOAD_CLICKS.
NO_CONVERSION_ACTION_FOUND	Określone działanie powodujące konwersję nie jest włączone lub konto w polu customer_id żądania nie ma do niego dostępu. Pobierz informacje o konfiguracji śledzenia konwersji, aby sprawdzić, czy działanie powodujące konwersję jest włączone. Właścicielem działania powodującego konwersję musi być klient Google Ads, który dokonał kliknięcia, lub konto w hierarchii śledzenia konwersji konta przesyłającego. Ten błąd występuje na przykład wtedy, gdy działanie powodujące konwersję należy do poprzedniego konta menedżera, które zostało odłączone po kliknięciu.
TOO_RECENT_CONVERSION_ACTION	Działanie powodujące konwersję zostało utworzone niedawno. Po utworzeniu działania odczekaj co najmniej 6 godzin, zanim spróbujesz ponownie przesłać nieudane konwersje.
INVALID_CUSTOMER_FOR_CLICK	Pole customer_id w żądaniu nie pasuje do klienta konwersji z reklam Google Ads w momencie kliknięcia. Ten błąd występuje, gdy konto przesyłające nie ma też dostępu do wielu kont w przypadku działania powodującego konwersję. Zaktualizuj pole customer_id w żądaniu, aby wskazywało konto w hierarchii właściciela działania powodującego konwersję.
EVENT_NOT_FOUND	Google Ads nie może znaleźć kombinacji identyfikatora kliknięcia i customer_id. Sprawdź wymagania dotyczące customer_id i upewnij się, że przesyłasz dane, korzystając z odpowiedniego konta Google Ads.
DUPLICATE_CLICK_CONVERSION_IN_REQUEST	Wiele konwersji w żądaniu ma tę samą kombinację identyfikatora kliknięcia, conversion_date_time i conversion_action. Usuń zduplikowane konwersje z żądania.
CLICK_CONVERSION_ALREADY_EXISTS	Konwersja z tą samą kombinacją identyfikatora kliknięcia, conversion_date_time i conversion_action została już przesłana. Zignoruj ten błąd, jeśli próbujesz ponownie przesłać konwersję, która została już wcześniej przesłana. Jeśli chcesz dodać kolejną konwersję oprócz tej przesłanej wcześniej, dostosuj parametr conversion_date_time w obiekcie ClickConversion, aby uniknąć duplikowania przesłanej wcześniej konwersji.
EXPIRED_EVENT	Zaimportowane kliknięcie miało miejsce przed przedziałem czasu określonym w polu click_through_lookback_window_days. Zmiana click_through_lookback_window_days wpływa tylko na kliknięcia zarejestrowane po jej wprowadzeniu, więc zmiana okresu ważności nie rozwiąże tego błędu w przypadku konkretnego kliknięcia. W razie potrzeby zmień conversion_action na inne działanie z dłuższym okresem ważności.
CONVERSION_PRECEDES_EVENT	Wartość conversion_date_time jest wcześniejsza niż data i godzina kliknięcia. Zmień wartość conversion_date_time na późniejszą.
VALUE_MUST_BE_UNSET	W elemencie ClickConversion ustawiono wartość dla gbraid lub wbraid (bez gclid) oraz wartość dla custom_variables lub cart_data, których Google Ads nie obsługuje w przypadku gbraid lub wbraid. Usuń ustawienie pola powodującego konflikt.