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.

Verwenden Sie eine der folgenden Ressourcen, um die neueste Offlinedatendiagnose für Ihr Konto abzurufen:

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 separate OfflineConversionUploadClientSummary-Zeilen für jeden Clienttyp zurück, der in 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.

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 in 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 können Sie den aktuellen Zustand Ihrer Uploads 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 Uploadanfragen aus den letzten 7 Tagen, gruppiert nach Uploaddate.
job_summaries

successful_count, failed_count und pending_count der sieben letzten Uploadanfragen, gruppiert nach job_id. job_id ist ein optionales Feld von UploadClickConversionsRequest und UploadConversionAdjustmentsRequest. Sie können für job_id entweder eine positive Zahl kleiner als 2^31 festlegen oder Ihrer Anfrage von der Google Ads API eine vom System generierte Job-ID zuweisen lassen. Unabhängig von der ausgewählten Option gibt UploadClickConversionsResponse oder UploadConversionAdjustmentsResponse den job_id zurück.

Eine Situation, in der die Zuweisung einer eigenen job_id sinnvoll ist, ist, wenn ein einzelner Job oder Prozess eine große Anzahl von Conversions mit mehreren Anfragen hochlädt. 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 die Google Ads API der job_id jeder Anfrage einen vom System generierten Wert zuweisen lassen, enthält job_summaries für jede Anfrage einen separaten Eintrag, was die Analyse des Gesamtzustands Ihres Jobs erschweren könnte.

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.

    Beispielsweise darf ein Kundenkonto mit kontoübergreifendem Conversion-Tracking keine Diagnosedaten enthalten. Sie können jedoch Diagnosedaten abrufen, indem Sie eine Anfrage senden, bei der 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.