Protected Audience açık artırması, bir reklam adayı döndürdüğünde
iframe
içinde reklam oluşturmak için kullanılan opak bir URN olarak döndürülür.
FencedFrameConfig
, reklamı çitli bir çerçevede oluşturmak için kullanılır.
Bu kılavuzda, sınırlanmış çerçevenin ne olduğu, neden gerekli olduğu ve iki yöntemden biriyle reklamın nasıl oluşturulacağını da öğreneceksiniz. Çitlerle ilgili daha ayrıntılı bilgi için bu kılavuzda veya teklifte daha fazla bilgi bulabilirsiniz.
Çitli çerçeve nedir?
Sınırla çevrili çerçeve (<fencedframe>
), yerleştirilmiş içerik için kullanılan bir HTML öğesidir.
iframe
ile benzer. iframe
ürününün aksine, sınırlanmış bir çerçeve iletişimi kısıtlar
olmadan, çerçevenin siteler arası verilere erişmesine olanak tanımak için yerleştirme bağlamıyla birlikte
yerleştirme bağlamıyla
paylaşabilirsiniz. Benzer şekilde,
yerleştirme bağlamı, sınırlanmış çerçeveyle paylaşılamaz.
Örneğin, news.example
(yerleştirme bağlamı) öğesinin
Sınırla çevrili bir çerçevede shoes.example
. news.example
, şuradan veri çalamaz:
shoes.example
reklamı; shoes.example
diğer kaynaklardan birinci taraf verilerini öğrenemez
news.example
Çitli çerçeveler nasıl çalışır?
Özel çerçeveler, gezinme için FencedFrameConfig
nesnesini kullanır. Bu nesne
Protected Audience açık artırmasından döndürülür. Ardından, config nesnesi şu şekilde ayarlanır:
sınırlanmış çerçeve öğesinde config
özelliği. Bu, iframe
cihazından farklıdır
burada src
özelliğine bir URL veya opak URN atanır. İlgili içeriği oluşturmak için kullanılan
FencedFrameConfig
nesnesi salt okunur url
özelliğine sahip; Ancak
mevcut kullanım alanları, dahili kaynağın gerçek URL'sinin gizlenmesini gerektirir.
bu özellik, okunduğunda opak dizesini döndürür.
Sınırla çevrili bir çerçeve, yerleşik oluşturucuyla iletişim kurmak için postMessage
öğesini kullanamaz.
Ancak sınırlanmış bir kare, postMessage
öğesini içinde iframe
ile kullanabilir
sınırlı çerçeve.
Kısıtlanmış çerçeveler yayıncıdan başka yöntemlerle izole edilir. Yayıncı
bir sınırla ayrılmış çerçevenin içindeki DOM'ye ve
yayıncının DOM'sine erişemez. Ayrıca,name
yayıncı tarafından belirlenen ve gözlemlenen herhangi bir değere ayarlanmamalı, sınırlı
çerçeveler.
Kısıtlanmış çerçeveler üst düzey göz atma bağlamı (ör. tarayıcı
sekmesi). Belirli kullanım alanlarında (opaque-ads
gibi) sınırlanmış bir çerçeve olsa da
Siteler arası veriler (ör. Protected Audience API ilgi alanı grubu) içerebilir.
çerçeve, bölümlendirilmemiş depolama alanına veya çerezlere erişemez. Çitli opaque-ads
çerçevenin benzersiz, tekil olmayan bir çereze ve depolama alanı bölümüne erişebilir.
Çitli çerçevelerin özellikleri açıklayıcıda daha ayrıntılı olarak açıklanmıştır.
Sınırla çevrili bir çerçevede reklam oluşturun
FencedFrameConfig
, sağlanan bir Protected Audience açık artırmasından döndürülür
AuctionConfig
s resolveToConfig
parametresinin "doğru" olarak ayarlandığından emin olun:
const frameConfig = await navigator.runAdAuction({
// ...auction configuration
resolveToConfig: true
});
Yapılandırmayı aldıktan sonra, özel çerçeveli bir karenin config
öğesine atayabilirsiniz
özelliğini kullanın.
Chrome'un önceki sürümleri resolveToConfig
özelliğini desteklemediğinden
yine de sözün daha önce FencedFrameConfig
navigasyon:
if (window.FencedFrameConfig && frameConfig instanceof FencedFrameConfig) {
const frame = document.createElement('fencedframe');
frame.config = frameConfig;
}
iframe'de reklam oluşturma
AuctionConfig
, resolveToConfig
özelliğini açıkça ayarlamazsa veya ayarlanırsa
ise runAdAuction()
, opak bir URN döndürür. Bu URN,
Reklamı oluşturmak için iframe
src
parametresi.