Kota Optimizasyonu

Display & Video 360 API kullanan tüm uygulamalarda kota optimizasyonu zorunludur. Kota kullanımını optimize etmek, API isteklerini kolaylaştırarak ve belirlenen hız sınırları aşıldığında döndürülen hataları önlemenize yardımcı olarak performansı artırır.

Bu sayfada, genel en iyi uygulamalar ayrıntılı bir şekilde anlatılmakta ve Display & Video 360 API'deki kota kullanımınızı azaltabilecek ek özellikler vurgulanmaktadır.

Çeşitli reklamverenlere karşı eşzamanlı isteklerde bulunma

Display & Video 360 API'sindeki yöntemlerin çoğu, URL'de bir reklamvereni belirtir. Aynı reklamvereni belirten çağrılar yapılırken bu yöntemler için proje genelindeki kotaya ek olarak "proje başına reklamveren başına" hız sınırları da uygulanır.

Bu kotayı optimize etmek için eşzamanlı istekleri, farklı reklamverenler belirten isteklerle sınırlayın.

filter ve orderBy parametrelerini kullanın

Birden fazla kaynak alırken get yöntemleri yerine list yöntemlerini kullanın. Ancak list çağrıları, sayfa boyutu sınırlamaları nedeniyle kotanın büyük bir kısmını tüketebilir. Tam liste yanıtının yalnızca 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ıyla alınan kaynakları, özellikleri belirtilen ifadelere uyan kaynaklarla kısıtlamanıza olanak tanır. Bu parametre, şunları almaya çalışırken yararlıdır:

  • Kimliği bilinmiyor ancak bilinen özellikleri olan belirli bir kaynak. Belirli bir kaynağı arıyorsanız döndürülen listeyi istenen kaynağın bilinen özelliklerine göre filtreleyebilirsiniz. Örnek olarak satır öğelerini bilinen bir displayName, reklam öğelerini beklenen creativeType miktarına ve envanter kaynaklarına göre alakalı exchange göre filtre uygulayabilirsiniz.
  • İlişkilendirilmiş kaynaklar. Display & Video 360'taki kaynaklar genellikle birbiriyle ilişkilendirilir. Döndürülen kaynakları başka bir kaynakla belirli bir ilişkisi olanlarla kısıtlamak için filtreleri kullanabilirsiniz. Örnekler arasında belirli bir campaignId altındaki tüm kampanya siparişlerini ve bir satır öğesine atanmış tüm reklam öğelerini almak yer alır.
  • Yalnızca işlem yapılabilir özellikleri olan kaynaklar. API işlevi, kaynakların durumunu kolayca kontrol etmenize ve programatik olarak tepki vermenize olanak tanır. Filtreleri kullanarak, yalnızca bir işlemin gerekli olduğu kaynakları elde etmek için list çağrılarını kullanabilirsiniz. Örneğin, işlem yapılabilir belirli bir lineItemWarningMessage gösteren tüm satır öğelerini, belirli bir tarihten bu yana güncellenen tüm kampanya siparişlerini veya başarısız olan tüm reklam öğelerini alabilirsinizapprovalStatus.

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 aktarılması gereken sayfa sayısını sınırlandırmak için kullanılabilir. Ayrıca kaynak listesinin alt ve üst sınırlarını kolayca edinmenizi sağlar. Örneğin, updateTime ölçütüne göre sıralama yapmak bir reklamverenin en son güncellenen satır öğelerini veya kampanya siparişlerini hızlı bir şekilde bulmanıza olanak tanır.

