Wenn Sie sich mit anderen Nutzern über unsere Produkte austauschen und Feedback geben möchten, können Sie dem offiziellen Google Ads-Discord-Kanal auf dem Server der
Google Advertising and Measurement Community beitreten.
Diagnose der Offlinedaten überwachen
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Verwenden Sie die Google Ads API, um Diagnosedaten zu Offlinedaten abzurufen. Diese enthalten Informationen zum allgemeinen Zustand Ihrer Prozesse für den Import von Conversions und Anpassungen.
Wenn Sie die neuesten Diagnosen für Offlinedaten für Ihr Konto abrufen möchten, verwenden Sie eine der folgenden Ressourcen:
Diagnose auf Kontoebene
Verwenden Sie die folgende GAQL-Abfrage, um Diagnosen zum Hochladen von Conversions 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 von GOOGLE_ADS_API und GOOGLE_ADS_WEB_CLIENT.
Diagnose auf Conversion-Aktion-Ebene
Verwenden Sie die folgende GAQL-Abfrage, um Diagnosedaten zum 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 wird mit dieser Abfrage für jeden in den letzten Importen verwendeten Clienttyp eine separate OfflineConversionUploadConversionActionSummary-Zeile zurückgegeben. 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 von GOOGLE_ADS_API und GOOGLE_ADS_WEB_CLIENT.
Zusammenfassungen interpretieren
Jeder OfflineConversionUploadClientSummary- oder OfflineConversionUploadConversionActionSummary-Eintrag hat ein status-Feld, das den allgemeinen Zustand der Importe für die 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, das eine Zusammenfassung der Fehler enthält, gruppiert nach OfflineConversionError.
Alle diese Felder enthalten Informationen aus dem letzten vollständigen Kalendertag der Importe. Anhand dieser Informationen können Sie den aktuellen Zustand Ihrer Importe beurteilen.
Außerdem enthält jede OfflineConversionUploadClientSummary oder OfflineConversionUploadConversionActionSummary zwei verschiedene Arten von Berichten:
daily_summaries- Eine
successful_count, failed_count und pending_count von Importanfragen aus den letzten 7 Tagen, gruppiert nach Import-date.
job_summariesDie successful_count, failed_count und pending_count der sieben letzten Importanfragen, gruppiert nach job_id. job_id ist ein optionales Feld von UploadClickConversionsRequest und UploadConversionAdjustmentsRequest. Sie können entweder job_id auf eine nicht negative Zahl festlegen, die kleiner als 2^31 ist, oder der Google Ads API eine vom System generierte Job-ID für Ihre Anfrage zuweisen lassen. Unabhängig davon, welche Option Sie auswählen, gibt UploadClickConversionsResponse oder UploadConversionAdjustmentsResponse job_id zurück.
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 über mehrere Anfragen importiert wird. Wenn Sie job_id für jede dieser Anfragen auf denselben Wert festlegen, können Sie einen einzelnen Eintrag für den Job aus job_summaries abrufen. Wenn Sie stattdessen die Google Ads API einen systemgenerierten Wert für die job_id jeder Anfrage zuweisen lassen, enthält die job_summaries einen separaten Eintrag für jede Anfrage. Das kann die Analyse des Gesamtzustands Ihres Jobs erschweren.
Zusammenfassungen verwenden
Damit bei Ihren Importvorgängen 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 Importprozess so anpassen, dass diese Fehler reduziert oder vermieden werden.
Beispiel:
Wenn der Status NEEDS_ATTENTION lautet, ist ein erheblicher Teil Ihrer Importvorgänge fehlgeschlagen. Sehen Sie sich die Fehler unter alerts an und passen Sie den Importvorgang an, um diese Fehler zu reduzieren oder zu vermeiden.
Wenn der Status NO_RECENT_UPLOADS lautet, wurden in Google Ads keine aktuellen Importe für client empfangen. Wenn das unerwartet ist, sehen Sie sich die Prozesse an, die Importe mit diesem Client ausführen.
Wenn beispielsweise status für GOOGLE_ADS_API NO_RECENT_UPLOADS ist, kann das darauf hindeuten, dass der Importprozess, bei dem die Google Ads API verwendet wird, vor Kurzem beendet wurde.
Wenn Sie herausfinden möchten, 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 mit dem Status „Ausstehend“ abgeschlossen sind.
Weitere Informationen dazu, wie Sie die Diagnosen für Offlinedaten verbessern können, finden Sie in der Hilfe.
Einschränkungen
Beachten Sie beim Abrufen von Importzusammenfassungen Folgendes:
Die Google Ads API gibt nur Diagnosen für Offlinedaten zurück, wenn die customer_id der searchStream- oder search-Anfrage derselbe Kunde ist, den Sie vor Kurzem zum Importieren von Conversions verwendet haben.
Ein Kundenkonto, in dem kontoübergreifendes Conversion-Tracking verwendet wird, enthält möglicherweise keine Diagnosen. Sie können jedoch Diagnosedaten abrufen, indem Sie eine Anfrage senden, in der customer_id mit dem customer_id des Managerkontos übereinstimmt, das Sie für Importe verwenden.
CLICK_NOT_FOUND-Fehler beim Import von erweiterten Conversions für Leads werden in Google Ads als Warnungen behandelt. Wenn alerts einen Eintrag für diesen Fehler enthält, gelten die entsprechenden Vorgänge weiterhin als erfolgreich und sind in successful_event_count enthalten.
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-09-05 (UTC).
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Benötigte Informationen nicht gefunden","missingTheInformationINeed","thumb-down"],["Zu umständlich/zu viele Schritte","tooComplicatedTooManySteps","thumb-down"],["Nicht mehr aktuell","outOfDate","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Problem mit Beispielen/Code","samplesCodeIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 2025-09-05 (UTC)."],[[["\u003cp\u003eThe Google Ads API allows retrieval of offline data diagnostics, offering insights into the health of your conversion uploads and adjustments.\u003c/p\u003e\n"],["\u003cp\u003eYou can access these diagnostics at both the account level and the conversion action level using specific GAQL queries.\u003c/p\u003e\n"],["\u003cp\u003eDiagnostics encompass data like total events, successful events, pending events, and alerts on errors, helping assess the upload process.\u003c/p\u003e\n"],["\u003cp\u003eDaily and job summaries are included, offering a detailed view of upload request performance over the past 7 days.\u003c/p\u003e\n"],["\u003cp\u003eRegularly review these summaries to ensure smooth conversion tracking, addressing any alerts to optimize the upload process for better results.\u003c/p\u003e\n"]]],[],null,["# Monitor offline data diagnostics\n\n| **Note:** For enhanced conversions for leads imports, use the [enhanced conversions for leads diagnostics report](//support.google.com/google-ads/answer/15249267) in the Google Ads UI to monitor your import health.\n\nUse the Google Ads API to retrieve\n[offline data diagnostics](//support.google.com/google-ads/answer/13812240),\nwhich contain information about the overall health of your conversion import and\nadjustment processes.\n\nTo retrieve the latest offline data diagnostics for your account, use\none of the following resources:\n\n- [`offline_conversion_upload_client_summary`](/google-ads/api/fields/v21/offline_conversion_upload_client_summary) aggregates import diagnostics at the account level.\n- [`offline_conversion_upload_conversion_action_summary`](/google-ads/api/fields/v21/offline_conversion_upload_conversion_action_summary) aggregates import diagnostics at the conversion action level.\n\nAccount level diagnostics\n-------------------------\n\nTo retrieve account level conversion upload diagnostics, use the following\nGAQL query: \n\n SELECT\n customer.id,\n offline_conversion_upload_client_summary.alerts,\n offline_conversion_upload_client_summary.client,\n offline_conversion_upload_client_summary.daily_summaries,\n offline_conversion_upload_client_summary.job_summaries,\n offline_conversion_upload_client_summary.last_upload_date_time,\n offline_conversion_upload_client_summary.pending_event_count,\n offline_conversion_upload_client_summary.pending_rate,\n offline_conversion_upload_client_summary.status,\n offline_conversion_upload_client_summary.success_rate,\n offline_conversion_upload_client_summary.successful_event_count,\n offline_conversion_upload_client_summary.total_event_count\n FROM offline_conversion_upload_client_summary\n\nThis query returns separate\n[`OfflineConversionUploadClientSummary`](/google-ads/api/reference/rpc/v21/OfflineConversionUploadClientSummary)\nrows for each type of client used in recent imports. For example, if you\nrecently imported using both the Google Ads API and the Google Ads UI, the results\ncontain separate entries for the `client` values of `GOOGLE_ADS_API` and\n`GOOGLE_ADS_WEB_CLIENT`.\n\nConversion action level diagnostics\n-----------------------------------\n\nTo retrieve conversion upload diagnostics at the conversion action level, use\nthe following GAQL query: \n\n SELECT\n offline_conversion_upload_conversion_action_summary.conversion_action_name,\n offline_conversion_upload_conversion_action_summary.alerts,\n offline_conversion_upload_conversion_action_summary.client,\n offline_conversion_upload_conversion_action_summary.daily_summaries,\n offline_conversion_upload_conversion_action_summary.job_summaries,\n offline_conversion_upload_conversion_action_summary.last_upload_date_time,\n offline_conversion_upload_conversion_action_summary.pending_event_count,\n offline_conversion_upload_conversion_action_summary.status,\n offline_conversion_upload_conversion_action_summary.successful_event_count,\n offline_conversion_upload_conversion_action_summary.total_event_count\n FROM offline_conversion_upload_conversion_action_summary\n WHERE offline_conversion_upload_conversion_action_summary.conversion_action_id = \u003c INSERT CONVERSION ACTION ID \u003e\n\nSimilar to account level diagnostics, this query returns separate\n[`OfflineConversionUploadConversionActionSummary`](/google-ads/api/reference/rpc/v21/OfflineConversionUploadConversionActionSummary)\nrows for each type of client used in recent imports. For example, if you\nrecently imported using both the Google Ads API and the Google Ads UI, the results\ncontain separate entries for the `client` values of `GOOGLE_ADS_API` and\n`GOOGLE_ADS_WEB_CLIENT`.\n\nHow to interpret these summaries\n--------------------------------\n\nEach `OfflineConversionUploadClientSummary` or\n`OfflineConversionUploadConversionActionSummary` has a `status` field, that\nreflects the [overall health](//support.google.com/google-ads/answer/13812240#2)\nof imports for the `client`. It also contains the following information:\n\n- The count of total events received.\n- The count of successfully processed events.\n- The count of pending events (events that are still being processed).\n- An `alerts` field, that provides a summary of errors, grouped by [`OfflineConversionError`](/google-ads/api/reference/rpc/v21/OfflineConversionError).\n\nAll of these fields contain information from the most recent full calendar day\nof imports. Use this information to assess the *current* health of your imports.\n\nIn addition, each `OfflineConversionUploadClientSummary` or\n`OfflineConversionUploadConversionActionSummary` contains two different\ntypes of reports:\n\n`daily_summaries`\n: A `successful_count`, `failed_count`, and `pending_count` of import requests\n from the last 7 days, grouped by import `date`.\n\n`job_summaries`\n\n: The `successful_count`, `failed_count`, and `pending_count` of the 7 most\n recent import requests, grouped by `job_id`. The `job_id` is an optional field\n of [`UploadClickConversionsRequest`](/google-ads/api/reference/rpc/v21/UploadClickConversionsRequest) and\n [`UploadConversionAdjustmentsRequest`](/google-ads/api/reference/rpc/v21/UploadConversionAdjustmentsRequest). You can either set the\n `job_id` to a non-negative number less than `2^31` or let the Google Ads API assign a\n system-generated job ID to your request. Regardless of which option you\n choose, the [`UploadClickConversionsResponse`](/google-ads/api/reference/rpc/v21/UploadClickConversionsResponse) or\n [`UploadConversionAdjustmentsResponse`](/google-ads/api/reference/rpc/v21/UploadConversionAdjustmentsResponse) returns the `job_id`.\n\n One scenario where assigning your own `job_id` is useful is when you have a\n single job or process that imports a large number of conversions using\n multiple requests. If you set the `job_id` on each of those requests to the\n same value, then you can retrieve a single entry for the job from\n `job_summaries`. If instead you let the Google Ads API assign a system-generated\n value to the `job_id` of each request, the `job_summaries` contains a separate\n entry for each request, which could make analyzing the overall health of your\n job more challenging.\n\nHow to use summaries\n--------------------\n\nTo ensure your import processes are recording conversions and enhancements as\nexpected, periodically retrieve the summaries for each of your accounts. If the\n`status` of any summary is not `EXCELLENT`, use the list of errors under\n`alerts` to guide you through modifying your import process to reduce or\neliminate those errors.\n\nFor example:\n\n- If the status is `NEEDS_ATTENTION`, then a significant portion of your\n import operations failed. Review the errors under `alerts` and modify your\n import process to reduce or eliminate those errors.\n\n- If the status is `NO_RECENT_UPLOADS`, then Google Ads has not received any recent\n imports for the `client`. If this is unexpected, then review the processes\n that perform imnports using that client.\n\n For example, if the `status` for `GOOGLE_ADS_API` is `NO_RECENT_UPLOADS`, that\n could indicate that your import process that uses the Google Ads API stopped running\n recently.\n- To determine if there was a specific import date or job that sent a large\n number of events that failed to process, check the `successful_count`,\n `failed_count`, and `pending_count` of `daily_summaries` and `job_summaries`.\n Any events in a pending state may take up to 24 hours\n to complete.\n\nMore information on how to improve offline data diagnostics can be found in\nthe [Help center](//support.google.com/google-ads/answer/13812240#4).\n\nRestrictions\n------------\n\nKeep the following in mind when retrieving import summaries:\n\n- The Google Ads API only returns offline data diagnostics if the\n [`customer_id`](/google-ads/api/reference/rpc/v21/SearchGoogleAdsStreamRequest#customer_id) of the\n `searchStream` or `search` request is the same customer you used recently to\n import conversions.\n\n For example, a client account that uses cross-account conversion tracking may\n not contain any diagnostics. However, you can retrieve diagnostics by sending\n a request where the `customer_id` matches the `customer_id` of the manager\n account you use in imports.\n- Google Ads treats `CLICK_NOT_FOUND` errors from [enhanced conversions for\n leads](/google-ads/api/docs/conversions/enhanced-conversions/leads) imports as warnings. As\n a result, if `alerts` contains an entry for this error, the corresponding\n operations are still considered successful and are included in the\n `successful_event_count`."]]
