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:
offline_conversion_upload_client_summary
fasst Upload-Diagnosen zusammen, Kontoebene.offline_conversion_upload_conversion_action_summary
(nur verfügbar in Version 17 oder höher) fasst Uploaddiagnosen auf Ebene der Conversion-Aktion zusammen.
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 nachOfflineConversionError
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
undpending_count
der Uploadanfragen aus den letzten 7 Tagen, gruppiert nachdate
. Upload.job_summaries
Die
successful_count
,failed_count
undpending_count
der 7 häufigsten Letzte Uploadanfragen, gruppiert nachjob_id
.job_id
ist ein optionales Feld. vonUploadClickConversionsRequest
undUploadConversionAdjustmentsRequest
Sie können entwederjob_id
in eine nicht negative Zahl kleiner als2^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 dieUploadClickConversionsResponse
oderUploadConversionAdjustmentsResponse
gibtjob_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 diejob_id
für jede dieser Anfragen auf den haben, können Sie einen einzelnen Eintrag für den Job ausjob_summaries
. Wenn Sie stattdessen die Google Ads API ein vom System generiertes Wert fürjob_id
jeder Anfrage festlegen, enthält diejob_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 unteralerts
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ürclient
. Wenn dies unerwartet ist, überprüfen Sie die Prozesse die Uploads mit diesem Client durchführen.Wenn zum Beispiel
status
fürGOOGLE_ADS_API
den WertNO_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
undpending_count
vondaily_summaries
undjob_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
vonsearchStream
- odersearch
-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 dercustomer_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. Wennalerts
einen Eintrag für diesen Fehler enthält, wird der entsprechende als erfolgreich gelten und in densuccessful_event_count
.