Raporlamayla İlgili En İyi Uygulamalar

Ö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
  • FILTER_TRUEVIEW ön ekiyle başlayan filtreler.
  • METRIC_TRUEVIEW ön ekiyle başlayan metrikler.
GRP
  • METRIC_GRP ön ekiyle başlayan metrikler.
YOUTUBE_PROGRAMMATIC_GUARANTEED
  • FILTER_YOUTUBE_PROGRAMMATIC_GUARANTEED ön ekiyle başlayan filtreler.
  • METRIC_PROGRAMMATIC_GUARANTEED ön ekiyle başlayan metrikler.
REACH
  • METRIC_UNIQUE_REACH ön ekiyle başlayan metrikler.
UNIQUE_REACH_AUDIENCE
  • METRIC_UNIQUE_REACH ön ekiyle başlayan metrikler.

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:

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:

  1. API'ye queries.reports.get isteği gönderin.
  2. Rapor nesnesini alın. metadata.status.state alanı DONE veya FAILED değilse rapor henüz yayınlanmamış demektir ve ankete devam edilmelidir.
  3. 5 saniye ve rastgele bir milisaniye sayısı bekleyip isteği yeniden deneyin.
  4. Rapor nesnesini alın. metadata.status.state alanı DONE veya FAILED değilse rapor henüz yayınlanmamış demektir ve ankete devam edilmelidir.
  5. 10 saniye ve rastgele bir milisaniye sayısı kadar bekleyip isteği yeniden deneyin.
  6. Rapor nesnesini alın. metadata.status.state alanı DONE veya FAILED değilse rapor henüz yayınlanmamış demektir ve ankete devam edilmelidir.
  7. 20 saniye ve rastgele bir milisaniye sayısı bekleyip isteği yeniden deneyin.
  8. Rapor nesnesini alın. metadata.status.state alanı DONE veya FAILED değilse rapor henüz yayınlanmamış demektir ve ankete devam edilmelidir.
  9. 40 saniye ve rastgele bir milisaniye sayısı kadar bekleyip isteği yeniden deneyin.
  10. Rapor nesnesini alın. metadata.status.state alanı DONE veya FAILED değilse rapor henüz yayınlanmamış demektir ve ankete devam edilmelidir.
  11. 80 saniye ve rastgele bir milisaniye sayısı kadar bekleyip isteği yeniden deneyin.
  12. 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.