Protected Audience API'nin verimli bir şekilde çalışmasını sağlamak herkesin yararınadır:
- Web'de gezinirken sitelerin hızlı yüklenmesini isterler. Bu nedenle geliştiriciler, sitelerin ve yerleştirilmiş reklamlarının yüklenmesi için gerekli olan işlem veya ağ kaynakları gibi sınırlı cihaz kaynaklarını aşırı kullanmamak için Protected Audience API'yi verimli bir şekilde kullanmalıdır.
- Yayıncılar, sitelerinin hızlı yüklenmesini ve kullanıcılara verimli ve duyarlı bir deneyim sunmasını ister. Yayıncılar da gelirlerini en üst düzeye çıkarmak için etkili reklamcılık ister.
- Reklamverenler ve reklam teknolojileri, en iyi hizmeti sunmak için reklamlarının hızlı bir şekilde gösterilmesini ister.
Bu belgede, sitenizin maksimum verimlilikle çalışmasını sağlamak için Protected Audience API uygulamasıyla ilgili bazı en iyi uygulamalar özetlenmektedir.
Alıcı (teklif veren) en iyi uygulamaları
Protected Audience API açık artırma verimliliği için optimizasyon yaptığınızdan emin olmak üzere aşağıdaki en iyi uygulamaları izleyin.
Daha az ilgi grubu sahibi
Tarayıcının, web'deki farklı kaynakları site izolasyonu kullanarak koruduğu şekilde Protected Audience API teklif verenleri korumak için tarayıcı, pahalı kaynaklar (ör. işletim sistemi süreçleri) kullanarak her bir ilgi alanı grubu sahibini korur.
Bu çok pahalı kaynakların harcamasını en aza indirmek için en az sayıda ilgi alanı grubu sahibine sahip olmak çok önemlidir. Çeşitli alt alan adlarına ait farklı ilgi alanları grupları bulundurmaktan kaçının. Örneğin, adtech.example'nın cats.adtech.example ve dogs.adtech.example'ye ait ilgi alanları grupları varsa tarayıcı, teklif verme komut dosyalarını çalıştırmak için muhtemelen iki ayrı işlem kullanır.
Daha az ilgi grubu teklif veriyor
Tarayıcı, alıcının generateBid() komut dosyasını çağırmadan önce önemli kurulum ve hazırlık işlemleri yapmalıdır. Örneğin, yeni ve temiz bir JavaScript yürütme ortamı oluşturmalı, generateBid() kodunu ayrıştırıp yüklemelidir.
- Etkin bir reklam kampanyasının mevcut hedefi olmayan kullanıcıları temsil eden ilgi alanı gruplarının reklam öğesi listeleri boş olmalıdır. Bu, Protected Audience API'nin alakalı reklamlar içermeyen ilgi alanı grupları için
generateBid()yürütmesini engeller. - Benzer ilgi alanları gruplarını birleştirmek,
generateBid()'nın çalıştırılma sayısını azaltır. Bir ilgi alanınınuserBiddingSignalsözelliği, kullanıcıyla ilgili ek meta verileri depolamak için kullanılabilir. Bu nedenle, daha az ilgi alanı, daha az etkili hedefleme anlamına gelmez. - Protected Audience API, satıcı tarafından belirtilen ilgi alanı grubu sayısıyla ilgili sınırları ve alıcıların ilgi alanı gruplarının göreceli önceliğini belirtebileceği bir API'yi destekler. Bu sınırlar, çalıştırılacak teklif verme komut dosyalarının sayısını önemli ölçüde azaltmak için kullanılabilir.
Anahtar/değer hizmetinizde teklif vermeden ilgi alanları gruplarını filtreleme
Bir alıcı, belirli ilgi alanlarının teklif vermemesi gerektiğini (ör. kampanya devre dışı, duraklatılmış veya bütçe dışı ya da bu yayıncıya teklif vermemeli) gerçek zamanlı güvenilir teklif sinyali sunucusunda belirleyebiliyorsa güvenilir teklif sinyalleri getirme işlemine priorityVector yanıtıyla bunu tarayıcıya bildirebilir. priorityVector ve prioritySignals'nin sonuçtaki seyrek nokta çarpımı negatifse tarayıcı, bu ilgi alanı grubu için generateBid()'yi çağırmayı atlar. Bu mekanizma hakkında daha fazla bilgiyi açıklayıcı belgenin "İlgi Gruplarını Filtreleme ve Önceliklendirme" bölümünde bulabilirsiniz.
JavaScript yürütme ortamını yeniden kullanma
Tarayıcının generateBid() kodunu yürütebilmesi için yeni bir JavaScript yürütme ortamı başlatması gerekir. Bu işlem, minimum düzeyde bir generateBid()'nın yürütülmesi kadar uzun sürebilir. Bu süre, group-by-origin veya frozen-context yürütme modları kullanılarak kısaltılabilir.
group-by-origin modu, ilgi alan gruplarının aynı kaynakta birleştirildiği durumlarda yürütme ortamlarını yeniden kullanabilir ve teklif komut dosyanızda değişiklik yapılması gerekmeyebilir. Daha fazla bilgi edinmek için açıklayıcıdaki group-by-origin açıklamasına bakın. Dondurulmuş bağlam modu, yürütme ortamlarının neredeyse tamamını yeniden kullanabilir ancak teklif verme komut dosyanızda değişiklik yapılması gerekebilir. Daha fazla bilgi edinmek için açıklamadaki frozen-context açıklamasını inceleyin.
Teklif verme komut dosyalarını yeniden kullanma
Mümkünse ilgi alanlarına göre gruplar için aynı teklif verme komut dosyasını kullanın. Bu, tarayıcının birden fazla komut dosyasını indirmesini, ayrıştırmasını ve derlemesini (bu da ek ağ isteklerine neden olur) önler. Teklif verenler, aynı komut dosyasını kullanırken tekliflerini ilgi alanı grubu bilgilerine (ör. name veya userBiddingSignals) göre farklılaştırmaya devam edebilir.
HTTP önbellek kontrolü üstbilgileri olmadan teklif verme komut dosyası önbelleğe alınmaz. Komut dosyasının gereksiz yere getirilmemesi için uygun başlıkları belirtin. Sayfada paralel olarak çalışan birden fazla açık artırma varsa aynı teklif verenin teklif komut dosyası, önbelleğe alma semantiği göz ardı edilerek zaten bellekteyse yeniden kullanılır. Açık artırmalar sırayla çalıştırılırsa tarayıcı, HTTP önbelleğe alma mekanizmasına uyar.
Tarayıcının, teklif verme süresi (generateBid() için) ve raporlama süresi (reportWin() için) boyunca teklif verme komut dosyasını yüklediğini unutmayın. Önbellek kontrolü başlıkları ayarlanmamışsa tarayıcı, her dönem için aynı komut dosyasını iki kez getirir.
Bu nedenle, tüm komut dosyalarınızda önbellek kontrolü üstbilgileri ayarlamanızı öneririz.
Yeniden kullan trustedBiddingSignalsUrls
Ağ gecikmesi ve kaynak kullanımı çok önemli olabilir. Daha az sayıda gerçek zamanlı güvenilir teklif sinyali getirme işlemi, bu gecikmeyi azaltmaya yardımcı olabilir.
trustedBiddingSignalsUrl birden fazla ilgi alanı grubu arasında yeniden kullanıldığında güvenilir teklif sinyali getirme işlemleri birleştirilebilir.
Mümkün olduğunda tüm ilgi alanları grupları için aynı trustedBiddingSignalsUrl kullanın.
Güvenilir teklif sinyali getirmelerinin belirli bir web sayfasındaki reklam alanlarında önbelleğe alınmasını sağlamak için uygun HTTP önbellek kontrolü üstbilgilerini belirtin. trustedBiddingSignalsSlotSizeMode değerini slot-size olarak ayarlamayın. Bu durumda, istenen URL farklı olacağından yuvaların boyutları farklı olduğunda reklam yuvaları arasında önbelleğe alma işlemi engellenir.
Daha küçük gerçek zamanlı güvenilir teklif verme sinyali getirme işlemleri
Ağ gecikmesi çok önemli olabilir ve bu durum, gerçek zamanlı güvenilen teklif sinyali getirme işlemleri sırasında ne kadar veri aktarıldığından doğrudan etkilenir.
Reklama özel veya ilgi alanına özel verilerin, anlık güvenilir teklif sinyali hizmetinde değil, ilgi alanında depolanması tercih edilir. Gerçek zamanlı güvenilir teklif sinyali verilerini yalnızca kampanya bütçesi veya kapatma anahtarları gibi gerçekten anlık sinyaller için ayırın.
Günlük veya daha uzun aralıklarla güncellenebilen tüm sinyaller ilgi alanları grubunda saklanmalı ve günlük güncellemeler kullanılarak güncellenmelidir.
"İlgi alanı gruplarını anahtar/değer hizmetinizde teklif vermenin dışında tutma" bölümünde açıklandığı şekilde filtrelenen ilgi alanı grupları için güvenilir teklif sinyalleri döndürmeyin.
İlgi gruplarına öncelik verme
Satıcılar, tarayıcı kaynaklarının yayıncı sayfalarında nasıl kullanılacağını sınırlamak için zaman aşımlarını kullanır. Satın alma uzmanlarının güvenilir teklif sinyallerini getirmesi ve teklif verme komut dosyalarını yürütmesi için gereken süreyi sınırlamak üzere perBuyerCumulativeTimeouts kullanıldığında, satın alma uzmanlarının ilgi alanlarına göre gruplandırmayı önceliklendirmesi ve böylece açık artırmayı kazanma olasılığı en yüksek olanların önce yürütülmesini sağlaması kritik önem taşır. Örneğin, perBuyerCumulativeTimeouts 100 ms olarak ayarlanmışsa ve bir teklif verenin güvenilir teklif sinyalleri getirme işlemi 50 ms sürüyorsa, her generateBid() çağrısı 10 ms sürüyorsa ve bir cihazda 10 ilgi alanı grubu varsa yalnızca ilgi alanı gruplarının yarısı teklif hesaplama şansına sahip olur. Bu örnekteki alıcı, ilgi alanlarını kazanma olasılığı en yüksek olandan en düşük olana doğru sıralamalıdır.
İlgi grupları, priority alanıyla tanımlanan statik öncelikler içerebilir. İlgi alanları grupları, güvenilir teklif sinyalleri hizmetlerinde hesaplanabilen ve güvenilir teklif sinyalleri getirme işlemine verilen priorityVector yanıtıyla tarayıcıya döndürülebilen dinamik öncelikler de kullanabilir.
Tarayıcı, ilgi alanları gruplarını en yüksek öncelikten en düşüğe doğru çalıştırdığında farklı birleştirme kaynaklarından gelen ilgi alanları gruplarının araya girebileceğini ve bunun da group-by-origin optimizasyonunu engelleyebileceğini unutmayın.
Satıcılarla ilgili en iyi uygulamalar
Protected Audience API açık artırma verimliliğini izlediğinizden ve bu verimlilik için optimizasyon yaptığınızdan emin olun.
Açık artırmaları paralel hale getirme
Modern ağ bağlantıları ve çok çekirdekli işlemciler, birden fazla etkinliği aynı anda gerçekleştirme konusunda oldukça başarılıdır. Tarayıcı, diğer etkinliklerle paralel olarak bir Protected Audience açık artırması yürütebilir. Bu işlem, runAdAuction()'ı mümkün olduğunca erken arayarak en iyi şekilde kolaylaştırılabilir. runAdAuction()'ya yapılan bazı girişlerin (ör. bağlamsal yanıtta tarayıcıya geri gönderilenler) başlangıçta kullanılamayabileceğinin farkında olan tarayıcı, bu girişler kullanıma sunulmadan önce runAdAution()'ın çağrılmasına ve JavaScript Promises kullanılarak daha sonra sağlanmasına olanak tanır. Mümkün olan en düşük açık artırma gecikmesini elde etmek için interestGroupBuyers girişi bilindiğinde runAdAuction() çağrılmalıdır. Bu, açık artırmanın birçok bölümünün (teklif verenin gerçek zamanlı teklif verme sinyallerinin getirilmesi dahil) hemen başlamasına olanak tanır.
Açık artırmalarınızı izleme
Açık artırmalarınızla ilgili metrikleri toplayın. Tarayıcı, satıcıların açık artırmalarında zamanın nasıl harcandığı hakkında çok fazla bilgi sağlayan gecikme metriklerini per-buyer satıcılara bildirebilir. Satıcılar, bu metrikleri kullanarak açık artırmalarını optimize etmenin yollarını arayabilir. Örneğin, zaman aşımlarını en etkili şekilde nasıl ayarlayacakları hakkında bilgi edinebilirler. Satıcılar, daha fazla optimizasyon yapabilmeleri için belirli bir alıcının gecikme metriklerini alıcıyla paylaşabilir.
Teklif verenler, kendi ilgi alanları gruplarının teklif performansıyla ilgili analizlere sahip olabilir ancak bunu diğer teklif verenlerle karşılaştıramayabilir. Farklı teklif verenler için göreceli kazanma oranları ve teklif reddetme oranlarını karşılaştırmak, teklif verme işlemine yönelik bilgi işlem kaynaklarının, ilgi alanları gruplarının hiçbir zaman uygun teklifler oluşturmaması veya onaylanmamış reklam öğeleriyle aşırı teklif verme nedeniyle boşa harcandığı durumların belirlenmesine yardımcı olabilir.
Yavaş teklif komut dosyalarına karşı koruma
Çok uzun süren teklif verme komut dosyaları, Protected Audience API açık artırmasını ilgili herkes için yavaşlatabilir. Zaman aşımlarını kullanmak, açık artırma yavaş olduğunda geliri kurtarmaya devam ederken yavaş açık artırmaları önleyebilir.
Satıcılar, yavaş açık artırmaları önlemek ve açık artırma yavaşlayıp zaman aşımına ulaştığında teklifleri kabul etmeye devam etmek için perBuyerCumulativeTimeouts kullanmalıdır. perBuyerCumulativeTimeouts, ilgi alanı grubu sayısı veya generateBid() hızı konusunda fikir belirtmediği için (ör. hızlı teklif veren çok sayıda ilgi alanı grubu ve yavaş teklif veren az sayıda ilgi alanı grubu, zaman aşımı süresi dolmadan tamamlanabilir) perBuyerTimeouts ve perBuyerGroupLimits yerine perBuyerCumulativeTimeouts kullanmak tercih edilir.
Güvenilir puanlama sinyallerinin getirilmesi ve scoreAd() yürütülmesinin çok uzun sürdüğü durumlarda aşırı uzun açık artırmaları önlemek için genel bir açık artırma zaman aşımı uygulamak üzere açık artırma yapılandırması signal alanını kullanmak da iyi bir fikirdir.
Sonraki adım
Herkesin yararlanabileceği bir API geliştirdiğimizden emin olmak için sizinle görüşmeler yapmak istiyoruz.
API'yi tartışın
Diğer Özel Korumalı Alan API'lerinde olduğu gibi bu API de belgelenmiş ve herkese açık olarak tartışılmıştır.
API ile deneme yapma
Protected Audience API hakkında denemeler yapabilir ve görüşmelere katılabilirsiniz.