Çevrimdışı veri teşhislerini izleme

Dönüşüm yükleme ve düzenleme 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 yüklemelerde kullanılan her istemci türü için ayrı OfflineConversionUploadClientSummary satırı 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ükleme yaptıysanız sonuçlar, GOOGLE_ADS_API ve GOOGLE_ADS_WEB_CLIENT için client değerlerine ait 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 yüklemelerde kullanılan her müşteri türü için ayrı OfflineConversionUploadConversionActionSummary satırı 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ükleme yaptıysanız sonuçlar, GOOGLE_ADS_API ve GOOGLE_ADS_WEB_CLIENT için client değerlerine ait ayrı girişler içerir.

Bu özetlerin yorumlanması

Her OfflineConversionUploadClientSummary veya OfflineConversionUploadConversionActionSummary'ın, client'e ait yüklemelerin genel durumunu yansıtan bir status alanı vardır. Ayrıca aşağıdaki bilgileri de içerir:

  • Alınan toplam etkinlik sayısı.
  • Başarıyla işlenen etkinliklerin sayısı.
  • Beklemedeki etkinliklerin (hâlâ işlenmekte olan etkinlikler) sayısı.
  • OfflineConversionError değerine göre gruplandırılmış hataların özetini sağlayan bir alerts alanı.

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 bilgileri kullanın.

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

daily_summaries
Son 7 gündeki yükleme isteklerinin successful_count, failed_count ve pending_count'i, yükleme date'e göre gruplandırılmış.
job_summaries

En son 7 yükleme isteğinden job_id'a göre gruplandırılmış successful_count, failed_count ve pending_count. job_id, UploadClickConversionsRequest ve UploadConversionAdjustmentsRequest'in isteğe bağlı bir alanıdır. job_id değerini 2^31'ten küçük, sıfırdan büyük 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 seçerseniz seçin UploadClickConversionsResponse veya UploadConversionAdjustmentsResponse, job_id değerini döndürür.

Kendi job_id'nizi atamanın yararlı olduğu bir senaryo, birden fazla istek kullanarak çok sayıda dönüşüm yükleyen tek bir işiniz veya işleminiz olduğunda ortaya çıkar. Bu isteklerin her birinde job_id değerini aynı değere ayarlarsanız job_summaries'dan iş için tek bir giriş alabilirsiniz. Bunun yerine, Google Ads API'nin her isteğin job_id değerine 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 sağlığını analiz etmeyi daha zor hale getirebilir.

Özetleri kullanma

Yükleme işlemlerinizin dönüşümleri ve iyileştirmeleri beklendiği gibi kaydettiğinden emin olmak için her hesabınızın özetlerini düzenli olarak alın. Bir özetin 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österecek alerts altındaki 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 işleminizi değiştirin.

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

    Örneğin, GOOGLE_ADS_API için status değeri NO_RECENT_UPLOADS ise Google Ads API'yi kullanan yükleme işleminizin kısa süre önce çalışmayı durdurduğunu gösterebilir.

  • İşlenemeyen çok sayıda etkinlik gönderen belirli bir yükleme tarihi veya işin olup olmadığını belirlemek için daily_summaries ve job_summaries için successful_count, failed_count ve pending_count değerlerini kontrol edin. Bekleme durumundaki etkinliklerin tamamlanması 24 saati bulabilir.

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ğinin customer_id değeri, dönüşümleri yüklemek için yakın zamanda kullandığınız müşteriyle aynıysa çevrimdışı veri teşhislerini döndürür.

    Örneğin, hesaplar arası dönüşüm izlemeyi kullanan bir müşteri hesabı herhangi bir teşhis içermeyebilir. Ancak customer_id değerinin, yüklemelerde kullandığınız yönetici hesabının customer_id değeriyle eşleştiği bir istek göndererek teşhis bilgilerini alabilirsiniz.

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

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