Başlıktan teklif alma (header bidding) ve çok satıcılı Korunan Kitle açık artırması ile sıralı açık artırma kurulumu

Yayıncılar genellikle gelir için optimizasyon yapmak amacıyla reklam talep kaynaklarını çeşitlendirir ve sayfadaki belirli bir reklam alanı için en iyi reklamı belirlemek amacıyla birden çok şirketi (örneğin, yayıncı reklam sunucuları, arz tarafı platformları ve talep tarafı platformları) çağırır. Başlıktan teklif alma (header bidding), yayıncıların çeşitli talep kaynaklarından reklam alanı için teklifler yakalamasına olanak tanır. Sıralı açık artırma ayarlarında başlıktan teklif alma (header bidding) kitaplığı, içerik verileri içeren bir açık artırma yürütmek için, Protected Audience ise siteler arası verilerle açık artırma yapmak için kullanılabilir.

Başlamadan önce açılış sayfasını ziyaret ederek Protected Audience ile ilgili temel bilgileri ve Prebid.js dokümanlarındaki header bidding 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üğü yer bağlamında mevcut verileri kullanan bir reklam açık artırması. İçeriğe dayalı bir açık artırmada birden fazla açık artırma (ör. başlıktan teklif alma (header bidding) ve sunucu tarafı açık artırmalar) olabilir.
Protected Audience açık artırması	Başka bir sitede oluşturulmuş 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ı	Öncelikle birden fazla paralel bileşen açık artırması içeren iki katmanlı bir Korunan Kitle açık artırması. Bu açık artırma daha sonra en yüksek puanlı reklamın en üst düzey açık artırmaya gönderilmesini sağlar.
Üst düzey açık artırma	Bileşen açık artırmalarından elde edilen bileşen açık artırması kazananlarının puanlanmasını sağlayan, Protected Audience çok satıcılı açık artırmadaki son reklam açık artırması.
Bileşen açık artırması	Her bileşen satıcısının bileşen açık artırmalarını paralel olarak düzenlediği, Protected Audience çok satıcılı açık artırmadaki 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 geçirilir.
Sıralı açık artırma kurulumu	İçeriğe dayalı açık artırmaları Protected Audience açık artırmasıyla entegre eden ve iki açık artırma arasından kazananı belirleyen bir reklam açık artırması ayarı.

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	Reklam alanını bir satıcıdan satın almak için açık artırmada teklif veren taraf. Genellikle talep tarafı platformu (TTP) olur.
Yayıncı Reklam Sunucusu	Sitede oluşturulacak reklamları yönetmek ve seçmek için yayıncılar tarafından kullanılan bir hizmet. Yayıncı Reklam Sunucusu, bir yayıncıya en çok 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 envanterini ve daha fazlasını birleştirebilir. Yayıncı Reklam Sunucusu, sunucuyla etkileşim için istemci tarafı kitaplığı sağlayabilir.
Üst düzey satıcı	Protected Audience çok satıcılı açık artırmasını çağıran (yani oluşturan) taraf, üst düzey açık artırmaya katılır.
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ı yapan taraf. Genellikle bir arz tarafı platformu (STP).

Sıralı açık artırma kurulumu

Sıralı açık artırma ayarlarında, önce içeriğe dayalı açık artırmalar yürütülür, ardından Protected Audience açık artırması gerçekleştirilir. Bu kurulum, yayıncıların sayfada bulunan içeriğe dayalı verilerle bir açık artırma ve ayrıca kullanıcıların gizliliğini korumak için güvenli bir ortamda siteler arası verilerle bir açık artırma yaparak kazanç potansiyellerini en üst düzeye çıkarmalarına olanak tanır.

