Monitorowanie diagnostyki danych offline

Interfejs Google Ads API umożliwia pobieranie diagnostyki danych offline, które zawierają informacje o ogólnym stanie procesów przesyłania i korygowania konwersji.

Aby pobrać najnowszą diagnostykę danych offline dla swojego konta, wyślij to zapytanie dotyczące zasobów offline_conversion_upload_client_summary, korzystając z 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

Powyższe zapytanie zwraca osobny element OfflineConversionUploadClientSummary dla każdego typu klienta używanego w ostatnio przesłanych plikach. Jeśli np. zostały niedawno przesłane pliki zarówno za pomocą interfejsu Google Ads API, jak i interfejsu Google Ads, wyniki zawierają osobne pozycje z wartościami client GOOGLE_ADS_API i GOOGLE_ADS_WEB_CLIENT.

Każdy element OfflineConversionUploadClientSummary ma pole status, które pokazuje ogólny stan przesyłanych danych do: client. Zawiera też liczbę wszystkich odebranych zdarzeń i liczbę przetworzonych zdarzeń oraz pole alerts, które zawiera podsumowanie błędów pogrupowane według wartości OfflineConversionError. Wszystkie zawierają informacje z ostatniego pełnego dnia kalendarzowego przesłania danych. Na podstawie tych informacji możesz ocenić bieżący stan przesyłanych plików.

Poza tym każdy OfflineConversionUploadClientSummary zawiera 2 różne typy raportów:

daily_summaries

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

job_summaries

successful_count i failed_count z 7 ostatnich próśb o przesłanie, pogrupowane według kategorii job_id. job_id to opcjonalne pole UploadClickConversionsRequest i UploadConversionAdjustmentsRequest. Możesz podać w polu job_id liczbę nieujemną mniejszą niż 2^31 lub pozwolić, by interfejs Google Ads API mógł przypisać do Twojego żądania identyfikator zadania wygenerowany przez system. Niezależnie od wybranej opcji UploadClickConversionsResponse lub UploadConversionAdjustmentsResponse zwraca wartość job_id.

Przykładem, w którym przypisanie własnego elementu job_id jest przydatne, jest sytuacja, w której masz 1 zadanie lub proces, który przesyła dużą liczbę konwersji za pomocą wielu żądań. Jeśli w każdym z tych żądań ustawisz tę samą wartość parametru job_id, możesz pobrać pojedynczy wpis dla zadania z usługi job_summaries. Jeśli zamiast tego pozwolisz interfejsowi Google Ads API przypisywać wartość wygenerowaną przez system do właściwości job_id każdego żądania, job_summaries będzie zawierać oddzielny wpis dla każdego żądania, co może utrudnić analizę ogólnego stanu Twojej pracy.

Jak korzystać z podsumowań

Aby mieć pewność, że konwersje i ulepszenia są rejestrowane zgodnie z oczekiwaniami, okresowo pobieraj podsumowania z każdego konta. Jeśli status w żadnym podsumowaniu nie zawiera wartości EXCELLENT, skorzystaj z listy błędów w sekcji alerts, aby dowiedzieć się, jak zmodyfikować proces przesyłania, aby ograniczyć lub wyeliminować te błędy.

Na przykład:

• Stan NEEDS_ATTENTION oznacza, że znaczna część operacji przesyłania się nie powiodła. Sprawdź błędy w sekcji alerts i zmodyfikuj proces przesyłania, aby ograniczyć lub wyeliminować ich liczbę.

• Jeśli stan to NO_RECENT_UPLOADS, oznacza to, że Google Ads nie otrzymał ostatnio żadnych przesłanych danych o client. Jeśli jest to niezgodne z oczekiwaniami, przejrzyj procesy, które wykonują przesyłanie za pomocą tego klienta.

  Jeśli na przykład status dla elementu GOOGLE_ADS_API to NO_RECENT_UPLOADS, może to oznaczać, że proces przesyłania, który korzysta z interfejsu Google Ads API, został ostatnio wstrzymany.

• Sprawdź successful_count i failed_count dotyczące właściwości daily_summaries i job_summaries, aby ustalić, czy konkretna data przesłania lub zadanie spowodowało wysłanie dużej liczby wydarzeń, które nie zostały przetworzone.

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óry został ostatnio użyty do przesyłania konwersji.

  Na przykład konto klienta korzystające ze śledzenia konwersji dla wielu kont nie może 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 jako ostrzeżenia błędy typu CLICK_NOT_FOUND z przesłanych konwersji rozszerzonych dotyczących potencjalnych klientów. W rezultacie, jeśli alerts zawiera wpis o tym błędzie, odpowiednie operacje są nadal uznawane za udane i są uwzględniane w elemencie successful_event_count.