Raporlamayla İlgili En İyi Uygulamalar

Önce kullanıcı arayüzünde yeni raporlar oluşturun

Raporlar; raporlama türleri, filtreler, boyutlar ve metriklerle ilgili bir dizi kısıtlama ve gereksinime tabidir. Bu sınırlamalar API'de uygulanır ve bir HTTP 400 hatası döndürülür. Rapor oluştururken hataları önlemek için öncelikle Display & Video 360 kullanıcı arayüzünde yeni raporlar oluşturmanızı öneririz.

Raporunuzu oluşturduktan sonra, Query kaynağının queries.get değerini gerçekleştirmek için referans belgeler sayfasındaki "Bu API'yi deneyin" özelliğini tıklayın. Döndürülen JSON dosyasını kullanarak gelecekteki raporları oluşturabilirsiniz.

Uyarı: Sorgular ve bunlarla ilişkili raporlara, API'de yalnızca sorguları oluşturan kullanıcı erişebilir. API'yi kullanarak sorgu çalıştırma ve rapor alma izni, kullanıcı arayüzünün paylaşım ayarları üzerinden verilemez.

Rapor türüne özgü metrikleri ve filtreleri kullanın

Bazı metrik ve filtre değerleri belirli rapor türlerine özgüdür. Raporlarınızı önce kullanıcı arayüzünde oluşturmanın yanı sıra belirli ReportType değerlerine ait metrik ve filtreleri Bid Manager API değerlerine göre de tanımlayabilirsiniz.

Aşağıda, alakalı Bid Manager API filtresini ve metrik değerlerini belirlemenin bazı yollarını bulabilirsiniz. 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
INVENTORY_AVAILABILITY	FILTER_TRUEVIEW_IAR ön ekine sahip filtreler.
YOUTUBE	FILTER_TRUEVIEW_IAR önekine sahip olanlar hariç, FILTER_TRUEVIEW ön ekine sahip filtreler. METRIC_TRUEVIEW ön ekine sahip metrikler.
GRP	METRIC_GRP ön ekine sahip metrikler.
YOUTUBE_PROGRAMMATIC_GUARANTEED	FILTER_YOUTUBE_PROGRAMMATIC_GUARANTEED ön ekine sahip filtreler. METRIC_PROGRAMMATIC_GUARANTEED ön ekine sahip metrikler.
REACH	METRIC_UNIQUE_REACH ön ekine sahip metrikler.
UNIQUE_REACH_AUDIENCE	METRIC_UNIQUE_REACH ön ekine sahip metrikler.

Raporları kaydetme ve yeniden kullanma

Aynı raporun birden fazla kez eklenmesi ve silinmesi kaynak israfına yol açtığından, düzenli olarak çalıştırdığınız sorgular için raporlar oluşturmanızı ve kaydetmenizi öneririz. dataRange alanında PREVIOUS_DAY veya LAST_7_DAYS gibi grup Range değerlerinin kullanılması raporları daha kullanılabilir hale getirir.

Raporları planlama

Tek seferlik raporlar veya tek seferlik raporlar, ayrı ayrı çalıştırıldığı ve eksik bir veri kümesinde yürütülebileceği için kaynak israfına yol açabilir. Planlanmış raporlar, toplu olarak çalıştırıldıkları ve bir önceki günün verilerinin işlenmesi tamamlanana kadar yürütülmeyeceğinin garanti edildiği için raporlama kaynaklarından en iyi şekilde yararlanır. Ayrıntılar için kullanılabilir planlama alanlarına bakın.

Benzer raporları birleştirme

Farklı reklamverenler veya iş ortakları için düzenli olarak aynı metriklere ve tarih aralıklarına sahip raporlar oluşturuyorsanız rapor hacimlerini optimize etmek için raporları birleştirmenizi öneririz.

Tüm raporların filtrelerini ekleyip tüm filtre türlerini boyut olarak ekleyerek benzer raporları birleştirebilirsiniz. Oluşturulduktan sonra, orijinal raporları oluşturmak için elde edilen raporun satırlarını orijinal filtre değerlerine bölebilirsiniz.

Kota bildirmeyi değerlendirin

Display & Video 360 raporlama özelliğinin sorumlu kullanımı, aşağıdaki ürün genelinde kullanım kotaları aracılığıyla zorunlu kılınır.

Günlük geçici rapor yürütme sayısı

Bir kullanıcının 24 saatlik süre içinde çalıştırabileceği anlık rapor sayısını sınırlar. Bu kotanın altında kalmak için:

• Rapor hacmini azaltmak için benzer raporları birleştirin.
• Özellikle anlık rapor hacmini azaltmak için yinelenen geçici raporlar planlayın.
• Gereksiz API komut dosyalarını devre dışı bırakın.

