Yayıncılar, geliri optimize etmek için genellikle reklam talebi kaynaklarını çeşitlendirir ve sayfadaki belirli bir reklam alanı için en iyi reklamı belirlemek üzere birden fazla şirket (ör. yayıncı reklam sunucuları, arz tarafı platformları ve talep tarafı platformları) çağırır. Başlıktan teklif alma, yayıncıların çeşitli talep kaynaklarından bir reklam alanı için teklif almasına olanak tanır. Sıralı açık artırma kurulumunda, bağlama dayalı verilerle açık artırma yapmak için başlıktan teklif alma kitaplığı, siteler arası verilerle açık artırma yapmak için ise Protected Audience kullanılabilir.
Başlamadan önce açılış sayfasından Korunan Kitle'nin temelleri ve Prebid.js dokümanlarından başlıktan teklif alma hakkında bilgi edinin.
Tanımlar
Açık Artırma
Açık artırma | Tanım |
İçeriğe dayalı açık artırma | Açık artırmanın yürütüldüğü bağlamdaki verileri kullanan bir reklam açık artırması. Bağlamsal açık artırmada başlıktan teklif alma ve sunucu tarafı açık artırmalar gibi birden fazla açık artırma olabilir. |
Protected Audience açık artırması | Başka bir sitede oluşturulan bir ilgi alanı grubu için teklif vermeyi içeren bir reklam açık artırması. |
Protected Audience çok satıcılı açık artırması | İlk olarak birden fazla paralel bileşen açık artırması içeren ve ardından en yüksek puan alan reklamlarını nihai üst düzey açık artırmaya gönderen iki katmanlı bir Protected Audience açık artırması. |
Üst düzey açık artırma | Protected Audience çok satıcılı açık artırması içindeki nihai reklam açık artırması. Bu açık artırma, bileşen açık artırmalarından bileşen açık artırması kazananlarının puanını sağlar. |
Bileşen açık artırması | Her bileşen satıcısının bileşen açık artırmalarını paralel olarak yürüttüğü Protected Audience çok satıcılı açık artırması içindeki iç içe yerleştirilmiş açık artırma. Her bileşen açık artırmasında en yüksek puan alan reklamlar üst düzey açık artırmaya iletilir. |
Sıralı açık artırma ayarı | Bağlamsal açık artırmaları Protected Audience açık artırmasıyla entegre eden ve iki açık artırma arasında bir kazanan belirleyen bir reklam açık artırması kurulumu. |
Katılımcı sayısı
Katılımcı | Tanım |
Reklamveren | Reklam yerleşimi isteyen ve reklam öğesini oluşturan taraf. |
Yayıncı | Açık artırma için reklam envanteri sağlayan taraf. |
Alım sorumlusu | Bir satıcıdan reklam alanı satın almak için açık artırmada teklif veren taraf. Genellikle bir talep tarafı platformu (TTP). |
Yayıncı Reklam Sunucusu | Yayıncıların, sitede oluşturulacak reklamları yönetmek ve seçmek için kullandığı bir hizmet. Yayıncı reklam sunucusu, yayıncıya en fazla geliri sağlayacak reklamı belirlemek için kendi açık artırma sonuçlarını, başlıktan teklif veren yanıtlarını, doğrudan satılan envanteri ve daha fazlasını birleştirebilir.
Yayıncı reklam sunucusu, sunucuyla etkileşim kurmak için istemci tarafı kitaplığı sağlayabilir. |
Üst düzey satıcı | Protected Audience çok satıcılı açık artırmayı çağıran (yani oluşturan) ve üst düzey açık artırmaya katılan taraf. |
Bileşen satıcısı | Yayıncının reklam alanını alıcılara satmak için Protected Audience çok satıcılı açık artırmasında bileşen açık artırması yürüten taraf. Genellikle arz tarafı platformu (STP). |
Sıralı açık artırma ayarı
Sıralı açık artırma ayarlarında önce bağlamsal açık artırmalar, ardından Korunan Kitle açık artırması yürütülür. Bu kurulum, yayıncıların hem sayfada bulunan bağlamsal verilerle açık artırma yaparak hem de kullanıcı gizliliğini korumak için güvenli bir ortamda siteler arası verilerle açık artırma yaparak kazanç potansiyellerini en üst düzeye çıkarmalarına olanak tanır.
Yayıncı reklam sunucusunun içeriğe dayalı açık artırması için teklif toplamak üzere sayfa üzerinde önce bir başlıktan teklif alma kitaplığı yürütülebilir. Ardından, bağlamsal açık artırmanın ayarlanmış kazanan teklif fiyatı, teklif tabanı olarak Korunan Kitle açık artırmasına girilebilir. Puanlama adımı sırasında üst düzey satıcı, istenilirlik puanı hesaplanırken bileşen açık artırma teklifi fiyatlarına sıfır puan atayarak bu fiyatları teklif tabanının altına düşürebilir. Protected Audience bileşeni açık artırma teklifi teklif tabanından yüksek değilse kullanıcıya bağlama dayalı açık artırma kazanan reklam oluşturulur. Protected Audience açık artırması bir kazanan döndürüyorsa teklif tabanının üzerinde olduğu anlamına gelir ve Protected Audience kazanan reklamı kullanıcıya oluşturulur.
Bu sıralı açık artırma kurulumu örneğinde, sayfada sırasıyla üç büyük açık artırma yürütülebilir: 1) Başlık teklifli sistem kitaplığına göre bağlama dayalı açık artırma, 2) Yayıncı reklam sunucusu tarafından bağlama dayalı açık artırma ve 3) Protected Audience açık artırması.

