Kota Optimizasyonu

Display & Video 360 API'sini kullanan tüm uygulamalar için kota optimizasyonu zorunludur. Kota kullanımını optimize etmek, API isteklerini kolaylaştırarak ve belirtilen oran sınırlarını aştığınızda döndürülen hatalardan kaçınmanıza yardımcı olarak performansı artırır.

Bu sayfada, genel en iyi uygulamalar ayrıntılı olarak açıklanmakta ve Display & Video 360 API'deki kota kullanımınızı azaltmanıza yardımcı olabilecek ek özellikler vurgulanmaktadır.

Çeşitli reklamverenlere eşzamanlı isteklerde bulunma

Display & Video 360 API'sindeki yöntemlerin çoğu, URL'de bir reklamveren belirtir. Proje genelindeki kotaya ek olarak, aynı reklamvereni belirten çağrılar yapılırken bu yöntemler için daha kısıtlayıcı "reklamveren başına proje başına" ücret sınırları uygulanır.

Bu kota için optimizasyon yapmak istiyorsanız eşzamanlı istekleri farklı reklamverenler belirten isteklerle sınırlayın.

pageSize, filter ve orderBy parametrelerini kullanın

Birden fazla kaynak alırken get yöntemleri yerine list yöntemlerini kullanın. Sayfa boyutuyla ilgili sınırlamalar nedeniyle list çağrıları yine de çok fazla kota tüketebilir.

pageSize parametresini izin verilen maksimum değere ayarlayarak tüm list isteklerinizi optimize edin. Parametre ayarlanmadığında kullanılan bir yöntemin varsayılan sayfa boyutu, izin verilen maksimum değerden daha az olabilir ve eksiksiz bir kaynak listesi almak için daha fazla istek gerekebilir.

Yalnızca tam liste yanıtının bir alt kümesini almanız gerekiyorsa isteğe bağlı filter ve orderBy parametrelerinden yararlanarak kota kullanımını optimize edebilirsiniz.

filter parametresi, list çağrısı tarafından alınan kaynakları, özellikleri belirli ifadelere uyan kaynaklarla kısıtlamanıza olanak tanır. Bu parametre aşağıdakileri alırken kullanışlıdır:

  • Bilinmeyen kimliğe ancak bilinen özelliklere sahip belirli bir kaynak. Belirli bir kaynağı arıyorsanız döndürülen listeyi, istenen kaynağın bilinen özelliklerine göre filtreleyebilirsiniz. Satır öğelerini bilinen bir displayName, reklam öğelerini beklenen creativeType ve envanter kaynaklarını ilgili exchange öğesine göre filtreleme örnekleri verilebilir.
  • İlişkili kaynaklar. Display & Video 360'taki kaynaklar genellikle birbiriyle ilişkilidir. Döndürülen kaynakları, başka bir kaynakla belirli bir ilişkisi olanlarla sınırlamak için filtreleri kullanabilirsiniz. Belirli bir campaignId altındaki tüm kampanya siparişlerini ve bir satır öğesine atanan tüm reklam öğelerini almak buna örnek gösterilebilir.
  • Yalnızca işlem yapılabilir özelliklere sahip kaynaklar. API işlevi, kaynakların durumunu kolayca kontrol etmenize ve programatik olarak yanıt vermenize olanak tanır. Filtreleri kullanarak list çağrılarını yalnızca işlem yapılması gereken kaynakları almak için kullanabilirsiniz. Belirli bir işlem yapılabilir lineItemWarningMessage gösteren tüm satır öğelerini, belirli bir tarih ve saatten sonra güncellenen tüm kampanya siparişlerini veya başarısız approvalStatus içeren tüm reklam öğelerini almak bu işlemlere örnek gösterilebilir.

orderBy parametresi, alınan kaynakları belirli özelliklere göre artan veya azalan düzende sıralamanıza olanak tanır. orderBy, özellikle filter ile birlikte kullanıldığında, belirli bir kaynağı bulmadan önce taranması gereken sayfa sayısını sınırlamak için kullanılabilir. Ayrıca, bir kaynak listesinin üst ve alt sınırlarını kolayca almanızı sağlar. Örneğin, updateTime ölçütüne göre sıralama yaparsanız bir reklamverenin en son güncellenen satır öğelerini veya kampanya siparişlerini hızlıca bulabilirsiniz.

Toplu ve kaynak genelinde işlevleri kullanma

