Pobierz interfejs Google Ads API diagnostyka danych offline, które zawierają informacje o ogólnym stanie przesyłanych konwersji oraz i dostosowywania stawek.
Aby pobrać najnowszą diagnostykę danych offline na koncie, użyj jeden z tych materiałów:
offline_conversion_upload_client_summary
zbiera dane diagnostyczne przesyłania na na poziomie konta.offline_conversion_upload_conversion_action_summary
(dostępny tylko w wersji 17 lub nowszej) zbiera dane diagnostyczne przesyłania na poziomie działania powodującego konwersję.
Diagnostyka na poziomie konta
Aby pobrać diagnostykę przesyłania konwersji na poziomie konta, skorzystaj z tych instrukcji: Zapytanie GAQL:
SELECT
customer.id,
offline_conversion_upload_client_summary.alerts,
offline_conversion_upload_client_summary.client,
offline_conversion_upload_client_summary.daily_summaries,
offline_conversion_upload_client_summary.job_summaries,
offline_conversion_upload_client_summary.last_upload_date_time,
offline_conversion_upload_client_summary.pending_event_count,
offline_conversion_upload_client_summary.pending_rate,
offline_conversion_upload_client_summary.status,
offline_conversion_upload_client_summary.success_rate,
offline_conversion_upload_client_summary.successful_event_count,
offline_conversion_upload_client_summary.total_event_count
FROM offline_conversion_upload_client_summary
To zapytanie zwraca oddzielne
OfflineConversionUploadClientSummary
wiersze dla każdego typu klienta użytego w ostatnio przesłanych plikach. Jeśli na przykład
przesłanych ostatnio za pomocą interfejsu Google Ads API i interfejsu Google Ads.
zawierają osobne wpisy z wartościami client
dla GOOGLE_ADS_API
i
GOOGLE_ADS_WEB_CLIENT
Diagnostyka na poziomie działania powodującego konwersję
Aby pobrać diagnostykę przesyłania konwersji na poziomie działania powodującego konwersję, użyj funkcji: następujące zapytanie GAQL:
SELECT
offline_conversion_upload_conversion_action_summary.conversion_action_name,
offline_conversion_upload_conversion_action_summary.alerts,
offline_conversion_upload_conversion_action_summary.client,
offline_conversion_upload_conversion_action_summary.daily_summaries,
offline_conversion_upload_conversion_action_summary.job_summaries,
offline_conversion_upload_conversion_action_summary.last_upload_date_time,
offline_conversion_upload_conversion_action_summary.pending_event_count,
offline_conversion_upload_conversion_action_summary.status,
offline_conversion_upload_conversion_action_summary.successful_event_count,
offline_conversion_upload_conversion_action_summary.total_event_count
FROM offline_conversion_upload_conversion_action_summary
WHERE offline_conversion_upload_conversion_action_summary.conversion_action_id = < INSERT CONVERSION ACTION ID >
Podobnie jak w przypadku diagnostyki na poziomie konta, to zapytanie zwraca osobne
OfflineConversionUploadConversionActionSummary
wiersze dla każdego typu klienta użytego w ostatnio przesłanych plikach. Jeśli na przykład
przesłanych ostatnio za pomocą interfejsu Google Ads API i interfejsu Google Ads.
zawierają osobne wpisy z wartościami client
dla GOOGLE_ADS_API
i
GOOGLE_ADS_WEB_CLIENT
Jak interpretować podsumowania
Co OfflineConversionUploadClientSummary
lub
OfflineConversionUploadConversionActionSummary
ma pole status
, w którym
odzwierciedla
ogólne zdrowie
filmów przesłanych na kanał client
. Zawiera też następujące informacje:
- Łączna liczba otrzymanych zdarzeń.
- Liczba udanych przetworzonych zdarzeń.
- Liczba zdarzeń oczekujących (które są nadal przetwarzane).
- Pole
alerts
z podsumowaniem błędów pogrupowanych wedługOfflineConversionError
Wszystkie te pola zawierają informacje z ostatniego pełnego dnia kalendarzowego filmów. Wykorzystaj te informacje, aby ocenić bieżący stan przesłanych plików.
Dodatkowo każde OfflineConversionUploadClientSummary
lub
OfflineConversionUploadConversionActionSummary
zawiera dwa różne
typy raportów:
daily_summaries
successful_count
,failed_count
ipending_count
próśb o przesłanie z ostatnich 7 dni, pogrupowane według przesyłania:date
.job_summaries
successful_count
,failed_count
ipending_count
z 7 najbardziej ostatnie żądania przesłania pogrupowane według kategoriijob_id
.job_id
to pole opcjonalne zUploadClickConversionsRequest
iUploadConversionAdjustmentsRequest
Możesz ustawićjob_id
do nieujemnej liczby mniejszej niż2^31
lub pozwól interfejsowi Google Ads API przypisać wygenerowany przez system identyfikator zadania do Twojego żądania. Niezależnie od wybranej opcji wybierzUploadClickConversionsResponse
lubUploadConversionAdjustmentsResponse
zwracajob_id
.Jedną ze scenariuszy, w której przydaje się własne przypisanie
job_id
, jest zastosowanie zadanie lub proces, który przesyła dużą liczbę konwersji za pomocą funkcji wiele żądań. Jeśli ustawisz polejob_id
w każdym z tych żądań na tej samej wartości, możesz pobrać pojedynczy wpis dla zadania zjob_summaries
Jeśli zezwolisz interfejsowi Google Ads API na przypisywanie do dojob_id
każdego żądania,job_summaries
zawiera osobny element dla każdego żądania, co może wpłynąć na analizę ogólnego stanu co jest trudniejsze.
Jak korzystać z podsumowań
Aby mieć pewność, że procesy przesyłania rejestrują konwersje i ulepszenia jako
okresowo pobiera podsumowania dotyczące każdego ze swoich kont. Jeśli
status
dowolnego podsumowania nie ma wartości EXCELLENT
, użyj listy błędów w
alerts
, aby pomóc Ci zmodyfikować proces przesyłania, aby zmniejszyć lub
i je wyeliminować.
Na przykład:
Jeśli stan to
NEEDS_ATTENTION
, znaczna część operacji przesyłania zakończyło się niepowodzeniem. Zapoznaj się z błędami w sekcjialerts
i zmodyfikuj przesyłania, aby ograniczyć lub wyeliminować te błędy.Jeśli stan to
NO_RECENT_UPLOADS
, usługa Google Ads nie otrzymała żadnych –client
. Jeśli jest to nieoczekiwane, sprawdź procesy które przesyłają za pomocą tego klienta.Jeśli np.
status
elementuGOOGLE_ADS_API
toNO_RECENT_UPLOADS
, może oznaczać, że proces przesyłania korzystający z interfejsu Google Ads API przestał działać w ostatnim czasie.Aby określić, czy istnieje konkretna data przesłania lub zadanie, które wysłało dużą liczby zdarzeń, których nie udało się przetworzyć, sprawdź
successful_count
,failed_count
ipending_count
zdaily_summaries
ijob_summaries
. Zdarzenie w stanie oczekiwania może potrwać do 24 godzin aby zakończyć.
Ograniczenia
Podczas pobierania podsumowań przesłanych filmów pamiętaj o tych kwestiach:
Interfejs Google Ads API zwraca diagnostykę danych offline tylko wtedy, gdy
customer_id
ŻądaniesearchStream
lubsearch
to ten sam klient, który był ostatnio przez Ciebie przesyłać konwersje.Na przykład konto klienta, które korzysta ze śledzenia konwersji dla wielu kont, może nie zawierają żadnych danych diagnostycznych. Możesz jednak pobrać dane diagnostyczne, wysyłając żądanie, w którym
customer_id
odpowiada parametrowicustomer_id
menedżera używanego do przesyłania plików.Google Ads traktuje
CLICK_NOT_FOUND
błędów z konwersji rozszerzonych dotyczących kampanii potencjalne zlecenia przesyłane jako ostrzeżenia. Jako wynik. Jeślialerts
zawiera wpis związany z tym błędem, oznacza to, że odpowiada on operacje są nadal uznawane za udane i są uwzględnione wsuccessful_event_count