Monitorowanie diagnostyki danych offline

Pobierz interfejs Google Ads API diagnostyka danych offline, które zawierają informacje o ogólnym stanie przesyłanych konwersji oraz i dostosowywania stawek.

Aby pobrać najnowszą diagnostykę danych offline na koncie, użyj jeden z tych materiałów:

Diagnostyka na poziomie konta

Aby pobrać diagnostykę przesyłania konwersji na poziomie konta, skorzystaj z tych instrukcji: Zapytanie 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 OfflineConversionUploadClientSummary wiersze dla każdego typu klienta użytego w ostatnio przesłanych plikach. Jeśli na przykład przesłanych ostatnio za pomocą interfejsu Google Ads API i interfejsu Google Ads. zawierają osobne wpisy z wartościami client dla 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 funkcji: następujące zapytanie 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 OfflineConversionUploadConversionActionSummary wiersze dla każdego typu klienta użytego w ostatnio przesłanych plikach. Jeśli na przykład przesłanych ostatnio za pomocą interfejsu Google Ads API i interfejsu Google Ads. zawierają osobne wpisy z wartościami client dla GOOGLE_ADS_API i GOOGLE_ADS_WEB_CLIENT

Jak interpretować podsumowania

Co OfflineConversionUploadClientSummary lub OfflineConversionUploadConversionActionSummary ma pole status, w którym odzwierciedla ogólne zdrowie filmów przesłanych na kanał client. Zawiera też następujące informacje:

  • Łączna liczba otrzymanych zdarzeń.
  • Liczba udanych przetworzonych zdarzeń.
  • Liczba zdarzeń oczekujących (które są nadal przetwarzane).
  • Pole alerts z podsumowaniem błędów pogrupowanych według OfflineConversionError

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

Dodatkowo każde OfflineConversionUploadClientSummary lub OfflineConversionUploadConversionActionSummary zawiera dwa różne typy 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 najbardziej ostatnie żądania przesłania pogrupowane według kategorii job_id. job_id to pole opcjonalne z UploadClickConversionsRequest i UploadConversionAdjustmentsRequest Możesz ustawić job_id do nieujemnej liczby mniejszej niż 2^31 lub pozwól interfejsowi Google Ads API przypisać wygenerowany przez system identyfikator zadania do Twojego żądania. Niezależnie od wybranej opcji wybierz UploadClickConversionsResponse lub UploadConversionAdjustmentsResponse zwraca job_id.

Jedną ze scenariuszy, w której przydaje się własne przypisanie job_id, jest zastosowanie zadanie lub proces, który przesyła dużą liczbę konwersji za pomocą funkcji wiele żądań. Jeśli ustawisz pole job_id w każdym z tych żądań na tej samej wartości, możesz pobrać pojedynczy wpis dla zadania z job_summaries Jeśli zezwolisz interfejsowi Google Ads API na przypisywanie do do job_id każdego żądania, job_summaries zawiera osobny element dla każdego żądania, co może wpłynąć na analizę ogólnego stanu co jest trudniejsze.

Jak korzystać z podsumowań

Aby mieć pewność, że procesy przesyłania rejestrują konwersje i ulepszenia jako okresowo pobiera podsumowania dotyczące każdego ze swoich kont. Jeśli status dowolnego podsumowania nie ma wartości EXCELLENT, użyj listy błędów w alerts, aby pomóc Ci zmodyfikować proces przesyłania, aby zmniejszyć lub i je wyeliminować.

Na przykład:

  • Jeśli stan to NEEDS_ATTENTION, znaczna część operacji przesyłania zakończyło się niepowodzeniem. Zapoznaj się z błędami w sekcji alerts i zmodyfikuj przesyłania, aby ograniczyć lub wyeliminować te błędy.

  • Jeśli stan to NO_RECENT_UPLOADS, usługa Google Ads nie otrzymała żadnych – client. Jeśli jest to nieoczekiwane, sprawdź procesy które przesyłają za pomocą tego klienta.

    Jeśli np. status elementu GOOGLE_ADS_API to NO_RECENT_UPLOADS, może oznaczać, że proces przesyłania korzystający z interfejsu Google Ads API przestał działać w ostatnim czasie.

  • Aby określić, czy istnieje konkretna data przesłania lub zadanie, które wysłało dużą liczby zdarzeń, których nie udało się przetworzyć, sprawdź successful_count, failed_count i pending_count z daily_summaries i job_summaries. Zdarzenie w stanie oczekiwania może potrwać do 24 godzin aby zakończyć.

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 Żądanie searchStream lub search to ten sam klient, który był ostatnio przez Ciebie przesyłać konwersje.

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

  • Google Ads traktuje CLICK_NOT_FOUND błędów z konwersji rozszerzonych dotyczących kampanii potencjalne zlecenia przesyłane jako ostrzeżenia. Jako wynik. Jeśli alerts zawiera wpis związany z tym błędem, oznacza to, że odpowiada on operacje są nadal uznawane za udane i są uwzględnione w successful_event_count