Rozwiązywanie problemów

Jeśli podczas korzystania z interfejsu Search Ads 360 API wystąpią problemy, skorzystaj z tej sekcji.

Jeśli po przeczytaniu zasobów z tej witryny nie możesz rozwiązać problemu, skontaktuj się z zespołem pomocy i przygotuj te informacje:

• Identyfikator agencji Search Ads 360 i identyfikator reklamodawcy, do których chcesz uzyskać dostęp

• Numer projektu z konsoli Google API

• Nazwa użytkownika konta Google, którego używasz do uzyskiwania dostępu do interfejsu API.
  To konto ma uprawnienie do uzyskiwania dostępu do Search Ads 360, czyli tego samego konta, którego używasz do konfigurowania autoryzacji.

• Fragment kodu żądania

• Odpowiedź JSON
  Jeśli odpowiedź jest błędem, upewnij się, że zawiera komunikat o błędzie, a nie tylko kod numeryczny.

Błędy autoryzacji

Oto kilka częstych błędów autoryzacji:

Wiadomość	opis,
Access Not Configured. Please use Google API Console to activate the API for your project.	Ten błąd występuje, jeśli nie masz włączonego interfejsu Search Ads 360 API na swoim koncie. Upewnij się, że wykonane zostały te czynności: Otwórz konsolę interfejsów API Google. Wybierz projekt. Jeśli nie masz jeszcze utworzonego projektu, przeczytaj artykuł Tworzenie projektu dla klienta. Na pasku bocznym po lewej rozwiń APIs & amp; auth (Interfejsy API i uwierzytelnianie). Następnie kliknij Interfejsy API. Na liście interfejsów API sprawdź, czy interfejs Search Ads 360 API ma stan WŁ.
Invalid grant	Ten błąd występuje, gdy token odświeżania jest nieprawidłowy. Token odświeżania możesz uzyskać, wywołując skrypt narzędzia Search Ads 360 w ten sposób: sa360Api.py --login Dowiedz się więcej o zalecanej procedurze autoryzacji.
Invalid client no application name	Ten błąd występuje, jeśli podczas konfigurowania projektu w konsoli interfejsu Google API nie określono nazwy usługi. Aby naprawić ten błąd, wpisz nazwę usługi na ekranie zgody w konsoli interfejsu Google API.
Inne typy błędów autoryzacji	Upewnij się, że używasz konta Google, które ma dostęp do Search Ads 360 po zalogowaniu się w konsoli interfejsu Google API w celu pobrania swojego identyfikatora klienta i tajnego klucza klienta oraz po uzyskaniu tokena odświeżania.

Błędy przesyłania konwersji

W tabeli poniżej znajdziesz listę błędów, które mogą wystąpić podczas przesyłania konwersji. Kodów szesnastkowych nie można zmieniać, więc możesz ich używać we własnych skryptach do wykrywania błędów.

