Çevrimdışı veri teşhislerini izleme
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Dönüşüm içe aktarma ve ayarlama işlemlerinizin genel durumu hakkında bilgi içeren çevrimdışı veri teşhislerini almak için Google Ads API'yi kullanın.
Hesabınızla ilgili en son çevrimdışı veri teşhislerini almak için aşağıdaki kaynaklardan birini kullanın:
Hesap düzeyinde teşhis
Hesap düzeyinde dönüşüm yükleme teşhislerini almak için aşağıdaki GAQL sorgusunu kullanın:
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
Bu sorgu, son içe aktarma işlemlerinde kullanılan her istemci türü için ayrı OfflineConversionUploadClientSummary satır döndürür. Örneğin, kısa süre önce hem Google Ads API'yi hem de Google Ads kullanıcı arayüzünü kullanarak içe aktarma işlemi yaptıysanız sonuçlar, client değerleri için GOOGLE_ADS_API ve GOOGLE_ADS_WEB_CLIENT olmak üzere ayrı girişler içerir.
Dönüşüm işlemi düzeyinde teşhisler
Dönüşüm yükleme teşhislerini dönüşüm işlemi düzeyinde almak için aşağıdaki GAQL sorgusunu kullanın:
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 >
Hesap düzeyindeki teşhislere benzer şekilde bu sorgu, son içe aktarma işlemlerinde kullanılan her istemci türü için ayrı OfflineConversionUploadConversionActionSummary satır döndürür. Örneğin, kısa süre önce hem Google Ads API'yi hem de Google Ads kullanıcı arayüzünü kullanarak içe aktarma işlemi yaptıysanız sonuçlar, client değerleri için GOOGLE_ADS_API ve GOOGLE_ADS_WEB_CLIENT olmak üzere ayrı girişler içerir.
Bu özetleri yorumlama
Her OfflineConversionUploadClientSummary veya OfflineConversionUploadConversionActionSummary, client için içe aktarma işlemlerinin genel durumunu yansıtan bir status alanına sahiptir. Ayrıca aşağıdaki bilgileri de içerir:
- Alınan toplam etkinlik sayısı.
- Başarıyla işlenen etkinliklerin sayısı.
- Bekleyen etkinliklerin sayısı (işlenmeye devam eden etkinlikler).
OfflineConversionError'ye göre gruplandırılmış hataların özetini sağlayan bir alerts alanı.
Bu alanların tümü, en son tam takvim günü içe aktarma işlemlerinden elde edilen bilgileri içerir. İçe aktarma işlemlerinizin mevcut durumunu değerlendirmek için bu bilgileri kullanın.
Ayrıca her OfflineConversionUploadClientSummary veya OfflineConversionUploadConversionActionSummary iki farklı rapor türü içerir:
daily_summariesdate işlemine göre gruplandırılmış içe aktarma isteklerinin - A
successful_count, failed_count ve pending_count.
job_summariesjob_id'ye göre gruplandırılmış, en son 7 içe aktarma isteğinin successful_count, failed_count ve pending_count. job_id, UploadClickConversionsRequest ve UploadConversionAdjustmentsRequest için isteğe bağlı bir alandır. job_id değerini 2^31 değerinden küçük, negatif olmayan bir sayıya ayarlayabilir veya Google Ads API'nin isteğinize sistem tarafından oluşturulan bir iş kimliği atamasına izin verebilirsiniz. Hangi seçeneği belirlerseniz belirleyin, UploadClickConversionsResponse veya UploadConversionAdjustmentsResponse, job_id değerini döndürür.
Kendi job_id değerinizi atamanın yararlı olduğu bir senaryo, birden fazla istek kullanarak çok sayıda dönüşümün içe aktarıldığı tek bir işiniz veya süreciniz olduğunda ortaya çıkar. Bu isteklerin her birinde job_id değerini aynı değere ayarlarsanız job_summaries'den iş için tek bir giriş alabilirsiniz. Bunun yerine Google Ads API'nin her isteğin job_id özelliğine sistem tarafından oluşturulan bir değer atamasına izin verirseniz job_summaries, her istek için ayrı bir giriş içerir. Bu da işinizin genel durumunu analiz etmeyi zorlaştırabilir.
Özetleri kullanma
İçe aktarma işlemlerinizin dönüşümleri ve geliştirmeleri beklendiği gibi kaydettiğinden emin olmak için hesaplarınızın her birine ait özetleri düzenli olarak alın. Herhangi bir özetin status değeri EXCELLENT değilse içe aktarma işleminizi değiştirerek bu hataları azaltma veya ortadan kaldırma konusunda size yol göstermesi için alerts bölümündeki hata listesini kullanın.
Örneğin:
Durum NEEDS_ATTENTION ise içe aktarma işlemlerinizin önemli bir kısmı başarısız olmuştur. alerts bölümündeki hataları inceleyin ve bu hataları azaltmak veya ortadan kaldırmak için içe aktarma işleminizi değiştirin.
Durum NO_RECENT_UPLOADS ise Google Ads, client için son zamanlarda herhangi bir içe aktarma almamıştır. Bu durum beklenmedikse söz konusu istemciyi kullanarak içe aktarma işlemleri gerçekleştiren süreçleri inceleyin.
Örneğin, GOOGLE_ADS_API için status değeri NO_RECENT_UPLOADS ise bu, Google Ads API'yi kullanan içe aktarma işleminizin kısa süre önce çalışmayı durdurduğunu gösterebilir.
İşlenemeyen çok sayıda etkinlik gönderen belirli bir içe aktarma tarihi veya işi olup olmadığını belirlemek için daily_summaries ve job_summaries'in successful_count, failed_count ve pending_count bölümlerini kontrol edin.
Beklemede olan etkinliklerin tamamlanması 24 saati bulabilir.
Çevrimdışı veri teşhislerini iyileştirme hakkında daha fazla bilgiyi Yardım Merkezi'nde bulabilirsiniz.
Kısıtlamalar
İçe aktarma özetlerini alırken aşağıdakileri göz önünde bulundurun:
Google Ads API, yalnızca searchStream veya search isteğinin customer_id, yakın zamanda dönüşümleri içe aktarmak için kullandığınız müşteriyle aynıysa çevrimdışı veri teşhislerini döndürür.
Örneğin, hesaplar arası dönüşüm izleme özelliğini kullanan bir müşteri hesabında herhangi bir teşhis bulunmayabilir. Ancak, içe aktarma işlemlerinde kullandığınız yönetici hesabının customer_id ile eşleşen bir customer_id isteği göndererek teşhis bilgilerini alabilirsiniz.
Google Ads, potansiyel müşteriler için gelişmiş dönüşüm içe aktarma işlemlerinden kaynaklanan CLICK_NOT_FOUND hatalarını uyarı olarak değerlendirir. Bu nedenle, alerts bu hatayla ilgili bir giriş içeriyorsa ilgili işlemler yine de başarılı kabul edilir ve successful_event_count'e dahil edilir.
Aksi belirtilmediği sürece bu sayfanın içeriği Creative Commons Atıf 4.0 Lisansı altında ve kod örnekleri Apache 2.0 Lisansı altında lisanslanmıştır. Ayrıntılı bilgi için Google Developers Site Politikaları'na göz atın. Java, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-09-05 UTC.
[[["Anlaması kolay","easyToUnderstand","thumb-up"],["Sorunumu çözdü","solvedMyProblem","thumb-up"],["Diğer","otherUp","thumb-up"]],[["İhtiyacım olan bilgiler yok","missingTheInformationINeed","thumb-down"],["Çok karmaşık / çok fazla adım var","tooComplicatedTooManySteps","thumb-down"],["Güncel değil","outOfDate","thumb-down"],["Çeviri sorunu","translationIssue","thumb-down"],["Örnek veya kod sorunu","samplesCodeIssue","thumb-down"],["Diğer","otherDown","thumb-down"]],["Son güncelleme tarihi: 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`."]]
