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 konwersji i korygowania danych.

Aby pobrać najnowsze dane diagnostyczne dotyczące danych offline na koncie, skorzystaj z jednego z tych zasobów:

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_APIGOOGLE_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_APIGOOGLE_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ług OfflineConversionError.

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_countpending_count z żądań importu z ostatnich 7 dni pogrupowane według importu date.
job_summaries

Wartości successful_count, failed_countpending_count z 7 najnowszych próśb o import pogrupowane według parametru 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ć wygenerowaną przez system wartość do parametru job_id każdego żądania, 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 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 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 jest to niespodziewane, sprawdź procesy, które wykonują importy za pomocą tego klienta.

    Jeśli np. wartość status dla GOOGLE_ADS_API wynosi NO_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_countpending_count w przypadku daily_summariesjob_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 żą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 wartość parametru customer_id jest zgodna z wartością parametru customer_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 pole alerts zawiera wpis dotyczący tego błędu, odpowiednie operacje są nadal uznawane za zakończone powodzeniem i są uwzględniane w polu successful_event_count.