Diagnose der Offlinedaten überwachen

Verwenden Sie die Google Ads API, um Offlinedatendiagnosen abzurufen. Diese enthalten Informationen zum Gesamtzustand des Conversion-Uploads und der Conversion-Anpassung.

Senden Sie die folgende Abfrage für offline_conversion_upload_client_summary-Ressourcen mit dem GoogleAdsService, um die neueste Offlinedatendiagnose für Ihr Konto 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.resource_name,
  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

Die obige Abfrage gibt eine separate OfflineConversionUploadClientSummary für jeden Clienttyp zurück, der in den letzten Uploads verwendet wurde. Wenn Sie beispielsweise vor Kurzem einen Upload über die Google Ads API und die Google Ads-Benutzeroberfläche vorgenommen haben, enthalten die Ergebnisse separate Einträge für die client-Werte GOOGLE_ADS_API und GOOGLE_ADS_WEB_CLIENT.

Jeder OfflineConversionUploadClientSummary hat ein status-Feld, das den Gesamtstatus der Uploads für client widerspiegelt. Außerdem enthält es die Anzahl der insgesamt empfangenen Ereignisse, die Anzahl der erfolgreich verarbeiteten Ereignisse und das Feld alerts mit einer Zusammenfassung der Fehler, gruppiert nach OfflineConversionError. Alle diese Felder enthalten Informationen vom letzten vollen Kalendertag der Uploads. Anhand dieser Informationen können Sie den aktuellen Zustand Ihrer Uploads beurteilen.

Darüber hinaus enthält jede OfflineConversionUploadClientSummary zwei verschiedene Berichtstypen:

daily_summaries

successful_count und failed_count der Uploadanfragen der letzten 7 Tage, gruppiert nach Upload-date.

job_summaries

successful_count und failed_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.

Ein Szenario, in dem das Zuweisen einer eigenen job_id nützlich ist, ist, wenn über einen einzelnen Job oder Prozess eine große Anzahl von Conversions über mehrere Anfragen hochgeladen wird. Wenn Sie für job_id für jede dieser Anfragen denselben Wert festlegen, können Sie einen einzelnen Eintrag für den Job aus 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 Conversions und Verbesserungen bei den Uploadprozessen wie erwartet erfasst werden, sollten Sie regelmäßig die Zusammenfassungen für jedes Ihrer Konten abrufen. Wenn das status einer Zusammenfassung nicht EXCELLENT ist, verwenden Sie die Liste der Fehler unter alerts, um den Uploadprozess zu ändern und diese Fehler zu reduzieren oder zu beseitigen.

Beispiel:

• Lautet der Status NEEDS_ATTENTION, ist ein erheblicher Teil der Uploadvorgänge fehlgeschlagen. Überprüfen Sie die Fehler unter alerts und ändern Sie den Uploadprozess, um diese Fehler zu reduzieren oder zu beheben.

• Wenn der Status NO_RECENT_UPLOADS lautet, sind in Google Ads keine neuen Uploads für client eingegangen. Wenn dies unerwartet ist, überprüfen Sie die Prozesse, die Uploads über diesen Client ausführen.

  Wenn status für GOOGLE_ADS_API beispielsweise NO_RECENT_UPLOADS lautet, kann das darauf hindeuten, dass der Uploadprozess, für den die Google Ads API verwendet wird, kürzlich beendet wurde.

• Prüfen Sie successful_count und failed_count von daily_summaries und job_summaries, um festzustellen, ob ein bestimmtes Uploaddatum oder ein Job eine große Anzahl von Ereignissen gesendet hat, die nicht erfolgreich verarbeitet wurden.

Einschränkungen

Beachte beim Abrufen von Uploadzusammenfassungen Folgendes:

• Die Google Ads API gibt nur dann Offlinedatendiagnosen zurück, wenn customer_id der searchStream- oder search-Anfrage derselbe Kunde ist, den Sie vor Kurzem zum Hochladen von Conversions verwendet 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 aus Uploads von erweiterten Conversions für Leads als Warnungen behandelt. Wenn alerts also einen Eintrag für diesen Fehler enthält, werden die entsprechenden Vorgänge dennoch als erfolgreich betrachtet und in die Datei successful_event_count aufgenommen.