Najczęstsze pytania

Czy istnieją jakieś ograniczenia dotyczące tego, co mogę przesyłać?

Pamiętaj o kilku ograniczeniach:

  • Pojedyncze żądania batchinsert i batchupdate są ograniczone do 1000 konwersji.
  • Sygnatura czasowa konwersji może być maksymalnie 28 dni starsza od czasu przesłania.
  • Konwersje możesz przesyłać tylko do konfiguracji Floodlight, do której ma dostęp Twój profil użytkownika Campaign Managera 360.
Czy do przesyłania konwersji mam używać Campaign Managera 360 czy Search Ads 360?

Szczegółowe porównanie funkcji oferowanych przez obie usługi znajdziesz w Centrum pomocy Search Ads 360.

Co się stanie, jeśli wstawię tę samą konwersję zarówno do Campaign Managera 360, jak i do Search Ads 360?

Jeśli wstawisz tę samą konwersję zarówno do Campaign Managera 360, jak i do Search Ads 360, wpisy nie zostaną zde-duplikowane. W takim przypadku użyj osobnych aktywności Floodlight.

Którego interfejsu API mam używać do przesyłania konwersji offline?

Zalecamy korzystanie z interfejsu Data Manager API, aby zwiększyć komfort pracy i uzyskać dostęp do dodatkowych funkcji.

Czym jest wartość porządkowa i jak jest używana?

Wartości porządkowe określają, jak są przetwarzane zduplikowane konwersje. Jeśli wstawiono wiele konwersji z tą samą aktywnością Floodlight, identyfikatorem konfiguracji Floodlight, identyfikatorem użytkownika i sygnaturą czasową konwersji, liczba porządkowa służy do określenia, czy:

  • Konwersje są deduplikowane i pozostaje tylko jedna. Dzieje się tak, gdy wszystkie konwersje mają tę samą wartość porządkową.
  • Konwersje są przetwarzane pojedynczo i wszystkie zostają zachowane. Dzieje się tak, gdy wszystkie konwersje mają różne wartości porządkowe.

Same wartości nie muszą mieć znaczenia. Ogólnie rzecz biorąc, użycie stałej wartości (np. 1) w przypadku wszystkich konwersji umożliwi deduplikację. Użycie losowej lub unikalnej wartości dla każdej konwersji spowoduje wyłączenie tej funkcji.

Jak postępować z błędami w odpowiedzi interfejsu API i które błędy należy ponowić?

Metody batchinsert i batchupdate przetwarzają konwersje na zasadzie „najlepszych starań”: żądanie zbiorcze może zwrócić odpowiedź HTTP 200 OK, mimo że poszczególne konwersje w żądaniu zbiorczym się nie powiodą. Zawsze sprawdzaj hasFailures w odpowiedzi i listę errors[] w każdym obiekcie ConversionStatus:

  • INTERNAL (Spróbuj ponownie): podczas przetwarzania konwersji w systemach Google wystąpił błąd przejściowy. Konwersja nie została wstawiona ani zaktualizowana. Ponów próbę przesłania nieudanych konwersji, stosując wzrastający czas do ponowienia (np. zaczynając po kilku minutach i ponawiając próby przez kilka godzin), zachowując dokładnie te same wartości ordinal, timestampMicros, floodlightActivityId oraz identyfikator użytkownika lub kliknięcia.
  • NOT_FOUND (Spróbuj ponownie z opóźnieniem): nie udało się jeszcze znaleźć identyfikatora (gclid, dclid, matchId lub mobileDeviceId) ani edytowanej konwersji. Ponieważ przetwarzanie i indeksowanie kliknięć online, tagów Floodlight i konwersji może potrwać 1–2 godziny, ponawiaj okresowo próby przesłania konwersji NOT_FOUND (np. co 1–3 godziny przez maksymalnie 6 godzin). Jeśli po 6 godzinach błąd NOT_FOUND nadal występuje, zapoznaj się z poniższymi sekcjami, aby poznać typowe przyczyny według typu identyfikatora.
  • INVALID_ARGUMENT i PERMISSION_DENIED (Nie próbuj ponownie): dane konwersji są nieprawidłowe (np. sygnatura czasowa konwersji jest starsza niż 28 dni lub pole jest nieprawidłowo sformatowane) albo Twój profil użytkownika nie ma uprawnień do docelowej konfiguracji Floodlight. Nie próbuj ponownie przesyłać tych konwersji, jeśli nie rozwiążesz problemu.

Jeśli całe żądanie HTTP nie powiedzie się z powodu błędu serwera 5xx lub błędu limitu/ograniczenia liczby żądań 429, spróbuj ponownie, stosując wzrastający czas do ponowienia.

