Diagnose der Offlinedaten überwachen

Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Mit der Google Ads API können Sie Offlinedatendiagnosen abrufen, die Informationen zum allgemeinen Zustand des Conversion-Imports und der ‑Anpassungsprozesse enthalten.

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

• offline_conversion_upload_client_summary Importdiagnosen werden auf Kontoebene zusammengefasst.
• offline_conversion_upload_conversion_action_summary fasst Importdiagnosen auf Ebene der Conversion-Aktion zusammen.

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

Mit dieser Abfrage werden für jeden Clienttyp, der in den letzten Importen verwendet wurde, separate OfflineConversionUploadClientSummary-Zeilen zurückgegeben. Wenn Sie beispielsweise vor Kurzem sowohl über die Google Ads API als auch über die Google Ads-Benutzeroberfläche importiert 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 Importen verwendet wurde. Wenn Sie beispielsweise vor Kurzem sowohl über die Google Ads API als auch über die Google Ads-Benutzeroberfläche importiert 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 Importe 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 Importe. Anhand dieser Informationen können Sie den aktuellen Zustand Ihrer Importe beurteilen.

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

daily_summaries

Anzahl der successful_count, failed_count und pending_count Importanfragen aus den letzten 7 Tagen, gruppiert nach Importdate.

job_summaries

Die 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 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 von der gewählten Option 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 importiert wird. Wenn Sie job_id bei jeder dieser Anfragen auf denselben Wert festlegen, können Sie einen einzelnen Eintrag für den Job aus 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 Importprozessen 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 Importprozess so anpassen, 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 beseitigen.

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

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

• Wenn Sie wissen 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 die Werte successful_count, failed_count und pending_count von daily_summaries und job_summaries. Bei Ereignissen im Status „Ausstehend“ kann es bis zu 24 Stunden dauern, bis sie abgeschlossen sind.

Weitere Informationen zur Verbesserung der Diagnose von Offlinedaten 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 der Kundennummer des Kontos übereinstimmt, mit dem Sie vor Kurzem Conversions importiert haben.

  Ein Kundenkonto, in dem das kontoübergreifende Conversion-Tracking verwendet wird, enthält beispielsweise möglicherweise keine Diagnosen. Sie können jedoch Diagnosen abrufen, indem Sie eine Anfrage senden, bei der die customer_id mit der customer_id des Verwaltungskontos übereinstimmt, das Sie bei Importen verwenden.

• In Google Ads werden CLICK_NOT_FOUND Fehler beim Import 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.