Yayıncı Reklam Sunucusu'nun içeriğe dayalı açık artırması için teklifler toplamak üzere sayfada ilk olarak bir başlıktan teklif alma (header bidding) kitaplığı yürütülebilir. Ardından, içeriğe dayalı açık artırmanın ayarlanmış kazanan teklif fiyatı, Protected Audience açık artırmasına teklif tabanı olarak girilebilir. Puanlama adımında, üst düzey satıcı istenenlik puanı hesaplanırken sıfır puan atayarak bileşen açık artırma teklifi fiyatlarını teklif tabanının altına düşürebilir. Korunan Kitle bileşeninin hiçbir açık artırma teklifi teklif tabanının üzerinde değilse içeriğe dayalı açık artırmayı kazanan reklam kullanıcı için oluşturulur. Korunan Kitle açık artırması kazananı döndürürse bu, reklamın teklif tabanının üzerinde olduğu ve Protected Audience kazanan reklam kullanıcıya oluşturulduğu anlamına gelir.

Not: Bu belgedeki kurulumda, Protected Audience'ın mevcut reklam yayınlama mekanizmalarıyla entegre edilmesi için kullanılabilecek bir yaklaşım açıklansa da bu yöntemin tek yolu bu değildir. Bu belgede, başlıktan teklif alma (header bidding) kitaplıklarından biri olan Prebid.js'nin Protected Audience ile nasıl entegre olduğu açıklanmaktadır.

Bu sıralı açık artırma kurulumu örneğinde, sayfada şu sırayla üç büyük açık artırma yürütülebilir: 1) başlıktan teklif alma (header bidding) kitaplığına göre içeriğe dayalı açık artırma, 2) Yayıncı Reklam Sunucusu tarafından içeriğe dayalı açık artırma ve 3) Korunan Kitle açık artırması.

Başlıktan teklif alma (header bidding) içeriğe dayalı açık artırmaya sahip Protected Audience çok satıcılı açık artırmaya genel bakış.

Genel bakış diyagramının ayrıntılı açıklaması:

1. Kullanıcı, açık artırmadan önce bir reklamveren sitesindeki bir ilgi alanı grubuna eklenir.
2. 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 içeriğe dayalı bir açık artırma çalıştırır. Bu adımda alıcılar sinyalleri sağlayabilir, satıcılar ise sonraki Protected Audience açık artırmasında kullanılacak bileşen açık artırma yapılandırmaları sağlayabilir. Prebid.js, bu sinyalleri ve yapılandırmaları Korunan Kitle açık artırmasına uygulamak için bir modül sağlar.
3. Prebid.js tarafından toplanan teklif yanıtları, sunucu tarafı içeriğe dayalı açık artırma için Yayıncı Reklam Sunucusu'na gönderilir.
4. Yayıncı Reklam Sunucusu, bir yayıncıya en çok geliri sağlayacak reklamı belirlemek için kendi açık artırma sonuçlarını, başlıktan teklif alma (header bidding) sonuçlarını, doğrudan satılan envanterini ve daha fazlasını birleştirebilir. Kazanan reklam, Yayıncı Reklam Sunucusu'nun istemci tarafı kitaplığına döndürülür.
5. İçeriğe dayalı açık artırmanın kazananından alınan düzenlenmiş teklif fiyatı, alıcı sinyalleri (perBuyerSignals) ve Prebid.js tarafından toplanan satıcı bileşeni açık artırma yapılandırmaları, Yayıncı Reklam Sunucusu'nun istemci tarafı kitaplığı tarafından Protected Audience açık artırmasına aktarılabilir.
6. Protected Audience çok satıcılı açık artırması, üst düzey satıcı tarafından yapılır. Üst düzey satıcının puanlama adımında, en üst düzey satıcı her bileşenin açık artırmayı kazanan teklif fiyatını, içeriğe dayalı açık artırma tarafından ayarlanan kazanan teklif fiyatıyla karşılaştırabilir. Bileşenin teklif fiyatı içeriğe dayalı açık artırma teklifi fiyatından düşükse üst düzey satıcı 0 olan istenenlik puanını döndürür. Tüm teklifler 0 olarak puanlanırsa runAdAuction() çağrısı, içeriğe dayalı açık artırmayı kazanan reklamın oluşturulması gerektiğini belirten null değerini döndürür.
7. Yayıncı Reklam Sunucusu istemci tarafı kitaplığı, runAdAuction() çağrısından döndürülen içeriğe göre kazanan Protected Audience reklamını veya içeriğe dayalı reklamı oluşturur.
8. Kazanan reklam kullanıcı için oluşturulur.

