Protected Audience API'nin verimli bir şekilde çalıştığından emin olmak herkesin yararınadır:
- Web'de gezinen kullanıcılar sitelerin hızlı yüklenmesini ister. Bu, geliştiricilerin siteleri ve yerleşik reklamlarını yüklemek için gereken sınırlı cihaz kaynaklarını (ör. bilgi işlem veya ağ kaynakları) aşırı kullanmamak amacıyla Protected Audience API ile verimli bir şekilde geliştirme yapması gerektiği anlamına gelir.
- 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 istiyor.
- Reklamverenler ve reklam teknolojileri, en iyi faydayı sağlamak için reklamlarının hızlı bir şekilde gösterilmesini ister.
Bu dokümanda, sitenizin maksimum verimlilikle çalıştığından emin olmak için Protected Audience API'nin uygulanmasıyla ilgili bazı en iyi uygulamalar özetlenmiştir.
Alıcı (teklif veren) ile ilgili 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ı, Protected Audience API teklif verenlerini site izolasyonu kullanarak web'deki farklı kaynaklarını koruduğu gibi korur. Tarayıcı, ilgi alanı grubu sahiplerinin her birini korumak için pahalı kaynaklar (ör. işletim sistemi işlemleri) kullanır.
Bu çok pahalı kaynakların harcamalarını en aza indirmek için en az sayıda ilgi alanı grubu sahibine sahip olmak çok önemlidir. Farklı alt alan adlarına ait farklı ilgi alanı grupları bulundurmaktan kaçının. Örneğin, adtech.example cats.adtech.example ve dogs.adtech.example'ye ait ilgi alanı gruplarına sahipse tarayıcı, teklif verme komut dosyalarını çalıştırmak için büyük olasılıkla iki ayrı işlem kullanır.
Teklif veren daha az ilgi alanı grubu
Tarayıcı, bir alıcının generateBid() komut dosyasını çağırmadan önce önemli kurulum ve hazırlık işlemleri yapmalıdır (ör. yeni ve temiz bir JavaScript yürütme ortamı oluşturma, generateBid() kodunu ayrıştırma ve yükleme).
- 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ı olmayan ilgi alanı grupları için
generateBid()'ü yürütmesini engeller. - Benzer ilgi alanı gruplarını birleştirmek,
generateBid()'ün çalıştırılma sayısını azaltır. İlgi alanı grubununuserBiddingSignalsmülkü, kullanıcıyla ilgili ek meta verileri depolamak için kullanılabilir. Bu nedenle, daha az ilgi alanı grubunun daha az etkili hedefleme anlamına gelmesi gerekmez. - Protected Audience API, ilgi alanı grubu sayısıyla ilgili satıcı tarafından belirtilen sınırları ve alıcıların ilgi alanı gruplarının göreceli önceliğini belirtmeleri için bir API'yi destekler. Bu sınırlar, çalıştırılacak teklifli sistem komut dosyalarının sayısını önemli ölçüde azaltmak için kullanılabilir.
Anahtar/değer hizmetinizde ilgi alanı gruplarını tekliften filtreleme
Bir alıcı, gerçek zamanlı güvenilir teklif sinyalleri sunucusunda belirli ilgi alanı gruplarının teklif vermemesi gerektiğini belirleyebilirse (ör. kampanya devre dışı, duraklatılmış veya bütçe aşılmıştır ya da belirli bir yayıncı için teklif verilmemelidir) güvenilir teklif sinyalleri getirme işlemine verilen priorityVector yanıtıyla bunu tarayıcıya gösterebilir. priorityVector ve prioritySignals'nin elde edilen seyrek nokta çarpımı negatifse tarayıcı, bu ilgi alanı grubu için generateBid() çağrısını atlar. Bu mekanizma hakkında daha fazla bilgiyi açıklamanın "İlgi Alanı Gruplarını Filtreleme ve Önceliklendirme" bölümünde bulabilirsiniz.
JavaScript yürütme ortamını yeniden kullanma
Tarayıcı, generateBid()'ü yürütebilmek için yeni bir JavaScript yürütme ortamı başlatmalıdır. Bu işlem, minimum generateBid()'ün yürütülmesinin gerektirdiği süreyle aynı düzeyde önemli bir zaman alabilir. Bu süre, kaynak grubuna göre gruplandırma veya dondurulmuş bağlam yürütme modları kullanılarak azaltılabilir.
group-by-origin modu, ilgi alanı gruplarının aynı kaynakta birleştirildiği durumlarda yürütme ortamlarını yeniden kullanabilir ve muhtemelen teklif verme komut dosyanızda değişiklik yapılmasını gerektirmez. Daha fazla bilgi edinmek için açıklama bölümündeki group-by-origin açıklamasına bakın. Dondurulmuş bağlam modu, tüm yürütme ortamlarını yeniden kullanabilir ancak teklif verme komut dosyanızda değişiklik yapılması gerekebilir. Daha fazla bilgi edinmek için açıklama bölümündeki frozen-context açıklamasına bakın.
Teklif verme komut dosyalarını yeniden kullanma
Mümkünse ilgi alanı grupları için aynı teklif verme komut dosyasını kullanın. Bu sayede tarayıcı birden fazla komut dosyasını indirmek, ayrıştırmak ve derlemek zorunda kalmaz (bu da ek ağ istekleri oluşturur). Teklif verenler, aynı komut dosyasını kullanırken teklifleri ilgi alanı grubu bilgilerine (ör. name veya userBiddingSignals) göre ayırt etmeye devam edebilir.
HTTP önbellek kontrolü üstbilgileri olmadan teklif verme komut dosyası önbelleğe alınmaz. Komut dosyasının gereksiz yere getirilmediğinden emin olmak için uygun üstbilgileri belirtin. Sayfada paralel olarak çalışan birden fazla açık artırma varsa aynı teklif verenin teklif verme komut dosyası, bellekte zaten mevcutsa önbelleğe alma semantikleri yoksayılarak 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. Önbelleğe alma denetimi üstbilgileri ayarlanmamışsa tarayıcı, her zaman dilimi için bir kez olmak üzere aynı komut dosyasını iki kez getirir.
Bu nedenle, tüm komut dosyalarınızda önbellek kontrol üstbilgilerini ayarlamanızı öneririz.
trustedBiddingSignalsUrls öğesini yeniden kullanma
Ağ gecikmesi ve kaynak kullanımı çok önemli olabilir. Daha az sayıda anlık güvenilir teklif sinyalleri getirme işlemi, bu gecikmeyi azaltmaya yardımcı olabilir.
trustedBiddingSignalsUrl birden fazla ilgi alanı grubu arasında yeniden kullanıldığında güvenilir teklif sinyallerini getirme işlemleri birleştirilebilir.
Mümkün olduğunda tüm ilgi alanı grupları için aynı trustedBiddingSignalsUrl değerini kullanın.
Güvenilir teklif sinyallerinin belirli bir web sayfasındaki reklam alanlarında önbelleğe alınmasını sağlamak için uygun HTTP önbelleği kontrol üstbilgilerini belirtin. İstekte bulunulan URL farklı olduğunda, reklam alanlarının boyutları farklı olduğunda reklam alanlarında önbelleğe alma işlemini önleyeceğinden trustedBiddingSignalsSlotSizeMode değerini slot-size olarak ayarlamamaya çalışın.
Daha küçük gerçek zamanlı güvenilir teklif verme sinyalleri getirme
Ağ gecikmesi çok önemli olabilir ve bu durum, gerçek zamanlı güvenilir teklif sinyalleri getirilirken ne kadar veri aktarıldığına bağlı olarak doğrudan etkilenir.
Reklamlara veya ilgi alanı gruplarına özgü verileri anlık güvenilir teklif verme sinyali hizmetinde değil, ilgi alanı grubunda saklamayı tercih edin. Gerçek zamanlı güvenilir teklif sinyalleri verilerini yalnızca kampanya bütçesi veya devre dışı bırakma anahtarları gibi gerçek anlamda gerçek zamanlı sinyaller için ayırın.
Günlük veya daha uzun aralıklarla güncellenebilen tüm sinyaller, ilgi alanı grubunda depolanmalı ve günlük güncellemeler kullanılarak güncellenmelidir.
"Anahtar/Değer hizmetinizde teklif vermeden ilgi alanı gruplarını filtreleme" 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ıldığını sınırlamak için zaman aşımlarını kullanır. Satın alma uzmanlarının güvenilir teklif sinyallerini getirmeleri ve teklif komut dosyalarını yürütmeleri için gereken süreyi sınırlamak amacıyla perBuyerCumulativeTimeouts kullanıldığında, satın alma uzmanlarının açık artırmayı kazanma olasılığı en yüksek olanın önce yürütülmesi için ilgi alanı gruplarına öncelik vermeleri çok önemlidir. Örneğin, perBuyerCumulativeTimeouts 100 ms olarak ayarlanırsa ve bir teklif verenin güvenilir teklif sinyalleri getirme işlemi 50 ms sürerse, her generateBid() çağrısı 10 ms sürerse ve cihazda 10 ilgi alanı grubu varsa ilgi alanı gruplarının yalnızca yarısının teklifleri hesaplama şansı olur. Bu örnekteki alıcı, ilgi alanı gruplarına kazanma olasılığı en yüksekten en düşüke doğru öncelik vermelidir.
İlgi alanı grupları, priority alanlarıyla tanımlanan statik öncelikler içerebilir. İlgi alanı 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 öncelikleri de kullanabilir.
Tarayıcı, ilgi alanı gruplarını en yüksek öncelikten en düşük önceliğe göre yürüttüğünde farklı birleştirme kaynaklarından gelen ilgi alanı gruplarının birbirine karışabileceğini ve bu durumun group-by-origin optimizasyonunu bozabileceğini unutmayın.
Satıcılarla ilgili en iyi uygulamalar
Protected Audience API açık artırma verimliliğini izleyerek optimize ettiğinizden emin olun.
Açık artırmaları paralelleştirme
Modern ağ bağlantıları ve çok çekirdekli işlemciler, aynı anda birden fazla işlem gerçekleştirme konusunda mükemmel bir performans gösterir. Tarayıcı, diğer etkinliklerle paralel olarak Protected Audience açık artırması yürütebilir. Bu işlemi en iyi şekilde gerçekleştirmek için runAdAuction() çağrısını olabildiğince erken yapmanız gerekir. runAdAuction()'e gönderilen bazı girişlerin (ör. bağlamsal yanıtta tarayıcıya geri gönderilenler) erken aşamada kullanılamayabileceğini bilen tarayıcı, runAdAution()'un kullanılabilir hale gelmeden önce çağrılmasına ve bu girişlerin JavaScript Promises kullanılarak daha sonra sağlanmasına izin verir. 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, teklif verenin gerçek zamanlı teklif verme sinyallerini getirme de dahil olmak üzere açık artırmanın birçok bölümünün hemen başlamasına olanak tanır.
Açık artırmalarınızı izleme
Açık artırmalarınızla ilgili metrikler toplayın. Tarayıcı, satıcılara per-buyergecikme metriklerini bildirebilir. Bu metrikler, satıcının açık artırmalarında ne kadar süre harcandığını anlamanıza yardımcı olur. Satıcılar, açık artırmalarını optimize etmenin yollarını aramak için bu metrikleri kullanabilir. Örneğin, zaman aşımlarını en etkili şekilde nasıl ayarlayabileceklerini öğrenebilirler. Satıcılar, daha fazla optimizasyon yapmalarına yardımcı olmak için belirli bir alıcının gecikmeli metriklerini alıcıyla paylaşabilir.
Teklif verenler, kendi ilgi alanı 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 kazanç oranlarını ve teklif reddetme oranlarını karşılaştırmak, ilgi alanı gruplarının hiçbir zaman uygun teklifler üretmemesi veya onaylanmamış reklam öğeleriyle aşırı teklif verme nedeniyle teklif hesaplama kaynaklarının israf edildiği durumları belirlemeye yardımcı olabilir.
Yavaş teklif komut dosyalarına karşı koruma
Çok fazla zaman alan teklif verme komut dosyaları, Protected Audience API açık artırmasını ilgili herkes için yavaşlatabilir. Zaman aşımı kullanmak, açık artırma yavaş olduğunda geliri kurtarırken açık artırmanın yavaşlamasını önleyebilir.
Satıcılar, açık artırmaların yavaşlamasını önlemek ve açık artırma yavaş olduğunda ve zaman aşımına ulaştığında teklifleri kabul etmeye devam etmek için perBuyerCumulativeTimeouts değerini kullanmalıdır. perBuyerCumulativeTimeouts, ilgi alanı gruplarının sayısı veya generateBid()'in hızı hakkında fikir beyan etmediği için perBuyerTimeouts ve perBuyerGroupLimits'e kıyasla tercih edilir (ör. hızlı teklif veren birçok ilgi alanı grubu ve yavaş teklif veren az sayıda ilgi alanı grubu, zaman aşımından önce tamamlanabilir).perBuyerCumulativeTimeouts
Güvenilir puanlama sinyalinin getirilmesi ve scoreAd()'ın yürütülmesinin çok fazla zaman aldığı durumlarda, genel bir açık artırma zaman aşımı uygulamak için açık artırma yapılandırması signal alanını kullanmak da aşırı uzun açık artırmaları önlemek için iyi bir fikirdir.
后续操作
我们希望与您交流，确保我们构建适合所有人的 API。
讨论 API
与其他 Privacy Sandbox API 一样，此 API 也会记录在案并公开讨论。
使用 API 进行实验
您可以进行实验并参与有关 Protected Audience API 的对话。