AdSense Management API'de yeni ve kayıtlı raporlar oluşturmak için çağrılar bulunur. Günlük kazançlar gibi basit analizler veya ülkeye göre özel kanal başına tıklama oranlarının yer aldığı çok karmaşık tablolar içerebilir. Bu kılavuzda, API'lerle güçlü bir entegrasyon için doğru şekilde ele alınması gereken uç durumların listesi sunulmaktadır.
Rapor yapısı
Rapor sonuçları ReportResult
nesnesi olarak döndürülür. Ayrıntılı ayrıntılar için rapor yanıtı referansına bakın.
Kronolojik boyutlar kullanılıyor: DATE, WEEK ve MONTH
Raporlar boş veya boşluklar içeriyor olabilir
İstekte belirtilen dönem boyunca etkinlik olmadıysa reklam isteği oluşturulmaz ve rapor hizmeti bu zaman aralıklarına ait satırları göstermez. Örneğin, grafik çiziyorsanız bu önemlidir.
Daha fazla bilgi için Tarihleri Doldurma kılavuzunu inceleyin.
Aynı raporda MONTH ve WEEK boyutlarını isteme
Bu raporun olumsuz veya beklenmeyen sonuçları olabilir. Bir hafta iki farklı aya aitse aynı hafta için her ay için bir tane olacak şekilde iki satır gösterir.
Örnek
Boyutlar | Metrikler | Start date (Başlangıç tarihi) | Bitiş tarihi |
---|---|---|---|
WEEK MONTH |
CLICKS | 2014-04-28 | 2014-05-03 |
Dönen:
MONTH | WEEK * | CLICKS |
---|---|---|
2014-04 | 2014-04-27 | 50 |
2014-05 | 2014-04-27 | 43 |
* haftanın ilk günü
Çözüm
MONTH
öğesini rapordan kaldırın.
WEEK | CLICKS |
---|---|
2014-04-27 | 93 |
Boyut değerlerini toplama
Örneğin platformlar (masaüstü, ileri teknoloji mobil cihazlar vb.) ile ilgili boyutlar gibi boyutlar istendiğinde yalnızca etkinliği olan platformlar gösterilir. Belirli bir gün, hafta veya ay içinde ileri teknoloji mobil cihazlardan hiç ziyaret yoksa söz konusu kategoriyle ilgili herhangi bir bilgi bulunmaz.
Örnek
Boyutlar | Metrikler | Start date (Başlangıç tarihi) | Bitiş tarihi |
---|---|---|---|
PLATFORM_TYPE_NAME MONTH |
AD_REQUESTS |
2014-02-01 | 2014-03-31 |
Dönen:
AY | PLATFORM_TYPE_NAME | AD_REQUESTS |
---|---|---|
2014-03 | Masaüstü | 100 |
2014-03 | İleri teknoloji mobil cihazlar | 5 |
2014-04 | Masaüstü | 75 |
Çözüm
Rapor sonuçlarını işlerken, sonuçlarda görünmeyen tüm boyut değerleri için sıfır değerini varsayın:
AY | PLATFORM_TYPE_NAME | AD_REQUESTS |
---|---|---|
2014-03 | Masaüstü | 100 |
2014-03 | İleri teknoloji mobil cihazlar | 5 |
2014-04 | Masaüstü | 75 |
2014-04 | İleri teknoloji mobil cihazlar | 0 |
Birden fazla ardışık raporu birleştirme
Bazen bir rapor, tek seferde oluşturulamayacak kadar büyük olur ve toplu işlem yapmak gerekebilir. Uygulamanız bunu yapıyorsa aşağıdaki durumları göz önünde bulundurun:
WEEK
veyaMONTH
boyutlarını kullanıyorsanız ve raporu bir haftanın ya da ayın ortasında bölüyorsanız her raporda farklı verilere sahip yinelenen girişler bulunur.- Veriler farklı boyutlar kullanılarak birleştirilemeyeceği için tüm raporların aynı metriklere ve boyutlara sahip olduğundan emin olun.
Özel hesaplar
Bazı kullanıcılarınızın, beklemediğiniz veya bilmediğiniz özelliklere sahip AdSense hesapları olabilir. Aşağıdakileri göz önünde bulundurduğunuzdan emin olun:
- Binlerce alan adı veya siteye sahip yayıncılar
- Binlerce reklam birimi veya özel kanala sahip yayıncılar
- Birden çok reklam müşterisi hakkında rapor oluşturmak isteyen yayıncılar (Arama için AdSense, Video için AdSense vb.)
Birden çok hesap
Kullanıcılar birden fazla AdSense hesabına erişebilir. Bu nedenle, API'ye yapılan her çağrı için bir hesap kimliği belirtilmelidir. accounts.list
çağrısı hesap listesini getirir ve kullanıcıya bir hesap seçici iletişim kutusu gösterilir. Getirilen hesap sayısı bir ise atlanabilir.
Saat dilimi değişiklikleri
AdSense Yayıncıları saat dilimlerini diledikleri zaman değiştirebilirler. Bu durum, raporlarda ani artış veya düşüşlere neden olabilir. Daha fazla bilgi için Yerel Saat Dilimi Raporlaması ile ilgili kılavuzu okuyun.