Genel bakış şemasının ayrıntılı açıklaması:
- Kullanıcı, açık artırmadan önce bir reklamveren sitesindeki bir ilgi alanı grubuna eklenir.
- Kullanıcı daha sonra yayıncı sayfasını ziyaret ettiğinde Prebid.js, başlıktan teklif verenlerden teklif yanıtlarını toplamak için bağlamsal bir açık artırma yapar. Bu adımda alıcılar sinyalleri, satıcılar ise sonraki Protected Audience açık artırmasında kullanılacak bileşen açık artırma yapılandırmalarını sağlayabilir. Prebid.js, bu sinyalleri ve yapılandırmaları Protected Audience açık artırmasına yaymak için bir modül sağlar.
- Prebid.js tarafından toplanan teklif yanıtları, sunucu tarafı bağlamsal açık artırma için yayıncı reklam sunucusuna gönderilir.
- Yayıncı reklam sunucusu, yayıncıya en fazla geliri sağlayacak reklamı belirlemek için kendi açık artırma sonuçlarını, başlık teklifi sonuçlarını, doğrudan satılan envanteri ve daha fazlasını birleştirebilir. Kazanan reklam, yayıncı reklam sunucusunun istemci tarafı kitaplığına döndürülür.
- Bağlamsal açık artırma kazananından gelen düzenlenmiş teklif fiyatı, alıcının sinyalleri (
perBuyerSignals
) ve Prebid.js tarafından toplanan satıcının bileşen açık artırma yapılandırmaları, yayıncı reklam sunucusunun istemci tarafı kitaplığı tarafından Protected Audience açık artırmasına iletilebilir. - Protected Audience çok satıcılı açık artırması üst düzey satıcı tarafından yürütülür. Üst düzey satıcı, puanlama adımında her bir bileşen açık artırmasının kazanan teklif fiyatını içeriğe dayalı açık artırma için ayarlanmış kazanan teklif fiyatıyla karşılaştırabilir. Bileşen teklif fiyatı, bağlamsal açık artırma teklif fiyatından düşükse üst düzey satıcı
0
arzu edilirlik puanını döndürür. Tüm teklifler0
olarak puanlanırsarunAdAuction()
çağrısınull
döndürür. Bu, içerikle alakalı açık artırmayı kazanan reklamın oluşturulması gerektiğini gösterir. - Yayıncı reklam sunucusu istemci tarafı kitaplığı,
runAdAuction()
çağrısından döndürülen değere bağlı olarak kazanan Protected Audience reklamını veya içeriğe dayalı reklamı oluşturur. - Kazanan reklam kullanıcıya oluşturulur.
Açık artırma öncesi

