Za pomocą interfejsu Google Ads API możesz pobierać diagnostykę danych offline, która zawiera informacje o ogólnym stanie przesyłania konwersji i ich dostosowywania.
Aby pobrać najnowszą diagnostykę danych offline na koncie, wyślij to zapytanie dotyczące zasobów offline_conversion_upload_client_summary
za pomocą narzędzia GoogleAdsService
:
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.resource_name,
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 osobne wartości OfflineConversionUploadClientSummary
dla każdego typu klienta użytego w ostatnio przesłanych plikach. Jeśli np. niedawno prześlesz plik przy użyciu zarówno interfejsu Google Ads API, jak i interfejsu Google Ads, wyniki będą zawierać osobne wpisy dla wartości client
GOOGLE_ADS_API
i GOOGLE_ADS_WEB_CLIENT
.
Każdy OfflineConversionUploadClientSummary
ma pole status
, które odzwierciedla ogólny stan przesyłanych plików w client
. Zawiera też liczbę otrzymanych zdarzeń, liczbę udanych przetworzonych zdarzeń oraz pole alerts
z podsumowaniem błędów pogrupowanych według OfflineConversionError
.
Wszystkie te pola zawierają informacje z ostatniego pełnego dnia kalendarzowego przesyłania. Wykorzystaj te informacje, aby ocenić bieżący stan przesłanych plików.
Dodatkowo każdy element OfflineConversionUploadClientSummary
zawiera 2 rodzaje raportów:
daily_summaries
successful_count
ifailed_count
żądań przesłania z ostatnich 7 dni, pogrupowane według przesyłaniadate
.job_summaries
successful_count
ifailed_count
z 7 ostatnich żądań przesłania, pogrupowane według kategoriijob_id
.job_id
jest polem opcjonalnym w przypadkuUploadClickConversionsRequest
iUploadConversionAdjustmentsRequest
. Możesz ustawićjob_id
na nieujemną liczbę mniejszą niż2^31
lub pozwolić interfejsowi Google Ads API przypisać do Twojego żądania identyfikator zadania wygenerowany przez system. Niezależnie od wybranej opcjiUploadClickConversionsResponse
lubUploadConversionAdjustmentsResponse
zwracajob_id
.Przypisanie własnego obiektu
job_id
przydaje się np. w sytuacji, gdy masz jedno zadanie lub proces, które przesyłają dużą liczbę konwersji za pomocą wielu żądań. Jeśli wjob_id
w każdym z tych żądań ustawisz tę samą wartość, możesz pobrać pojedynczy wpis dla tego zadania z adresujob_summaries
. Jeśli zamiast tego zezwolisz interfejsowi Google Ads API na przypisywanie wartości wygenerowanej przez system dojob_id
każdego żądania,job_summaries
będzie zawierać osobne wpisy dla każdego żądania, co może utrudnić analizę ogólnego stanu zadania.
Jak korzystać z podsumowań
Aby mieć pewność, że procesy przesyłania rejestrują konwersje i ulepszenia zgodnie z oczekiwaniami, okresowo pobieraj podsumowania ze wszystkich swoich kont. Jeśli status
któregokolwiek z podsumowań nie ma wartości EXCELLENT
, skorzystaj z listy błędów w sekcji alerts
, aby zmodyfikować proces przesyłania, aby ograniczyć lub wyeliminować te błędy.
Na przykład:
Stan
NEEDS_ATTENTION
oznacza, że znaczna część operacji przesyłania zakończyła się niepowodzeniem. Zapoznaj się z błędami w sekcjialerts
i zmodyfikuj proces przesyłania, aby ograniczyć lub wyeliminować te błędy.Jeśli stan to
NO_RECENT_UPLOADS
, oznacza to, że usługaclient
nie przesłała żadnych ostatnio przesłanych danych. Jeśli jest to nieoczekiwane, sprawdź procesy przesyłania za pomocą tego klienta.Jeśli np.
status
w poluGOOGLE_ADS_API
toNO_RECENT_UPLOADS
, może to oznaczać, że proces przesyłania korzystający z interfejsu Google Ads API niedawno przestał działać.Sprawdź
successful_count
ifailed_count
właściwościdaily_summaries
orazjob_summaries
, aby określić, czy jakaś konkretna data przesłania lub określone zadanie wysłało dużą liczbę zdarzeń, które nie zostały przetworzone.
Ograniczenia
Podczas pobierania podsumowań przesłanych filmów pamiętaj o tych kwestiach:
Interfejs Google Ads API zwraca diagnostykę danych offline tylko wtedy, gdy parametr
customer_id
w żądaniusearchStream
lubsearch
to ten sam klient, który ostatnio był przez Ciebie przesyłany.Na przykład konto klienta, które używa śledzenia konwersji dla wielu kont, może nie zawierać żadnych danych diagnostycznych. Możesz jednak pobierać dane diagnostyczne, wysyłając żądanie, w którym
customer_id
odpowiada parametrowicustomer_id
konta menedżera, którego używasz do przesyłania danych.Google Ads traktuje
CLICK_NOT_FOUND
błędów z przesłanych konwersji rozszerzonych dotyczących potencjalnych klientów jako ostrzeżenia. W związku z tym, jeślialerts
zawiera wpis dotyczący tego błędu, odpowiednie operacje są nadal uznawane za udane i są uwzględnione wsuccessful_event_count
.