Monitorowanie diagnostyki danych offline

Za pomocą interfejsu Google Ads API możesz pobierać diagnostykę danych offline, która zawiera informacje o ogólnym stanie przesyłania konwersji i ich dostosowywania.

Aby pobrać najnowszą diagnostykę danych offline na koncie, wyślij to zapytanie dotyczące zasobów offline_conversion_upload_client_summary za pomocą narzędzia GoogleAdsService:

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.resource_name,
  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 osobne wartości OfflineConversionUploadClientSummary dla każdego typu klienta użytego w ostatnio przesłanych plikach. Jeśli np. niedawno prześlesz plik przy użyciu zarówno interfejsu Google Ads API, jak i interfejsu Google Ads, wyniki będą zawierać osobne wpisy dla wartości client GOOGLE_ADS_API i GOOGLE_ADS_WEB_CLIENT.

Każdy OfflineConversionUploadClientSummary ma pole status, które odzwierciedla ogólny stan przesyłanych plików w client. Zawiera też liczbę otrzymanych zdarzeń, liczbę udanych przetworzonych zdarzeń oraz pole alerts z podsumowaniem błędów pogrupowanych według OfflineConversionError. Wszystkie te pola zawierają informacje z ostatniego pełnego dnia kalendarzowego przesyłania. Wykorzystaj te informacje, aby ocenić bieżący stan przesłanych plików.

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

daily_summaries

successful_count i failed_count żądań przesłania z ostatnich 7 dni, pogrupowane według przesyłania date.

job_summaries

successful_count i failed_count z 7 ostatnich żądań przesłania, pogrupowane według kategorii job_id. job_id jest polem opcjonalnym w przypadku 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 job_id.

Przypisanie własnego obiektu job_id przydaje się np. w sytuacji, gdy masz jedno zadanie lub proces, które przesyłają dużą liczbę konwersji za pomocą wielu żądań. Jeśli w job_id w każdym z tych żądań ustawisz tę samą wartość, możesz pobrać pojedynczy wpis dla tego zadania z adresu job_summaries. Jeśli zamiast tego zezwolisz interfejsowi Google Ads API na przypisywanie wartości wygenerowanej przez system do job_id każdego żądania, job_summaries będzie zawierać osobne wpisy 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 ze wszystkich swoich 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. Zapoznaj się z błędami 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. status w polu GOOGLE_ADS_API to NO_RECENT_UPLOADS, może to oznaczać, że proces przesyłania korzystający z interfejsu Google Ads API niedawno przestał działać.

• Sprawdź successful_count i failed_count właściwości daily_summaries oraz job_summaries, aby określić, czy jakaś konkretna data przesłania lub określone zadanie wysłało dużą liczbę zdarzeń, które nie zostały przetworzone.

Ograniczenia

Podczas pobierania podsumowań przesłanych filmów pamiętaj o tych kwestiach:

• Interfejs Google Ads API zwraca diagnostykę danych offline tylko wtedy, gdy parametr customer_id w żądaniu searchStream lub search to ten sam klient, który ostatnio był przez Ciebie przesyłany.

  Na przykład konto klienta, które używa śledzenia konwersji dla wielu kont, może nie zawierać żadnych danych diagnostycznych. Możesz jednak pobierać dane diagnostyczne, wysyłając żądanie, w którym customer_id odpowiada parametrowi customer_id konta menedżera, którego używasz do przesyłania danych.

• Google Ads traktuje CLICK_NOT_FOUND błędów z przesłanych konwersji rozszerzonych dotyczących potencjalnych klientów jako ostrzeżenia. W związku z tym, jeśli alerts zawiera wpis dotyczący tego błędu, odpowiednie operacje są nadal uznawane za udane i są uwzględnione w successful_event_count.