Użyj interfejsu Google Ads API, aby pobrać diagnostykę danych offline, która zawiera informacje o ogólnym stanie procesów importowania konwersji i korygowania danych.
Aby pobrać najnowsze dane diagnostyczne dotyczące danych offline na koncie, skorzystaj z jednego z tych zasobów:
offline_conversion_upload_client_summary
zbiera diagnostykę importu na poziomie konta.offline_conversion_upload_conversion_action_summary
zbiera diagnostykę importu na poziomie działania powodującego konwersję.
Diagnostyka na poziomie konta
Aby pobrać diagnostykę przesyłania konwersji na poziomie konta, użyj tego zapytania 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 wierszeOfflineConversionUploadClientSummary
dla każdego typu klienta użytego w ostatnich importach. Jeśli np. ostatnio importowano dane za pomocą interfejsu Google Ads API i interfejsu Google Ads, wyniki będą zawierać osobne wpisy dla wartości client
: 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 tego zapytania 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 wiersze OfflineConversionUploadConversionActionSummary
dla każdego typu klienta użytego w ostatnich importach. Jeśli np. ostatnio importowano dane za pomocą interfejsu Google Ads API i interfejsu Google Ads, wyniki będą zawierać osobne wpisy dla wartości client
: GOOGLE_ADS_API
i GOOGLE_ADS_WEB_CLIENT
.
Jak interpretować te podsumowania
Każdy element OfflineConversionUploadClientSummary
lub OfflineConversionUploadConversionActionSummary
ma pole status
, które odzwierciedla ogólny stan importów w przypadku client
. Zawiera też te informacje:
- Liczba wszystkich otrzymanych zdarzeń.
- Liczba zdarzeń, które zostały przetworzone.
- Liczba oczekujących zdarzeń (zdarzeń, które są nadal przetwarzane).
- Pole
alerts
, które zawiera podsumowanie błędów pogrupowanych wedługOfflineConversionError
.
Wszystkie te pola zawierają informacje z ostatniego pełnego dnia kalendarzowego importów. Używaj tych informacji do oceny bieżącego stanu importów.
Każda OfflineConversionUploadClientSummary
lub OfflineConversionUploadConversionActionSummary
zawiera 2 rodzaje raportów:
daily_summaries
- A
successful_count
,failed_count
ipending_count
z żądań importu z ostatnich 7 dni pogrupowane według importudate
. job_summaries
Wartości
successful_count
,failed_count
ipending_count
z 7 najnowszych próśb o import pogrupowane według parametrujob_id
. Polejob_id
jest opcjonalne w przypadkuUploadClickConversionsRequest
iUploadConversionAdjustmentsRequest
. Możesz ustawić wartość parametrujob_id
na nieujemną liczbę mniejszą niż2^31
lub pozwolić interfejsowi Google Ads API przypisać do Twojego żądania wygenerowany przez system identyfikator zadania. Niezależnie od wybranej opcji funkcjaUploadClickConversionsResponse
lubUploadConversionAdjustmentsResponse
zwraca wartośćjob_id
.Przypisanie własnego identyfikatora
job_id
jest przydatne w sytuacji, gdy masz jedno zadanie lub proces, który importuje dużą liczbę konwersji za pomocą wielu żądań. Jeśli w każdym z tych żądań ustawisz parametrjob_id
na tę samą wartość, możesz pobrać zjob_summaries
pojedynczy wpis dotyczący zadania. Jeśli zamiast tego pozwolisz interfejsowi Google Ads API przypisać wygenerowaną przez system wartość do parametrujob_id
każdego żądania, parametrjob_summaries
będzie zawierać osobny wpis dla każdego żądania, co może utrudnić analizowanie ogólnego stanu zadania.
Jak korzystać z podsumowań
Aby mieć pewność, że procesy importu rejestrują konwersje i ulepszenia zgodnie z oczekiwaniami, okresowo pobieraj podsumowania dla każdego konta. Jeśli w przypadku któregoś podsumowania wartość status
nie jest równa EXCELLENT
, skorzystaj z listy błędów w sekcji alerts
, aby zmodyfikować proces importu i zmniejszyć liczbę błędów lub je wyeliminować.
Na przykład:
Jeśli stan to
NEEDS_ATTENTION
, oznacza to, że znaczna część operacji importu zakończyła się niepowodzeniem. Sprawdź błędy w sekcjialerts
i zmodyfikuj proces importowania, aby je ograniczyć lub wyeliminować.Jeśli stan to
NO_RECENT_UPLOADS
, oznacza to, że Google Ads nie otrzymało ostatnio żadnych importów dotyczącychclient
. Jeśli jest to niespodziewane, sprawdź procesy, które wykonują importy za pomocą tego klienta.Jeśli np. wartość
status
dlaGOOGLE_ADS_API
wynosiNO_RECENT_UPLOADS
, może to oznaczać, że proces importowania korzystający z interfejsu Google Ads API został niedawno zatrzymany.Aby sprawdzić, czy była konkretna data importu lub zadanie, które wysłało dużą liczbę zdarzeń, które nie zostały przetworzone, sprawdź
successful_count
,failed_count
ipending_count
w przypadkudaily_summaries
ijob_summaries
. Przetwarzanie zdarzeń w stanie oczekiwania może potrwać do 24 godzin.
Więcej informacji o tym, jak ulepszyć diagnostykę danych offline, znajdziesz w Centrum pomocy.
Ograniczenia
Podczas pobierania podsumowań importu pamiętaj o tych kwestiach:
Interfejs Google Ads API zwraca diagnostykę danych offline tylko wtedy, gdy
customer_id
w przypadku żądaniasearchStream
lubsearch
jest tym samym klientem, którego używasz ostatnio do importowania konwersji.Na przykład konto klienta, które korzysta ze śledzenia konwersji dla wielu kont, może nie zawierać żadnych informacji diagnostycznych. Możesz jednak pobrać dane diagnostyczne, wysyłając żądanie, w którym wartość parametru
customer_id
jest zgodna z wartością parametrucustomer_id
na koncie menedżera używanym do importowania.Google Ads traktuje
CLICK_NOT_FOUND
błędy importowania konwersji rozszerzonych dotyczących potencjalnych klientów jako ostrzeżenia. W rezultacie, jeśli polealerts
zawiera wpis dotyczący tego błędu, odpowiednie operacje są nadal uznawane za zakończone powodzeniem i są uwzględniane w polusuccessful_event_count
.