Çevrimdışı veri teşhislerini izleme

Dönüşüm yükleme ve ayarlama süreçlerinizin genel durumu hakkında bilgiler içeren çevrimdışı veri teşhislerini almak için Google Ads API'yi kullanın.

Hesabınız için en güncel çevrimdışı veri teşhislerini almak istiyorsanız GoogleAdsService kullanarak offline_conversion_upload_client_summary kaynakları için aşağıdaki sorguyu gönderin:

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

Yukarıdaki sorgu, son yüklemelerde kullanılan her istemci türü için ayrı bir OfflineConversionUploadClientSummary döndürür. Örneğin, yakın zamanda hem Google Ads API'yi hem de Google Ads kullanıcı arayüzünü kullanarak yüklediyseniz sonuçlar, GOOGLE_ADS_API ve GOOGLE_ADS_WEB_CLIENT client değerleri için ayrı girişler içerir.

Her OfflineConversionUploadClientSummary, client için yüklemelerin genel durumunu yansıtan bir status alanına sahiptir. Ayrıca alınan toplam etkinlik sayısını, başarıyla işlenen etkinliklerin sayısını ve hataların özetini sağlayan bir alerts alanını OfflineConversionError ile gruplanmış olarak içerir. Bu alanların tümü, yüklemelerin en son tam takvim gününe ait bilgileri içerir. Yüklemelerinizin mevcut durumunu değerlendirmek için bu bilgilerden yararlanabilirsiniz.

Ayrıca, her OfflineConversionUploadClientSummary iki farklı rapor türü içerir:

daily_summaries

Son 7 güne ait yükleme isteklerinin successful_count ve failed_count kadarı (date yüklemeye göre gruplanmış)

job_summaries

En son 7 yükleme isteğinin successful_count ve failed_count değerleri job_id bazında gruplandırılmıştır. 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şturulmuş bir iş kimliği atamasına izin verebilirsiniz. Belirlediğiniz seçenekten bağımsız olarak UploadClickConversionsResponse veya UploadConversionAdjustmentsResponse, job_id değerini döndürür.

Kendi job_id atamanızı atamanın yararlı olduğu senaryolardan biri, tek bir işiniz veya birden fazla istek kullanarak çok sayıda dönüşüm yükleyen bir süreciniz olduğunda işe yarar. Bu isteklerin her biri için job_id öğesini aynı değere ayarlarsanız job_summaries üzerinden iş için tek bir giriş alabilirsiniz. Bunun yerine, Google Ads API'nin her isteğin job_id öğesine 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 durumunun analiz edilmesini daha zor hale getirebilir.

Özetler nasıl kullanılır?

Yükleme süreçlerinizin dönüşümleri ve geliştirmeleri beklendiği gibi kaydettiğinden emin olmak için her bir hesabınızla ilgili özetleri düzenli olarak alın. Özette status değeri EXCELLENT değilse bu hataları azaltmak veya ortadan kaldırmak için yükleme işleminizi değiştirirken size yol göstermesi amacıyla alerts bölümündeki hata listesini kullanın.

Örneğin:

• Durum NEEDS_ATTENTION ise yükleme 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 yükleme sürecinizi değiştirin.

• Durum NO_RECENT_UPLOADS ise Google Ads yakın zamanda client için herhangi bir yükleme almamıştır. Bu beklenmedik bir durumsa söz konusu istemciyi kullanarak yükleme yapan işlemleri inceleyin.

  Örneğin GOOGLE_ADS_API için status değerinin NO_RECENT_UPLOADS olması, Google Ads API'yi kullanan yükleme işleminizin yakın zamanda çalışmayı durdurduğunu gösterebilir.

• Başarıyla işlenmemiş çok sayıda etkinlik gönderen belirli bir yükleme tarihi veya iş olup olmadığını belirlemek için daily_summaries ve job_summaries öğelerinin successful_count ve failed_count değerlerini kontrol edin.

Kısıtlamalar

Yükleme özetlerini alırken aşağıdakileri göz önünde bulundurun:

• Google Ads API yalnızca searchStream veya search isteğindeki customer_id, yakın zamanda dönüşümleri yüklemek için kullandığınız müşteriyle aynıysa çevrimdışı veri teşhisi döndürür.

  Örneğin, hesaplar arası dönüşüm izleme kullanan bir müşteri hesabında teşhis bilgileri bulunmayabilir. Ancak customer_id değerinin yüklemelerde kullandığınız yönetici hesabının customer_id ile eşleştiği bir istek göndererek teşhisleri alabilirsiniz.

• Google Ads, potansiyel müşteriler için gelişmiş dönüşümler yüklemelerindeki CLICK_NOT_FOUND hatayı uyarı olarak değerlendirir. Sonuç olarak, alerts bu hata için bir giriş içeriyorsa ilgili işlemler yine de başarılı olarak kabul edilir ve successful_event_count içine dahil edilir.