Açık artırma öncesi

Bir reklamveren sayfasındaki ilgi alanı grubu zaman dizisi.

Açık artırmadan önce kullanıcı bir reklamverenin sayfasını ziyaret ettiğinde, alıcı ve reklamveren, sitede kullanıcının ait olduğu ilgi alanı grubunu tanımlayabilir ve daha sonra açık artırma için sinyal olarak kullanılmak üzere reklamverenin sitesinden içerik verileri ve birinci taraf verilerini ekleyebilir.

1. Kullanıcı, reklamverenin sitesine gider.
2. Reklamveren sitesi, açık artırmaya katılan her alıcının komut dosyasını daha sonra yükler.
3. 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 Sunucusu ile içeriğe dayalı açık artırmalar

Yayıncı sayfasında içeriğe dayalı açık artırma zamanı sırası.

Sıralı açık artırma ayarlarında, tüm içeriğe dayalı açık artırmalar Protected Audience açık artırması başlamadan önce yürütülür. Bu belgede açıklanan kurulumda, Prebid.js tarafından Yayıncı Reklam Sunucusu tarafından sunucu tarafı açık artırmaya giren bir başlıktan teklif alma (header bidding) içeriğe dayalı açık artırması çalıştırırız.

Yayıncı, önce bir Protected Audience açık artırmasının daha sonra yürütüleceğini belirtmek için Prebid.js'yi bir işaret ile çağırarak başlıktan teklif alma (header bidding) içeriğe dayalı açık artırması başlatır. Daha sonra Prebid.js, teklif yanıtlarını toplar ve bunları sunucu tarafı içeriğe dayalı açık artırma için Yayıncı Reklam Sunucusu'na 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ılmak üzere bileşen açık artırma yapılandırmaları ve alıcı sinyalleri (perBuyerSignals) sağlayabilir. Bu bileşen açık artırma yapılandırması, sonunda bir sonraki Protected Audience açık artırmasına aktarılır.

1. İçeriğe dayalı açık artırma başlatma Kullanıcı, yayıncı sayfasını ziyaret eder.
2. Yayıncı sayfası, Yayıncı Reklam Sunucusu istemci tarafı kitaplığını yükler ve reklam alanlarını tanımlar.
3. Yayıncı sayfası Prebid'i yükler ve başlıktan teklif alma (header bidding) içeriğe dayalı açık artırmasını başlatır.
4. A Satıcısının içeriğe dayalı açık artırması(Satıcı B'nin içeriğe dayalı açık artırmasına paralel olarak yayınlanır). Prebid.js, Satıcı A'ya bir teklif isteği gönderir.
5. Satıcı A, alıcılardan teklif yanıtlarını ve perBuyerSignals alır.
6. A Satıcısı içeriğe dayalı bir açık artırma gerçekleştirir.
7. Satıcı A, bileşen açık artırma yapılandırmasını perBuyerSignals dahil ederek oluşturur.
8. Satıcı A, Prebid.js'ye kazanan teklif ve bileşeninin açık artırma yapılandırmasıyla yanıt verir.
9. 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ıyla paralel olarak çalışır). Prebid.js, Satıcı B'ye bir teklif isteği gönderir.
10. Satıcı B, alıcılardan teklif yanıtlarını ve perBuyerSignals alır.
11. Satıcı B, içeriğe dayalı bir açık artırma gerçekleştirir.
12. Satıcı B, perBuyerSignals özelliği eklenmiş olarak bileşen açık artırma yapılandırmasını oluşturur.
13. Satıcı B, Prebid.js'ye kazanan teklif ve bileşeninin açık artırma yapılandırmasıyla yanıt verir.
14. Yayıncı Reklam Sunucusu'nun içeriğe dayalı açık artırması Prebid.js tarafından toplanan teklif yanıtları, içeriğe dayalı açık artırma için Yayıncı Reklam Sunucusu'na gönderilir.
15. Alıcıların sinyallerine sahip bileşen açık artırma yapılandırmaları, Yayıncı Reklam Sunucusu'nun istemci tarafı kitaplığıyla paylaşılır.
16. Yayıncı Reklam Sunucusu; doğrudan satılan kampanyalar, programatik teklifler, ön teklifin içeriğe dayalı teklifleri ve diğer envanterler arasında en iyi reklamı belirlemek için içeriğe dayalı bir açık artırma çalıştırır.
17. Yayıncı Reklam Sunucusu, düzenlenmiş kazanan teklifi döndürür.

