Özel Korumalı Alan'ın bir parçası olarak Chrome, tarayıcı içi bir API olan Protected Audience API'yi önerdi. Bu API, reklamverenlerin ve reklam teknolojisi şirketlerinin, kullanıcıları üçüncü taraf çerezlerine gerek kalmadan ilgi alanı grubu hedefli reklamları göstermesine ve kullanıcıları siteler arası izlemeye karşı korumasına olanak tanır.
Chrome, Protected Audience API için bir kaynak denemesi çalıştırmaktadır. Authorized Buyers, Ad Manager yayıncı envanterinde Protected Audience API testine katılmaya uygundur. Teklif verenler, Protected Audience API'yi test ederek aşağıdakileri yapabilir:
- Protected Audience API akışlarının etkinliğini yineleyin ve öğrenin.
- Herkese açık forumlarda olası API iyileştirmeleri hakkında geri bildirim oluşturun (örneğin, GitHub).
- Üçüncü taraf çerezlerine dayanmadan API üzerinden kişiselleştirilmiş reklamcılığı desteklemeye hazırlanın.
Test yapmak isteyen Authorized Buyers alıcıları, ayrıntılar için İlk katılım bölümüne göz atmalıdır.
Yayınlama akışı özeti
Authorized Buyers iş ortakları için Protected Audience reklam yayınlama akışının özetini burada bulabilirsiniz:
- Teklif veren, her bir reklamverenin ilgi alanı gruplarını korumak için reklamverenleriyle birlikte çalışır. Çoğu zaman reklamverenler, ilgi alanı gruplarına bir tarayıcı eklemek için teklif verenin etiketini reklamverenin sayfasına ekler.
- Bir son kullanıcı bir reklamverenin sayfasını ziyaret eder. Sayfa, teklif verenin etiketini içerebilir.
- Teklif verenin etiketi, Protected Audience API
joinAdInterestGroup()
'yi çağırır. Bu çağrıda, tarayıcının kullanıcıyı bir ilgi alanı grubuna eklemesi istenir. - Son kullanıcı bir yayıncı web sayfasını ziyaret eder. Kullanıcının tarayıcısı, Google'ın yayıncı reklam etiketini ister.
- Google'ın yayıncı reklam etiketi, Google sunucusuna içeriğe dayalı bir reklam isteği gönderir.
- Google, katılımcı teklif verenlere içeriğe dayalı teklif istekleri gönderir. Daha fazla bilgi için Teklif isteği değişiklikleri bölümüne bakın.
- Teklif veren,
interest_group_bidding
alanıyla birBidResponse
döndürür. Teklif vereninterest_group_bidding
belirtmezse Google,interestGroupBuyers
açık artırma yapılandırmasına teklif verenin kaynağını dahil etmez. Teklif yanıtı şunları da içerebilir:interest_group_bidding.per_buyer_signals
.per_buyer_signals
, tarayıcı içi açık artırma sırasında teklif verenin teklif işlevine iletilecektir. Daha fazla bilgi için Teklif yanıtı değişiklikleri bölümüne bakın. - Google, sunucu tarafı açık artırmayı çalıştırır ve tarayıcıya bir teklif yanıtı döndürür. Sunucu tarafı açık artırmasında geleneksel, sunucu tarafı teklifler dikkate alınır. Teklif yanıtı, içeriğe dayalı olarak kazanan bir teklif (varsa) hakkında bilgi içerebilir.
- Teklif yanıtı, tarayıcı içi açık artırma için bir açık artırma yapılandırması içerir. Bu bilgiler arasında, katılımcı her alıcıdan gelen (
interest_group_bidding.per_buyer_signals
aracılığıyla gönderilen) bağlamsal sinyaller, bağlamsal kazanan bilgileri ve teklif uygunluğu ayarları yer alabilir. - Google'ın yayıncı etiketi, cihaz üzerinde ilgi alanı grubu açık artırmasını başlatmak için Protected Audience API
runAdAuction()
'yi çağırır. Google yalnızca daha önceinterest_group_bidding
öğesini açık artırma yapılandırmasındainterestGroupBuyers
olarak iade eden alıcıları dahil eder. - Google, her uygun teklif verenin
per_buyer_signals
değerini Korumalı Kitle açık artırma yapılandırmasına geçirir. - Belirli bir teklif verenin ilgi alanı grupları
trustedBiddingSignalsUrl
değerini belirtmişse tarayıcı, her bir grup için gerçek zamanlı sinyalleri getirmek amacıyla her grubuntrustedBiddingSignalsUrl
öğesine istek gönderir. Protected Audience API spesifikasyonundaki ayrıntıları inceleyin. - Tarayıcı, tarayıcı içi açık artırmaya katılmaya uygun olan ve etkinleştirilen her bir ilgi alanı grubu için teklif verenin
generateBid()
değerini çağırır. Bu adım, teklifi hesaplar ve bir reklam öğesi seçer.generateBid()
, teklif veren tarafından sağlananper_buyer_signals
ve belirli bir ilgi alanı grubu için güvenilir teklif verme sinyallerine erişebilir. - Tarayıcı, ilgi alanı grubu reklam açık artırmasında her teklife bir sıralama atamak için satıcının (bu durumda Google'ın)
scoreAd()
özelliğini çağırır. Teklifler; yayıncı korumaları, reklam politikaları ve diğer kısıtlamalara göre sıralanır ve filtrelenir. - Tarayıcı, uygun ilgi alanı grubu teklifleriyle bir açık artırma yapar. En üst sıradaki içeriğe dayalı teklif, tarayıcı içi açık artırmaya katılır.
- Açık artırmadan sonra bir ilgi alanı grubu kazananı varsa tarayıcı, her bir tarafı tarayıcı içi açık artırmanın kazananı hakkında bilgilendirmek için satıcının
reportResult()
ve teklif verenreportWin()
özelliğini çağırır. - Bir ilgi alanı grubu reklamı kazanırsa Google'ın yayıncı etiketi reklamı bir iframe içinde oluşturur.
Yayınlama akışı ayrıntıları
Reklam yayınlanmadan önce
Reklam incelemesi
Reklam öğelerinin, Protected Audience tarayıcıdaki açık artırmalardan sunulmadan önce Google tarafından incelenip onaylanması gerekir. Reklam öğelerini Gerçek Zamanlı Teklif Verme API'si aracılığıyla veya otomatik reklam öğesi tarama aracılığıyla incelemeye gönderebilirsiniz. Tarayıcıdaki ilgi alanı grubu reklam açık artırmalarındaki Protected Audience reklam açık artırmalarının reklam öğeleri, inceleme için renderUrls
içermelidir.
renderUrls
için gereksinimler:
- API aracılığıyla gönderilen
renderUrl
, ilgi alanı grubu reklam açık artırmasında kullanılanrenderUrl
ile eşleşmelidir. - Her
renderUrl
yalnızca tek bir reklamvereni veya reklam kampanyasını temsil edebilir. Belirli birrenderUrl
, birden fazla reklamveren adına reklam oluşturmak için kullanılamaz. HerrenderUrl
tek bir reklam öğesiyle eşlenmelidir. renderUrl
, reklamda son teklif verildikten sonra en fazla 7 gün boyunca Google'ın çevrimdışı reklam öğesi inceleme sistemleri tarafından erişilebilir ve getirilebilir olmalıdır.
Real-time Bidding API
Teklif verenler, ilgi alanı grubu teklifli sistemi için reklam öğeleri yüklemek üzere Gerçek Zamanlı Teklif Verme API'sini kullanabilir.
Otomatik reklam öğesi tarama
Teklif verenler, Real-time Bidding API aracılığıyla yüklenmeyen reklam öğeleri için otomatik reklam öğesi taraması ayarlayabilir.
Otomatik reklam öğesi taramayı ayarlarsanız Google, tarayıcı içi açık artırmada reklam öğelerini bulur ve gelecekteki açık artırmalara uygun olmaları için otomatik olarak tarar.
Otomatik reklam öğesi taramanın nasıl açılacağı aşağıda açıklanmıştır:
İlgi alanı grubu reklam öğesinin tüm
renderUrl
kaynaklarını Authorized Buyer hesabına ekleyin.Reklam öğesinin HTTP yanıtına aşağıdaki özel HTTP üstbilgilerini ekleyin:
Authorized-Buyers-Creative-ID
dize
Alıcıya özel reklam öğesi kimliği. Reklam öğesi kimliğinin maksimum uzunluğu 128 bayttır.
Authorized-Buyers-Click-Through-URLs
dize
RFC2396'ya göre kodlanmış reklam öğesi için bildirilen hedef URL'ler grubu.
Örnek:
HTTP/1.1 200 OK
Date: Mon, 8 Jan 2022 12:28:53 GMT
Server: Apache/2.2.14 (Win32)
Last-Modified: Mon, 8 Jan 2022 12:01:53 GMT
Content-Length: 88
Content-Type: text/html
Connection: Closed
Authorized-Buyers-Creative-ID:123456
Authorized-Buyers-Click-Through-URLs:https://www.advertiser.com/clickUrl1,https://www.advertiser.com/clickUrl12
<html>
<body>
<h1>Hello, World!</h1>
</body>
</html>
Reklam öğesi süre sonu
Reklam öğeleri 15 gün için onaylanır. Reklam öğelerini Gerçek Zamanlı Teklif Verme API'si ile gönderirseniz reklam öğesini 15 gün sonra yeniden göndermeniz gerekir. Otomatik reklam öğesi taramasından yararlanıyorsanız tarama sürecinde reklam öğeleri otomatik olarak yeniden taranır.
Alıcı Raporlama Kimliği
Alıcı tarafından sağlanan boyutları (ör. kampanya kimliği veya reklamveren kimliği) kullanarak raporlama metriklerinin (gösterimler gibi) dökümünü alabilirsiniz. İlgi alanı grubu harcaması için boyut eklemek üzere, kullanıcının cihazını ilgi alanı grubuna eklerken reklamınız için bir buyerAndSellerReportingId
belirtin. Ek ayrıntıları Protected Audience belgelerinde bulabilirsiniz.
Aşağıda, ilgi alanı grubu yapılandırmasına buyerAndSellerReportingId
öğesinin nasıl ekleneceğine dair bir örnek gösterilmektedir:
const myGroup = {
...
'ads': [
{
...
'buyerAndSellerReportingId':
'{"google_signals": {"buyer_reporting_id": "12345"}}',
...
}
]
}
joinAdInterestGroup(myGroup);
buyer_reporting_id
, Authorized Buyers'ın Raporlama Aracı'nda Alıcı Raporlama Kimliği boyutu olarak yeni bir boyut olarak görünür.
Sunucu tarafı açık artırma
Teklif isteği değişiklikleri
Aşağıda, denemede kullanılmak üzere desteklenen protokollerin önceki sürümleri verilmiştir:
- Google RTB protokolü erken bağlantı
- OpenRTB erken bağlantısı
İlgi alanı grubu açık artırma desteğini belirtme
Teklif isteklerinde auction_environment
adlı yeni bir alan var.
- Google GZT Protokolü:
BidRequest.adslot.auction_environment
- OpenRTB:
BidRequest.imp.ext.auction_environment
Protected Audience tarayıcı içi ilgi alanı grubu açık artırmasını destekleyen gösterim fırsatları ile yalnızca geleneksel sunucu tarafı exchange açık artırmasını destekleyen gösterim fırsatlarını ayırt etmek için bu alanı kullanabilirsiniz. auction_environment
sıralaması aşağıdaki değerlere sahip olabilir:
SERVER_SIDE_AUCTION
(OpenRTB JSON:0
): Geleneksel sunucu tarafı açık artırmalarıON_DEVICE_INTEREST_GROUP_AUCTION
(OpenRTB JSON:1
): Protected Audience destekli istekler. Bu yapıda, exchange'in sunucularında içeriğe dayalı açık artırma, ilgi alanı grubu teklifi ve son açık artırma tarayıcıda çalıştırılır.
Korunan Kitle reklam alanının boyutunu belirtme
Teklif isteğinde, Protected Audience reklam alanı boyutunu sağlamak için aşağıdaki alanlar bulunur:
- Google RTB Protokolü:
BidRequest.adslot.interest_group_auction.width
BidRequest.adslot.interest_group_auction.height
- OpenRTB:
BidRequest.imp.ext.interest_group_auction
.width
BidRequest.imp.ext.interest_group_auction
.height
Bu alanlar, Protected Audience açık artırması için reklam alanının boyutunu piksel cinsinden gösterir.
Bu boyut, içeriğe dayalı istek boyutlarından farklı olabilir (Adslot.width
veAdslot.height
ya da OpenRTB: BidRequest.imp.banner.format
).
İçeriğe dayalı isteğin birden fazla boyutu olabilir. Cihaz üzerinde açık artırmayı kazanan reklamın yalnızca tek bir sabit alan boyutunu doldurması beklenir.
Protected Audience reklam oluşturulabilirliğini belirtin
Korunan Kitle reklamları, mevcut entegrasyon aşamasına bağlı olarak oluşturulabilir veya oluşturulmayabilir (Oluşturulmama denemesi bölümüne bakın). Teklif isteğindeki render_interest_group_ads
alanı, kazanan Protected Audience reklamının oluşturulup oluşturulmayacağını belirtir.
- Google GZT Protokolü:
BidRequest.adslot.interest_group_auction.render_interest_group_ads
- OpenRTB:
BidRequest.imp.ext.interest_group_auction.render_interest_group_ads
Kullanıcı tanımlayıcılarına bağımlılığı en aza indirin
Protected Audience API testi kapsamındaki içeriğe dayalı teklif istekleri, tarayıcıdan kullanılabilir olduklarında google_user_id
(OpenRTB'de BidRequest.user.id
) ve hosted_match_data
(OpenRTB'de BidRequest.user.buyerid
) gibi geleneksel çerez tabanlı tanımlayıcıları taşımaya devam edebilir. Bu tür tanımlayıcıların teklif isteklerinde bulunması, mevcut gizlilik politikalarına tabi olmaya devam edecektir. Üçüncü taraf çerezleri kullanılamadığında etkili satın alma için daha iyi hazırlanmak amacıyla testler sırasında hedefleme ve teklif verme amacıyla çerez tabanlı tanımlayıcılar kullanmamanızı öneririz.
Google, Protected Audience API testi kapsamındaki teklif isteklerinden çerez tabanlı tanımlayıcıların çıkartıldığı küçük ölçekli denemeler de yapabilir. Bu inceleme, üçüncü taraf çerezlerine yönelik desteğin sonlandırılmasının potansiyel etkisini değerlendirmek içindir.
Chrome'un desteklediği üçüncü taraf çerezleri için desteği sonlandırma testi
Chrome, 2024'te üçüncü taraf çerezlerinin kullanımdan kaldırılmasına (3PCD) hazırlanmak için artık Chrome destekli testler sunuyor.
Siteler ve satıcılar, Chrome destekli testleri kullanarak sistemlerini 3PCD ile test edebilir. Testte, Chrome tarayıcılar üç PCD deneme grubuna (A Modu veya B Modu) atanır. Her tarayıcıya, tarayıcı içindeki Chrome API aracılığıyla erişebileceğiniz belirli bir 3PCD deneme grubuna karşılık gelen tutarlı bir etiket atanır.
Google, GZT teklif isteğine Chrome API'sinden değiştirilmemiş etiketi iletir. Google, tek bir etiketin küçük trafik dilimlerinden dolayı etiketi gizlilikle sınırlı bağlamlara her zaman eklemez.
Etiketi görüntüleyebileceğiniz alanlar şunlardır:
- Google GZT Protokolü:
BidRequest.device.cookie_deprecation_label
- OpenRTB:
BidRequest.device.ext.cdep
Teklif yanıtı değişiklikleri
İlgi alanı grubu açık artırma katılımını belirtme
İçeriğe dayalı teklif yanıtında InterestGroupBidding
nesnesini döndürerek tarayıcı içi açık artırmaya katılma niyetinizi açıkça belirtmek sizin sorumluluğunuzdadır:
- Google GZT Protokolü:
BidResponse.interest_group_bidding
- OpenRTB:
BidResponse.ext.igbid
İçeriğe dayalı bir teklif yanıtı sağlamalısınız. İçeriğe dayalı teklif içermek için yanıta gerek yoktur. InterestGroupBidding
nesnesi, ilgi alanı grubu sahibinin origin
değerini içermelidir. Bu değer, teklif veren tarafından hesabı için yapılandırılan kaynaklardan biriyle eşleşmelidir. Google Yayıncı Etiketi runAdAuction()
yöntemini çağırdığında, origin
açık artırma yapılandırmasının interestGroupBuyers
öğesine eklenir.
Alıcı içerik sinyallerini yayınlama (perBuyerSignals başına)
İçeriğe dayalı teklif yanıtına alıcının sinyallerini ekleyebilirsiniz. Google, bu sinyalleri, perBuyerSignals
bağımsız değişkeni aracılığıyla cihaz üzerinde teklif verme işlevine bir JSON nesnesi olarak dağıtır. Bu, protokole bağlı olarak aşağıdaki alanlarla teklif yanıtına eklenebilir:
- Google GZT:
BidResponse.interest_group_bidding.per_buyer_signals
- OpenRTB:
BidResponse.ext.igbid.igbuyer.buyerdata
Alıcı içeriğe dayalı oluşturma sinyalleri yayın
İlgi alanı grubu reklam öğeleri, oluşturma sırasında bu sinyalleri içeriğe dayalı teklif yanıtı aracılığıyla gönderip makro genişletmeyi kullanarak oluşturma URL'si isteğinde alarak sınırlı içerik sinyalleri kullanabilir. Örneğin, belirli bir reklam alanı veya yayıncı sayfası bağlamında performansı artırmak için reklam öğesinin görünümünü ve tarzını özelleştirmek amacıyla oluşturma sinyalleri kullanılabilir.
Alıcının oluşturma sinyallerini içeriğe dayalı teklif yanıtına URL için güvenli dize olarak serileştirilmiş olarak ekleyebilirsiniz. Google, ${RENDER_DATA_buyer.origin.example[_OPTIONAL_SUFFIX]}
makrosunu oluşturarak kazanan ilgi alanı grubu oluşturma URL'sinde bu sinyalleri değiştirir.
Oluşturma sinyalleri, protokole bağlı olarak aşağıdaki alanlarla teklif yanıtında belirtilebilir:
- Google GZT:
BidResponse.interest_group_bidding.interest_group_buyer.rendering_signals
- OpenRTB:
BidResponse.ext.igbid.igbuyer.rsig
Farklı sinyalleri ayırt etmek için teklif yanıtına, farklı makro son eklerine sahip en fazla 3 oluşturma sinyali grubu eklenebilir. Örneğin, yalnızca reklam öğeleri için geçerli olan belirli bir sinyal grubunu, oluşturma URL'lerindeki karşılık gelen makroyla eşleştirmek için bir son ek kullanılabilir. Böylece, veri aktarımı boyutu azaltılabilir.
Sinyaller URL için güvenli değilse, makro sonekleri benzersiz değilse veya 3'ten fazla sinyal grubu sağlanmışsa ilgi alanı grubu alıcısının Korunan Kitle açık artırmasına katılması reddedilir.
Tarayıcı içi maksimum teklif fiyatını belirtin
Korunan Kitle teklifinde teklif hesaplaması ve son açık artırmanın yerel olarak cihaz üzerinde çalışması beklenir. Bu durum, kazanan teklif fiyatı gibi nihai açık artırma sonuçlarının bütünlüğünü etkileyebilecek potansiyel kötüye kullanım vektörleri oluşturabilir.
Google'ın GZT iş ortakları için Protected Audience API testi sırasında desteklenen bir çözüm olarak, her bir içeriğe dayalı teklif yanıtında beklenen maksimum teklif değeri belirtebilirsiniz. Beklenen maksimum teklif, teklif verme işlevinizin döndürmesi beklenen maksimum teklif fiyatıdır. Tarayıcı içi açık artırmadan bildirilen kazanan teklif bu tutarı aşarsa kazanan teklif faturalandırılabilir etkinlik olarak sayılmaz. Bu yaklaşım zaman içinde değiştirilebilir.
Teklif yanıtında, beklenen maksimum teklif değerini aşağıdaki alanlarda belirtebilirsiniz:
- Google RTB protokolü:
BidResponse.interest_group_bidding.interest_group_buyers.max_bid_cpm_micros
(mikro BGBM olarak ifade edilir) - OpenRTB:
BidResponse.igbid.igbuyer.maxbid
(BGBM para birimi cinsinden ifade edilir)
Gösterimleri birden çok hesapla ilişkilendirme
Teklif veren, ilgi alanı grubu teklifinin gösterimlerini aşağıdaki alanları kullanarak ilişkilendirmek için bir faturalandırma kimliği seçmelidir:
- Google RTB protokolü:
BidResponse.interest_group_bidding.interest_group_buyers.billing_id
- OpenRTB:
BidResponse.igbid.igbuyer.billing_id
Seçilen faturalandırma kimliği, teklif isteğindeki uygun bir faturalandırma kimliği olmalıdır:
- Google RTB protokolü:
BidRequest.adslot.matching_ad_data.billing_id
- OpenRTB:
BidRequest.imp.ext.billing_id
İlgi alanı grubu teklifli sistem gösterimlerini ilişkilendirecek faturalandırma kimliği sağlanmazsa teklif veren, Korunan Kitle açık artırmasına katılmaz.
Alt hesaplarda en fazla iki faturalandırma kimliği olabilir. Alıcı, içeriğe dayalı harcama için ve ilgi alanı grubu harcaması için başka bir faturalandırma kimliği kullanabilir. Bir alt hesap için iki faturalandırma kimliği yapılandırmak istiyorsanız hesap yöneticinize ulaşın.
Her faturalandırma kimliği için günlük bütçe ayarlamak mümkündür. Alt hesapların faturalandırma kimlikleri için günlük bütçeyi belirlemek üzere hesap yöneticinize ulaşın.
Gösterime teklif vermeye uygun kullanılabilir bütçesi olan tüm alt hesapların faturalandırma kimlikleri, harcama ilişkilendirmesi seçimi için teklif isteğinde görünür. Bir ilgi alanı grubu faturalandırma kimliğinin bütçesini değiştirmek için hesap yöneticinize ulaşın.
Tarayıcı içi açık artırma sırasında
Tarayıcı içi teklifler oluştur
Tarayıcı içi teklifler oluşturmak için generateBid()
kullanın.
Google aşağıdaki parametreleri sağlar:
auctionSignals
: BoşperBuyerSignals
: İçeriğe dayalı yanıtta teklif veren tarafından sağlanan aynı sinyalleri içeren bir JavaScript nesnesi
Aşağıdaki parametreler döndürülür:
ad
: Google bu alanı yoksayar.bid
: Açık artırmaya giren sayısal bir tekliftir. BGBM biriminde olmalıdır (mikrosaniye cinsinden değil).render
: Teklifin açık artırmayı kazanması durumunda reklam öğesini görüntülemek için oluşturulan URL. Google'ın bu URL'yi inceleyip onaylaması gerekir, aksi takdirde açık artırmadan filtrelenir.allowComponentAuction
:true
olmalıdır. Google şu anda çok satıcılı açık artırmaların test edilmesini desteklemektedir.
Aşağıda bir örnek verilmiştir:
function generateBid(...) {
...
return {'ad': 'example',
'bid': ad.metadata.bid,
'render': ad.renderUrl,
'allowComponentAuction': true};
}
generateBid()
işlevinin açıklaması için Korunan Kitle özelliğindeki Cihaz üzerinde Teklif Verme bölümüne bakın.
Teklif para birimi
Tarayıcı içi açık artırma teklifleri, seçilen teklif para biriminin BGBM birimleri cinsinden yerleştirilir.
Teklif para birimi, hem içeriğe dayalı teklif yanıtında hem de generateBid
değeri döndürülmeli ve "USD", "EUR" veya "JPY" gibi geçerli bir ISO 4217 alfa kodu olmalıdır.
OpenRTB'de, Google'ın teklif yanıtı uzantısındaki InterestGroupBuyer
nesnesindeki yeni cur
alanını kullanın.
Aşağıda bir örnek verilmiştir:
ext {
igbid {
impid: "1"
igbuyer {
origin: "https://examplebuyerorigin.com"
cur: "EUR"
}
}
}
Google RTB protokolünde, teklif yanıtındaki InterestGroupBuyer
mesajında yer alan yeni currency
alanını kullanın.
Aşağıda bir örnek verilmiştir:
interest_group_bidding {
adslot_id: 1
interest_group_buyer {
origin: "https://examplebuyerorigin.com"
currency: "EUR"
}
}
Teklif verenlerin generateBid
işlevleri, teklifleri içeriğe dayalı teklif yanıtında belirtilen para biriminde döndürmelidir. Yeni bidCurrency
özelliğini generateBid
öğesinin döndürülen değerine doldurun:
function generateBid(...) {
...
return {'ad': ad,
'bid': bid,
'bidCurrency': 'EUR',
...};
}
İçeriğe dayalı teklif yanıtındaki para birimi, generateBid
tarafından döndürülen para biriminden farklıysa veya her biri geçersiz bir para birimi döndürürse teklif, açık artırmadan önce filtrelenir.
Reklam kalitesi kontrolleri
Reklam öğesi politikası ve yayıncı denetimlerinin uygulanması, RTB iş ortakları için Protected Audience API testi sırasında tarayıcı içi ilgi alanı grubu teklifleri için daha kısıtlayıcı olabilir.
Dijital Hizmetler Yasası desteği
Dijital Hizmetler Yasası'nın 26. Maddesi uyarınca yayıncılar, alıcıların reklam içi şeffaflık açıklamaları oluşturmasını zorunlu kılabilir. "Alıcılardan, sitemde veya AEA'daki uygulamamda yalnızca DSA şeffaflık bilgilerine sahip reklamları göstermelerini iste" denetimi bir yayıncı tarafından etkinleştirildiğinde ilgi alanı grubu alıcıları, alınan teklif isteklerinde aşağıdaki alanları belirterek alıcı şeffaflığı oluşturmak için hangi fırsatların gerekli olacağını belirleyebilir: Google Authorized Buyers protokolü için BidRequest.dsa.dsa_support
ve BidRequest.dsa.publisher_rendering_support
, OpenRTB protokolü için BidRequest.regs.dsa.required
ve BidRequest.dsa.pubrender
.
Protected Audience API açık artırmalarına katılmak isteyen bir teklif veren, teklif isteğinde Protected Audience API aracılığıyla yayınlanan reklamlar için DSA şeffaflığının gösterilmesi gerektiğini belirten bir sinyal aldığında gerekli bilgileri uygun şekilde görüntüleyip görüntüleyemeyeceğini değerlendirmeli ve Google Authorized Buyers protokolü için veya BidResponse.ext.igbid.igbuyer.dsaadrender
OpenRTB protokolü için BidResponse.ext.igbid.igbuyer.dsaadrender
ayarlayarak belirtmelidir.BidResponse.interest_group_bidding.interest_group_buyers.dsa_buyer_render
Aksi takdirde alıcı, Protected Audience API açık artırmasına dahil edilmez.
Dijital Hizmetler Yasası Reklam Şeffaflığı hakkında daha fazla bilgi için Yardım Merkezi Makalesi: Dijital Hizmetler Yasası'nı Destekleme bölümüne bakın.
Teklif filtreleme
Google, cihaz üzerinde açık artırma sırasında yayıncı kontrollerini ve reklam politikalarını zorunlu kılar.
Tarayıcı içi açık artırmadan sonra
Açık artırma sonucunu alıcıya bildir: reportWin()
Google aşağıdaki bağımsız değişkenleri doldurmaz:
auctionSignals
sellerSignals
Açık artırma sonucunu alıcıya bildirmek için reportWin()
öğesini kullanın.
Daha fazla bilgi için Protected Audience API açıklayıcısının Oluşturma ve Reklam Etkinlikleriyle İlgili Alıcı Raporları bölümüne bakın.
Makrolar
Protected Audience API reklam öğesine başvuran renderUrl
, makro adı verilen bir veya daha fazla yer tutucu içerebilir. İlgi alanı grubu açık artırması sona erdikten sonra, ancak oluşturulmadan önce makrolar karşılık gelen değerlerle değiştirilir. Cihaz üzerinde açık artırmada kullanılan renderUrl
aşağıdaki makroları içerebilir:
${GDPR}
|
GDPR geçerli değilse 0'a, GDPR geçerliyse 1'e genişler. Belgelere göz atın. |
${GDPR_CONSENT_XXXX}
|
İstekle ilişkili Şeffaflık ve Kullanıcı Rızası (TC) dizesine genişler. Şeffaflık ve Kullanıcı Rızası (TC) dizesi boş veya geçersizse bu makro genişlemez.
TC dizesini bir URL'de IAB GVL'ye kayıtlı bir sağlayıcıya iletmek için bu makroyu kullanın.
Eklediğiniz IAB GVL kimliğiyle ilişkilendirilmiş IAB GVL'ye kayıtlı tedarikçinin kullanıcı izni yoksa ${GDPR_CONSENT_XXXX} makrosu, renderUrl içinde yalnızca bir kez bulunmalıdır.
|
${ADDL_CONSENT}
|
İstekle ilişkili Ek İzin (Eİ) dizesine genişler. |
${AD_WIDTH}, ${AD_HEIGHT)
|
Bu makrolar, reklam alanının genişliğini ve yüksekliğini ekler. |
${RENDER_DATA_buyer.origin.example[_OPTIONAL_SUFFIX]}
|
Teklif yanıtında belirtilen oluşturma zamanı alıcı sinyallerini içeren makro.
|
Gösterim sayımı
RTB iş ortaklarıyla Protected Audience API testi gerçekleştirilirken Google, tarayıcı reportResult()
işlevini çağırdığında ve ardından sendReportTo()
çağrısıyla Google'ın raporlama URL'sini getirdiğinde gösterimleri sayar.
Google tarafından tarayıcıdaki Protected Audience açık artırmalarındaki gösterimleri saymak için kullanılan etkinlik, GZT alıcı iş ortakları tarafından gösterimleri saymak için kullanılan etkinlikten farklı olabileceğinden gösterim sayıları farklı olabilir.
Google'ın Protected Audience API'yi test etme hedeflerinden biri bu tutarsızlıkları tespit edip azaltmaktır.
Faturalandırılabilir gösterimlerin ilişkilendirilmesi
Teklif verenin tarayıcı içi Korunan Kitle açık artırmalarındaki tüm harcamaları, teklif veren için yapılandırılan ilgi alanı grubu sahibi kaynaklarından gelen eşlemeye göre tek bir teklif veren hesabıyla ilişkilendirilir. Harcamanın teklif verenin farklı alt hesap hesaplarıyla ilişkilendirilmesi desteklenmez.
Günlük bütçe sınırı
Protected Audience API testi sırasında her hesabın hesap düzeyinde bir Protected Audience harcaması günlük bütçe sınırı vardır. Günlük bütçe sınırı, tarayıcı içi açık artırma ortamındaki riski sınırlar. Günlük bütçe sınırına ulaşıldığında hesap artık Protected Audience'a uygun teklif isteklerini almaz.
Hesap, korunan kitle sınırına ulaştıktan sonra sunucu tarafı içeriğe dayalı açık artırmalara katılmaya devam edebilir. Örneğin, korunan kitle sınırına ulaşan bir teklif veren hesabı, teklif isteği Protected Audience açık artırması için uygun olsa bile auction_environment
= SERVER_SIDE_AUCTION
(OpenRTB: 0
) ile bir teklif isteği alabilir.
Gerçek zamanlı geri bildirim ve kazanmak için minimum teklif
Gerçek zamanlı geri bildirim almayı kabul eden teklif verenler, cihaz üzerinde Protected Audience açık artırmasına dahil edilmek istenen ilgi alanı grubu alıcıları hakkında geri bildirim alır. Teklif verenin teklif yanıtı için belirttiği her ilgi alanı grubu alıcısı, ilgi alanı grubu alıcısının Protected Audience açık artırmasında kaç teklif verdiğinden bağımsız olarak bir geri bildirim nesnesi alır. İlgi alanı grubu alıcı geri bildirim nesnesinde aşağıdaki bilgiler yer alır:
- Geri bildirim nesnesinin geri bildirim türü
INTEREST_GROUP_BUYER_FEEDBACK
olur. - İlgi alanı grubu alıcısının kaynağı.
- Genel açık artırmayı kazanmak amacıyla ilgi alanı grubu alıcısı için kazanacak minimum teklif.
- Genel açık artırmanın sunucu tarafı bileşeninde en yüksek sıralamayı alan teklifi geçmek amacıyla ilgi alanı grubu alıcısı için kazanacak minimum teklif.
- İlgi alanı grubu alıcısının durum kodu. Olası durum kodları, interest-group-buyer-status-codes.txt içinde tanımlanır.
Belirli alan adları için Authorized Buyers RTB ve OpenRTB Uzantıları ile ilgili protokol belgelerine bakın.
Teklif geri bildirim bildirimi
Chrome, Protected Audience API için Ad Manager'ın Protected Audience teklifi hakkında geri bildirim içeren gerçek zamanlı sunucudan sunucuya hata ayıklama bildirimleri göndermesine olanak tanıyan bir geçici hata ayıklama API'si sağlar. Bu bildirimde, aşağıda açıklanan bir teklifle ilgili diğer bilgilerin yanı sıra Protected Audience'ın tarayıcı içi açık artırmasında tekliflerin filtrelenmiş olabileceği nedenler yer alır.
Teklif verenler, hesap yöneticileriyle iletişime geçerek Protected Audience hata ayıklama teklif geri bildirimi bildirimlerini yayınlamak üzere kullanılacak statik bir URL oluşturabilir. Bu statik URL, Protected Audience açık artırması tamamlandıktan sonra seçilen makrolar değiştirilerek Google sunucularından getirilir. Aşağıdaki makrolar desteklenir:
%%GOOGLE_QUERY_ID%%
: Bu makro, Protected Audience özellikli içeriğe dayalı teklif isteğinde gönderilen Google Sorgu Kimliği (Authorized Buyer protokolündeBidRequest.google_query_id
ve OpenRTB protokolündeBidRequest.ext.google_query_id
) ile değiştirilir.%%INTEREST_GROUP_OWNER%%
: İlgi alanı grubu sahibinin kaynağı.%%BID_CPM%%
: Alıcı tarafındangenerateBid()
işlevinde belirtilen BGBM teklif fiyatı.%%RENDER_URL%%
: Reklam öğesinin oluşturma URL'si.%%STATUS%%
: TeklifscoreAd()
içinde reddedildiyse bir durum kodu. Değerler, reklam öğesi durum kodlarıdır.
Aşağıda, teklif verenin hesap yöneticisine sağlayabileceği örnek statik URL'yi görebilirsiniz:
https://dsp.example/debug?google_query_id=%%GOOGLE_QUERY_ID%%&ig_owner=%%INTEREST_GROUP_OWNER%%&render_url=%%RENDER_URL%%&bid=%%BID_CPM%%&status=%%STATUS%%
Teklif geri bildirim bildirimi, Chrome'un geçici ForDebuggingOnly
API'sine bağlı olan geçici bir özelliktir.
Ürün düzeyinde TURTLEDOVE
Birden Fazla Parçadan Oluşan Reklamlar veya Ürün düzeyinde TURTLEDOVE (PLTD), Protected Audience API testi sırasında Google GZT iş ortakları için desteklenir. PLTD'yi test etmeyi planlıyorsanız ek kaynak ve yapılandırma gerekeceğinden, entegrasyon sırasında bunu hesap yöneticinize bildirin.
Oryantasyon
Protected Audience API'yi şu şekilde test edebilirsiniz:
Uygulanacak adımlar
- Protected Audience API denemesine katılmak için istek formunu doldurun.
- İstek formunu gönderdikten sonra hesap yöneticinize ulaşın veya Authorized Buyer Yardım Merkezi'ni kullanarak destek kaydı oluşturun.
- Hesap yapılandırıldıktan sonra, hem Google hem de iş ortağı Test aşamalarındaki adımları uygulayarak entegrasyonu doğrulayabilir.
Reklam Öğesi İncelemesi
Protected Audience API açık artırmalarında ürün düzeyinde reklamlarla (birden fazla parçadan oluşan reklamlar) teklif vermek için aşağıdaki koşulları yerine getirin:
- Reklam öğesi incelemesi sırasında üst düzey
renderUrls
'yi ayırt etmek için&pltd=True
sorgu parametresini bileşen reklamın kapsayıcısına (üst düzeyrenderUrl
olarak da adlandırılır) ilişkinrenderUrl
öğesine ekleyin. - Bileşen reklamın kapsayıcısı Google tarafından reklam öğesi incelemesi için alındığında temsili bir reklam öğesi oluşturun. Temsili reklam oluşturmanın ne zaman döndürülmesi gerektiğini anlamak için Google reklam öğesi inceleme sistemi tarafından ayarlanan
validation=True
sorgu parametresine bakabilirsiniz.
Entegrasyon kontrol listesi
- İçeriğe dayalı teklif yanıtındaki Protected Audience API ile ilgili alanları dolduracak bir teklif isteği uç noktası oluşturun (örneğin,
interest_group_bidding
). - Kullanıcının tarayıcısını ilgi alanı grubuna eklemek için reklamverenin sayfalarına etiketleme uygulayın.
generateBid()
vereportWin()
uygulayın.- İlgi alanı grubu sahibi kaynaklarını seçin ve bunları Authorized Buyer hesabına ekleyin.
- İlgi alanı grubu sahibi kaynakları,
generateBid()
işlevlerinin barındırıldığı kaynaklarla eşleşmelidir. - Bu adımı tamamlamak için hesap yöneticisine ulaşın veya Authorized Buyers Yardım Merkezi'ni kullanarak destek kaydı oluşturun.
- İlgi alanı grubu sahibi kaynakları,
- Protected Audience API testiyle ilgili envanter için ön hedefleme ayarlayın.
- Reklam öğelerini, Reklam Öğeleri API'si aracılığıyla inceleme ve onay için gönderin.
- (İsteğe bağlı) Güvenilir teklif sinyalleri uç noktalarını ayarlayın.
- (İsteğe bağlı) Google mühendislerinin tarayıcılarını ilgi alanı grubu alıcınızın kaynağına ait ilgi alanı gruplarına eklemelerine olanak tanıyan bir test reklamveren sayfası oluşturun. Bu sayede Protected Audience açık artırmalarını manuel olarak tetikleyebiliriz.
- (İsteğe bağlı) Protected Audience açık artırmasına dahil edilmesi istenen ilgi alanı grubu alıcıları hakkında geri bildirim almak için hesabınızda gerçek zamanlı geri bildirimi etkinleştirin.
- (İsteğe bağlı) Beklenmedik sorunları gidermenize yardımcı olması için cihaz üzerinde bir Protected Audience açık artırmasındaki bir teklifin durumu hakkında Korunan Kitle teklifi geri bildirimi sağlayan bir statik URL'yi sunucudan sunucuya bildirim alacak şekilde yapılandırmak için hesap yöneticinize ulaşın. Ayrıntılar için teklif geri bildirim bildirimine bakın.
Test aşamaları
1. Aşama: Manuel test
Korunan Kitle açık artırmasını manuel olarak tetiklemek, reklamın oluşturulabildiğinden emin olmak ve gösterimi kaydetmek için aşağıdaki adımları uygulayın:
- Chrome 101 veya sonraki bir sürümü kullanın.
chrome://flags/#privacy-sandbox-ads-apis
vechrome://flags/#enable-fenced-frames
kullanarak Privacy Sandbox API'yi ve Fenced Frame'i etkinleştirin. Daha fazla bilgi için Özel korumalı alanı test etme konusuna bakın.- Gerçek Zamanlı Teklif Verme API'sini kullanarak reklam öğesini onaya gönderin.
- Teklif verenin sahip olduğu ilgi alanı grubuna tarayıcı eklemek için teklif veren tarafından sağlanan reklamveren sayfasını kullanın.
Korunan Kitle açık artırmasını tetiklemek için Google tarafından sağlanan aşağıdaki test yayıncısı sayfasını kullanın:
https://fledge-testing.uc.r.appspot.com/?nid=allow_all
Tarayıcıdaki ilgi alanı grubu, geleneksel sunucu tarafı tekliflerle rekabet edebileceğinden açık artırmayı kazanacak kadar yüksek teklif vermelidir. Google ayrıca her iş ortağı için, yalnızca belirli iş ortağının açık artırmaya katılabileceği özel bir test yayıncısı sayfası sağlar. Bir iş ortağına özgü sayfada, tarayıcı içi açık artırmaları güvenilir bir şekilde kazanmak daha kolay olabilir.
Aşağıdakileri doğrulayın:
- Beklenen kazanan reklam oluşturulur.
- Açık artırma sonucu sunucu tarafında gönderilir. Diğer bir deyişle, kazanan teklif veren
reportWin()
tarafından geri ping alır. - Test yayıncısı sayfası konsolu, her teklif için aşağıdaki bilgileri içeren bir hata ayıklama mesajı kaydeder:
renderUrl
: Teklifin oluşturma URL'si.interestGroupOwner
: Teklifin ilgi alanı grubu sahibi.accepted
: Bu alan, teklif kabul edildiysetrue
ve teklifscoreAd()
tarafından reddedildiysefalse
olur.externalBidStatus
: TeklifscoreAd()
içinde reddedildiyse bir durum kodu. Değerler, reklam öğesi durum kodlarıdır.
2. Aşama: (İsteğe bağlı) Oluşturmama denemesi
Google ve iş ortağı, iş ortağının Protected Audience açık artırmasına katılabileceğini manuel olarak doğruladıktan sonra Google, iş ortağını testin bir sonraki aşamasında etkinleştirir.
Google, Protected Audience açık artırmalarını yürütmek için az miktarda canlı trafik ayırır. Böylece Google ve iş ortağının Korunan Kitle açık artırmasını manuel olarak tetiklemesine gerek kalmaz. Korunan Kitle açık artırmasının sonucu oluşturulmaz. Bu sayede entegrasyonu geniş ölçekte test edebiliyoruz.
Hazır olduğunuzda hesap yöneticinize ulaşın veya Authorized Buyer Yardım Merkezi'nden destek kaydı oluşturun. Google, hesabı bu aşamada etkinleştirir.
3. Aşama: Oluşturma Denemesi
Google ve iş ortağı, Protected Audience açık artırmalarını oluşturmadan geniş ölçekte doğruladıktan sonra Google, iş ortağının Protected Audience'ı kazanan reklamı oluşturmasını sağlayabilir. Google'ın, Protected Audience açık artırmalarının yayınlanmaya uygun olduğu ve kazanan ilgi alanı grubu reklamlarının oluşturulduğu az miktarda trafik vardır. Katılımcı teklif verenlerin tarayıcı içi teklifleri, geleneksel tekliflerle rekabet eder.
Hazır olduğunuzda hesap yöneticinize ulaşın veya Authorized Buyer Yardım Merkezi'nden destek kaydı oluşturun. Google, hesabı bu aşamada etkinleştirir.
Ek Özellikler
Aşağıdaki özellikler çekirdek protokolün uzantılarıdır.
Paralelleştirme
Paralelleştirme, trustedBiddingSignalsUrl
öğesinde belirtilen alıcı güvenilir sunucularına yapılan isteklere paralel olarak içeriğe dayalı reklam isteği başlatarak uçtan uca açık artırma gecikmesini azaltan bir optimizasyondur.
Paralelleştirme, gecikmeyi azaltır ancak ilgi alanı grubu alıcısının uygunluğunu ve koordine edilmiş denemelere desteğini etkiler. Paralelleştirme, cihaz üzerinde ilgi alanı grubu açık artırmasına katılan tüm teklif verenler için geçerlidir. Teklif verenlerin paralel açık artırmalara katılmak için herhangi bir işlem yapması gerekmez, ancak paralel yapma özelliğinin cihaz üzerinde açık artırmalara uygunluklarını nasıl etkileyebileceğini öğrenmesi gerekir. Koordine denemeler için deneme grubu kimlikleri, henüz paralel açık artırmalarda desteklenmemektedir.
Yayınlama akışı özeti
Paralel açık artırma akışının özetini aşağıda bulabilirsiniz:
Cihaz üzerinde ilgi alanı grubu alıcı uygunluğu
Paralel açık artırmalarda navigator.runAdAuction
çağrısı, içeriğe dayalı reklam yanıtı döndürülmeden önce gerçekleşir. Alıcı güvenilir sunucu çağrıları başlatmak için navigator.runAdAuction
, interestGroupBuyers
parametresinin değer olarak iletilmesini gerektirir. Diğer açık artırma parametreleri ise içeriğe dayalı reklam yanıtından sonra çözülebilen JavaScript Sözlerini kabul eder. interestGroupBuyers
, içeriğe dayalı reklam yanıtından önce iletildiğinden, belirli bir istek için hangi alıcıların paralel açık artırmaya katılacağını seçmek amacıyla içeriğe dayalı reklam yanıtı (teklif yanıtları dahil) kullanılamaz. Bunun yerine, Google'ın yayıncı etiketi, kullanıcının tarayıcısında önceki navigator.runAdAuction
parametresine ait interestGroupBuyers
parametresini önbelleğe alır. Bu parametre, aynı alan adında yürütülür.
Paralelleştirmede dikkate alınması gereken bazı önemli noktalar vardır:
Alıcı güvenilir sunucu istekleri için gerekli olmayan açık artırma sinyalleri (ör.
perBuyerSignals
), GZT teklif yanıtlarında, paralelleştirilmemiş açık artırmalarda olduğu gibi belirtilmeye devam edebilir. Bu sinyallerle ilgili taahhütler çözüme ulaştırıldıktan sonra cihaz üzerinde açık artırmanın geri kalan adımları, paralel olmayan açık artırma akışıyla aynı şekilde tamamlanacaktır.Paralelleştirme, ilgi alanı grubu alıcılarının listesinin önbelleğe alınmasına dayanır. Bu nedenle, paralel yapma önbelleği boş veya süresi dolmuş olabileceğinden Google her zaman paralel açık artırma çalıştırmaz. Önbellek boşsa veya süresi dolmuşsa Google, standart paralel olmayan bir Protected Audience API açık artırması çalıştırır ve ilgi alanı grubu alıcı önbelleğini oluşturmak amacıyla paralel olmayan açık artırmaya katılmak için alıcı niyetini kullanır.
Mevcut yayıncı alanı için herhangi bir teklif veren için en az bir alıcı önbelleğe alınmışsa Google, teklif isteğinde belirtilen bir paralel açık artırma gerçekleştirir.
- Google GZT Protokolü:
BidRequest.adslot.interest_group_auction.parallelized
- OpenRTB:
BidRequest.imp.ext.interest_group_auction.parallelized
- Google GZT Protokolü:
Paralel açık artırmaya dahil olan belirli bir teklif veren için kayıtlı her ilgi grubu alıcı kaynağı buna karşılık gelen bir
ParallelAuctionBuyer
girişine sahiptir:- Google GZT Protokolü:
BidRequest.adslot.interest_group_auction.parallel_auction_buyer
- OpenRTB:
BidRequest.imp.ext.interest_group_auction.pbuyer
- Google GZT Protokolü:
Paralel açık artırma yapılır ancak önbellekte belirli bir alıcı kaynağı yoksa bu alıcı, cihaz üzerindeki mevcut açık artırmaya eklenemez. Bu, belirli bir ilgi alanı grubu alıcı kaynağı için
ParallelAuctionBuyer
girişi bulunmayanparallelized=True
öğesine sahip bir istekle gösterilir. Bununla birlikte, teklif yanıtlarına geçerli ve uygunInterestGroupBuyer
öğeleri ekleyerek ilgi gösterdiğini belirten teklif verenlerin, karşılık gelen ilgi alanı grubu alıcı kaynakları önbelleğe eklenir ve bu kaynaklar, aynı tarayıcıdan ve alandan gelecek olan paralel istekler için uygun olur. İlgi alanı grubu açık artırmalarına katılma amacı aşağıdaki alanlarda belirtilebilir:- Google GZT Protokolü:
BidResponse.adslot.interest_group_bidding.interest_group_buyers
- OpenRTB:
BidResponse.ext.igbid.igbuyer
- Google GZT Protokolü:
Teklif verenin teklif yanıtına katılma niyeti belirtmediği önbelleğe alınmış alıcı kaynakları (paralel açık artırmanın
interestGroupBuyers
parametresine dahil edilir) alıcı güvenilir sunucu çağrısı alabilir ancak paralel açık artırmaya katılmaz.