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ć najnowszą diagnostykę danych offline na koncie, użyj jednego z tych materiałów:

• offline_conversion_upload_client_summary zbiera dane diagnostyczne przesyłania na poziomie konta.
• offline_conversion_upload_conversion_action_summary (dostępne tylko w wersji 17 i nowszych) zbiera dane diagnostyczne przesyłania na poziomie działań powodujących 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 wiersze OfflineConversionUploadClientSummary dla każdego typu klienta użytego w ostatnich przesłanych plikach. Jeśli np. niedawno przesłałeś 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 ostatnio przesłanych plikach. Jeśli np. niedawno przesłałeś 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 też następujące 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. 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 z ostatnich 7 dni, pogrupowane według przesyłania date.

job_summaries

successful_count, failed_count i pending_count z 7 ostatnich próśb o przesłanie, pogrupowane według kategorii job_id. Pole job_id jest opcjonalnym polem w UploadClickConversionsRequest i UploadConversionAdjustmentsRequest. 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 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 przypadku każdego z tych żądań 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 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. 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, oznacza to, że usługa client 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. 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 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ń przesłanych filmów 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.