Diagnose der Offlinedaten überwachen

Mit der Google Ads API können Sie Offline-Datendiagnose, mit Informationen zur Gesamtleistung Ihres Conversion-Uploads und Anpassungsprozessen.

Um die neuesten Diagnosedaten zu Offlinedaten für Ihr Konto abzurufen, verwenden Sie eine der folgenden Ressourcen:

Diagnose auf Kontoebene

So rufen Sie Diagnosen zum Conversion-Upload auf Kontoebene ab: GAQL-Abfrage:

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 für jeden Clienttyp, der in den letzten Uploads verwendet wurde. Wenn Sie beispielsweise die über die Google Ads API und die Google Ads-Benutzeroberfläche hochgeladen wurden, separate Einträge für die client-Werte von GOOGLE_ADS_API und GOOGLE_ADS_WEB_CLIENT

Diagnose auf Conversion-Aktionsebene

Wenn Sie eine Diagnose beim Conversion-Upload auf Ebene der Conversion-Aktion abrufen möchten, verwenden Sie folgende GAQL-Abfrage:

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 OfflineConversionUploadConversionActionSummary für jeden Clienttyp, der in den letzten Uploads verwendet wurde. Wenn Sie beispielsweise die über die Google Ads API und die Google Ads-Benutzeroberfläche hochgeladen wurden, separate Einträge für die client-Werte von GOOGLE_ADS_API und GOOGLE_ADS_WEB_CLIENT

So interpretieren Sie diese Zusammenfassungen

Alle OfflineConversionUploadClientSummary- oder OfflineConversionUploadConversionActionSummary hat das Feld status, spiegelt die Gesundheit insgesamt von Uploads für den client. 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 enthält, gruppiert nach OfflineConversionError

Alle diese Felder enthalten Informationen vom letzten vollen Kalendertag. von Uploads. Anhand dieser Informationen können Sie den aktuellen Zustand Ihrer Uploads beurteilen.

Außerdem werden alle OfflineConversionUploadClientSummary- oder OfflineConversionUploadConversionActionSummary enthält zwei verschiedene Arten von Berichten:

daily_summaries
successful_count, failed_count und pending_count der Uploadanfragen aus den letzten 7 Tagen, gruppiert nach date. Upload.
job_summaries

Die successful_count, failed_count und pending_count der 7 häufigsten Letzte Uploadanfragen, gruppiert nach job_id. job_id ist ein optionales Feld. von UploadClickConversionsRequest und UploadConversionAdjustmentsRequest Sie können entweder job_id in eine nicht negative Zahl kleiner als 2^31 ein oder lassen Sie die Google Ads API eine die vom System generierte Job-ID in Ihre Anfrage einfügt. Unabhängig davon, welche Option die UploadClickConversionsResponse oder UploadConversionAdjustmentsResponse gibt job_id zurück.

Das Zuweisen einer eigenen job_id ist nützlich, wenn Sie einzelner Job oder Prozess, bei dem eine große Anzahl von Conversions mit mehrere Anfragen gesendet werden. Wenn Sie die job_id für jede dieser Anfragen auf den haben, können Sie einen einzelnen Eintrag für den Job aus job_summaries. Wenn Sie stattdessen die Google Ads API ein vom System generiertes Wert für job_id jeder Anfrage festlegen, enthält die job_summaries einen separaten einen Eintrag erstellen, der eine Analyse des Gesamtzustands und anspruchsvoller zu werden.

Zusammenfassungen verwenden

Um sicherzustellen, dass bei Ihren Upload-Prozessen Conversions und Verbesserungen erfasst werden, die Zusammenfassungen für jedes Ihrer Konten regelmäßig abrufen. Wenn die status einer Zusammenfassung ist nicht EXCELLENT, verwenden Sie die Fehlerliste unter alerts, um den Uploadprozess zu ändern, um beseitigen Sie diese Fehler.

Beispiel:

  • Lautet der Status NEEDS_ATTENTION, dann ist ein erheblicher Teil Ihrer Upload-Vorgänge fehlgeschlagen. Überprüfen Sie die Fehler unter alerts und ändern Sie die um diese Fehler zu reduzieren oder zu beseitigen.

  • Wenn der Status NO_RECENT_UPLOADS lautet, sind an Google Ads keine aktuellen Uploads für client. Wenn dies unerwartet ist, überprüfen Sie die Prozesse die Uploads mit diesem Client durchführen.

    Wenn zum Beispiel status für GOOGLE_ADS_API den Wert NO_RECENT_UPLOADS hat, Möglicherweise läuft der Uploadprozess, bei dem die Google Ads API verwendet wird, nicht mehr vor Kurzem.

  • Um zu ermitteln, ob ein bestimmtes Upload-Datum oder ein Job aufgetreten ist, Anzahl der Ereignisse, die nicht verarbeitet werden konnten, prüfen Sie den successful_count. failed_count und pending_count von daily_summaries und job_summaries. Ereignisse mit dem Status „Ausstehend“ können bis zu 24 Stunden dauern noch zu erledigen.

Einschränkungen

Beachte beim Abrufen von Uploadzusammenfassungen Folgendes:

  • Die Google Ads API gibt nur dann eine Diagnose für Offlinedaten zurück, wenn das customer_id von searchStream- oder search-Anfrage ist derselbe Kunde, den Sie in letzter Zeit verwendet haben Conversions hochladen.

    Beispiel: Ein Kundenkonto, in dem kontoübergreifendes Conversion-Tracking verwendet wird, keine Diagnosen enthalten. Sie können Diagnosedaten abrufen, indem Sie Eine Anfrage, bei der customer_id mit der customer_id des Verwaltungskontos übereinstimmt Konto, das du für Uploads verwendest.

  • Google Ads behandelt CLICK_NOT_FOUND Fehler aus erweiterten Conversions für Uploads als Warnungen. Als ein Ergebnis. Wenn alerts einen Eintrag für diesen Fehler enthält, wird der entsprechende als erfolgreich gelten und in den successful_event_count.