Rozwiązywanie problemów

Jeśli podczas korzystania z interfejsu Search Ads 360 API napotkasz problemy, zapoznaj się z tą sekcją dotyczącą rozwiązywania problemów.

Jeśli wystąpi problem, którego nie będzie można rozwiązać po zapoznaniu się z materiałami w tej witrynie, skontaktuj się z zespołem pomocy i przygotuj te informacje:

Błędy autoryzacji

Oto kilka często występujących 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 na swoim koncie nie masz włączonego interfejsu Search Ads 360 API. Najpierw wykonaj te czynności:

  1. Otwórz konsolę interfejsów API Google.

  2. Wybierz projekt. Jeśli nie masz jeszcze utworzonego projektu, zapoznaj się z artykułem Tworzenie projektu dla klienta.

  3. Na pasku bocznym po lewej stronie rozwiń APIs &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ŁĄCZONY.

Invalid grant

Ten błąd występuje, gdy token odświeżania jest nieprawidłowy. Aby uzyskać token odświeżania, wywołaj skrypt narzędziowy Search Ads 360 w ten sposób:

sa360Api.py --login

Dowiedz się więcej o zalecanym procesie autoryzacji.

Invalid client
no application name

Ten błąd występuje, jeśli podczas konfigurowania projektu w Konsoli interfejsów API Google nie określisz nazwy produktu. Aby naprawić ten błąd, wpisz nazwę swojego produktu na ekranie zgody w Konsoli interfejsów API Google.

Inne typy błędów autoryzacji

Podczas logowania się w Konsoli interfejsów API Google, aby pobrać identyfikator klienta i klucz tajny klienta, oraz podczas uzyskiwania tokena odświeżania, używaj konta Google, które ma przyznany dostęp do Search Ads 360.

Błędy przesyłania konwersji

W tabeli poniżej znajdziesz listę błędów, które mogą wystąpić podczas przesyłania konwersji. Pamiętaj, że kody błędów w systemie szesnastkowym są niezmienne, więc możesz ich używać w własnych skryptach do identyfikowania 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:

  • Sprawdź, czy identyfikator kliknięcia został wygenerowany 4 godziny przed przesłaniem konwersji.

  • Aktywuj usługę konwersji API.

  • Jeśli przypisujesz udział w konwersjach konkretnym wizytom, poczekaj z przesłaniem konwersji co najmniej 30 minut od wizyty. 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 być konieczne odczekanie do 4 godzin, zanim Search Ads 360 rozpozna identyfikator clickId.

  • Potwierdzono, że kliknięcie pochodzi z ważnego źródła, zgodnie z wskazaniem parametru gclsrc.

  • Potwierdzono, że w kolumnie advertiserId podano właściwego reklamodawcę.

  • Zweryfikowaliśmy, że 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 niedostępna. Jeśli widzisz ten błąd, sprawdź, czy nie występują te typowe problemy:

  • Wielkość liter w nazwach ma znaczenie, więc upewnij się, że w żądaniu jest rozróżniana wielkość liter.
  • Upewnij się, że nazwa aktywności Floodlight nie zawiera żadnych niedrukowalnych znaków Unicode ani podwójnych spacji.
  • Upewnij się, że podana nazwa to aktywność Floodlight, a nie kolumna Floodlight.
  • Sprawdź, czy aktywność Floodlight istnieje dla reklamodawcy określonego w kolumnie advertiserId. (Możesz wskazać niewłaściwego reklamodawcę).
  • Po utworzeniu lub zmodyfikowaniu aktywności Floodlight odczekaj kilka godzin, zanim prześlesz konwersje.
0x00000115 Custom dimension '{name}' is not found

Sprawdź, czy wybrana przez Ciebie niestandardowa zmienna Floodlight została skonfigurowana jako wymiar (a nie dane) dla reklamodawcy powiązanego z konwersją clickId, criterionId lub productGroupId.

0x00000116 Custom metric '{name}' is not found

Upewnij się, że wybrana przez Ciebie niestandardowa zmienna Floodlight została skonfigurowana jako dane (a nie wymiar) dla reklamodawcy powiązanego z konwersją, której dotyczy clickId, criterionId lub productGroupId.

0x0000011A The advertiser conversion ID is already specified for a conversion with Search Ads 360 conversion ID {ID}

Konwersja o tym samym zakresie i tym samym identyfikatorze konwersji u reklamodawcy została już przesłana. conversionId

„Identyfikator konwersji u reklamodawcy” to identyfikator wygenerowany przez Ciebie. Search Ads 360 wymaga, aby ten identyfikator był unikalny w danym zakresie. Identyfikator konwersji Search Ads 360 jest generowany przez Search Ads 360 i zawsze jest unikalny.

0x0000011B Advertiser conversion ID '{ID}' is not found

Twoje żądanie update próbowało zaktualizować identyfikator konwersji reklamodawcy, który nie istnieje. Sprawdź, czy podano prawidłowy identyfikator.

0x0000011D User does not have permission to view advertiser {advertiser ID}

Konto Google, którego używa klient, nie ma uprawnień do wyświetlania reklamodawcy określonego w prośbie.

Podczas logowania się w konsoli interfejsów API Google w celu pobrania identyfikatora klienta i klucza tajnego klienta oraz podczas uzyskiwania tokenu odświeżania pamiętaj, aby używać konta Google, które ma przyznany dostęp do wskazanego przez Ciebie reklamodawcy.

0x0000011F Advertiser conversion ID is already specified in this request

Co najmniej 2 konwersje w żądaniu podają ten sam zakres i identyfikator konwersji u reklamodawcy.

Identyfikator konwersji reklamodawcy to identyfikator wygenerowany i podany w kolumnie conversionId. Search Ads 360 wymaga, aby ten identyfikator był unikalny w danym zakresie.

0x0000011E The requested Floodlight activity '{name}' does not match the conversion type (ACTION/TRANSACTION)

Podany identyfikator lub nazwa aktywności Floodlight nie pasują do podanego typu konwersji.

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

Jeśli żądasz raportu, a w odpowiedzi otrzymujesz komunikat o błędzie, zapoznaj się z artykułami Kody odpowiedzi w interfejsie Search Ads 360 APIStandardowe odpowiedzi na błędy, aby uzyskać więcej informacji o tym błędzie.

Dane w interfejsie Search Ads 360 nie pasują do raportu zwróconego przez interfejs API

Dane w interfejsie Search Ads 360 powinny domyślnie odpowiadać danym zwracanym przez interfejs API. Jeśli w prośbie o zgłoszenie ustawisz wartość includeRemovedEntities na true, sprawdź, czy w interfejsie zaznaczone jest też pole wyboru Pokaż usunięte.