Monitorowanie diagnostyki danych offline

Użyj interfejsu Google Ads API, aby pobrać raport z diagnostyki danych offline, który zawiera informacje o ogólnym stanie procesów przesyłania i dostosowywania konwersji.

Aby pobrać najnowsze dane diagnostyczne dotyczące Twojego konta offline, skorzystaj z jednego z tych materiałów:

• offline_conversion_upload_client_summaryzbiorczy diagnostykę przesyłania na poziomie konta.
• offline_conversion_upload_conversion_action_summary(dostępna tylko w wersji 17 lub nowszej) agreguje diagnostykę przesyłania na poziomie działania konwersji.

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 wiersze OfflineConversionUploadClientSummary dla każdego typu klienta użytego w ostatnich przesłanych plikach. Jeśli np. niedawno przesłano 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 diagnostyka na poziomie konta to zapytanie zwraca osobne OfflineConversionUploadConversionActionSummarywiersze dla każdego typu klienta użytego w ostatnich przesłanych danych. Jeśli np. niedawno przesłano 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.

Interpretowanie tych podsumowań

Każdy element OfflineConversionUploadClientSummary lub OfflineConversionUploadConversionActionSummary ma pole status, które odzwierciedla ogólny stan przesyłanych danych do client. Zawiera ona też te informacje:

• Łączna liczba otrzymanych zdarzeń.
• Liczba pomyślnie 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 przesyłania danych. Wykorzystaj te informacje do oceny obecnego stanu przesyłanych treści.

Dodatkowo każdy element OfflineConversionUploadClientSummary lub OfflineConversionUploadConversionActionSummary zawiera 2 rodzaje raportów:

daily_summaries

successful_count, failed_count i pending_count próśb o przesłanie danych z ostatnich 7 dni, pogrupowanych według typu przesyłania date.

job_summaries

successful_count, failed_count i pending_count z 7 najnowszych żądań przesyłania, pogrupowanych według job_id. Pole job_id jest opcjonalnym polem w UploadClickConversionsRequest i UploadConversionAdjustmentsRequest. Możesz ustawić parametr job_id na nieujemną liczbę mniejszą niż 2^31 lub pozwolić interfejsowi Google Ads API przypisać do żądania wygenerowany przez system identyfikator zadania. Niezależnie od wybranej opcji UploadClickConversionsResponse lub UploadConversionAdjustmentsResponse zwraca wartość job_id.

Przypisanie własnego parametru job_id może być przydatne w przypadku pojedynczego zadania lub procesu, który przesyła dużą liczbę konwersji za pomocą wielu żądań. Jeśli ustawisz job_id w każdej z tych próśb 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ć wygenerowaną przez system wartość do atrybutu job_id każdego żądania, atrybuty job_summaries będą zawierać osobny wpis 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 dotyczące każdego z Twoich kont. Jeśli status w dowolnym podsumowaniu nie jest EXCELLENT, skorzystaj z listy błędów w sekcji alerts, aby dowiedzieć się, jak zmodyfikować proces przesyłania, aby zmniejszyć lub wyeliminować te błędy.

Na przykład:

• Jeśli stan to NEEDS_ATTENTION, oznacza to, że znaczna część operacji przesyłania zakończyła się niepowodzeniem. Sprawdź błędy w sekcji alerts i zmodyfikuj proces przesyłania, aby ograniczyć lub wyeliminować te błędy.

• Jeśli stan to NO_RECENT_UPLOADS, Google Ads nie otrzymało żadnych ostatnich przesyłek dotyczących client. Jeśli jest to nieoczekiwane, sprawdź procesy przesyłania za pomocą tego klienta.

  Jeśli np. wartość status dla GOOGLE_ADS_API to NO_RECENT_UPLOADS, może to oznaczać, że proces przesyłania, który korzysta z interfejsu Google Ads API, niedawno przestał działać.

• Aby sprawdzić, czy w przypadku jakiejś konkretnej daty przesyłania lub konkretnego zadania wysłano dużą liczbę zdarzeń, które nie zostały przetworzone, sprawdź kolumny successful_count, failed_count i pending_count w tabeli daily_summaries oraz job_summaries. Realizacja zdarzeń o stanie oczekujące może potrwać do 24 godzin.

Ograniczenia

Podczas pobierania podsumowań przesyłania pamiętaj o tych kwestiach:

• Interfejs Google Ads API zwraca diagnostykę danych offline tylko wtedy, gdy customer_id żądania searchStream lub search to ten sam klient, którego dane zostały niedawno przesłane.

  Na przykład konto klienta, które korzysta ze śledzenia konwersji dla wielu kont, może nie zawierać żadnych danych diagnostycznych. Możesz jednak pobrać dane diagnostyczne, wysyłając żądanie, w którym wartość parametru customer_id odpowiada wartości parametru customer_id konta menedżera używanego do przesyłania.

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