Diagnose der Offlinedaten überwachen

Mit der Google Ads API können Sie Diagnosedaten zu Offlinedaten abrufen, die Informationen zum allgemeinen Zustand Ihrer Conversion-Import- und Anpassungsprozesse enthalten.

Hinweis: Bei Importen von erweiterten Conversions für Leads können Sie den Importstatus im Diagnosebericht zu erweiterten Conversions für Leads in der Google Ads-Benutzeroberfläche im Blick behalten. Bei erweiterten Conversions für das Web (ENHANCEMENT-Anpassungen) werden in der Offlinedatendiagnose nur Fehler bei der Datenaufnahme auf API-Anfrageebene erfasst. Wenn Sie den asynchronen Tag-zu-API-Abgleich (order_id), die API-Abdeckung für erweiterte Conversions und die Vollständigkeit der Nutzer-IDs im Blick behalten möchten, verwenden Sie den Diagnosebericht für erweiterte Conversions in der Google Ads-Benutzeroberfläche. Schritte zur Fehlerbehebung finden Sie unter Diagnosebenachrichtigungen in der Benutzeroberfläche nach einem erfolgreichen API-Upload.

Wenn Sie die neuesten Diagnosedaten zu Offlinedaten für Ihr Konto abrufen möchten, verwenden Sie eine der folgenden Ressourcen:

• offline_conversion_upload_client_summary fasst Importdiagnosen auf Kontoebene zusammen.
• offline_conversion_upload_conversion_action_summary aggregiert die Importdiagnose auf Ebene der Conversion-Aktion.

Diagnose auf Kontoebene

Verwenden Sie die folgende GAQL-Abfrage, um die Diagnose für den Conversion-Upload auf Kontoebene abzurufen:

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

Diese Abfrage gibt separate OfflineConversionUploadClientSummary-Zeilen für jeden Clienttyp zurück, der in den letzten Importen verwendet wurde. Wenn Sie beispielsweise vor Kurzem sowohl die Google Ads API als auch die Google Ads-Benutzeroberfläche für den Import verwendet haben, enthalten die Ergebnisse separate Einträge für die client-Werte GOOGLE_ADS_API und GOOGLE_ADS_WEB_CLIENT.

Diagnose auf Ebene der Conversion-Aktion

Verwenden Sie die folgende GAQL-Abfrage, um Diagnosedaten zum Conversion-Upload auf Ebene der Conversion-Aktion abzurufen:

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>

Ähnlich wie bei der Diagnose auf Kontoebene werden bei dieser Abfrage separate OfflineConversionUploadConversionActionSummary-Zeilen für jeden Clienttyp zurückgegeben, der bei den letzten Importen verwendet wurde. Wenn Sie beispielsweise vor Kurzem sowohl die Google Ads API als auch die Google Ads-Benutzeroberfläche für den Import verwendet haben, enthalten die Ergebnisse separate Einträge für die client-Werte GOOGLE_ADS_API und GOOGLE_ADS_WEB_CLIENT.

Zusammenfassungen interpretieren

Jeder OfflineConversionUploadClientSummary oder OfflineConversionUploadConversionActionSummary hat ein status-Feld, das den Gesamtzustand der Importe für den client widerspiegelt. Sie enthält außerdem die folgenden Informationen:

• Die Gesamtzahl der empfangenen Ereignisse.
• Die Anzahl der erfolgreich verarbeiteten Ereignisse.
• Die Anzahl der ausstehenden Ereignisse (Ereignisse, die noch verarbeitet werden).
• Ein alerts-Feld, das eine Zusammenfassung der Fehler enthält, gruppiert nach OfflineConversionError.

Alle diese Felder enthalten Informationen vom letzten vollständigen Kalendertag der Importe. Anhand dieser Informationen können Sie den aktuellen Zustand Ihrer Importe beurteilen.

Außerdem enthält jede OfflineConversionUploadClientSummary oder OfflineConversionUploadConversionActionSummary zwei verschiedene Arten von Berichten:

daily_summaries

Eine successful_count, failed_count und pending_count der Importanfragen der letzten 7 Tage, gruppiert nach Import-date.

job_summaries

