Protected Audience API reklam açık artırması için satıcı API kılavuzu ve referanslar.
Bu makalede, deneysel Protected Audience API'nin mevcut iterasyonunda kullanılan reklam açık artırması için teknik bir referans bulunmaktadır.
Kullanım ömrü boyunca geliştirici kılavuzunu okuyun döngüsünü takip edin ve Protected Audience API açıklayıcısına bakarak satıcıların cihaz üzerinde açık artırmaları nasıl yürüttüğü.
Geliştirici değil misiniz? Protected Audience API'ye genel bakış sayfasını inceleyin.
Protected Audience API reklam açık artırması nedir?
Protected Audience API reklam açık artırması, Tarayıcı, bir reklam seçmek için kullanıcının cihazında çalışır. Gizliliği korumak için, tüm reklamlar Satıcı ve alıcılardan alınan açık artırma kodu izole JavaScript'te çalıştırılır iletişim kuramayan iş akışlarını çok şanslıydık.
![Protected Audience API reklam açık artırmasında altı aşama](https://developers-dot-devsite-v2-prod.appspot.com/static/privacy-sandbox/assets/images/six-stages-a-protected-a-3e1dd6fdeddbe.png?authuser=8&hl=tr)
- Kullanıcı reklamların görüntülendiği bir siteyi ziyaret eder.
- Satıcının kodu
navigator.runAdAuction()
yürütür. Bu, reklam alanının satılık olduğunu ve kimlerin teklif verebileceğini belirler. Satıcılar bir komut dosyası da içermelidir Bu da her bir teklifinscoreAd()
olarak derecelendirilmesini sağlar. - Davet edilen alıcının kodu, teklif (alakalı bir reklamın URL'si) oluşturmak için yürütülür ve diğer verileri içerir. Teklif komut dosyası gerçek zamanlı verileri sorgulayabilir, geri kalan reklam kampanyası bütçesi gibi, alıcının Anahtar/Değer hizmeti.
- Satıcının kodu her teklifi puanlar ve kazananı seçer. Bu mantık teklif değerini ve diğer verileri döndürür. Daha iyi olmayan reklamlar içeriğe dayalı kazanan reddedilir. Satıcı kendi Gerçek zamanlı veriler için Anahtar/Değer hizmeti.
- Kazanan reklam opak bir değer olarak döndürülür ve çizili çerçeve'yi seçin. Hem satıcı hem de yayıncı bu değeri görüntüleyemez.
- Açık artırma satıcıya ve kazanan alıcılara bildirilir.
Açık artırma ne zaman yapılır?
Protected Audience API, tek başına veya programatik açık artırmalarla çalıştırılabilir. Çok satıcılı hesaplarda programatik açık artırma:
- Kullanıcı, katılımcı bir siteyi ziyaret eder.
- Mevcut bir reklam alanına yönelik içeriğe dayalı bir reklam bulmak için başka bir satıcı tarafından programatik açık artırma yürütülür.
- Protected Audience API açık artırması yapılıyor.
scoreAd()
Alıcının tekliflerini ilk açık artırmanın sonuçlarıyla karşılaştırır.
İçeriğe dayalı kazananı geçemeyen teklifler reddedilir.
Protected Audience API reklam açık artırmasını kimler düzenler?
Reklam alanı satmak için açık artırma yürütebilecek birden fazla taraf vardır.
Örneğin:
- İçerik yayıncısı: Web sitesinde reklam içeriği barındırmak için kendisi adına hareket etme.
- Arz tarafı platformu (STP): Yayıncıyla çalışma ve başka hizmetler sağlama.
- Üçüncü taraf komut dosyası: Reklam açık artırmalarına katılımı sağlamak için yayıncı adına hareket etme.
Protected Audience API ile bir satıcının üç işi olur:
- Yayıncı kurallarını zorunlu kılın: Hangi alıcılar ve hangi tekliflerin uygun olduğu.
- Açık artırma mantığını çalıştır: JavaScript'in çalışması iş akışını istenen puandır.
- Açık artırma sonucunu bildirin.
Bu işler programatik olarak, satıcı tarafından sağlanan kodla
JavaScript işlevini çağırarak reklam açık artırması başlatır
navigator.runAdAuction()
API işlevleri
runAdAuction()
Satıcı, navigator.runAdAuction()
kodunu çağırarak bir reklam açık artırması başlatmak için kullanıcının tarayıcısına istekte bulunur.
Örneğin:
const auctionConfig = {
seller: 'https://ssp.example',
decisionLogicUrl: ...,
trustedScoringSignalsUrl: ...,
interestGroupBuyers: ['https://dsp.example', 'https://buyer2.example', ...],
auctionSignals: {...},
sellerSignals: {...},
sellerTimeout: 100,
perBuyerSignals: {
'https://dsp.example': {...},
'https://another-buyer.example': {...},
...
},
perBuyerTimeouts: {
'https://dsp.example': 50,
'https://another-buyer.example': 200,
'*': 150,
...
},
componentAuctions: [
{
'seller': 'https://some-other-ssp.example',
'decisionLogicUrl': ...,
...
},
...
]
};
try {
const auctionResultPromise = navigator.runAdAuction(auctionConfig);
} catch (error) {
// Handle error.
}
runAdAuction()
,URNurn:uuid:<something>
reklam açık artırması sonucu Bu öğenin kodu yalnızca çitle ayrılmış bir çerçeveye geçirildiğinde tarayıcı tarafından çözülebilir
oluşturma için: Yayıncı sayfası kazanan reklamı denetleyemiyor.
decisionLogicUrl
komut dosyası, her bir reklamı ve reklam öğelerini dikkate alır.
teklif ve meta verileri kullanır ve ardından buna sayısal bir değer atar
skoruna dahildir.
auctionConfig
tesis
seller
- Zorunlu
- Örnek:
'https://ssp.example'
- Rol: Satıcının kökeni.
decisionLogicUrl
- Zorunlu
- Örnek:
'https://ssp.example/auction-decision-logic.js'
- Rol: Açık artırma iş akışı JavaScript'inin URL'si.
trustedScoringSignalsUrl
- İsteğe bağlı
- Örnek:
'https://ssp.example/scoring-signals'
- Rol: Satıcının güvenilir sunucusunun URL'si.
interestGroupBuyers
- Zorunlu
- Örnek:
['https://dsp.example', 'https://buyer2.example', ...]
- Rol: Açık artırmada teklif vermek istenen tüm ilgi alanı grubu sahiplerinin kaynakları. ziyaret edin.
- Notlar: Satıcı, tüm ilgi alanı gruplarının teklif vermesine izin vermek için
interestGroupBuyers:
değerini belirtebilir. Reklamlar, daha sonra ilgi alanı grubu sahibinin dahil edilmesi dışındaki ölçütlere göre kabul edilir veya reddedilir. Örneğin, satıcı kendi politikalarına uygun olduğunu onaylamak için reklam öğelerini inceleyebilir. auctionSignals
- İsteğe bağlı
- Örnek:
{...}
- Rol: Sayfa bağlamı, açık artırma türü vb.hakkında satıcı bilgileri
sellerSignals
- İsteğe bağlı
- Örnek:
{...}
- Rol: Yayıncı ayarlarına dayalı bilgiler, içeriğe dayalı reklam isteğinde bulunma vb.
sellerTimeout
- İsteğe bağlı
- Örnek:
100
- Rol: Satıcının
scoreAd()
komut dosyasının maksimum çalışma zamanı (ms). perBuyerSignals
- İsteğe bağlı
- Örnek:
{'https://dsp.example': {...}, 'https://another-buyer.example': {...}, ... }
- Rol: Her bir alıcının sunucusundan gelen, sayfayla ilgili bağlamsal sinyaller.
perBuyerTimeouts
- İsteğe bağlı
- Örnek:
50
- Rol: Belirli bir alıcının
generateBid()
komut dosyalarının maksimum çalışma zamanı (ms). componentAuctions
- İsteğe bağlı
- Örnek:
[{'seller': 'https://www.some-other-ssp.com', 'decisionLogicUrl': ..., ...}, ...]
- Rol: Bileşen açık artırmaları için ek yapılandırmalar.
decisionLogicUrl
decisionLogicUrl
, açık artırma yapılandırma nesnesinin bir özelliğidir.
runAdAuction()
adresine iletildi. Bu URL,
scoreAd()
işlevini kullanın. Bu mantık, her reklamın bir kez çalıştırılması için
ve ara hedefler belirlenir.
scoreAd(adMetadata, bid, auctionConfig, trustedScoringSignals, browserSignals) {
...
return desirabilityScoreForThisAd;
}
browserSignals
browserSignals
, tarayıcı tarafından oluşturulan bir nesnedir. Aşağıdaki bilgiler de buna dahildir:
satıcının bildiği ve satıcının açık artırma komut dosyasının neyi,
doğrulayın:
{
topWindowHostname: 'publisher.example',
interestGroupOwner: 'https://dsp.example',
renderUrl: 'https://cdn.example/render',
adComponents: ['https://cdn.com/ad-component-1', ...],
biddingDurationMsec: 12,
dataVersion: 1 /* DValue from the seller's Key/Value service response. */
}
Açık artırma başlamadan önce satıcı,
kullanılabilir. scoreAd()
mantığının bir bölümü, şunları yapamayan reklamları reddeder:
içerik açısından kazananı yendi.
scoreAd()
scoreAd()
, şu bağımsız değişkenleri alır:
Argüman | Rol |
---|---|
adMetadata |
Alıcı tarafından sağlanan rastgele meta veriler. |
auctionConfig |
Açık artırma yapılandırma nesnesi navigator.runAdAuction() işlevine aktarıldı. |
bid |
Sayısal teklif değeri. |
trustedScoringSignals |
Açık artırma anında satıcının güvenilir sunucusundan alınan ve satıcının reklamla ilgili görüşünü temsil eden değerler. |
Sık sorulan sorular
Açık artırmanın kazananı nasıl belirlenir ve kim tarafından seçilir?
Satıcı, her bir reklamın istenirlik puanını belirlemek için puanlama mantığını sağlar ve tarayıcı, en yüksek puanı kazanan reklam olarak seçer.
Satıcı, scoreAd()
işlevine bir mantık ekliyor ve tarayıcı, işlevi bunun dışındaki kodla sınırlı iletişimi olan bir iş akışında yürütüyor. Tarayıcının kendisi reklamları puanlamaz. Puanlama mantığını yürütmek ve en yüksek puana sahip teklifi seçmek yalnızca tarayıcıya sorumludur.
Tüm Protected Audience API referansları
API referans kılavuzları mevcuttur:
- Protected Audience API için geliştirici kılavuzu.
- Korunan Kitle ilgi alanı grupları ve teklif oluşturma ile ilgili reklam alıcı rehberi.
- Korunan Kitle reklam açık artırmaları ile ilgili reklam satıcısı kılavuzu.
- Açık artırma sonuçlarını raporlama kılavuzu
- Korunan Kitle için en iyi uygulamalar reklam açık artırması gecikmesi
- Korunan Kitle ile ilgili sorunları giderme
Protected Audience API açıklayıcısı da özellik desteği ve kısıtlamalar hakkında ayrıntılı bilgi sağlar.