Korunan Kitle açık artırması bir reklam adayını döndürdüğünde, iframe içinde reklam oluşturmak için kullanılan opak bir URN veya reklamı sınırlı bir çerçeve içinde oluşturmak için kullanılan bir FencedFrameConfig olarak döndürülebilir.
Bu kılavuzda, özel bir çerçevenin ne olduğu, neden gerekli olduğu ve her iki yöntemden birini kullanarak nasıl reklam oluşturulacağı da açıklanmaktadır. Özel çerçevelere daha ayrıntılı bir bakış için bu kılavuzda veya teklifte daha fazla bilgi bulabilirsiniz.
Kısıtlanmış çerçeve nedir?
Örtülü çerçeve (<fencedframe>), iframe öğesine benzer şekilde yerleştirilmiş içeriğe yönelik bir HTML öğesidir. iframe'lerden farklı olarak, sınırlı bir çerçeve, yerleştirme bağlamıyla paylaşılmadan çerçevenin siteler arası verilere erişebilmesi için yerleştirme bağlamıyla iletişimi kısıtlar. Benzer şekilde, yerleştirme bağlamındaki birinci taraf verileri, sınırlandırılmış çerçeveyle paylaşılamaz.
Örneğin, news.example (yerleştirme bağlamı) tarafından sınırlı bir çerçeveye shoes.example sitesinden bir reklam yerleştirildiğini varsayalım. news.example, shoes.example reklamından veri sızdıramaz ve shoes.example, news.example kaynağından birinci taraf verilerini öğrenemez.
Kısıtlanmış çerçeveler nasıl çalışır?
Kısıtlanmış çerçeveler, gezinme için FencedFrameConfig nesnesini kullanır. Bu nesne, Protected Audience açık artırmasından döndürülebilir. Daha sonra yapılandırma nesnesi, sınırlanmış çerçeve öğesinde config özelliği olarak ayarlanır. Bu, src özelliğine bir URL veya opak URN atanan iframe öğesinden farklıdır. FencedFrameConfig nesnesi salt okunur bir url özelliğine sahiptir. Ancak mevcut kullanım alanları dahili kaynağın gerçek URL'sinin gizlenmesini gerektirdiğinden bu özellik okunurken dizeyi opak döndürür.
Sınırlanmış bir çerçeve, yerleştiriciyle iletişim kurmak için postMessage kullanamaz.
Bununla birlikte, sınırlı bir çerçevede postMessage, sınırlı çerçeve içinde iframe ile kullanılabilir.
Kısıtlanmış çerçeveler, yayıncıdan başka yollarla izole edilir. Yayıncı, sınırlanmış bir çerçevenin içindeki DOM'a erişemez ve sınırlı çerçeve yayıncının DOM'sine erişemez. Ayrıca, yayıncı tarafından herhangi bir değere ayarlanabilen ve gözlemlenebilen name gibi özellikler, sınırlandırılmış çerçevelerde kullanılamaz.
Kısıtlanmış çerçeveler, üst düzey tarama bağlamı (tarayıcı sekmesi gibi) gibi davranır. Belirli kullanım alanlarında (opaque-ads gibi) sınırlı bir çerçeve, siteler arası veriler (ör. Protected Audience API ilgi alanı grubu) içerebilir ancak çerçeve bölümlendirilmemiş depolama alanına veya çerezlere erişemez. opaque-ads sınırıyla ayrılmış bir çerçeve, benzersiz, nonce tabanlı bir çerez ve depolama alanı bölümüne erişebilir.
Özel çerçevelerin özellikleri açıklayıcıda daha ayrıntılı olarak açıklanmıştır.
Kısıtlanmış bir çerçevede reklam oluşturma
AuctionConfig resolveToConfig parametresinin doğru değerine ayarlanması koşuluyla, Korunan Kitle açık artırmasından bir FencedFrameConfig döndürülür:
const frameConfig = await navigator.runAdAuction({
// ...auction configuration
resolveToConfig: true
});
Yapılandırmayı aldıktan sonra, çerçeveyi yapılandırmanın temsil ettiği kaynağa gitmek için sınırlanmış bir çerçevenin config özelliğine atayabilirsiniz.
Chrome'un önceki sürümleri resolveToConfig özelliğini desteklemez. Bu nedenle, gezinmeden önce sözünün bir FencedFrameConfig ile sonuçlandığını onaylamanız gerekir:
if (window.FencedFrameConfig && frameConfig instanceof FencedFrameConfig) {
const frame = document.createElement('fencedframe');
frame.config = frameConfig;
}
iFrame içinde reklam oluşturma
AuctionConfig, resolveToConfig özelliğini açıkça ayarlamazsa veya yanlış değerine ayarlanırsa runAdAuction() opak bir URN döndürür. Bu URN, reklamı oluşturmak için iframe src olarak ayarlanabilir.