Diagnose der Offlinedaten überwachen

Verwenden Sie die Google Ads API, um Diagnosedaten zu Offlinedaten abzurufen. Diese enthalten Informationen zum allgemeinen Zustand Ihrer Prozesse für den Import von Conversions und Anpassungen.

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

Diagnose auf Kontoebene

Verwenden Sie die folgende GAQL-Abfrage, um Diagnosen zum Hochladen von Conversions 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 bei den letzten Importen verwendet wurde. Wenn Sie beispielsweise kürzlich 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 von GOOGLE_ADS_API und GOOGLE_ADS_WEB_CLIENT.

Diagnose auf Conversion-Aktion-Ebene

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_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 wird mit dieser Abfrage für jeden in den letzten Importen verwendeten Clienttyp eine separate OfflineConversionUploadConversionActionSummary-Zeile zurückgegeben. Wenn Sie beispielsweise kürzlich 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 von GOOGLE_ADS_API und GOOGLE_ADS_WEB_CLIENT.

Zusammenfassungen interpretieren

Jeder OfflineConversionUploadClientSummary- oder OfflineConversionUploadConversionActionSummary-Eintrag hat ein status-Feld, das den allgemeinen Zustand der Importe für die client widerspiegelt. Außerdem enthält sie die folgenden Informationen:

  • Die Anzahl der insgesamt 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 aus dem 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 von Importanfragen aus den letzten 7 Tagen, gruppiert nach Import date.
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 entweder job_id auf eine nicht negative Zahl festlegen, die kleiner als 2^31 ist, oder der Google Ads API eine vom System generierte Job-ID für Ihre Anfrage zuweisen lassen. Unabhängig davon, welche Option Sie auswählen, gibt UploadClickConversionsResponse oder UploadConversionAdjustmentsResponse den Wert job_id zurück.

Ein Szenario, in dem die Zuweisung einer eigenen job_id nützlich ist, ist, wenn Sie einen einzelnen Job oder Prozess haben, mit dem eine große Anzahl von Conversions über mehrere Anfragen importiert wird. Wenn Sie job_id für jede dieser Anfragen auf denselben Wert 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 einen separaten Eintrag für jede Anfrage. Das kann die Analyse des Gesamtzustands Ihres Jobs erschweren.

Zusammenfassungen verwenden

Damit bei Ihren Importvorgängen 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 vermieden werden.

Beispiel:

  • Wenn der Status NEEDS_ATTENTION lautet, ist ein erheblicher Teil Ihrer Importvorgänge fehlgeschlagen. Sehen Sie sich die Fehler unter alerts an und passen Sie den Importvorgang an, um diese Fehler zu reduzieren oder zu vermeiden.

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

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

  • Wenn Sie herausfinden 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 Ereignisse mit dem Status „Ausstehend“ abgeschlossen sind.

Weitere Informationen dazu, wie Sie die Diagnosedaten für Offline-Daten verbessern können, finden Sie in der Google Ads-Hilfe.

Einschränkungen

Beachten Sie beim Abrufen von Importzusammenfassungen Folgendes:

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

    Ein Kundenkonto, in dem kontoübergreifendes Conversion-Tracking verwendet wird, enthält möglicherweise keine Diagnosen. Sie können jedoch Diagnosedaten abrufen, indem Sie eine Anfrage senden, in der customer_id mit dem customer_id des Managerkontos übereinstimmt, das Sie für Importe verwenden.

  • CLICK_NOT_FOUND-Fehler beim Import von erweiterten Conversions für Leads werden in Google Ads als Warnungen behandelt. Wenn alerts 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
Benutzerdefinierte Conversion-Variablen
Weiter
Berichterstellung