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
vefailed_count
kadarı (date
yüklemeye göre gruplanmış) job_summaries
En son 7 yükleme isteğinin
successful_count
vefailed_count
değerlerijob_id
bazında gruplandırılmıştır.job_id
,UploadClickConversionsRequest
veUploadConversionAdjustmentsRequest
için isteğe bağlı bir alandır.job_id
değerini2^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 olarakUploadClickConversionsResponse
veyaUploadConversionAdjustmentsResponse
,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çinjob_id
öğesini aynı değere ayarlarsanızjob_summaries
üzerinden iş için tek bir giriş alabilirsiniz. Bunun yerine, Google Ads API'nin her isteğinjob_id
öğesine sistem tarafından oluşturulan bir değer atamasına izin verirsenizjob_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 zamandaclient
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çinstatus
değerininNO_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
vejob_summaries
öğelerininsuccessful_count
vefailed_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
veyasearch
isteğindekicustomer_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ıncustomer_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 vesuccessful_event_count
içine dahil edilir.