Çevrimdışı veri teşhislerini izleme

Dönüşüm içe aktarma ve ayarlama süreçlerinizin 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ırları döndürür. Örneğin, yakın zamanda 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, GOOGLE_ADS_API ve GOOGLE_ADS_WEB_CLIENT değerlerinin client için ayrı girişler içerir.

Dönüşüm işlemi düzeyinde teşhisler

Dönüşüm işlemi düzeyinde dönüşüm yükleme teşhislerini almak için aşağıdaki GAQL sorgusunu kullanın:

SELECT
  offline_conversion_upload_conversion_action_summary.conversion_action_id,
  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 = <CONVERSION_ACTION_ID>

Hesap düzeyindeki teşhislere benzer şekilde bu sorgu, son içe aktarma işlemlerinde kullanılan her müşteri türü için ayrı OfflineConversionUploadConversionActionSummary satırları döndürür. Örneğin, yakın zamanda hem Google Ads API'yi hem de Google Ads kullanıcı arayüzünü kullanarak içe aktarma işlemi yaptıysanız sonuçlarda GOOGLE_ADS_API ve GOOGLE_ADS_WEB_CLIENT client değerleri için ayrı girişler yer alır.

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ı.
  • Beklemedeki etkinliklerin (hâlâ işlenmekte olan etkinlikler) sayısı.
  • OfflineConversionError gruplandırma ölçütüne göre gruplandırılmış hataların özetini sağlayan bir alerts alanı.

Bu alanların tümü, içe aktarma işlemlerinin yapıldığı en son tam takvim gününe ait 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ı türde rapor içerir:

daily_summaries
Son 7 güne ait içe aktarma isteklerinin successful_count, failed_count ve pending_count, içe aktarma date göre gruplandırılmış.
job_summaries

En son 7 içe aktarma isteğinin successful_count, failed_count ve pending_count değerleri, job_id gruplandırma ölçütüne göre gruplandırılır. job_id, UploadClickConversionsRequest ve UploadConversionAdjustmentsRequest için isteğe bağlı bir alandır. job_id alanını pozitif bir 32 bit tam sayıya (1 - 2^31 - 1) ayarlayabilir veya Google Ads API'nin isteğinize sistem tarafından oluşturulan bir iş kimliği atamasını sağlayabilirsiniz. Hangi seçeneği tercih ederseniz edin, 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ü içe aktaran 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 üzerinden 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 durumunu analiz etmeyi zorlaştırabilir.

Özetleri kullanma

İçe aktarma işlemlerinizin dönüşümleri ve geliştirmeleri API hatası olmadan aldığını doğrulamak için hesaplarınızın her biriyle ilgili özetleri düzenli olarak alın. Herhangi bir özetin status alanı EXCELLENT değilse içe aktarma işleminizi bu hataları azaltacak veya ortadan kaldıracak şekilde değiştirme konusunda size yol göstermesi için alerts alanındaki 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 altındaki 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 yakın zamanda herhangi bir içe aktarma işlemi almamıştır. Bu beklenmeyen bir durumsa söz konusu istemciyi kullanarak içe aktarma işlemi gerçekleştiren süreçleri inceleyin.

    Örneğin, GOOGLE_ADS_API için status NO_RECENT_UPLOADS ise bu, Google Ads API'yi kullanan içe aktarma işleminizin yakın zamanda durdurulduğ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'nin successful_count, failed_count ve pending_count değerlerini kontrol edin. Bekleme durumundaki etkinliklerin tamamlanması 24 saati bulabilir.

Çevrimdışı veri teşhisini 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 parametresi, dönüşümleri içe aktarmak 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 izleme kullanan bir müşteri hesabı herhangi bir teşhis bilgisi içermeyebilir. Ancak içe aktarma işlemlerinde kullandığınız yönetici hesabının customer_id değeriyle eşleşen bir customer_id içeren istek göndererek teşhis bilgilerini alabilirsiniz.

  • Google Ads, potansiyel müşteriler için gelişmiş dönüşümler içe aktarma işlemlerinden kaynaklanan 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ı kabul edilir ve successful_event_count içine dahil edilir.

Önceki
Özel dönüşüm değişkenleri
Sonraki
Raporlama