Mit der Google Ads API können Sie Diagnosedaten für Offlinedaten abrufen. Diese enthalten Informationen zur allgemeinen Funktionsfähigkeit des Conversion-Uploads und der Anpassungsprozesse.
Verwenden Sie eine der folgenden Ressourcen, um die neueste Offlinedatendiagnose für Ihr Konto abzurufen:
offline_conversion_upload_client_summary
fasst Uploaddiagnosen auf Kontoebene zusammen.offline_conversion_upload_conversion_action_summary
(nur in Version 17 oder höher verfügbar) aggregiert Uploaddiagnosen auf Conversion-Aktionsebene.
Diagnose auf Kontoebene
Verwenden Sie die folgende GAQL-Abfrage, um Diagnosedaten für den 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 in den letzten Uploads verwendet wurde. Wenn Sie beispielsweise vor Kurzem sowohl über die Google Ads API als auch über die Google Ads-Benutzeroberfläche Daten hochgeladen haben, enthalten die Ergebnisse separate Einträge für die client
-Werte GOOGLE_ADS_API
und GOOGLE_ADS_WEB_CLIENT
.
Diagnose auf Ebene der Conversion-Aktion
Verwenden Sie die folgende GAQL-Abfrage, um Diagnosedaten für den Conversion-Upload auf Ebene der Conversion-Aktion 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 der Diagnose auf Kontoebene gibt diese Abfrage separate OfflineConversionUploadConversionActionSummary
-Zeilen für jeden Clienttyp zurück, der in den letzten Uploads verwendet wurde. Wenn Sie beispielsweise vor Kurzem sowohl über die Google Ads API als auch über die Google Ads-Benutzeroberfläche Daten hochgeladen haben, enthalten die Ergebnisse separate Einträge für die client
-Werte GOOGLE_ADS_API
und GOOGLE_ADS_WEB_CLIENT
.
So interpretieren Sie diese Zusammenfassungen
Jede OfflineConversionUploadClientSummary
oder OfflineConversionUploadConversionActionSummary
hat ein status
-Feld, das den allgemeinen Zustand der Uploads für die client
widerspiegelt. 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 nachOfflineConversionError
enthält.
Alle diese Felder enthalten Informationen vom letzten vollständigen Kalendertag der Uploads. Anhand dieser Informationen können Sie den aktuellen Zustand Ihrer Uploads beurteilen.
Außerdem enthält jede OfflineConversionUploadClientSummary
oder OfflineConversionUploadConversionActionSummary
zwei verschiedene Arten von Berichten:
daily_summaries
- Eine
successful_count
,failed_count
undpending_count
von Uploadanfragen aus den letzten 7 Tagen, gruppiert nach Uploaddate
. job_summaries
successful_count
,failed_count
undpending_count
der sieben letzten Uploadanfragen, gruppiert nachjob_id
.job_id
ist ein optionales Feld vonUploadClickConversionsRequest
undUploadConversionAdjustmentsRequest
. Sie können fürjob_id
entweder eine positive Zahl kleiner als2^31
festlegen oder Ihrer Anfrage von der Google Ads API eine vom System generierte Job-ID zuweisen lassen. Unabhängig von der ausgewählten Option gibtUploadClickConversionsResponse
oderUploadConversionAdjustmentsResponse
denjob_id
zurück.Eine Situation, in der die Zuweisung einer eigenen
job_id
sinnvoll ist, ist, wenn ein einzelner Job oder Prozess eine große Anzahl von Conversions mit mehreren Anfragen hochlädt. Wenn Siejob_id
bei jeder dieser Anfragen auf denselben Wert festlegen, können Sie einen einzelnen Eintrag für den Job vonjob_summaries
abrufen. Wenn Sie stattdessen die Google Ads API derjob_id
jeder Anfrage einen vom System generierten Wert zuweisen lassen, enthältjob_summaries
für jede Anfrage einen separaten Eintrag, was die Analyse des Gesamtzustands Ihres Jobs erschweren könnte.
Zusammenfassungen verwenden
Damit bei Ihren Uploadprozessen Conversions und Verbesserungen wie erwartet erfasst werden, sollten Sie regelmäßig die Zusammenfassungen für jedes Ihrer Konten abrufen. Wenn die status
einer Zusammenfassung nicht EXCELLENT
ist, können Sie anhand der Fehlerliste unter alerts
Ihren Uploadprozess ändern, um diese Fehler zu reduzieren oder zu beseitigen.
Beispiel:
Wenn der Status
NEEDS_ATTENTION
lautet, ist ein erheblicher Teil Ihrer Uploadvorgänge fehlgeschlagen. Prüfen Sie die Fehler unteralerts
und ändern Sie den Uploadvorgang, um diese Fehler zu reduzieren oder zu beseitigen.Wenn der Status
NO_RECENT_UPLOADS
lautet, wurden in Google Ads in letzter Zeit keine Uploads für dieclient
empfangen. Wenn das unerwartet ist, prüfen Sie die Prozesse, die Uploads mit diesem Client ausführen.Wenn der Wert für
status
fürGOOGLE_ADS_API
beispielsweiseNO_RECENT_UPLOADS
ist, könnte das darauf hindeuten, dass der Uploadprozess, der die Google Ads API verwendet, vor Kurzem beendet wurde.Wenn Sie wissen möchten, ob es ein bestimmtes Uploaddatum oder einen bestimmten Job gab, bei dem eine große Anzahl von Ereignissen gesendet wurde, die nicht verarbeitet werden konnten, sehen Sie sich die Werte
successful_count
,failed_count
undpending_count
vondaily_summaries
undjob_summaries
an. Bei Ereignissen im Status „Ausstehend“ kann es bis zu 24 Stunden dauern, bis sie abgeschlossen sind.
Einschränkungen
Beachten Sie beim Abrufen von Uploadzusammenfassungen Folgendes:
Die Google Ads API gibt nur dann Diagnosen für Offlinedaten zurück, wenn die
customer_id
dersearchStream
- odersearch
-Anfrage dem Kunden entspricht, für den Sie vor Kurzem Conversions hochgeladen haben.Beispielsweise darf ein Kundenkonto mit kontoübergreifendem Conversion-Tracking keine Diagnosedaten enthalten. Sie können jedoch Diagnosedaten abrufen, indem Sie eine Anfrage senden, bei der
customer_id
mit dercustomer_id
des Verwaltungskontos übereinstimmt, das Sie für Uploads verwenden.In Google Ads werden
CLICK_NOT_FOUND
Fehler beim Hochladen von erweiterten Conversions für Leads als Warnungen behandelt. Wennalerts
also einen Eintrag für diesen Fehler enthält, gelten die entsprechenden Vorgänge weiterhin als erfolgreich und sind insuccessful_event_count
enthalten.