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.