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.

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

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 die Diagnose für den 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 von GOOGLE_ADS_API und GOOGLE_ADS_WEB_CLIENT.

Zusammenfassungen interpretieren

Jede OfflineConversionUploadClientSummary oder OfflineConversionUploadConversionActionSummary hat ein status-Feld, das den Gesamtzustand der Importe für die client widerspiegelt. Sie enthalten 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 job_id auf eine nicht negative Zahl kleiner als 2^31 festlegen oder die Google Ads API eine vom System generierte 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 sinnvoll, 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 denselben Wert für job_id festlegen, können Sie einen einzelnen Eintrag für den Job aus job_summaries abrufen. Wenn Sie stattdessen die Google Ads API einen systemgenerierten Wert für die job_id jeder Anfrage zuweisen lassen, enthält die job_summaries für jede Anfrage einen separaten Eintrag. Das kann die Analyse des Gesamtzustands Ihres Jobs erschweren.

Zusammenfassungen verwenden

Damit Conversions und Optimierungen wie erwartet erfasst werden, sollten Sie regelmäßig die Zusammenfassungen für jedes Ihrer Konten abrufen. Wenn der status einer Zusammenfassung nicht EXCELLENT ist, verwenden Sie die Liste der Fehler unter alerts, um Ihren Importprozess so zu ändern, dass diese Fehler reduziert oder beseitigt werden.

Beispiel:

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

  • 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.

  • Wenn Sie feststellen möchten, 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 alle ausstehenden Ereignisse abgeschlossen sind.

Weitere Informationen zur Verbesserung der Offlinedatendiagnose 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.

Zurück
Benutzerdefinierte Conversion-Variablen
Weiter
Berichterstellung