Açık artırmadan önce, kullanıcı bir reklamveren sayfasını ziyaret ettiğinde alıcı ve reklamveren, kullanıcının ait olduğu sitenin ilgi alanı grubunu tanımlayabilir ve daha sonra açık artırma için sinyal olarak kullanılacak reklamverenin sitesinden ve birinci taraf verilerinden bağlamsal veriler ekleyebilir.
- Kullanıcı reklamveren sitesine gider.
- Reklamveren sitesi, açık artırmaya katılan her alıcıdan komut dosyasını daha sonra yükler.
- Alıcının komut dosyası, kullanıcıyı alıcının ilgi alanı grubuna eklemek için
joinAdInterestGroup()
çağrısını içerir.
Prebid.js ve yayıncı reklam sunucusuyla bağlama dayalı açık artırmalar

Sıralı açık artırma ayarlarında, tüm bağlamsal açık artırmalar Protected Audience açık artırması çalıştırılmadan önce yürütülür. Bu belgede açıklanan kurulumda, yayıncı reklam sunucusu tarafından sunucu tarafı açık artırmaya beslenen Prebid.js tarafından bir başlıktan teklif alma bağlamsal açık artırması çalıştırırız.
Yayıncı, önce Protected Audience açık artırmasının daha sonra yürütüleceğini belirtmek için Prebid.js'yi bir işaretle çağırarak bir başlıktan teklif alma bağlamsal açık artırması başlatır. Ardından Prebid.js, teklif yanıtlarını toplar ve sunucu tarafı bağlamsal açık artırma için yayıncı reklam sunucusuna gönderir. Teklif yanıtı toplama adımında alıcılar ve satıcılar, katılmak isterlerse sonraki Protected Audience açık artırmasında kullanılacak bileşen açık artırma yapılandırmalarını ve alıcı sinyallerini (perBuyerSignals
) sağlayabilir. Bu bileşen açık artırma yapılandırması, sonunda sonraki Protected Audience açık artırmasına aktarılır.
- Bağlamsal açık artırma başlatma Kullanıcı, yayıncı sayfasını ziyaret eder.
- Yayıncı sayfası, yayıncı reklam sunucusu istemci tarafı kitaplığını yükler ve reklam alanlarını tanımlar.
- Yayıncı sayfası Prebid'i yükler ve başlıktan teklif alma bağlamsal açık artırmasını başlatır.
- Satıcı A'nın bağlama dayalı açık artırması(Satıcı B'nin bağlama dayalı açık artırmasına paralel olarak çalışır). Prebid.js, Satıcı A'ya bir teklif isteği gönderir.
- Satıcı A, alıcılara teklif yanıtlarını ve
perBuyerSignals
öğesini gönderir. - Satıcı A, içeriğe dayalı bir açık artırma gerçekleştirir.
- Satıcı A, bileşen açık artırma yapılandırmasını
perBuyerSignals
dahil ederek oluşturur. - Satıcı A, kazanan teklifi ve bileşen açık artırma yapılandırmasını kullanarak Prebid.js'ye yanıt verir.
- Satıcı B'nin içeriğe dayalı açık artırması (Satıcı A'nın içeriğe dayalı açık artırmasına paralel olarak çalışır). Prebid.js, Satıcı B'ye bir teklif isteği gönderir.
- Satıcı B, teklif yanıtlarını ve
perBuyerSignals
öğesini alıcılardan alır. - Satıcı B, içeriğe dayalı bir açık artırma gerçekleştirir.
- Satıcı B, bileşen açık artırma yapılandırmasını
perBuyerSignals
dahil ederek oluşturur. - Satıcı B, kazanan teklifi ve bileşen açık artırma yapılandırmasını kullanarak Prebid.js'ye yanıt verir.
- Yayıncı reklam sunucusunun bağlama dayalı açık artırması Prebid.js tarafından toplanan teklif yanıtları, bağlama dayalı açık artırma için yayıncı reklam sunucusuna gönderilir.
- Alıcı sinyallerinin bulunduğu bileşen açık artırma yapılandırmaları, yayıncı reklam sunucusunun istemci tarafı kitaplığıyla paylaşılır.
- Yayıncı reklam sunucusu, doğrudan satılan kampanyalar, programatik teklifler, Prebid'in içeriğe dayalı teklifleri ve diğer envanter arasında en iyi reklamı belirlemek için içeriğe dayalı bir açık artırma yürütür.
- Yayıncı reklam sunucusu, ayarlanmış kazanan teklifi döndürür.
Protected Audience çok satıcılı açık artırması

