Monitorowanie diagnostyki danych offline

Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.

Użyj interfejsu Google Ads API, aby pobrać raport diagnostyczny danych offline, który zawiera informacje o ogólnym stanie procesów importowania i dostosowywania konwersji.

Aby pobrać najnowsze dane diagnostyczne dotyczące Twojego konta offline, skorzystaj z jednego z tych materiałów:

• offline_conversion_upload_client_summaryzbiorcza diagnostyka importu na poziomie konta.
• offline_conversion_upload_conversion_action_summary(dostępne tylko w wersji 17 lub nowszej) agreguje diagnostykę importu na poziomie działania konwersji.

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 OfflineConversionUploadClientSummarywiersze dla każdego typu klienta użytego w ostatnich importach. Jeśli np. niedawno zaimportowałeś 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ć 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 diagnostyka na poziomie konta to zapytanie zwraca osobne OfflineConversionUploadConversionActionSummarywiersze dla każdego typu klienta użytego w ostatnich importach. Jeśli np. niedawno zaimportowałeś 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.

Interpretowanie tych podsumowań

Każdy OfflineConversionUploadClientSummary lub OfflineConversionUploadConversionActionSummary ma pole status, które odzwierciedla ogólny stan importów w client. Zawiera ona też te informacje:

• Łączna liczba otrzymanych zdarzeń.
• Liczba pomyślnie przetworzonych zdarzeń.
• 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. Użyj tych informacji, aby ocenić obecny stan importowanych danych.

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

daily_summaries

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

job_summaries

successful_count, failed_count i pending_count z 7 najnowszych próśb o importowanie danych, pogrupowane według wymiaru job_id. Pole job_id jest opcjonalnym polem w UploadClickConversionsRequest i UploadConversionAdjustmentsRequest. Możesz ustawić parametr job_id na nieujemną wartość mniejszą niż 2^31 lub pozwolić interfejsowi Google Ads API przypisać do żądania wygenerowany przez system identyfikator zadania. Niezależnie od wybranej opcji UploadClickConversionsResponse lub UploadConversionAdjustmentsResponse zwraca wartość job_id.

Przypisanie własnego parametru job_id może być przydatne w przypadku pojedynczego zadania lub procesu, który importuje dużą liczbę konwersji za pomocą wielu żądań. Jeśli ustawisz job_id w każdej z tych próśb 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 atrybutu job_id każdego żądania, atrybuty job_summaries będą 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 z każdego konta. Jeśli status w dowolnym podsumowaniu nie jest EXCELLENT, skorzystaj z listy błędów w sekcji alerts, aby dowiedzieć się, jak zmodyfikować proces importowania w celu zmniejszenia liczby błędów lub ich wyeliminowania.

Na przykład:

• Jeśli stan to NEEDS_ATTENTION, znaczna część operacji importu zakończyła się niepowodzeniem. Zapoznaj się z błędami w sekcji alerts i zmodyfikuj proces importowania, aby zmniejszyć lub wyeliminować te błędy.

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

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

• Aby sprawdzić, czy w przypadku jakiejś konkretnej daty importu lub zadania wysłano dużą liczbę zdarzeń, które nie zostały przetworzone, sprawdź wartości successful_count, failed_count i pending_count w tablicach daily_summaries i job_summaries. Przetwarzanie zdarzeń o stanie oczekujące 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 diagnostykę danych offline tylko wtedy, gdy customer_id w prośbie searchStream lub search to ten sam klient, którego dane zostały niedawno zaimportowane.

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

• Google Ads traktuje błędy CLICK_NOT_FOUND występujące podczas importowania konwersji rozszerzonych dotyczących potencjalnych klientów jako ostrzeżenia. W rezultacie, jeśli alerts zawiera wpis dotyczący tego błędu, odpowiednie operacje są nadal uznawane za udane i uwzględniane w successful_event_count.