Toplu ve kaynak genelinde işlevler kullanma

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

  • Tek bir kanala ait siteleri toplu olarak düzenleme. Kanallara atanmış binlerce site olabilir. Bir kanalın site listesini ayrı ayrı create veya delete istekleriyle yönetmek yerine, çok sayıda site ekleyip kaldırmak ya da kanalın tüm içeriğini değiştirmek için tek bir bulkEdit veya replace isteği kullanabilirsiniz.
  • Bir reklamverenin hedefleme paketinin tamamını yönetme. Bir kaynağın hedefleme paketi, birden çok hedefleme türüne atanır. advertisers hizmetindeki listAssignedTargetingOptions ve editAssignedTargetingOptions gibi kaynak düzeyindeki hedefleme işlevleri sayesinde tek bir istekle birden fazla hedefleme türü genelinde hedefleme alabilir, oluşturabilir ve kaldırabilirsiniz. Bu da, bir reklamverenin hedefleme paketini tek bir isteğe ayarlamanın kota maliyetini azaltır.
  • Birden fazla satır öğesinde aynı hedefleme kısıtlamasını ayarlama. Birden fazla satır öğesinde aynı hedefleme değişikliklerini tek seferde yapmanız gerekiyorsa bunu tek bir advertisers.lineItems.bulkEditAssignedTargetingOptions isteği kullanarak yapabilirsiniz.
  • Birden fazla satır öğesini etkinleştirme veya duraklatma. Satır öğeleri oluşturulduktan sonra, yayınlanmaya başlamadan önce etkinleştirilmeleri 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, sunulmalarını durdurmak amacıyla birden fazla satır öğesini duraklatmak için kullanılabilir.

Önbelleğe alın ve düzenli olarak kullanılan kimlikleri kontrol edin

Display & Video 360 API'sindeki birçok işlem, API'nin kendisi üzerinden alınan kaynak kimliklerinin kullanılmasını gerektirir. Bu kimlikler arasında hedefleme seçeneği kimlikleri, Google kitle kimlikleri ve daha fazlası yer alır. Her kullanımda kimlikleri API'den almaktan kaçınmak için bu kimlikleri yerel olarak depolamanızı öneririz.

Ancak bazı kaynaklar kullanımdan kaldırılabilir, silinebilir veya başka bir şekilde kullanılamaz hale getirilebilir. Bu kaynaklar için kimlikleri kullanmaya çalışmak hata döndürebilir. Bu nedenle, önbelleğe alınmış tüm kimliklerin hâlâ alınabilir olduğunu ve beklenen duruma sahip olduğunu onaylamak için uygun get veya filtrelenmiş list yöntemini kullanarak haftalık olarak kontrol etmenizi öneririz.

Uzun süreli işlemler için eksponansiyel geri yükleme uygulayın

SDF indirme görevi gibi uzun süren bir işlemin bitip bitmediğini görmek için yoklama yaparken, gönderilen isteklerin sıklığını ve toplam sayısını azaltmak için üstel geri çekilme stratejisi kullanın.

Üstel geri yükleme, istemcinin istekleri giderek artan bir süre içinde düzenli olarak yeniden denediği ağ uygulamaları için standart bir hata işleme stratejisidir. Doğru kullanıldığında eksponansiyel geri yükleme, 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.

İstemci kitaplıklarında uygulanan eksponansiyel geri yükleme stratejisini SDF indirme kodu örneklerimizde bulabilirsiniz. Basit eksponansiyel geri yüklemenin uygulanmasına dair adım adım akış aşağıdaki gibidir:

  • API'ye bir sdfdownloadtasks.operations.get isteği gönderin.
  • İşlem nesnesini alın.
    • done alanının doğru olmaması isteği yeniden denemeniz gerektiğini gösterir.
    • 5 saniye + milisaniye cinsinden rastgele bir sayı bekledikten sonra isteği yeniden deneyin.
  • İşlem nesnesini alın.
    • done alanının doğru olmaması isteği yeniden denemeniz gerektiğini gösterir.
    • 10 saniye + milisaniye cinsinden rastgele bir sayı bekleyip isteği yeniden deneyin.
  • İşlem nesnesini alın.
    • done alanının doğru olmaması isteği yeniden denemeniz gerektiğini gösterir.
    • 20 saniye + milisaniye cinsinden rastgele bir sayı bekleyip isteği yeniden deneyin.
  • İşlem nesnesini alın.
    • done alanının doğru olmaması isteği yeniden denemeniz gerektiğini gösterir.
    • 40 saniye ile rastgele bir milisaniye süresince bekleyin ve isteği yeniden deneyin.
  • İşlem nesnesini alın.
    • done alanının doğru olmaması isteği yeniden denemeniz gerektiğini gösterir.
    • 80 saniye + milisaniye cinsinden rastgele bir sayı bekleyip isteği yeniden deneyin.
  • Sorgu nesnesi güncellenene veya geçen maksimum süreye ulaşılana kadar bu kalıbı devam ettirin.