successful_count, failed_count und pending_count der sieben letzten Importanfragen, gruppiert nach job_id. job_id ist ein optionales Feld von UploadClickConversionsRequest und UploadConversionAdjustmentsRequest. Sie können entweder das Feld job_id auf eine positive 32-Bit-Ganzzahl (1 bis 2^31 - 1) festlegen oder die Google Ads API eine systemgenerierte Job-ID für Ihre Anfrage zuweisen lassen. Unabhängig davon, welche Option Sie wählen, gibt UploadClickConversionsResponse oder UploadConversionAdjustmentsResponse den job_id zurück.

Das Zuweisen einer eigenen job_id ist beispielsweise nützlich, wenn Sie einen einzelnen Job oder Prozess haben, der eine große Anzahl von Conversions über mehrere Anfragen importiert. Wenn Sie für jede dieser Anfragen die job_id auf denselben Wert festlegen, können Sie einen einzelnen Eintrag für den Job aus job_summaries abrufen. Wenn Sie stattdessen zulassen, dass die Google Ads API der job_id jeder Anfrage einen systemgenerierten Wert zuweist, enthält die job_summaries für jede Anfrage einen separaten Eintrag. Das kann die Analyse des Gesamtzustands Ihres Jobs erschweren.

Zusammenfassungen verwenden

Wenn Sie prüfen möchten, ob Ihre Importprozesse Conversions und Erweiterungen ohne API-Fehler aufnehmen, rufen Sie regelmäßig die Zusammenfassungen für jedes Ihrer Konten ab. Wenn das Feld status einer Zusammenfassung nicht EXCELLENT ist, verwenden Sie die Liste der Fehler im Feld alerts, um Ihren Importvorgang so zu ändern, dass diese Fehler reduziert oder beseitigt werden.

Beispiel:

• Wenn der Status NEEDS_ATTENTION lautet, ist ein erheblicher Teil der Importvorgänge fehlgeschlagen. Prüfen Sie die Fehler unter alerts und ändern Sie den Importvorgang, um diese Fehler zu reduzieren oder zu beseitigen.

• Wenn der Status NO_RECENT_UPLOADS lautet, hat Google Ads in letzter Zeit keine Importe für client erhalten. Wenn dies unerwartet ist, prüfen Sie die Prozesse, die Importe mit diesem Client ausführen.

  Wenn beispielsweise der status für GOOGLE_ADS_API NO_RECENT_UPLOADS ist, könnte das darauf hindeuten, dass der Importvorgang, bei dem die Google Ads API verwendet wird, vor Kurzem beendet wurde.

• Um festzustellen, ob es ein bestimmtes Importdatum oder einen bestimmten Job gab, bei dem eine große Anzahl von Ereignissen gesendet wurde, die nicht verarbeitet werden konnten, prüfen Sie successful_count, failed_count und pending_count von daily_summaries und job_summaries. Es kann bis zu 24 Stunden dauern, bis ausstehende Ereignisse abgeschlossen sind.

Weitere Informationen zur Verbesserung der Offlinedaten-Diagnose finden Sie in der Google Ads-Hilfe.

Einschränkungen

Beachten Sie beim Abrufen von Importzusammenfassungen Folgendes:

• Die Google Ads API gibt nur dann Diagnosen für Offlinedaten zurück, wenn die customer_id der searchStream- oder search-Anfrage mit dem Kundenkonto übereinstimmt, das Sie vor Kurzem zum Importieren von Conversions verwendet haben.

  In einem Kundenkonto, in dem kontoübergreifendes Conversion-Tracking verwendet wird, sind beispielsweise möglicherweise keine Diagnosen enthalten. Sie können jedoch Diagnosedaten abrufen, indem Sie eine Anfrage senden, bei der die customer_id mit der customer_id des Verwaltungskontos übereinstimmt, das Sie für Importe verwenden.

• Google Ads behandelt CLICK_NOT_FOUND-Fehler aus Importen von erweiterten Conversions für Leads als Warnungen. Wenn alerts einen Eintrag für diesen Fehler enthält, werden die entsprechenden Vorgänge daher weiterhin als erfolgreich betrachtet und in successful_event_count aufgenommen.