Çevrimdışı veri teşhislerini izleme

Dönüşüm yükleme 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ızın en yeni çevrimdışı veri teşhislerini almak için GoogleAdsService ile 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ı, başarıyla işlenen etkinliklerin sayısı ve hataların özetini sağlayan alerts alanını içerir. Bu alan OfflineConversionError ölçütüne göre gruplandırılır. Bu alanların tümü, yüklemelerin yapıldığı en son tam takvim gününe ait bilgileri içerir. Yüklemelerinizin mevcut durumunu değerlendirmek için bu bilgilerden yararlanın.

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

daily_summaries
Son 7 gündeki yükleme isteklerinin successful_count ve failed_count kadarı yüklemeye göre gruplandırılmış date.
job_summaries

En son 7 yükleme isteğinden job_id ölçütüne göre gruplandırılmış successful_count ve failed_count. job_id, UploadClickConversionsRequest ve UploadConversionAdjustmentsRequest seçeneklerinin isteğe bağlı bir alanıdır. job_id için negatif olmayan, 2^31 değerinden küçük bir sayı ayarlayabilir veya Google Ads API'nin isteğinize sistem tarafından oluşturulmuş bir iş kimliği atamasına izin verebilirsiniz. Hangi seçeneği belirlediğinize bakılmaksızın UploadClickConversionsResponse veya UploadConversionAdjustmentsResponse, job_id değerini döndürür.

Kendi job_id atamanızı kullanmanın kullanışlı olduğu senaryolardan biri, birden fazla istek kullanarak çok sayıda dönüşüm yükleyen tek bir işiniz veya süreciniz olduğu zamanlardır. Bu isteklerin her birinde job_id için aynı değeri ayarlarsanız job_summaries öğesinden 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, işinizin genel durumunun analiz edilmesini daha güç hale getirebilir.

Özetler nasıl kullanılır?

Yükleme 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 kısmı EXCELLENT değilse yükleme işleminizi değiştirerek bu hataları azaltmak veya ortadan kaldırmak için size yol göstermesi için alerts bölümündeki hata listesinden yararlanın.

Örneğin:

  • Durum NEEDS_ATTENTION ise yükleme işlemlerinizin önemli bir kısmı başarısız olmuştur. alerts altındaki hataları inceleyin ve bu hataları azaltmak veya ortadan kaldırmak için yükleme işleminizi değiştirin.

  • Durum NO_RECENT_UPLOADS ise Google Ads, client ile ilgili yakın zamanda yapılan yükleme işlemlerini almamıştır. Bu beklenmedik bir durumsa ilgili istemciyi kullanarak yükleme gerçekleştiren işlemleri gözden geçirin.

    Örneğin, GOOGLE_ADS_API için status değerinin NO_RECENT_UPLOADS olması, Google Ads API'yi kullanan yükleme işleminizin kısa süre önce ç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 aklınızda bulundurun:

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

    Örneğin, hesaplar arası dönüşüm izleme kullanan bir müşteri hesabında teşhis bulunmayabilir. Bununla birlikte, customer_id öğesinin 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 kapsamına alınır.

Önceki
Dönüşüm değeri kuralları
Sonraki
Raporlama