Diagnose der Offlinedaten überwachen

Mit der Google Ads API können Sie Offlinedaten-Diagnosedaten abrufen, die Informationen zum Gesamtstatus der Prozesse für den Conversion-Upload und die Anpassung enthalten.

Wenn Sie die aktuellen Offlinedatendiagnosen für Ihr Konto abrufen möchten, senden Sie die folgende Abfrage für offline_conversion_upload_client_summary-Ressourcen mithilfe des GoogleAdsService:

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 ein separates OfflineConversionUploadClientSummary für jeden in den letzten Uploads verwendeten Clienttyp zurück. Wenn Sie beispielsweise kürzlich Inhalte sowohl mit der Google Ads API als auch mit der Google Ads-Benutzeroberfläche hochgeladen haben, enthalten die Ergebnisse separate Einträge für die client-Werte von GOOGLE_ADS_API und GOOGLE_ADS_WEB_CLIENT.

Jede OfflineConversionUploadClientSummary hat ein status-Feld, das den Gesamtzustand der Uploads für den client angibt. Es enthält auch die Gesamtzahl der empfangenen Ereignisse und die Anzahl der erfolgreich verarbeiteten Ereignisse sowie 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 kannst du den aktuellen Status deiner Uploads beurteilen.

Außerdem enthält jedes OfflineConversionUploadClientSummary zwei verschiedene Arten von Berichten:

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 job_id entweder auf eine nicht negative Zahl kleiner als 2^31 festlegen oder Ihrer Anfrage über die 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 sinnvoll ist, ist, wenn Sie einen einzelnen Job oder Prozess haben, bei dem eine große Anzahl von Conversions mithilfe mehrerer Anfragen hochgeladen wird. Wenn Sie für job_id bei jeder 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 dem job_id jeder Anfrage einen vom System generierten Wert zuweisen lassen, enthält die job_summaries für jede Anfrage einen separaten Eintrag, was die Analyse des Gesamtstatus Ihres Jobs erschweren könnte.

Zusammenfassungen verwenden

Damit bei Ihren Uploadprozessen Conversions und Verbesserungen wie erwartet erfasst werden, rufen Sie regelmäßig die Zusammenfassungen für jedes Ihrer Konten ab. Wenn der status einer Zusammenfassung nicht EXCELLENT ist, verwenden Sie die Liste der Fehler unter alerts als Anleitung zum Ändern des Uploadprozesses, um diese Fehler zu reduzieren oder zu beseitigen.

Beispiel:

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

• Wenn der Status NO_RECENT_UPLOADS ist, hat Google Ads in letzter Zeit keine Uploads für die client erhalten. Sollte dies unerwartet sein, prüfen Sie die Prozesse, die Uploads mit diesem Client durchführen.

  Wenn beispielsweise status für GOOGLE_ADS_API den Wert NO_RECENT_UPLOADS hat, kann das darauf hindeuten, dass der Uploadvorgang, der die Google Ads API verwendet, vor Kurzem nicht mehr ausgeführt wurde.

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

Einschränkungen

Beachten Sie beim Abrufen von Upload-Zusammenfassungen Folgendes:

• Die Google Ads API gibt nur dann Offlinedatendiagnosen zurück, wenn der customer_id der searchStream- oder search-Anfrage derselbe Kunde ist, den Sie kürzlich zum Hochladen von Conversions verwendet haben.

  Ein Kundenkonto, für das kontoübergreifendes Conversion-Tracking verwendet wird, darf beispielsweise keine Diagnosedaten enthalten. Sie können Diagnosen jedoch auch abrufen, indem Sie eine Anfrage senden, bei der customer_id mit dem 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 Warnung behandelt. Wenn alerts einen Eintrag für diesen Fehler enthält, gelten die entsprechenden Vorgänge daher als erfolgreich und werden in die successful_event_count aufgenommen.