Diagnose der Offlinedaten überwachen

Mit der Google Ads API können Sie Diagnosedaten zu Offlinedaten abrufen. Diese enthalten Informationen zum allgemeinen Zustand Ihrer Prozesse für den Import von Conversions und Anpassungen.

Wenn Sie die neuesten Diagnosedaten 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 Diagnosedaten 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 Daten 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

Wenn Sie Diagnosedaten zum Conversion-Upload auf Ebene der Conversion-Aktion abrufen möchten, verwenden Sie die folgende GAQL-Abfrage:

SELECT
  offline_conversion_upload_conversion_action_summary.conversion_action_id,
  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 = <CONVERSION_ACTION_ID>

Ähnlich wie bei Diagnosen auf Kontoebene werden mit dieser Abfrage separate OfflineConversionUploadConversionActionSummary-Zeilen für jeden Clienttyp zurückgegeben, 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.

Zusammenfassungen interpretieren

Jede OfflineConversionUploadClientSummary oder OfflineConversionUploadConversionActionSummary hat ein Feld status, das den allgemeinen Zustand der Importe für die client widerspiegelt. Sie enthält auch die folgenden Informationen:

  • Die Anzahl der insgesamt empfangenen Ereignisse.
  • Die Anzahl der erfolgreich verarbeiteten Ereignisse.
  • 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 Status 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 die 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 in jeder 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 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 der status einer Zusammenfassung nicht EXCELLENT ist, können Sie anhand der Fehlerliste unter alerts Ihren Importprozess so anpassen, dass diese Fehler reduziert oder behoben 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 status für GOOGLE_ADS_API NO_RECENT_UPLOADS ist, könnte das darauf hindeuten, dass Ihr Importprozess, der die Google Ads API verwendet, vor Kurzem nicht mehr ausgeführt 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 zur Verbesserung der Offlinedaten-Diagnose finden Sie im Hilfe-Center.

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 beispielsweise möglicherweise keine Diagnosen. Sie können jedoch Diagnosedaten abrufen, indem Sie eine Anfrage senden, bei der customer_id mit dem customer_id des Managerkontos übereinstimmt, das Sie bei Importen verwenden.

  • Google Ads behandelt CLICK_NOT_FOUND-Fehler aus Importen von erweiterten Conversions für Leads als Warnungen. Wenn alerts einen Eintrag für diesen Fehler enthält, gelten die entsprechenden Vorgänge weiterhin als erfolgreich und werden in successful_event_count berücksichtigt.

Zurück
Benutzerdefinierte Conversion-Variablen
Weiter
Berichterstellung