Verwenden Sie die Google Ads API, um Offlinedatendiagnosen abzurufen. Diese enthalten Informationen zum Gesamtzustand des Conversion-Uploads und der Conversion-Anpassung.
Senden Sie die folgende Abfrage für offline_conversion_upload_client_summary
-Ressourcen mit dem GoogleAdsService
, um die neueste Offlinedatendiagnose für Ihr Konto 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.resource_name,
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
Die obige Abfrage gibt eine separate OfflineConversionUploadClientSummary
für jeden Clienttyp zurück, der in den letzten Uploads verwendet wurde. Wenn Sie beispielsweise vor Kurzem einen Upload über die Google Ads API und die Google Ads-Benutzeroberfläche vorgenommen haben, enthalten die Ergebnisse separate Einträge für die client
-Werte GOOGLE_ADS_API
und GOOGLE_ADS_WEB_CLIENT
.
Jeder OfflineConversionUploadClientSummary
hat ein status
-Feld, das den Gesamtstatus der Uploads für client
widerspiegelt. Außerdem enthält es die Anzahl der insgesamt empfangenen Ereignisse, die Anzahl der erfolgreich verarbeiteten Ereignisse und das Feld alerts
mit einer Zusammenfassung der Fehler, gruppiert nach OfflineConversionError
.
Alle diese Felder enthalten Informationen vom letzten vollen Kalendertag der Uploads. Anhand dieser Informationen können Sie den aktuellen Zustand Ihrer Uploads beurteilen.
Darüber hinaus enthält jede OfflineConversionUploadClientSummary
zwei verschiedene Berichtstypen:
daily_summaries
successful_count
undfailed_count
der Uploadanfragen der letzten 7 Tage, gruppiert nach Upload-date
.job_summaries
successful_count
undfailed_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.Ein Szenario, in dem das Zuweisen einer eigenen
job_id
nützlich ist, ist, wenn über einen einzelnen Job oder Prozess eine große Anzahl von Conversions über mehrere Anfragen hochgeladen wird. Wenn Sie fürjob_id
für jede dieser Anfragen denselben Wert festlegen, können Sie einen einzelnen Eintrag für den Job ausjob_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 Conversions und Verbesserungen bei den Uploadprozessen wie erwartet erfasst werden, sollten Sie regelmäßig die Zusammenfassungen für jedes Ihrer Konten abrufen. Wenn das status
einer Zusammenfassung nicht EXCELLENT
ist, verwenden Sie die Liste der Fehler unter alerts
, um den Uploadprozess zu ändern und diese Fehler zu reduzieren oder zu beseitigen.
Beispiel:
Lautet der Status
NEEDS_ATTENTION
, ist ein erheblicher Teil der Uploadvorgänge fehlgeschlagen. Überprüfen Sie die Fehler unteralerts
und ändern Sie den Uploadprozess, um diese Fehler zu reduzieren oder zu beheben.Wenn der Status
NO_RECENT_UPLOADS
lautet, sind in Google Ads keine neuen Uploads fürclient
eingegangen. Wenn dies unerwartet ist, überprüfen Sie die Prozesse, die Uploads über diesen Client ausführen.Wenn
status
fürGOOGLE_ADS_API
beispielsweiseNO_RECENT_UPLOADS
lautet, kann das darauf hindeuten, dass der Uploadprozess, für den die Google Ads API verwendet wird, kürzlich beendet wurde.Prüfen Sie
successful_count
undfailed_count
vondaily_summaries
undjob_summaries
, um festzustellen, ob ein bestimmtes Uploaddatum oder ein Job eine große Anzahl von Ereignissen gesendet hat, die nicht erfolgreich verarbeitet wurden.
Einschränkungen
Beachte beim Abrufen von Uploadzusammenfassungen Folgendes:
Die Google Ads API gibt nur dann Offlinedatendiagnosen zurück, wenn
customer_id
dersearchStream
- odersearch
-Anfrage derselbe Kunde ist, den Sie vor Kurzem zum Hochladen von Conversions verwendet 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 aus Uploads von erweiterten Conversions für Leads als Warnungen behandelt. Wennalerts
also einen Eintrag für diesen Fehler enthält, werden die entsprechenden Vorgänge dennoch als erfolgreich betrachtet und in die Dateisuccessful_event_count
aufgenommen.