Bu aşamada bağlama dayalı açık artırmalar sona ermiştir ve yayıncı reklam sunucusunun istemci tarafı kitaplığı, bağlama dayalı açık artırmada kazanan düzenlenmiş teklif fiyatını, bileşen açık artırma yapılandırmalarını ve Protected Audience açık artırmasına katılan alıcıların sinyallerini üst düzey satıcıya iletebilir. Taban olarak kullanılan bağlama dayalı açık artırma teklifi fiyatı, üst düzey açık artırmada puanlama için bir sinyal olarak açık artırma yapılandırmasına iletilebilir.
Bileşen açık artırmaları paralel olarak yürütülür ve her bileşen açık artırmasında tarayıcı, söz konusu bileşen açık artırmasına katılan her alıcının teklif verme mantığından teklifler oluşturur, her teklifi bileşen satıcısının puanlama mantığını kullanarak puanlar ve ardından en yüksek puana sahip reklamı üst düzey açık artırmaya döndürür.
- Yayıncı sitesi, üst düzey satıcının komut dosyasını yükler.
- Yayıncı reklam sunucusunun istemci tarafı kitaplığı, alıcılardan üst düzey satıcıya sinyaller içeren içeriğe dayalı açık artırma teklifi fiyatını ve bileşen açık artırma yapılandırmalarını sağlar. Bağlamsal açık artırmada kazanan reklam teklifi fiyatı, açık artırma yapılandırmasına satıcı sinyalleri olarak iletilebilir (bu teklif fiyatı, üst düzey satıcının
scoreAd()
işlevinde kullanılabilir hale gelir). - Üst düzey satıcı,
runAdAuction()
çağrısı yaparak Protected Audience açık artırmasını başlatır. - Satıcı A bileşen açık artırması (Satıcı B'nin bileşen açık artırmasına paralel olarak çalışır). Tarayıcı, Satıcı A'nın bileşen açık artırmasına katılan tüm alıcılar için kullanıcının ilgi alanı gruplarını okur.
- Tarayıcı, teklif verme komut dosyalarını ve güvenilir teklif verme sinyallerini, bileşen açık artırmasına katılan alıcıların ilgi alanı gruplarında belirtilen konumlardan alır.
- Tarayıcı, her alıcının teklif oluşturma mantığını yürüterek teklifleri oluşturur.
- Tarayıcı, her reklamın puanlama komut dosyasını ve güvenilir puanlama sinyallerini Satıcı A'dan alır.
- Tarayıcı, her teklif için Satıcı A'nın puanlama mantığını yürütür.
- Tarayıcı, Satıcı A'nın puanlama mantığı tarafından gönderilen en yüksek puana sahip reklamı seçer.
- Satıcı B'nin bileşen açık artırması (Satıcı A'nın bileşen açık artırmasına paralel olarak çalışır). Tarayıcı, Satıcı B'nin bileşen açık artırmasına katılan tüm alıcılar için kullanıcının ilgi alanı gruplarını okur.
- Tarayıcı, teklif verme komut dosyalarını ve güvenilir teklif verme sinyallerini, bileşen açık artırmasına katılan alıcıların ilgi alanı gruplarında belirtilen konumlardan alır.
- Tarayıcı, her alıcının teklif oluşturma mantığını yürüterek teklifleri oluşturur.
- Tarayıcı, her reklamın puanlama komut dosyasını ve güvenilir puanlama sinyallerini Satıcı B'den alır.
- Tarayıcı, her teklif için Satıcı B'nin puanlama mantığını yürütür.
- Tarayıcı, Satıcı B'nin puanlama mantığı tarafından gönderilen en yüksek puana sahip reklamı seçer.
Üst düzey açık artırma puanlaması ve reklam oluşturma

