Monitorowanie diagnostyki danych offline

Użyj interfejsu Google Ads API, aby pobrać diagnostykę danych offline, która zawiera informacje o ogólnym stanie procesów importowania i dostosowywania konwersji.

Aby pobrać najnowszą diagnostykę danych offline na swoim koncie, skorzystaj z jednego z tych materiałó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żywanego 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 clientGOOGLE_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_id,
  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 = <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 zaimportowano 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 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 przetworzonych zdarzeń.
• Liczba oczekujących zdarzeń (zdarzeń, które są nadal przetwarzane).
• Pole alerts, które zawiera podsumowanie błędów pogrupowanych według OfflineConversionError.

Wszystkie te pola zawierają informacje z ostatniego pełnego dnia kalendarzowego importów. Wykorzystaj te informacje, aby ocenić bieżący stan importów.

Każdy OfflineConversionUploadClientSummary lub OfflineConversionUploadConversionActionSummary zawiera 2 rodzaje raportów:

daily_summaries

Liczba successful_count, failed_count i pending_count żądań importu z ostatnich 7 dni, pogrupowanych według importu date.

job_summaries

Wartości successful_count, failed_count i pending_count z 7 najnowszych próśb o import pogrupowane według job_id. Pole job_id jest opcjonalne w przypadku UploadClickConversionsRequest i UploadConversionAdjustmentsRequest. Możesz ustawić wartość parametru job_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 funkcja UploadClickConversionsResponse lub UploadConversionAdjustmentsResponse 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 parametr job_id na tę samą wartość, możesz pobrać z job_summaries pojedynczy wpis dotyczący zadania. Jeśli zamiast tego pozwolisz interfejsowi Google Ads API przypisać do parametru job_id każdego żądania wygenerowaną przez system wartość, parametr job_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 importowania rejestrują konwersje i ulepszenia zgodnie z oczekiwaniami, okresowo pobieraj podsumowania dla każdego konta. Jeśli status w przypadku dowolnego podsumowania nie jest EXCELLENT, skorzystaj z listy błędów w sekcji alerts, aby zmodyfikować proces importowania i zmniejszyć lub wyeliminować te błędy.

Na przykład:

• Jeśli stan to NEEDS_ATTENTION, oznacza to, że znaczna część operacji importu się nie powiodła. Sprawdź błędy w sekcji alerts 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ących client. Jeśli to nieoczekiwane zachowanie, sprawdź procesy, które wykonują importowanie za pomocą tego klienta.

  Jeśli na przykład wartość status dla GOOGLE_ADS_API wynosi NO_RECENT_UPLOADS, może to oznaczać, że proces importowania, który korzysta z interfejsu Google Ads API, został niedawno zatrzymany.

• Aby sprawdzić, czy w określonym dniu lub w ramach określonego zadania importu wysłano dużą liczbę zdarzeń, których nie udało się przetworzyć, sprawdź successful_count, failed_count i pending_count w sekcjach daily_summaries i job_summaries. Wykonanie zdarzeń w stanie oczekiwania może zająć 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 żądania searchStream lub search 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 customer_id pasuje do customer_id konta menedżera używanego w importach.

• Google Ads traktuje błędy CLICK_NOT_FOUND pochodzące z importów konwersji rozszerzonych dotyczących potencjalnych klientów jako ostrzeżenia. W rezultacie, jeśli pole alerts zawiera wpis dotyczący tego błędu, odpowiednie operacje są nadal uznawane za udane i są uwzględniane w polu successful_event_count.