Monitorowanie diagnostyki danych offline

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

Aby pobrać najnowsze informacje o diagnostyce danych offline na swoim koncie, użyj jednego z tych zasobów:

• offline_conversion_upload_client_summary agreguje diagnostykę importu na poziomie konta.
• offline_conversion_upload_conversion_action_summary agreguje diagnostykę importu na poziomie działania powodującego konwersję.

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 OfflineConversionUploadClientSummary wiersze 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ć oddzielne 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 w przypadku diagnostyki na poziomie konta to zapytanie zwraca oddzielne OfflineConversionUploadConversionActionSummary wiersze 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ć oddzielne wpisy dla wartości client GOOGLE_ADS_API i GOOGLE_ADS_WEB_CLIENT.

Jak interpretować te podsumowania

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

• liczba wszystkich 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 importów. Użyj tych informacji, aby ocenić bieżący stan importów.

Każde podsumowanie OfflineConversionUploadClientSummary lub OfflineConversionUploadConversionActionSummary zawiera też 2 różne typy raportów:

daily_summaries

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

job_summaries

successful_count, failed_count i pending_count 7 najnowszych żądań importu pogrupowanych według job_id. job_id to opcjonalne pole obiektu UploadClickConversionsRequest i UploadConversionAdjustmentsRequest. Możesz ustawić job_id na liczbę nieujemną 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 job_id.

Przypisanie własnego job_id jest przydatne np. wtedy, gdy masz jedno zadanie lub proces, który importuje dużą liczbę konwersji za pomocą wielu żądań. Jeśli ustawisz job_id na tę samą wartość w każdym z tych żądań, możesz pobrać pojedynczy wpis dotyczący zadania z job_summaries. Jeśli zamiast tego pozwolisz interfejsowi Google Ads API przypisać do job_id każdego żądania wartość wygenerowaną przez system, job_summaries będzie zawierać oddzielny wpis dla każdego żądania, co może utrudnić analizowanie ogólnego stanu zadania.

Jak korzystać z podsumowań

Aby mieć pewność, że procesy importu rejestrują konwersje i ulepszenia zgodnie z oczekiwaniami, okresowo pobieraj podsumowania dla każdego konta. Jeśli status dowolnego podsumowania nie jest równy EXCELLENT, użyj listy błędów w sekcji alerts, aby zmodyfikować proces importu w taki sposób, aby zmniejszyć lub wyeliminować te błędy.

Na przykład:

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

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

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

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

Więcej informacji o tym, jak ulepszyć 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 żądania searchStream lub search jest taki sam jak identyfikator klienta, którego używasz do importowania konwersji.

  Na przykład konto klienta, które korzysta ze śledzenia konwersji dla wielu kont, może nie zawierać żadnych informacji diagnostycznych. Możesz jednak pobrać informacje diagnostyczne, wysyłając żądanie, w którym customer_id jest zgodny z customer_id konta menedżera używanego do importowania.

• Google Ads traktuje błę0/}dy z importów konwersji rozszerzonych dotyczących potencjalnych klientów jako ostrzeżenia.CLICK_NOT_FOUND Jeśli w sekcji alerts znajduje się wpis dotyczący tego błędu, odpowiednie operacje są nadal uznawane za udane i są uwzględniane w successful_event_count.