Önceki bölümdeki bileşen açık artırmaları yürütüldükten sonra tarayıcı, her bileşen açık artırmasının kazanan reklamında üst düzey satıcının puanlama mantığını çalıştırır. Üst düzey satıcının scoreAd()
işlevinde, bağlama dayalı açık artırma düzenlenmiş teklif fiyatı sellerSignals
olarak kullanılabilir ve puanlama mantığı, bu bağlama dayalı açık artırma teklif fiyatını Korunan Kitle bileşeni açık artırmasının kazanan teklif fiyatıyla karşılaştırabilir.
Bağlamsal açık artırmanın kazanan teklif fiyatı, bileşen açık artırmasının kazanan teklif fiyatından yüksekse scoreAd()
işlevi 0
arzu edilirlik puanı döndürebilir. 0
'ten yüksek bir arzu puanı olan reklam yoksa bu, bağlamsal açık artırmanın kazanan reklamının bileşen açık artırmasının kazanan reklamlarından herhangi birinden daha değerli olduğunu gösterir ve runAdAuction()
işlevi null
değerini döndürür.
Protected Audience açık artırmasının kazananı yoksa ve null
döndürülürse yayıncının reklam sunucusu istemci tarafı kitaplığı, bağlama dayalı açık artırma kazananını bir iFrame olarak oluşturabilir. Korunan kitle açık artırması, bağlamsal açık artırmaya karşı kazanan olursa ve bir FencedFrameConfig
nesnesi veya opak URN döndürürse kazanan Korunan Kitle açık artırması reklamı, çitle çevrili bir çerçeve veya bir iFrame olarak oluşturulabilir.
- Üst düzey açık artırma reklamı puanlaması Tarayıcı, puanlama komut dosyasını üst düzey satıcıdan ve her reklamın güvenilir puanlama sinyalleriyle birlikte getirir.
- Tarayıcı, tüm bileşen açık artırmalarının her bir kazanan teklifi için üst düzey satıcının puanlama mantığını yürütür. Üst düzey satıcının
scoreAd()
komut dosyasında mantık, açık artırma yapılandırmasındasellerSignals
olarak iletilmiş olabilecek bağlama dayalı açık artırma düzenlenmiş kazanan teklif fiyatına erişebilir. Komut dosyası, kazanan bağlamsal teklif fiyatını bileşen Korunan Kitle teklif fiyatıyla karşılaştırabilir ve bağlamsal fiyat daha yüksekse 0 değerinde bir arzu puanı döndürebilir. Aksi takdirde komut dosyası, istek puanını büyük olasılıkla bileşen Korunan Kitle teklif fiyatına göre hesaplar. - Tarayıcı, üst düzey satıcının puanlama mantığı tarafından gönderilen en yüksek arzu puanına sahip reklamı seçer.
- Protected Audience açık artırması kazanırsa Protected Audience açık artırması, yayıncının reklam sunucusu istemci tarafı kitaplığına bir
FencedFrameConfig
nesnesi veya opak bir URN döndürür. - İstemci tarafı kitaplığı, çitle çevrili çerçevenin
config
özelliğiniFencedFrameConfig
nesnesine veya iFrame'insrc
özelliğini kazanan Protected Audience reklamının opak URN'sine ayarlar. - Tarayıcı, Protected Audience açık artırmasını kazanan reklamı alıcıdan alır.
- Tarayıcı, reklamı kullanıcıya oluşturur.
- Bağlamsal açık artırma kazanırsa Protected Audience açık artırması
null
değerini döndürür. - Tarayıcı, iframe'ın
src
özelliğini kazanan içeriğe dayalı reklama ayarlar. - Tarayıcı, içeriğe dayalı açık artırmayı kazanan reklamı alıcıdan alır.
- Tarayıcı, reklamı kullanıcıya oluşturur.
Etkileşim kurma ve geri bildirim paylaşma
Sonraki adım
Herkesin yararlanabileceği bir API geliştirdiğimizden emin olmak için sizinle görüşmeler yapmak istiyoruz.
API'yi tartışın
Diğer Özel Korumalı Alan API'lerinde olduğu gibi bu API de belgelenmiş ve herkese açık olarak tartışılmıştır.
API ile deneme yapma
Protected Audience API hakkında denemeler yapabilir ve görüşmelere katılabilirsiniz.