Monitorowanie diagnostyki danych offline

Używaj interfejsu Google Ads API do pobierania danych diagnostycznych dotyczących danych offline, które zawierają informacje o ogólnym stanie procesów importowania i dostosowywania konwersji.

Aby pobrać najnowsze dane diagnostyczne dotyczące danych offline na koncie, użyj 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 osobne wiersze OfflineConversionUploadClientSummary dla każdego typu klienta używanego 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_API i GOOGLE_ADS_WEB_CLIENT.

Diagnostyka na poziomie działania powodującego konwersję

Aby pobrać dane diagnostyczne przesyłania konwersji na poziomie działania powodującego konwersję, użyj tego zapytania GAQL:

SELECT
  offline_conversion_upload_conversion_action_summary.conversion_action_id,
  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 = <CONVERSION_ACTION_ID>

Podobnie jak w przypadku diagnostyki na poziomie konta to zapytanie zwraca osobne wiersze OfflineConversionUploadConversionActionSummary dla każdego typu klienta używanego w ostatnich importach. Jeśli np. niedawno przeprowadzono importowanie 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.

Jak interpretować te podsumowania

Każdy element OfflineConversionUploadClientSummary lub OfflineConversionUploadConversionActionSummary ma pole status, które odzwierciedla ogólny stan importu dla client. Zawiera też te informacje:

  • Łączna liczba 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 importu. Te informacje pozwolą Ci ocenić bieżący stan importu.

Dodatkowo każdy OfflineConversionUploadClientSummary lub OfflineConversionUploadConversionActionSummary zawiera 2 różne typy raportów:

daily_summaries
successful_count, failed_count i pending_count żądań importu z ostatnich 7 dni, pogrupowane według date importu.
job_summaries

successful_count, failed_count i pending_count 7 ostatnich próśb o import, pogrupowane według job_id. job_id to opcjonalne pole w UploadClickConversionsRequest i UploadConversionAdjustmentsRequest. Możesz ustawić parametr job_id na liczbę nieujemną mniejszą niż 2^31 lub pozwolić interfejsowi Google Ads API na przypisanie do żądania identyfikatora zadania wygenerowanego przez system. Niezależnie od wybranej opcji UploadClickConversionsResponse lub UploadConversionAdjustmentsResponse zwraca job_id.

Przypisanie własnego identyfikatora job_id jest przydatne, 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 job_id na tę samą wartość, możesz pobrać pojedynczy wpis dotyczący zadania z job_summaries. Jeśli zamiast tego pozwolisz interfejsowi Google Ads API przypisać wygenerowaną przez system wartość do pola job_id każdego żądania, pole job_summaries będzie 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 importowania rejestrują konwersje i ulepszenia zgodnie z oczekiwaniami, okresowo pobieraj podsumowania dla każdego konta. Jeśli status jakiegokolwiek podsumowania nie jest EXCELLENT, użyj listy błędów w sekcji alerts, aby zmodyfikować proces importowania i ograniczyć lub wyeliminować te błędy.

Na przykład:

  • Jeśli stan to NEEDS_ATTENTION, oznacza to, że znaczna część operacji importowania nie powiodła się. Sprawdź błędy w sekcji alerts i zmodyfikuj proces importowania, aby je ograniczyć lub wyeliminować.

  • Jeśli stan to NO_RECENT_UPLOADS, Google Ads nie otrzymało ostatnio żadnych importów dla client. Jeśli jest to nieoczekiwane, sprawdź procesy, które wykonują importy za pomocą tego klienta.

    Jeśli np. status dla GOOGLE_ADS_API wynosi NO_RECENT_UPLOADS, może to oznaczać, że proces importowania, który korzysta z interfejsu Google Ads API, został niedawno zatrzymany.

  • Aby sprawdzić, czy w określonym dniu importu lub w ramach konkretnego zadania wysłano dużą liczbę zdarzeń, których nie udało się przetworzyć, sprawdź successful_count, failed_count i pending_count w daily_summaries i job_summaries. Zakończenie wszystkich zdarzeń w stanie oczekiwania może potrwać do 24 godzin.

Więcej informacji o tym, jak poprawić diagnostykę danych offline, znajdziesz w Centrum pomocy.

Ograniczenia

Podczas pobierania podsumowań importu pamiętaj o tych kwestiach:

  • Interfejs Google Ads API zwraca dane diagnostyczne dotyczące danych offline tylko wtedy, gdy customer_id żądania searchStream lub search jest tym samym klientem, którego użyto niedawno do zaimportowania konwersji.

    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 customer_id odpowiada customer_id konta menedżera używanego do importowania.

  • Google Ads traktuje błędy CLICK_NOT_FOUND z importów 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ędniane w successful_event_count.

Wstecz
Niestandardowe zmienne konwersji
Dalej
Raportowanie