Kod błędu	Wiadomość	opis,
0x00000101	Click ID '{ID}' is not found	Identyfikator kliknięcia podany w żądaniu update jest nieprawidłowy. Prześlij ponownie konwersje po wykonaniu tych czynności: Sprawdziliśmy, że identyfikator kliknięcia został wygenerowany na 4 godziny przed przesłaniem konwersji. Aktywowano usługę konwersji interfejsu API. Jeśli przypisujesz konwersje do określonych wizyt, przed przesłaniem konwersji poczekaj co najmniej 30 minut. Search Ads 360 może nie rozpoznać identyfikatora clickID wizyty, jeśli prześlesz konwersję przed upływem 30 minut. W rzadkich przypadkach może minąć do 4 godzin, zanim Search Ads 360 rozpozna parametr clickId. Potwierdzono, że kliknięcie pochodzi z prawidłowego źródła, na co wskazuje parametr gclsrc. Sprawdziliśmy, czy w kolumnie AdvertiserId masz wybranego odpowiedniego reklamodawcę. Sprawdziliśmy, czy identyfikator kliknięcia został wygenerowany w ciągu ostatnich 90 dni.
0x0000010E	Floodlight activity name '{name}' is not found	Nazwa aktywności Floodlight podana w kolumnie segmentationName jest nieprawidłowa lub jeszcze niedostępna. Jeśli widzisz ten błąd, sprawdź typowe problemy: Wielkość liter w nazwach ma znaczenie, więc upewnij się, że jest ona zgodna z Twoją prośbą. Upewnij się, że w nazwie aktywności Floodlight nie ma żadnych niedrukowalnych znaków Unicode ani podwójnych spacji. Pamiętaj, by podać nazwę aktywności Floodlight, a nie kolumny Floodlight. Sprawdź, czy istnieje aktywność Floodlight reklamodawcy określonego w kolumnie advertiserId. (Być może podany reklamodawca jest nieprawidłowy.) Po utworzeniu lub edytowaniu aktywności Floodlight poczekaj kilka godzin, zanim prześlesz konwersje.
0x00000115	Custom dimension '{name}' is not found	Upewnij się, że określona niestandardowa zmienna Floodlight została skonfigurowana jako wymiar (a nie dane) reklamodawcy powiązanego z atrybucją clickId, criterionId lub productGroupId, którą przypisujesz do konwersji.
0x00000116	Custom metric '{name}' is not found	Upewnij się, że określona niestandardowa zmienna Floodlight została skonfigurowana jako dane (nie jako wymiar) dla reklamodawcy powiązanego z obiektem clickId, criterionId lub productGroupId, który przypiszesz do konwersji.
0x0000011A	The advertiser conversion ID is already specified for a conversion with Search Ads 360 conversion ID {ID}	Ktoś już przesłał konwersję o tym samym zakresie i identyfikatorze konwersji reklamodawcy z kolumny conversionId. „Identyfikator konwersji u reklamodawcy” to generowany przez Ciebie identyfikator. Search Ads 360 wymaga, aby ten identyfikator był unikalny dla danego zakresu. Identyfikator konwersji Search Ads 360 jest generowany przez Search Ads 360 i jest gwarantowany.
0x0000011B	Advertiser conversion ID '{ID}' is not found	Twoja prośba o update próbowała zaktualizować nieistniejący identyfikator konwersji reklamodawcy. Sprawdź, czy podany jest właściwy identyfikator.
0x0000011D	User does not have permission to view advertiser {advertiser ID}	Konto Google, z którego korzysta Twój klient, nie ma uprawnień do wyświetlania reklamodawcy określonego w żądaniu. Gdy logujesz się w konsoli interfejsu Google API w celu pobrania identyfikatora klienta i tajnego klucza klienta, oraz po uzyskaniu tokena odświeżania pamiętaj, by korzystać z konta Google, które udzielono dostępu określonemu reklamodawcy.
0x0000011F	Advertiser conversion ID is already specified in this request	Co najmniej 2 konwersje w żądaniu określają ten sam zakres i identyfikator konwersji reklamodawcy. Identyfikator konwersji u reklamodawcy to identyfikator, który generujesz i określasz w kolumnie conversionId. Search Ads 360 wymaga, aby ten identyfikator był unikalny w ramach danego zakresu.
0x0000011E	The requested Floodlight activity '{name}' does not match the conversion type (ACTION/TRANSACTION)	Podany identyfikator aktywności Floodlight lub nazwa nie pasują do określonego typu konwersji.

Zgłaszanie kodów odpowiedzi i komunikatów o błędach

Jeśli poprosisz o raport, którego odpowiedź to komunikat o błędzie, przeczytaj Kody odpowiedzi w interfejsie Search Ads 360 API i Standardowe odpowiedzi dotyczące błędów, aby dowiedzieć się więcej o tym błędzie.

Dane w interfejsie Search Ads 360 są niezgodne z raportami zwróconymi przez interfejs API.

Dane w interfejsie Search Ads 360 powinny być domyślnie zgodne z danymi zwracanymi przez interfejs API. Jeśli w żądaniu raportu ustawisz includeRemovedEntities na true, musisz też zaznaczyć pole wyboru Pokaż usunięte w interfejsie.