Etkin planlanmış raporlar

Bir kullanıcının belirli bir zaman için etkin olarak planlayabileceği rapor sayısını sınırlar. Bu kotanın altında kalmak için:

• Programlanan raporların toplam sayısını azaltmak için benzer planlanmış raporları birleştirme.
• Planlanmış gereksiz 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 kotanın altında kalmak için:

• Düzenli olarak çalışan raporlar planlayın.
• Gereksiz API komut dosyalarını devre dışı bırakın.
• Üstel geri yükleme mantığı kullanarak yoklama yaparak raporlarınızın ne zaman tamamlandığını izleyin.

Raporlama uygulamanızı optimize etmenize rağmen yine de size verilen kotanızı aştığınızı fark ederseniz iletişim formunu kullanarak Display & Video 360 destek ekibiyle iletişime geçin.

Rapor durumu için yoklama yaparken eksponansiyel geri yükleme kullan

Bir raporun ne kadar sürede çalıştırılacağını tahmin etmek mümkün değildir. Süre, örneğin tarih aralığı ve işlenecek veri miktarı gibi birçok faktöre bağlı olarak saniyeden birkaç saate kadar değişebilir. Ayrıca, raporun çalışma zamanı ile raporda döndürülen satır sayısı arasında bir bağlantı yoktur. Bu nedenle, rapor kaynağını queries.reports.get yöntemini kullanarak düzenli bir şekilde almanız ve kaynağın metadata.status.state alanının DONE veya FAILED olarak güncellenip güncellenmediğini kontrol etmeniz gerekir. Bu, "anket" olarak bilinen bir süreçtir.

Yoklama gerekli olsa da verimsiz bir uygulama, uzun süreli bir raporla karşılaştığınızda kotanızı hızla tüketebilir. Bu nedenle, yeniden denemeleri sınırlamak ve kotadan tasarruf etmek için eksponansiyel geri yükleme kullanmanızı öneririz.

Eksponansiyel geri yükleme

Üstel geri yükleme, istemcinin artan bir süre içinde isteği düzenli olarak yeniden denediği ağ uygulamaları için standart bir hata işleme stratejisidir. Doğru kullanıldığında üstel geri yükleme özelliği, 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ı ortamlarda isteklerin işleme hızını en üst düzeye çıkarır.

Not: Bu akışta, yokladığınız raporun kimliğine sahip olduğunuz varsayılır. Bir sorgu için en son çalıştırılan raporu yoklamak isterseniz orderBy parametre değerini key.reportId desc kullanarak queries.reports.list yöntemini çağırabilir ve listedeki ilk raporun reportId sürümünü kullanabilirsiniz.

Basit üstel geri yükleme uygulama akışı aşağıdaki gibidir:

1. API'ye bir queries.reports.get isteği gönderin.
2. Rapor nesnesini alın. metadata.status.state alanı DONE veya FAILED değilse bu durum, raporun çalıştırılmadığını gösterir ve yoklamaya devam etmelidir.
3. 5 saniye bekleyin + milisaniye cinsinden rastgele bir sayı belirleyin ve isteği yeniden deneyin.
4. Rapor nesnesini alın. metadata.status.state alanı DONE veya FAILED değilse bu durum, raporun çalıştırılmadığını gösterir ve yoklamaya devam etmelidir.
5. 10 saniye + milisaniye cinsinden rastgele bir sayı bekleyin ve isteği yeniden deneyin.
6. Rapor nesnesini alın. metadata.status.state alanı DONE veya FAILED değilse bu durum, raporun çalıştırılmadığını gösterir ve yoklamaya devam etmelidir.
7. 20 saniye + milisaniye cinsinden rastgele bir sayı bekleyin ve isteği yeniden deneyin.
8. Rapor nesnesini alın. metadata.status.state alanı DONE veya FAILED değilse bu durum, raporun çalıştırılmadığını gösterir ve yoklamaya devam etmelidir.
9. 40 saniye + rastgele bir milisaniye süresince bekleyin ve isteği yeniden deneyin.
10. Rapor nesnesini alın. metadata.status.state alanı DONE veya FAILED değilse bu durum, raporun çalıştırılmadığını gösterir ve yoklamaya devam etmelidir.
11. 80 saniye + milisaniye cinsinden rastgele bir sayı bekleyin ve isteği yeniden deneyin.
12. Rapor nesnesi güncellenene veya geçen maksimum süreye ulaşılana kadar bu kalıbı devam ettirin.

Rapor çalıştırılıyorsa ve DONE durumunda bitiyorsa oluşturulan rapor dosyasını Google Cloud Storage'dan, metadata.googleCloudStoragePath alanında verilen yoldan alabilirsiniz.