Diagnose der Offlinedaten überwachen

Mit der Google Ads API können Sie Diagnosen zu Offlinedaten, die Informationen zum allgemeinen Status Ihrer Conversion-Import- und ‑Anpassungsprozesse enthalten, abrufen.

Verwenden Sie eine der folgenden Ressourcen, um die neuesten Diagnosen zu Offlinedaten für Ihr Konto abzurufen:

• offline_conversion_upload_client_summary fasst die Importdiagnosen auf Kontoebene zusammen.
• offline_conversion_upload_conversion_action_summary fasst die Importdiagnosen auf Conversion-Aktionsebene zusammen.

Diagnosen auf Kontoebene

Verwenden Sie die folgende GAQL-Abfrage, um Diagnosen zum 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 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 GOOGLE_ADS_API und GOOGLE_ADS_WEB_CLIENT.

Diagnosen auf Conversion-Aktionsebene

Verwenden Sie die folgende GAQL-Abfrage, um Diagnosen zum Conversion-Upload auf Conversion-Aktionsebene 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 Diagnosen auf Kontoebene gibt diese Abfrage separate OfflineConversionUploadConversionActionSummary 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 GOOGLE_ADS_API und GOOGLE_ADS_WEB_CLIENT.

Zusammenfassungen interpretieren

Jede OfflineConversionUploadClientSummary oder OfflineConversionUploadConversionActionSummary hat ein status-Feld, das den allgemeinen Status der Importe für den 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 mit einer Zusammenfassung der Fehler, gruppiert nach OfflineConversionError.

Alle diese Felder enthalten Informationen vom 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

Ein successful_count, failed_count und pending_count der Importanfragen der letzten 7 Tage, gruppiert nach Importdatum (date).

job_summaries

successful_count, failed_count und pending_count der 7 letzten Importanfragen, gruppiert nach job_id. Das job_id ist ein optionales Feld von UploadClickConversionsRequest und UploadConversionAdjustmentsRequest. Sie können job_id entweder auf eine nicht negative Zahl unter 2^31 festlegen oder der Google Ads API eine vom System generierte Job-ID für Ihre Anfrage zuweisen lassen. Unabhängig davon, welche Option Sie wählen, wird die job_id von UploadClickConversionsResponse oder UploadConversionAdjustmentsResponse zurückgegeben.

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 mit mehreren Anfragen importiert wird. Wenn Sie für jede dieser Anfragen dieselbe job_id festlegen, können Sie in job_summaries einen einzelnen Eintrag für den Job abrufen. Wenn Sie stattdessen der Google Ads API erlauben, jeder Anfrage eine vom System generierte job_id zuzuweisen, enthält job_summaries einen separaten Eintrag für jede Anfrage. Das kann die Analyse des allgemeinen Status Ihres Jobs erschweren.

Zusammenfassungen verwenden

Damit 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 Liste der Fehler unter alerts Ihren Importprozess so ändern, dass diese Fehler reduziert oder beseitigt werden.

Beispiel:

• Wenn der Status NEEDS_ATTENTION ist, ist ein erheblicher Teil Ihrer Importvorgänge fehlgeschlagen. Prüfen Sie die Fehler unter alerts und ändern Sie Ihren Importprozess, um diese Fehler zu reduzieren oder zu beseitigen.

• Wenn der Status NO_RECENT_UPLOADS ist, hat Google Ads keine aktuellen Importe für den client erhalten. Wenn das nicht erwartet wurde, prüfen Sie die Prozesse, mit denen Importe mit diesem Client ausgeführt werden.

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

• Um festzustellen, 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 im Status „Ausstehend“ abgeschlossen sind.

Weitere Informationen zur Verbesserung der Diagnosen zu Offlinedaten finden Sie in der Google Ads-Hilfe.

Einschränkungen

Beachten Sie beim Abrufen von Importzusammenfassungen Folgendes:

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

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

• Google Ads behandelt CLICK_NOT_FOUND-Fehler aus Importen erweiterter 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.