Reklam oluşturma

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 AuctionConfigs 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.