Diagnose der Offlinedaten überwachen

Mit der Google Ads API können Sie Diagnosedaten für Offlinedaten abrufen. Diese enthalten Informationen zur allgemeinen Funktionsfähigkeit des Conversion-Uploads und der Anpassungsprozesse.

Die neuesten Offlinedatendiagnosen für Ihr Konto können Sie über eine der folgenden Ressourcen abrufen:

Diagnose auf Kontoebene

Verwenden Sie die folgende GAQL-Abfrage, um Diagnosedaten 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 für jeden Clienttyp, der in den letzten Uploads verwendet wurde, separate OfflineConversionUploadClientSummary-Zeilen zurück. Wenn Sie beispielsweise vor Kurzem sowohl über die Google Ads API als auch über die Google Ads-Benutzeroberfläche Daten hochgeladen 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 für den Conversion-Upload auf Ebene der Conversion-Aktion abzurufen:

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 >

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

So interpretieren Sie diese Zusammenfassungen

Jede OfflineConversionUploadClientSummary oder OfflineConversionUploadConversionActionSummary hat ein status-Feld, das den allgemeinen Zustand der Uploads für die client widerspiegelt. Außerdem enthält er 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 nach OfflineConversionError enthält.

Alle diese Felder enthalten Informationen vom letzten vollständigen Kalendertag der Uploads. Anhand dieser Informationen kannst du den aktuellen Status deiner Uploads beurteilen.

Außerdem enthält jede OfflineConversionUploadClientSummary oder OfflineConversionUploadConversionActionSummary zwei verschiedene Berichtstypen:

daily_summaries
Eine successful_count, failed_count und pending_count von Uploadanfragen aus den letzten 7 Tagen, gruppiert nach Uploaddate.
job_summaries

Die successful_count, failed_count und pending_count der 7 letzten Uploadanfragen, gruppiert nach job_id. job_id ist ein optionales Feld von UploadClickConversionsRequest und UploadConversionAdjustmentsRequest. Sie können job_id entweder auf eine positive Zahl festlegen, die kleiner als 2^31 ist, oder die Google Ads API kann Ihrer Anfrage eine systemgenerierte Job-ID zuweisen. Unabhängig davon, welche Option Sie auswählen, wird mit UploadClickConversionsResponse oder UploadConversionAdjustmentsResponse die job_id zurückgegeben.

Eine Situation, in der die Zuweisung einer eigenen job_id sinnvoll ist, ist ein einzelner Job oder Prozess, bei dem eine große Anzahl von Conversions mit mehreren Anfragen hochgeladen wird. Wenn Sie job_id bei jeder dieser Anfragen auf denselben Wert festlegen, können Sie einen einzelnen Eintrag für den Job von job_summaries abrufen. Wenn Sie stattdessen der job_id jeder Anfrage einen systemgenerierten Wert zuweisen lassen, enthält die job_summaries einen separaten Eintrag für jede Anfrage. Das kann die Analyse des Gesamtzustands Ihrer Aufgabe erschweren.

Zusammenfassungen verwenden

Damit bei Ihren Uploadprozessen Conversions und Verbesserungen wie erwartet erfasst werden, sollten Sie regelmäßig die Zusammenfassungen für jedes Ihrer Konten abrufen. Wenn die status einer Zusammenfassung nicht EXCELLENT ist, können Sie anhand der Fehlerliste unter alerts Ihren Uploadprozess ändern, um diese Fehler zu reduzieren oder zu beseitigen.

Beispiel:

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

  • Wenn der Status NO_RECENT_UPLOADS lautet, wurden in Google Ads in letzter Zeit keine Uploads für die client empfangen. Wenn das unerwartet ist, prüfen Sie die Prozesse, die Uploads mit diesem Client ausführen.

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

  • Wenn Sie wissen möchten, ob es ein bestimmtes Uploaddatum oder einen bestimmten Job gab, bei dem eine große Anzahl von Ereignissen gesendet wurde, die nicht verarbeitet werden konnten, sehen Sie sich die Werte successful_count, failed_count und pending_count von daily_summaries und job_summaries an. Bei Ereignissen im Status „Ausstehend“ kann es bis zu 24 Stunden dauern, bis sie abgeschlossen sind.

Einschränkungen

Beachten Sie beim Abrufen von Uploadzusammenfassungen Folgendes:

  • Die Google Ads API gibt nur dann Diagnosen für Offlinedaten zurück, wenn die customer_id der searchStream- oder search-Anfrage dem Kunden entspricht, für den Sie vor Kurzem Conversions hochgeladen haben.

    Ein Kundenkonto, in dem das kontoübergreifende Conversion-Tracking verwendet wird, enthält beispielsweise möglicherweise keine Diagnosen. 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 Uploads verwenden.

  • In Google Ads werden CLICK_NOT_FOUND Fehler beim Hochladen von erweiterten Conversions für Leads als Warnungen behandelt. Wenn alerts also einen Eintrag für diesen Fehler enthält, gelten die entsprechenden Vorgänge weiterhin als erfolgreich und sind in successful_event_count enthalten.

Zurück
Regeln für Conversion-Wert
Weiter
Berichterstellung