Display & Video 360 API, tek bir istekle çok sayıda işlem yürüten çeşitli toplu ve kaynak genelinde işlevler sunar. Bu tür işlevlere örnek olarak aşağıdakiler verilebilir:

  • Tek bir kanala ait siteleri toplu olarak düzenleme Kanallara binlerce site atanabilir. Bir kanalın site listesini tek tek create veya delete istekleriyle yönetmek yerine, tek bir bulkEdit veya replace isteğiyle birden fazla site ekleyip kaldırmak ya da sırasıyla bir kanalın tüm içeriğini değiştirmek için kullanabilirsiniz.
  • Reklamverenin hedefleme paketinin tamamını yönetme Bir kaynağın hedefleme paketi birden fazla hedefleme türüne atanır. advertisers hizmetindeki listAssignedTargetingOptions ve editAssignedTargetingOptions gibi kaynak düzeyinde hedefleme işlevleri, tek bir istekle birden fazla hedefleme türü arasında hedefleme almanıza, oluşturmanıza ve kaldırmanıza olanak tanır. Bu, reklamverenin hedefleme paketini tek bir istekle ayarlama kota maliyetini azaltır.
  • Birden fazla satır öğesinde aynı hedefleme kısıtlamasını ayarlama. Aynı hedefleme değişikliklerini aynı anda birden fazla satır öğesinde yapmanız gerekiyorsa bu işlem tek bir advertisers.lineItems.bulkEditAssignedTargetingOptions isteğinde bulunarak yapılabilir.
  • Birden fazla satır öğesini etkinleştirme veya duraklatma. Satır öğelerinin yayınlanmaya başlamadan önce oluşturulduktan sonra etkinleştirilmesi gerekir. Hızlı bir şekilde art arda birden fazla satır öğesi oluşturuyorsanız bunların tümünü tek bir advertisers.lineItems.bulkUpdate isteğiyle etkinleştirebilirsiniz. Aynı yöntem, birden fazla satır öğesinin yayınlanmasını durdurmak için bunları duraklatmak amacıyla da kullanılabilir.

Sık kullanılan kimlikleri önbelleğe alma ve kontrol etme

Display & Video 360 API'sindeki birçok işlem, hedefleme seçeneği kimlikleri ve Google kitle kimlikleri gibi API aracılığıyla alınan kaynak kimliklerinin kullanılmasını gerektirir. Kimlikleri her kullanımda API'den almak zorunda kalmamak için bu kimlikleri yerel olarak saklamanızı öneririz.

Ancak bazı kaynakların desteği sonlandırılabilir, silinebilir veya başka bir şekilde kullanılamaz hale getirilebilir. Bu kaynakların kimliklerini kullanmaya çalışmak hata verebilir. Bu nedenle, hâlâ alınabilir durumda olup olmadığını ve beklenen durumda olduğunu onaylamak için uygun get veya filtrelenmiş list yöntemini kullanarak tüm önbelleğe alınmış kimlikleri haftalık olarak kontrol etmenizi öneririz.

Uzun süreli işlemler için eksponansiyel geri yükleme uygulama

SDF indirme görevi gibi uzun süren bir işlemin tamamlanıp tamamlanmadığını kontrol ederken, gönderilen isteklerin sıklığını ve toplam sayısını azaltmak için üstel geri yükleme stratejisi kullanın.

Üçlü erteleme, istemcinin artan bir süre boyunca isteklerini düzenli olarak yeniden denediği ağ uygulamaları için standart bir hata işleme stratejisidir. Doğru şekilde kullanıldığında üstel geri çekilme, 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.

İstemci kitaplıklarıyla uygulanan üssel geri çekme stratejisini SDF indirme kod örneklerimizde bulabilirsiniz. Basit eksponansiyel geri yüklemeyi uygulamayla ilgili adım adım akış aşağıdaki gibidir:

  • API'ye sdfdownloadtasks.operations.get isteği gönderin.
  • İşlem nesnesini alın.
    • done alanı doğru değilse isteği tekrar denemeniz gerekir.
    • 5 saniye ve rastgele bir milisaniye sayısı bekleyip isteği yeniden deneyin.
  • İşlem nesnesini alın.
    • done alanı doğru değilse isteği tekrar denemeniz gerekir.
    • 10 saniye ve rastgele bir milisaniye sayısı kadar bekleyip isteği tekrar deneyin.
  • İşlem nesnesini alın.
    • done alanı doğru değilse isteği tekrar denemeniz gerekir.
    • 20 saniye ve rastgele bir milisaniye sayısı kadar bekleyip isteği yeniden deneyin.
  • İşlem nesnesini alın.
    • done alanı doğru değilse isteği tekrar denemeniz gerekir.
    • 40 saniye ve rastgele bir milisaniye sayısı kadar bekleyip isteği yeniden deneyin.
  • İşlem nesnesini alın.
    • done alanı doğru değilse isteği tekrar denemeniz gerekir.
    • 80 saniye ve rastgele bir milisaniye sayısı kadar bekleyip isteği yeniden deneyin.
  • Sorgu nesnesi güncellenene veya azami süre dolana kadar bu kalıbı sürdürün.