Bezpieczne ponowne próby i usuwanie duplikatów: podczas ponownej próby przesłania konwersji, która nie powiodła się z powodu błędu INTERNAL lub NOT_FOUND (lub po przekroczeniu limitu czasu HTTP 5xx, gdy wynik jest nieznany), zawsze wysyłaj dokładnie te same wartości ordinal i timestampMicros. Jeśli konwersja została już zarejestrowana, Campaign Manager 360 automatycznie usunie duplikaty na podstawie tych danych: ordinal, identyfikator użytkownika, aktywność Floodlight i data konwersji.

Co oznacza, że przesyłanie mobileDeviceId nie powiodło się z powodu błędu NOT_FOUND?

Najczęstsze przyczyny tego błędu:

  • Wartość mobileDeviceId jest nieprawidłowa.
  • mobileDeviceId jest nieznany w Search Ads 360. Oznacza to, że na urządzeniu nie wyświetlono jeszcze reklamy z Campaign Managera 360.
Co oznacza, że przesyłanie gclid nie powiodło się z powodu błędu NOT_FOUND?

Najczęstsze przyczyny tego błędu:

  • Wartość gclid jest nieprawidłowa.
  • gclid nie jest powiązany z kampanią Search Ads 360 ani z elementem zamówienia YouTube w Display & Video 360. Może się tak zdarzyć, jeśli parametr gclid został zebrany z przekierowania kliknięcia Google Ads, które nie przeszło przez Search Ads 360 (np. kliknięcia rozszerzeń lokalizacji), lub z przekierowania kliknięcia reklamy na YouTube, które nie jest powiązane z elementem zamówienia YouTube w Display & Video 360.
  • Kliknięcie powiązane z tym zdarzeniem (gclid) miało miejsce zbyt dawno temu. Konwersje można wstawiać tylko w przypadku kliknięć, które miały miejsce nie wcześniej niż 60 dni temu.
  • Kliknięcie powiązane z identyfikatorem gclid miało miejsce zbyt niedawno. Zalecamy opóźnienie przesyłania konwersji opartych na identyfikatorze gclid o godzinę, aby mieć pewność, że identyfikator gclid został przetworzony i jest dostępny do dopasowania.
Co oznacza, że przesyłanie dclid nie powiodło się z powodu błędu NOT_FOUND?

Najczęstsze przyczyny tego błędu:

  • Wartość dclid jest nieprawidłowa.
  • Kliknięcie powiązane z parametrem dclid miało miejsce zbyt dawno temu. Konwersje można wstawiać tylko w przypadku kliknięć, które miały miejsce nie wcześniej niż 60 dni temu.
  • Kliknięcie powiązane z identyfikatorem dclid miało miejsce zbyt niedawno. Zalecamy opóźnienie przesyłania konwersji opartych na identyfikatorze dclid o godzinę, aby mieć pewność, że identyfikator dclid został przetworzony i jest dostępny do dopasowania.
Co oznacza, że przesyłanie matchId nie powiodło się z powodu błędu NOT_FOUND?

Najczęstsze przyczyny tego błędu:

  • matchId jest nieznany w usłudze Campaign Manager 360. Może się tak zdarzyć, jeśli parametr matchId został zebrany z wywołania Floodlight, które nie zostało prawidłowo przekazane przez Campaign Managera 360 (upewnij się, że wywołania Floodlight działają prawidłowo, w tym parametr tagu matchId).
  • Wywołanie Floodlight powiązane z matchId nie zawierało pliku cookie. Wywołanie Floodlight musi zawierać plik cookie lub identyfikator, aby Campaign Manager 360 mógł prawidłowo zapisać matchId (np. użytkownik mógł zablokować pliki cookie lub zrezygnować z ich używania).
  • Wywołanie Floodlight powiązane z matchId miało miejsce zbyt dawno. Przesyłanie konwersji offline musi nastąpić w ciągu 60 dni od wywołania Floodlight zawierającego parametr matchId.
  • Wywołanie Floodlight powiązane z matchId miało miejsce zbyt niedawno. Zalecamy opóźnienie przesyłania konwersji na podstawie matchId o 2 godziny, aby mieć pewność, że matchId zostanie przetworzony i będzie dostępny do dopasowania.
Czy konwersje offline z sygnaturą czasową sprzed utworzenia aktywności Floodlight są uwzględniane w raportach?

Przesłane konwersje offline z sygnaturą czasową sprzed utworzenia aktywności Floodlight mogą być raportowane jako wyświetlenia Floodlight oraz jako konwersje nieprzypisane lub przypisane, do 28 dni przed czasem przesłania. Nie jest to jednak gwarantowane i nie należy na tym polegać. Sprawdzoną metodą jest tworzenie aktywności Floodlight przed najwcześniejszą sygnaturą czasową konwersji offline.

Jakie zgody są wymagane, aby używać wstawiania konwersji offline do tworzenia list odbiorców?

Aby umożliwić tworzenie list odbiorców, oprócz zgody na wykorzystanie danych użytkownika reklam pole nonPersonalizedAd musi być ustawione na false.