Önce kullanıcı arayüzünde yeni raporlar oluşturun
Raporlar; raporlama türleri, filtreler, boyutlar ve metriklerle ilgili çeşitli kısıtlamalara ve şartlara tabidir. Bu sınırlamalar API'de uygulanır ve HTTP 400
hatası döndürülür. Rapor oluştururken hataları önlemek için önce Display & Video 360 kullanıcı arayüzünde yeni raporlar oluşturmanızı öneririz.
Raporunuzu oluşturduktan sonra, Query
kaynağının queries.get
işlemini yapmak için referans dokümanları sayfasındaki "Bu API'yi dene" özelliğini tıklayın. Gelecekte rapor oluşturmak için döndürülen JSON'u kullanabilirsiniz.
Rapor türüne özel metrikler ve filtreler kullanın
Bazı metrik ve filtre değerleri belirli rapor türlerine özeldir. Raporlarınızı önce kullanıcı arayüzünde oluşturmanın yanı sıra belirli ReportType
değerlerine ait metrikleri ve filtreleri Bid Manager API değerlerine göre de tanımlayabilirsiniz.
Aşağıda, ilgili Bid Manager API filtresi ve metrik değerlerini belirlemenin bazı yolları verilmiştir. Bu tablo, bu tür raporlarda kullanılabilecek filtre ve metriklerin kapsamlı bir listesi değildir. Tüm değerler tek bir raporda birlikte kullanılamaz.
ReportType |
Alakalı Filtreler ve Metrikler |
---|---|
YOUTUBE |
|
GRP |
|
YOUTUBE_PROGRAMMATIC_GUARANTEED |
|
REACH |
|
UNIQUE_REACH_AUDIENCE |
|
Raporları kaydetme ve yeniden kullanma
Aynı raporu birden çok kez ekleyip silmeniz kaynakları boşa harcadığından, düzenli olarak çalıştırdığınız sorgular için rapor oluşturup kaydetmenizi öneririz.
dataRange
alanında PREVIOUS_DAY
veya LAST_7_DAYS
gibi sabit Range
değerleri kullanmak, raporların yeniden kullanılabilirliğini artırır.
Raporları planlama
Anlık veya tek seferlik raporlar, ayrı ayrı çalıştırıldıklarından ve eksik bir veri kümesine göre yürütülebileceklerinden kaynak israfına neden olabilir. Planlanmış raporlar toplu olarak çalıştırıldığı ve önceki güne ait verilerin işlenmesi tamamlanana kadar yürütülmeyeceği garanti edildiği için raporlama kaynaklarını en iyi şekilde kullanır. Ayrıntılar için kullanılabilir planlama alanlarına bakın.
Benzer raporları birleştirme
Farklı reklamverenler veya iş ortakları için aynı metrikleri ve tarih aralıklarını içeren raporları düzenli olarak oluşturuyorsanız rapor hacmini optimize etmek için raporları birleştirmenizi öneririz.
Tüm raporların filtrelerini ve tüm filtre türlerini boyut olarak ekleyerek benzer raporları birleştirebilirsiniz. Oluşturma işleminden sonra, orijinal raporları oluşturmak için ortaya çıkan raporun satırlarını orijinal filtre değerlerine göre bölebilirsiniz.
Raporlama kotalarını göz önünde bulundurun
Display & Video 360 raporlama özelliğinin sorumlu kullanımı, aşağıdaki ürün genelindeki kullanım kotaları aracılığıyla zorunlu kılınmaktadır.
Günlük geçici rapor yürütme işlemleri
Bir kullanıcının 24 saat içinde çalıştırabileceği ad hoc rapor sayısını sınırlar. Bu kotayı aşmamak için:
- Rapor hacmini azaltmak için benzer raporları birleştirin.
- Anlık rapor hacmini azaltmak için yinelenen anlık raporlar planlayın.
- Gereksiz API komut dosyalarını devre dışı bırakın.
Etkin planlanmış raporlar
Kullanıcının belirli bir zamanda etkin olarak planlayabileceği rapor sayısını sınırlar. Bu kotayı aşmamak için:
- Planlanmış raporların toplam sayısını azaltmak için benzer planlanmış raporları birleştirin.
- Gereksiz planlanmış raporları devre dışı bırakın.
- Gereksiz API komut dosyalarını devre dışı bırakın.
Eşzamanlı raporlar
Kullanıcının aynı anda çalıştırabileceği rapor sayısını sınırlar. Bu kotayı aşmamak için:
- Düzenli olarak çalıştırılacak raporları planlayın.
- Gereksiz API komut dosyalarını devre dışı bırakın.
- Eksponansiyel geri yükleme mantığını kullanarak anket yaparak raporlarınızın ne zaman tamamlandığını izleyin.
Raporlama uygulamanızı optimize ettiyseniz ve yine de kotanızı aştıysanız iletişim formunu kullanarak Display & Video 360 Destek Ekibi ile iletişime geçin.
Rapor durumu için anket yaparken eksponansiyel geri yükleme kullanın
Bir raporun çalıştırılmasının ne kadar süreceğini tahmin etmek mümkün değildir. Süre, tarih aralığı ve işlenmesi gereken veri miktarı gibi birçok faktöre bağlı olarak saniyeler ile saatler arasında değişebilir. Ayrıca, rapor çalışma süresi ile raporda döndürülen satır sayısı arasında da bir ilişki yoktur. Bu nedenle, raporun çalışıp çalışmadığını belirlemek için queries.reports.get
yöntemini kullanarak rapor kaynağını düzenli olarak almanız ve kaynağın metadata.status.state
alanının DONE
veya FAILED
olarak güncellenip güncellenmediğini kontrol etmeniz gerekir. Bu işleme "anket" adı verilir.
Anket gerekli olsa da, uzun süre çalışan bir raporla karşılaşıldığında verimsiz bir uygulama kotanızı hızla tüketebilir. Bu nedenle, yeniden denemeleri sınırlamak ve kotayı korumak için eksponansiyel geri yükleme kullanmanızı öneririz.
Eksponansiyel geri yükleme
Eksponansiyel geri yükleme, istemcinin isteği belirli aralıklarla artan bir süre boyunca yeniden denediği ağ uygulamaları için standart bir hata işleme stratejisidir. Üstel geri çekilme, doğru şekilde kullanıldığında bant genişliği kullanımının verimliliğini artırır, başarılı bir yanıt almak için gereken istek sayısını azaltır ve eşzamanlı ortamlardaki isteklerin veri hızını en üst düzeye çıkarır.
Basit eksponansiyel geri yüklemeyi uygulama akışı aşağıdaki gibidir:
- API'ye
queries.reports.get
isteği gönderin. - Rapor nesnesini alın.
metadata.status.state
alanıDONE
veyaFAILED
değilse rapor henüz yayınlanmamış demektir ve ankete devam edilmelidir. - 5 saniye ve rastgele bir milisaniye sayısı bekleyip isteği yeniden deneyin.
- Rapor nesnesini alın.
metadata.status.state
alanıDONE
veyaFAILED
değilse rapor henüz yayınlanmamış demektir ve ankete devam edilmelidir. - 10 saniye ve rastgele bir milisaniye sayısı kadar bekleyip isteği yeniden deneyin.
- Rapor nesnesini alın.
metadata.status.state
alanıDONE
veyaFAILED
değilse rapor henüz yayınlanmamış demektir ve ankete devam edilmelidir. - 20 saniye ve rastgele bir milisaniye sayısı bekleyip isteği yeniden deneyin.
- Rapor nesnesini alın.
metadata.status.state
alanıDONE
veyaFAILED
değilse rapor henüz yayınlanmamış demektir ve ankete devam edilmelidir. - 40 saniye ve rastgele bir milisaniye sayısı kadar bekleyip isteği yeniden deneyin.
- Rapor nesnesini alın.
metadata.status.state
alanıDONE
veyaFAILED
değilse rapor henüz yayınlanmamış demektir ve ankete devam edilmelidir. - 80 saniye ve rastgele bir milisaniye sayısı kadar bekleyip isteği yeniden deneyin.
- Rapor nesnesi güncellenene veya azami süre dolana kadar bu kalıbı sürdürün.
Raporun çalışması tamamlanıp DONE
durumunda sona ererse oluşturulan rapor dosyasını metadata.googleCloudStoragePath
alanında verilen yoldan Google Cloud Storage'dan alabilirsiniz.