Korunan kitle çok satıcılı açık artırması

Yayıncı sayfasındaki Korunan Kitle açık artırma zamanı sırası.

Bu aşamada, içeriğe dayalı açık artırmalar sona ermiştir ve Yayıncı Reklam Sunucusu'nun istemci tarafı kitaplığı, içeriğe dayalı açık artırmayı kazanan düzenlenmiş teklif fiyatını, bileşen açık artırma yapılandırmasını ve Protected Audience açık artırmasına katılan alıcılardan gelen sinyalleri üst düzey satıcıya iletebilir. İçeriğe dayalı açık artırma teklifi fiyatı, taban değer olarak açık artırma yapılandırmasına, üst düzey açık artırmada puanlama sinyali olarak aktarılabilir.

Bileşen açık artırmaları paralel olarak yürütülür ve her bileşen açık artırmasında tarayıcı, bu bileşen açık artırmasına katılan her alıcının teklif verme mantığından teklifler oluşturur, her bir teklifi bileşen satıcısının puanlama mantığını kullanarak puanlar ve daha sonra, en yüksek puanlı reklamı üst düzey açık artırmaya döndürür.

1. Yayıncı sitesi, üst düzey satıcının komut dosyasını yükler.
2. Yayıncı reklam sunucusunun istemci tarafı kitaplığı, alıcılardan üst düzey satıcıya giden sinyallerle içeriğe dayalı açık artırma teklif fiyatı ve bileşen açık artırma yapılandırmaları sağlar. İçeriğe dayalı açık artırmayı kazanan reklam teklifi fiyatı, açık artırma yapılandırmasına satıcı sinyalleri olarak aktarılabilir (bu teklif fiyatı üst düzey satıcının scoreAd() işlevinde kullanılabilir hale gelir).
3. Üst düzey satıcı, runAdAuction() numaralı telefonu arayarak Protected Audience açık artırmasını başlatır.
4. Satıcı A bileşeni açık artırması (Satıcı B'nin bileşen açık artırmasına paralel olarak çalışır). Tarayıcı, A Satıcısı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.
5. Tarayıcı, bileşen açık artırmasına katılan alıcıların ilgi gruplarında belirtilen konumlardan teklif komut dosyalarını ve güvenilir teklif verme sinyallerini getirir.
6. Tarayıcı, teklifleri her alıcının teklif oluşturma mantığını uygulayarak oluşturur.
7. Tarayıcı, Satıcı A'dan her reklamın puanlama komut dosyasını ve güvenilir puanlama sinyallerini alır.
8. Tarayıcı, her teklif için Satıcı A'nın puanlama mantığını yürütür.
9. Tarayıcı, A Satıcısının puanlama mantığına göre gönderilen en yüksek puana sahip reklamı seçer.
10. Satıcı B bileşeni 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.
11. Tarayıcı, bileşen açık artırmasına katılan alıcıların ilgi gruplarında belirtilen konumlardan teklif komut dosyalarını ve güvenilir teklif verme sinyallerini getirir.
12. Tarayıcı, teklifleri her alıcının teklif oluşturma mantığını uygulayarak oluşturur.
13. Tarayıcı, Satıcı B'den her reklamın puanlama komut dosyasını ve güvenilir puanlama sinyallerini alır.
14. Tarayıcı, her teklif için Satıcı B'nin puanlama mantığını yürütür.
15. Tarayıcı, Satıcı B'nin puanlama mantığına göre gönderilen en yüksek puana sahip reklamı seçer.

Üst düzey açık artırma puanlaması ve reklam oluşturma

Yayıncı sayfasında reklam oluşturma sırası.

Önceki bölümde yer alan bileşen açık artırmaları yürütüldükten sonra, tarayıcı her bir bileşen açık artırmasının kazanan reklamında en üst düzey satıcının puanlama mantığını çalıştırır. Üst düzey satıcının scoreAd() işlevinde, içeriğe dayalı açık artırma tarafından ayarlanmış teklif fiyatı sellerSignals olarak kullanılabilir ve puanlama mantığı, içeriğe dayalı açık artırma teklifi fiyatını, Protected Audience bileşeninin kazanan teklif fiyatıyla karşılaştırabilir.

İçeriğe dayalı 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 istenenlik puanı döndürebilir. Tercih edilirlik puanı 0 değerinden yüksek olan herhangi bir reklam yoksa bu durum, içeriğe dayalı açık artırmanın kazanan reklamının, bileşen açık artırmasının kazanan reklamlarından daha değerli olduğunu ve runAdAuction() işlevinin null değerini döndürdüğünü gösterir.

Korunan Kitle açık artırmasında kazanan yoksa ve null değerini döndürürse yayıncının reklam sunucusu istemci tarafı kitaplığı, içeriğe dayalı açık artırmanın kazananını iframe olarak oluşturabilir. İçeriğe dayalı açık artırmaya karşı korunan Kitle açık artırması kazanırsa FencedFrameConfig nesnesi veya opak bir URN döndürürse kazanan Protected Audience açık artırma reklamı, sınırlandırılmış bir çerçeve veya iframe içinde oluşturulabilir.

1. Üst düzey açık artırma reklamı puanlaması Tarayıcı, üst düzey satıcıdan her bir reklamın güvenilir puanlama sinyalleriyle birlikte puanlama komut dosyasını alır.
2. Tarayıcı, tüm bileşen açık artırmalarının her 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ının içinde mantık, açık artırma yapılandırmasında sellerSignals olarak eklenmiş olabilecek içeriğe dayalı açık artırma ayarlı kazanan teklif fiyatına erişebilir. Komut dosyası, kazanan içeriğe dayalı teklif fiyatını bileşen korumalı kitle teklif fiyatıyla karşılaştırabilir ve içeriğe dayalı fiyat daha yüksekse istenenlik puanı 0 sonucunu döndürebilir. Aksi takdirde, komut dosyası, muhtemelen Protected Audience teklif fiyatını temel alarak istenenlik puanını hesaplar.
3. Tarayıcı, en üst düzey satıcının puanlama mantığına göre gönderilen en yüksek istenen puana sahip reklamı seçer.
4. Korunan Kitle açık artırması kazanırsa Korunan Kitle 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.
5. İstemci tarafı kitaplığı, sınırlanmış çerçevenin config özelliğini FencedFrameConfig nesnesine veya iframe'in src özelliğini, kazanan Protected Audience reklamının opak URN'sine ayarlar.
6. Tarayıcı, alıcıdan Protected Audience açık artırmasını kazanan reklamı getirir.
7. Tarayıcı, reklamı kullanıcıya oluşturur.
8. İçeriğe dayalı açık artırma kazanırsa Korunan Kitle açık artırması null değerini döndürür.
9. Tarayıcı, iframe'in src özelliğini kazanan içeriğe dayalı reklama ayarlar.
10. Tarayıcı, alıcıdan içeriğe dayalı açık artırmayı kazanan reklamı getirir.
11. Tarayıcı, reklamı kullanıcıya oluşturur.

Etkileşimde bulunun ve geri bildirim paylaşın

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.