Chrome, Özel Korumalı Alan kapsamında Protected Audience API'yi önerdi. Bu tarayıcı içi API, reklamverenlerin ve reklam teknolojisi şirketlerinin üçüncü taraf çerezlerine güvenmeden ilgi alanı grubu hedefli reklamlar göstermesine olanak tanırken kullanıcıları siteler arası izlemeye karşı korur.
Chrome, Protected Audience API için kaynak denemesi yapmaktadır. Authorized Buyers, Ad Manager yayıncı envanterinde Protected Audience API'nin testine katılabilir. Teklif verenler, Protected Audience API'yi test ederek aşağıdakileri yapabilir:
- Protected Audience API akışlarının etkinliği hakkında bilgi edinin ve bu akışları yineleyin.
- Herkese açık forumlarda (ör. GitHub) olası API iyileştirmeleriyle ilgili geri bildirim oluşturun.
- Üçüncü taraf çerezlerine güvenmeden API aracılığıyla kişiselleştirilmiş reklamcılığı desteklemeye hazırlanma.
Test etmek isteyen Authorized Buyers, ayrıntılar için İlk katılım bölümünü incelemelidir.
Yayın akışı özeti
Authorized Buyers iş ortakları için Protected Audience reklam yayını akışının bir özetini aşağıda bulabilirsiniz:
- Bir teklif veren, her reklamveren için ilgi alanları gruplarını korumak üzere reklamverenleriyle birlikte çalışır. Çoğu zaman reklamverenler, bir tarayıcıyı ilgi alanlarına eklemek için reklamverenin sayfasına teklif verenin etiketini eklerdi.
- Bir son kullanıcı, reklamverenin sayfasını ziyaret eder. Sayfada teklif verenin etiketi bulunuyor olabilir.
- Teklif verenin etiketi Protected Audience API'yi
joinAdInterestGroup()çağırır. Bu çağrı, tarayıcıdan kullanıcıyı bir ilgi alanları grubuna eklemesini ister. - 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, bir Google sunucusuna bağlamsal reklam isteğinde bulunur.
- Google, bağlamsal teklif isteklerini katılımcı teklif verenlere gönderir. Daha fazla bilgi için Teklif isteği değişiklikleri bölümüne bakın.
- Teklif veren, ilgi alanı grubu açık artırmasına katılmak için gereken
InterestGroupBiddingmesajını içeren bir teklif yanıtı döndürür. OpenRTB'de bu,BidResponse.ext.igbidalanı ile belirtilir. Destek sonlandırılan Google GZT protokolünde iseBidResponse.interest_group_biddingalanı ile belirtilir. Teklif veren bu bilgileri belirtmezse Google, teklif verenin kaynağını açık artırma yapılandırmasına dahil etmez.interestGroupBuyersInterestGroupBidding, tarayıcı içi açık artırma sırasında teklif verenin teklif verme işlevine iletilecek isteğe bağlı alıcıya özel sinyaller de içerebilir. OpenRTB'de bu,BidResponse.ext.igbid.igbuyer.buyerdataalanı ile belirtilir. Kullanımdan kaldırılan Google GZT protokolünde iseBidResponse.interest_group_bidding.interest_group_buyers.per_buyer_signalsalanı ile belirtilir. 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ırmada geleneksel sunucu tarafı teklifleri dikkate alınır. Teklif yanıtı, bağlamsal bir kazanan teklif hakkında bilgi içerebilir (varsa).
- Teklif yanıtı, tarayıcı içi açık artırma için bir açık artırma yapılandırması içerir. Bu, her katılımcı alıcıdan gelen bağlamsal sinyalleri (daha önce OpenRTB'nin
buyerdataveya kullanımdan kaldırılan Google RTB protokolününper_buyer_signalsaracılığıyla gönderilen), bağlamsal kazanan bilgilerini ve teklif uygunluğu ayarlarını içerebilir. - Google'ın yayıncı etiketi, cihaz üzerinde ilgi alanı grubu açık artırmasını başlatmak için Protected Audience API'yi
runAdAuction()çağırır. Google yalnızca açık artırma yapılandırması sırasındaInterestGroupBiddingiçindeInterestGroupBuyerolarak dahil edilen alıcıları içerir. - Google, her uygun teklif verenin isteğe bağlı alıcıya özel sinyallerini Protected Audience açık artırma yapılandırmasına iletir.
- Belirli bir teklif verenin ilgi alanı grupları
trustedBiddingSignalsUrldeğerini belirtiyorsa tarayıcı, her grup için gerçek zamanlı sinyalleri getirmek üzere her grubuntrustedBiddingSignalsUrldeğerine istekte bulunur. Ayrıntıları Protected Audience API spesifikasyonunda bulabilirsiniz. - Tarayıcı, tarayıcı içi açık artırmaya katılmayı kabul eden ve katılmaya uygun olan her ilgi alanı grubu için teklif verenin
generateBid()işlevini çağırır. Bu adımda teklif hesaplanır ve bir reklam öğesi seçilir.generateBid(), teklif veren tarafından sağlanan isteğe bağlı alıcı sinyallerine ve belirli ilgi alanı grubu için güvenilir teklif sinyallerine erişebilir. - Tarayıcı, ilgi alanı grubu reklam açık artırmasındaki her teklife bir sıralama atamak için satıcının (bu örnekte Google)
scoreAd()işlevini çağırır. Teklifler, yayıncı korumalarına, reklam politikalarına 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ırada yer alan bağlamsal 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ı, tarayıcı içi açık artırmanın kazananı hakkında her iki tarafı da bilgilendirmek için satıcının
reportResult()ve teklif vereninreportWin()işlevini çağırır. - Bir ilgi alanı grubu reklamı kazanırsa Google'ın yayıncı etiketi, reklamı bir iFrame'de oluşturur.
Sunma akışı ayrıntıları
Reklam yayınlamadan önce
Reklam öğesi incelemesi
Reklam öğelerinin, Protected Audience tarayıcı içi açık artırmalarında yayınlanabilmesi için Google tarafından incelenip onaylanması gerekir. Reklam öğelerini incelemeye göndermek için gerçek zamanlı teklif API'sini veya otomatik reklam öğesi taramayı kullanabilirsiniz. Tarayıcı içi Protected Audience ilgi alanı grubu reklam açık artırmalarına yönelik reklam öğeleri, inceleme için renderUrls içermelidir.
renderUrls ile ilgili şartlar:
- API aracılığıyla gönderilen
renderUrl, ilgi alanı grubu reklam açık artırmasında kullanılanrenderUrlile eşleşmelidir. - Her
renderUrlyalnızca tek bir reklamvereni veya reklam kampanyasını temsil edebilir. Belirli birrenderUrl, birden fazla reklamveren adına reklam oluşturmak için kullanılamaz. HerrenderUrltek bir reklam öğesiyle eşlenmelidir. renderUrl, Google'ın çevrimdışı reklam öğesi inceleme sistemleri tarafından erişilebilir ve reklamla son teklif verildikten sonraki 7 gün boyunca getirilebilir olmalıdır.
Real-time Bidding API
Teklif verenler, ilgi alanı grubu teklifi için reklam öğelerini yüklemek üzere Real-time Bidding API'yi kullanabilir.
Otomatik reklam öğesi taraması
Teklif verenler, Gerçek Zamanlı Teklif Verme API'si üzerinden 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ırmadaki reklam öğelerini bulur ve gelecekteki açık artırmalarda kullanılabilmeleri için bunları otomatik olarak tarar.
Otomatik reklam öğesi taramayı etkinleştirmek için:
İlgi alanı grubu reklam öğesinin tüm
renderUrlkaynaklarını yetkili alıcı hesabına ekleyin.Aşağıdaki özel HTTP üstbilgilerini reklam öğesinin HTTP yanıtına ekleyin:
Authorized-Buyers-Creative-IDstring
Alıcıya özgü reklam öğesi kimliği. Reklam öğesi kimliğinin maksimum uzunluğu 128 bayttır.
Authorized-Buyers-Click-Through-URLsstring
Reklam öğesi için RFC2396'ya göre kodlanmış, beyan edilen hedef URL'ler kümesi.
Ö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 öğesinin süresi dolma
Reklam öğeleri 15 gün boyunca onaylanır. Reklam öğelerini anlık teklif verme API'si ile gönderirseniz 15 gün sonra reklam öğesini yeniden göndermeniz gerekir. Otomatik reklam öğesi taramasına güveniyorsanız tarama işlemi bunları otomatik olarak yeniden tarar.
Alıcı Raporlama Kimliği
Alıcı tarafından sağlanan boyutları (ör. kampanya kimliği veya reklamveren kimliği) kullanarak raporlama metriklerini (ör. gösterim sayısı) ayrıntılandırabilirsiniz. İlgi alanı grubu harcamaları için bir 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 verilmiştir:
const myGroup = {
...
'ads': [
{
...
'buyerAndSellerReportingId':
'{"google_signals": {"buyer_reporting_id": "12345"}}',
...
}
]
}
joinAdInterestGroup(myGroup);
buyer_reporting_id, Authorized Buyers Raporlama Aracı'nda Alıcı Raporlama Kimliği boyutu olarak yeni bir boyut şeklinde 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 erken sürümleri verilmiştir:
- OpenRTB erken bağlantısı
- Google GZT protokolü (desteği sonlandırıldı) erken bağlantı
İlgi grubu açık artırması desteğini belirtme
Teklif isteklerinde, ilgi alanı grubu açık artırmaları desteğini belirtmek için yeni alanlar bulunur:
- OpenRTB:
BidRequest.imp.ext.aeBidRequest.imp.ext.igbid
- Google GZT Protokolü (kullanımdan kaldırıldı):
BidRequest.adslot.supported_auction_environmentBidRequest.adslot.interest_group_bidding_allowed
Bu alanı, tarayıcıda Protected Audience ilgi alanı grubu açık artırmasını destekleyen gösterim fırsatları ile yalnızca geleneksel sunucu tarafı değişim açık artırmasını destekleyen gösterim fırsatları arasında ayrım yapmak için kullanabilirsiniz. AuctionEnvironment enum'u aşağıdaki değerleri içerebilir:
SERVER_SIDE_AUCTION(OpenRTB JSON:0): Kazanan reklamı belirleyen açık artırma, borsanın sunucularında çalışır.ON_DEVICE_INTEREST_GROUP_AUCTION(OpenRTB JSON:1): Protected Audience desteği olan istekler. Bu isteklerde, borsa sunucularında bağlamsal bir açık artırma yürütülür ve ilgi alanı grubu teklifi ile son açık artırma tarayıcıda yürütülür.SERVER_SIDE_INTEREST_GROUP_AUCTION(OpenRTB JSON:3): Bağlamsal açık artırma, exchange'in sunucularında çalışır. İlgi alanı grubu teklifleri için teklif verme mantığı ve son kazanan reklamı belirlemek için puanlama mantığı Teklif verme ve açık artırma sunucularında çalıştırılır.
Protected Audience reklam alanı boyutunu belirtme
Teklif isteği, Protected Audience reklam alanı boyutunu sağlamak için aşağıdaki alanları içerir:
- OpenRTB:
BidRequest.imp.ext.interest_group_auction.widthBidRequest.imp.ext.interest_group_auction.height
- Google GZT Protokolü (kullanımdan kaldırıldı):
BidRequest.adslot.interest_group_auction.widthBidRequest.adslot.interest_group_auction.height
Bu alanlar, Protected Audience açık artırması için reklam alanının boyutunu piksel cinsinden belirtir.
Bu boyut, bağlamsal istektekilerden farklı olabilir. Örneğin, OpenRTB'nin BidRequest.imp.banner.format.w ve BidRequest.imp.banner.format.h alanlarında veya kullanımdan kaldırılan Google GZT protokolünün BidRequest.adslot.width ve BidRequest.adslot.height alanlarında görülenler farklı olabilir.
Bağlamsal istek birden fazla boyuta sahip olabilir. Cihaz üzerinde açık artırmayı kazanan reklamın yalnızca tek bir sabit yuva boyutunu doldurması beklenir.
Protected Audience reklamının oluşturulabilirliğini belirtme
Protected Audience reklamları, mevcut entegrasyon aşamasına bağlı olarak oluşturulabilir veya oluşturulmayabilir (bkz. oluşturulmayan reklam denemesi). Teklif isteğindeki render_interest_group_ads
alanı, kazanan Protected Audience reklamının oluşturulup oluşturulmayacağını gösterir.
- OpenRTB:
BidRequest.imp.ext.interest_group_auction.render_interest_group_ads - Google GZT Protokolü (kullanımdan kaldırıldı):
BidRequest.adslot.interest_group_auction.render_interest_group_ads
Kullanıcı tanımlayıcılarına güvenmeyi en aza indirin
Protected Audience API testi kapsamındaki bağlamsal teklif istekleri, tarayıcıda kullanılabilir olduğunda BidRequest.user.id ve BidRequest.user.buyerid alanları gibi geleneksel çerez tabanlı tanımlayıcıları veya kullanımdan kaldırılan Google RTB protokolündeki BidRequest.google_user_id ve BidRequest.hosted_match_data alanlarını taşımaya devam edebilir. Teklif isteklerinde bu tür tanımlayıcıların bulunması, mevcut gizlilik politikalarına tabidir. Üçüncü taraf çerezleri artık kullanılamadığında verimli satın alma için daha iyi hazırlanmak amacıyla test sırasında hedefleme ve teklif verme işlemleri için ç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 çıkarıldığı küçük ölçekli denemeler de yapabilir. Bu, üçüncü taraf çerezleri desteğinin sonlandırılmasının olası etkisini değerlendirmek için yapılır.
Chrome'un desteklediği üçüncü taraf çerez desteğinin sonlandırılması testi
Chrome, 2024'te üçüncü taraf çerezlerinin desteğinin sonlandırılmasına (3PCD) hazırlanmak için artık Chrome tarafından kolaylaştırılan testler sunuyor.
Siteler ve sağlayıcılar, sistemlerini 3PCD kapsamında test etmek için Chrome tarafından kolaylaştırılan testleri kullanabilir. Testte, Chrome tarayıcılar 3PCD deneme grubuna (A modu veya B modu) atanır. Her tarayıcıya, tarayıcı içi Chrome API'si üzerinden erişebileceğiniz belirli bir 3PCD deneme grubuna karşılık gelen tutarlı bir etiket atanır.
Google, Chrome API'den alınan değiştirilmemiş etiketi RTB teklif isteğine iletir. Google, tek bir etiketin küçük trafik dilimleri nedeniyle etiketi her zaman gizlilikle sınırlı bağlamlara dahil etmez.
Etiketi görebileceğiniz alanlar şunlardır:
- OpenRTB:
BidRequest.device.ext.cdep - Google GZT Protokolü (kullanımdan kaldırıldı):
BidRequest.device.cookie_deprecation_label
Teklif yanıtı değişiklikleri
İlgi grubu açık artırmasına katılımı belirtme
Bağlamsal teklif yanıtında InterestGroupBidding nesnesini döndürerek tarayıcı içi açık artırmaya katılma niyetinizi açıkça belirtmekten siz sorumlusunuz:
- OpenRTB:
BidResponse.ext.igbid - Google GZT Protokolü (kullanımdan kaldırıldı):
BidResponse.interest_group_bidding
Bağlamsal bir teklif yanıtı sağlamanız gerekir. Yanıtın bağlamsal teklif içermesi gerekmez. InterestGroupBidding nesnesi, her InterestGroupBuyer için 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 çağrıları yapıldığında origin, açık artırma yapılandırmasının interestGroupBuyers bölümüne eklenir
runAdAuction().
Alıcı içerik sinyallerini yayma
Google'ın perBuyerSignals bağımsız değişkeni aracılığıyla cihaz üzerinde teklif verme işlevine bir JSON nesnesi olarak yaydığı bağlamsal teklif yanıtına alıcının sinyallerini ekleyebilirsiniz. Bu, protokole bağlı olarak aşağıdaki alanlarla birlikte teklif yanıtına dahil edilebilir:
- OpenRTB:
BidResponse.ext.igbid.igbuyer.buyerdata - Google RTB (kullanımdan kaldırıldı):
BidResponse.interest_group_bidding.per_buyer_signals
Alıcı içerik oluşturma sinyallerini yayma
İlgi alanı grubu reklam öğeleri, oluşturma sırasında sınırlı içerik sinyallerini kullanabilir. Bu sinyaller, içerik teklifi yanıtı aracılığıyla gönderilir ve makro genişletme kullanılarak oluşturma URL'si isteğinde alınır. Örneğin, oluşturma sinyalleri, 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 kullanılabilir.
Bağlamsal teklif yanıtına, alıcının URL güvenli dize olarak serileştirilmiş oluşturma sinyallerini ekleyebilirsiniz. Google, ${RENDER_DATA_buyer.origin.example[_OPTIONAL_SUFFIX]} makrosunu oluşturarak kazanan ilgi alanı grubu oluşturma URL'sinde bu sinyallerin yerini alır.
Oluşturma sinyalleri, protokole bağlı olarak aşağıdaki alanlarla teklif yanıtında belirtilebilir:
- OpenRTB:
BidResponse.ext.igbid.igbuyer.rsig - Google RTB (kullanımdan kaldırıldı):
BidResponse.interest_group_bidding.interest_group_buyer.rendering_signals
Farklı makro sonekleri olan en fazla 3 grup oluşturma sinyali, farklı sinyalleri ayırt etmek için teklif yanıtına dahil edilebilir. Örneğin, yalnızca oluşturma URL'lerinde ilgili makroya sahip reklam öğeleri için geçerli olan belirli bir sinyal grubunu eşleştirmek için bir sonek kullanılabilir. Böylece veri aktarımı boyutu küçülür.
Sinyaller URL 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 Protected Audience açık artırmasına katılması reddedilir.
Tarayıcı içi maksimum teklif fiyatını belirtin
Protected Audience teklifinde, teklif hesaplamasının ve nihai açık artırmanın cihaz üzerinde yerel olarak çalışması beklenir. Bu durum, nihai açık artırma sonuçlarının (ör. kazanan teklif fiyatı) bütünlüğünü etkileyebilecek potansiyel kötüye kullanım vektörleri oluşturabilir.
Google tarafından RTB iş ortakları için Protected Audience API testi sırasında desteklenen bir azaltma önlemi olarak, her bağlamsal teklif yanıtında bir beklenen maksimum teklif değeri belirtebilirsiniz. Beklenen maksimum teklif, teklif 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 değişebilir.
Teklif yanıtında, beklenen maksimum teklif değerini aşağıdaki alanlarda belirtebilirsiniz:
- OpenRTB:
BidResponse.igbid.igbuyer.maxbid(BGBM para birimi cinsinden ifade edilir) - Google GZT protokolü (kullanımdan kaldırıldı):
BidResponse.interest_group_bidding.interest_group_buyers.max_bid_cpm_micros(mikro eCPM olarak ifade edilir)
Gösterimleri birden fazla hesapla ilişkilendirme
Bir teklif veren, aşağıdaki alanları kullanarak ilgi alanı grubu teklifinin gösterimlerini ilişkilendirmek için bir faturalandırma kimliği seçmelidir:
- OpenRTB:
BidResponse.igbid.igbuyer.billing_id - Google GZT protokolü (kullanımdan kaldırıldı):
BidResponse.interest_group_bidding.interest_group_buyers.billing_id
Seçilen faturalandırma kimliği, teklif isteğindeki uygun bir faturalandırma kimliği olmalıdır:
- OpenRTB:
BidRequest.imp.ext.billing_id - Google GZT protokolü (kullanımdan kaldırıldı):
BidRequest.adslot.matching_ad_data.billing_id
İlgi alanı grubu teklifi gösterimlerinin ilişkilendirileceği faturalandırma kimliği sağlanmazsa teklif veren, Protected Audience açık artırmasına katılmaz.
Alt hesapların en fazla iki faturalandırma kimliği olabilir. Alıcı, içerik harcaması için bir faturalandırma kimliği, ilgi alanı grubu harcaması için ise diğerini kullanabilir. Bir alt hesap için iki faturalandırma kimliği yapılandırmak istiyorsanız hesap yöneticinizle iletişime geçin.
Her faturalandırma kimliği için günlük bütçe belirleyebilirsiniz. Alt hesapların faturalandırma kimlikleri için günlük bütçeyi ayarlamak üzere hesap yöneticinizle iletişime geçin.
Gösterime teklif vermeye uygun kullanılabilir bütçeye sahip tüm alt hesapların faturalandırma kimlikleri, harcama ilişkilendirme seçimi için teklif isteğinde gösterilir. Bir ilgi alanı grubu faturalandırma kimliğinin bütçesini değiştirmek için hesap yöneticinizle iletişime geçin.
Tarayıcı içi açık artırma sırasında
Tarayıcı içi teklifler oluşturma
Tarayıcı içi teklifler oluşturmak için generateBid()'ı kullanın.
Google aşağıdaki parametreleri sağlar:
auctionSignals: BoşperBuyerSignals: Bağlamsal yanıtta teklif veren tarafından sağlanan sinyallerin aynısını içeren bir JavaScript nesnesi
Aşağıdaki parametreler döndürülür:
ad: Google bu alanı yok sayar.bid: Açık artırmaya giren sayısal teklif. CPM birimlerinde olmalıdır (mikro birimlerde değil).render: Teklif açık artırmayı kazanırsa reklam öğesini göstermek için oluşturulan URL. Google bu URL'yi inceleyip onaylamalıdır. Aksi takdirde URL, açık artırmadan filtrelenir.allowComponentAuction:trueolmalıdır. Google şu anda birden fazla satıcının yer aldığı açık artırmaların test edilmesini desteklemektedir.
Aşağıda bununla ilgili 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 Protected Audience spesifikasyonunun 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 birimlerinde verilir.
Teklif para birimi hem bağlamsal teklif yanıtında hem de generateBid dönüş değerinde belirtilmelidir 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 nesnesinde yeni cur alanını kullanın.
Aşağıda bununla ilgili 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 yeni currency alanını kullanın.
Aşağıda bununla ilgili bir örnek verilmiştir:
interest_group_bidding {
adslot_id: 1
interest_group_buyer {
origin: "https://examplebuyerorigin.com"
currency: "EUR"
}
}
Teklif verenlerin generateBid işlevleri, bağlamsal teklif yanıtında belirtildiği gibi aynı para biriminde teklif döndürmelidir. bidCurrency özelliğini generateBid'nin dönüş değerine göre doldurun:
function generateBid(...) {
...
return {'ad': ad,
'bid': bid,
'bidCurrency': 'EUR',
...};
}
Bağlamsal teklif yanıtındaki para birimi, generateBid tarafından döndürülen para biriminden farklıysa veya her ikisi de geçersiz bir para birimi döndürürse teklif, açık artırmadan önce filtrelenir.
Reklam kalitesi kontrolleri
RTB iş ortakları için Protected Audience API testi sırasında tarayıcı içi ilgi alanı grubu teklifleri için reklam öğesi politikası ve yayıncı denetimleri yaptırımı 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 tutabilir. "Alıcılardan, AEA'daki sitemde veya uygulamamda yalnızca DSA şeffaflık bilgileri içeren reklamları göstermesini iste" kontrolü bir yayıncı tarafından etkinleştirildiğinde ilgi alanı grubu alıcıları, teklif isteğindeki BidRequest.regs.dsa.required ve BidRequest.dsa.pubrender değerlerine (kullanımdan kaldırılan Google GZT protokolünde sırasıyla BidRequest.dsa.dsa_support ve BidRequest.dsa.publisher_rendering_support) bakarak alıcı şeffaflığı sağlamaları gereken fırsatları belirleyebilir.
Protected Audience API açık artırmalarına katılmak isteyen bir teklif veren, 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 düzgün şekilde gösterip gösteremeyeceğini değerlendirmeli ve BidResponse.ext.igbid.igbuyer.dsaadrender (kullanımdan kaldırılan Google GZT protokolünde BidResponse.interest_group_bidding.interest_group_buyers.dsa_buyer_render) ayarını yaparak belirtmelidir. 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 başlıklı makaleyi inceleyin.
Teklif filtreleme
Google, cihaz üzerinde açık artırma sırasında yayıncı denetimlerini ve reklam politikalarını uygular.
Tarayıcı içi açık artırmadan sonra
Açık artırma sonucunu alıcıya bildirme: reportWin()
Google aşağıdaki bağımsız değişkenleri doldurmaz:
auctionSignalssellerSignals
Açık artırma sonucunu alıcıya bildirmek için reportWin() simgesini 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 referans veren renderUrl, makro adı verilen bir veya daha fazla yer tutucu içerebilir. İlgi alanı grubu açık artırması sona erdikten sonra ancak oluşturmadan önce makrolar, ilgili 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, GDPR geçerliyse 1 olarak genişletilir. 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şletilmez.
TC dizesini bir URL'de IAB GVL'ye kayıtlı bir tedarikçiye iletmek için bu makroyu kullanın.
${GDPR_CONSENT_XXXX} makrosu, renderUrl içinde yalnızca bir kez bulunmalıdır.
|
${ADDL_CONSENT}
|
İstekle ilişkili Ek İzin (AC) dizesine genişler. |
${AD_WIDTH}, ${AD_HEIGHT)
|
Bu makrolar, reklam alanı 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ı
Google, RTB iş ortaklarıyla Protected Audience API testi sırasında tarayıcı reportResult() işlevini çağırdığında ve ardından sendReportTo() işlevine yapılan bir çağrıda Google'ın raporlama URL'sini getirdiğinde gösterimleri sayar.
Google'ın tarayıcı içi Protected Audience açık artırmalarında gösterimleri saymak için kullandığı etkinlik, RTB alıcı iş ortaklarının gösterimleri saymak için kullandığı etkinlikten farklı olabileceğinden gösterim sayıları farklı olabilir.
Google'ın Protected Audience API'yi test etme hedeflerinden biri bu tutarsızlıkları belirleyip azaltmaktır.
Faturalandırılabilir gösterimlerin ilişkilendirilmesi
Bir teklif verenin tarayıcı içi Protected Audience açık artırmalarındaki tüm harcamaları, teklif veren için yapılandırılan ilgi alanı grubu sahibi kaynaklarından yapılan eşlemeye göre tek bir teklif veren hesabına atanır. Harcamayı bir teklif verenin farklı alt teklif vereni hesaplarıyla ilişkilendirme desteklenmez.
Günlük bütçe sınırı
Protected Audience API testi sırasında her hesabın hesap düzeyinde Protected Audience harcaması için 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 için uygun teklif istekleri almaz.
Hesap, Protected Audience sınırına ulaştıktan sonra sunucu tarafı bağlamsal açık artırmalara katılmaya devam edebilir. Örneğin, Protected Audience sınırına ulaşan bir teklif veren hesabı, teklif isteği bir Protected Audience açık artırması için uygun olsa bile auction_environment
= SERVER_SIDE_AUCTION (OpenRTB JSON: 0) ile bir teklif isteği alabilir.
Anlık geri bildirim ve kazanmak için minimum teklif
Gerçek zamanlı geri bildirim almayı etkinleştiren teklif verenler, cihaz üzerinde Protected Audience açık artırmasına dahil edilmesi istenen ilgi alanı grubu alıcıları için geri bildirim alır. Bir teklif veren tarafından teklif yanıtında belirtilen her ilgi alanı grubu alıcısı, Protected Audience açık artırmasına kaç teklif verdiği fark etmeksizin bir geri bildirim nesnesi alır. İlgi grubu alıcı geri bildirimi nesnesinde aşağıdaki bilgiler yer alır:
- Geri bildirim nesnesinin geri bildirim türü
INTEREST_GROUP_BUYER_FEEDBACKolur. - İlgi grubu alıcısının kaynağı.
- Genel açık artırmayı kazanmak için ilgi alanı grubu alıcısının kazanmak için vermesi gereken minimum teklif.
- Genel açık artırmanın sunucu tarafı bileşeninden gelen en yüksek sıralı teklifi geçmek için ilgi alanı grubu alıcısının kazanmak üzere vermesi gereken minimum teklif.
- İlgi grubu alıcısının durum kodu. Olası durum kodları, interest-group-buyer-status-codes.txt dosyasında tanımlanır.
Belirli alan adları için Authorized Buyers GZT ve OpenRTB Uzantıları protokol belgelerine bakın.
Teklif geri bildirimi bildirimi
Chrome, Protected Audience API için geçici bir hata ayıklama API'si sağlar. Bu API, Ad Manager'ın Protected Audience teklifiyle ilgili geri bildirim içeren gerçek zamanlı sunucudan sunucuya hata ayıklama bildirimleri göndermesine olanak tanır. Bu bildirimde, tekliflerin Protected Audience tarayıcı içi açık artırmasında filtrelenmiş olabileceği nedenlerin yanı sıra aşağıda açıklanan teklifle ilgili diğer bilgiler de yer alır.
Teklif verenler, Protected Audience hata ayıklama teklifi geri bildirim bildirimlerini sunmak için kullanılacak statik bir URL yapılandırmak üzere hesap yöneticileriyle iletişime geçebilir. 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'ın etkinleştirildiği bağlamsal teklif isteğinde gönderilen Google sorgu kimliğiyle değiştirilir. OpenRTB protokolünde bu,BidRequest.ext.google_query_idile belirtilirken kullanımdan kaldırılan Google GZT protokolündeBidRequest.google_query_idkullanılır.%%INTEREST_GROUP_OWNER%%: İlgi alanı grubu sahibinin kaynağı.%%BID_CPM%%: Alıcı tarafındangenerateBid()işlevinde belirtilen BGBM'deki teklif fiyatı.%%RENDER_URL%%: Reklam öğesinin oluşturma URL'si.%%STATUS%%: TeklifscoreAd()içinde reddedildiyse durum kodu. Değerler reklam öğesi durumu kodlarıdır.
Aşağıda, bir teklif verenin hesap yöneticisine sağlayabileceği örnek bir statik URL verilmiştir:
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 bildirimi bildirimi, Chrome'un geçici ForDebuggingOnly API'sine bağlı 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 entegrasyon sırasında hesap yöneticinize bildirin. Ek kaynak ve yapılandırma gerekir.
Oryantasyon
Protected Audience API'yi nasıl test edebileceğiniz aşağıda açıklanmıştır:
Adımlar
- Protected Audience API denemesine katılmak için istek formunu doldurun.
- İstek formunu gönderdikten sonra hesap yöneticinize ulaşın veya Yetkili Alıcı Yardım Merkezi'ni kullanarak bir destek kaydı oluşturun.
- Hesap yapılandırıldıktan sonra hem Google hem de iş ortağı, Test aşamaları bölümündeki adımları uygulayarak entegrasyonu doğrulayabilir.
Reklam öğesi incelemesi
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ı karşılamanız gerekir:
- Reklam öğesi incelemesi sırasında üst seviye
renderUrlsöğesini ayırt etmek için bileşen reklamının kapsayıcısı (üst seviyerenderUrlolarak da adlandırılır) içinrenderUrlöğesine&pltd=Truesorgu parametresini ekleyin. - Google tarafından reklam öğesi incelemesi için bileşen reklamının kapsayıcısı getirildiğinde temsili bir reklam öğesi oluşturun. Temsili bir reklam oluşturmanın ne zaman döndürülmesi gerektiğini anlamak için Google reklam öğesi inceleme sistemi tarafından ayarlanan
validation=Truesorgu parametresine bakabilirsiniz.
Entegrasyon kontrol listesi
- Bağlamsal teklif yanıtında Protected Audience API ile ilgili alanları dolduracak bir teklif isteği uç noktası ayarlayın. Örneğin,
interest_group_bidding. - Kullanıcının tarayıcısını ilgi alanları grubuna eklemek için reklamverenin sayfalarında etiketleme uygulayın.
generateBid()vereportWin()işaretlemelerini uygulayın.- İlgi grubu sahibi kaynaklarını seçin ve bunları Yetkili Alıcı 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öneticisiyle iletişime geçin veya Yetkili Alıcı Yardım Merkezi'ni kullanarak destek kaydı oluşturun.
- İlgi alanı grubu sahibi kaynakları,
- Protected Audience API testiyle alakalı envanter için ön hedefleme ayarlayın.
- Creatives API aracılığıyla reklam öğelerini 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 eklemesine 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ı için geri bildirim almak üzere hesabınızda gerçek zamanlı geri bildirimi etkinleştirin.
- (İsteğe bağlı) Beklenmedik sorunların hata ayıklamasına yardımcı olmak için cihaz üzerinde Protected Audience açık artırmasından gelen bir teklifin durumuyla ilgili Protected Audience teklif geri bildirimi sağlayan bir sunucudan sunucuya bildirim almak üzere statik bir URL yapılandırmak için hesap yöneticinizle iletişime geçin. Ayrıntılar için teklif geri bildirimi bildirimini inceleyin.
Test aşamaları
1. aşama: Manuel test
Protected Audience açık artırmasını manuel olarak nasıl tetikleyeceğiniz, reklamın oluşturulabilmesini nasıl sağlayacağınız ve gösterimi nasıl kaydedeceğiniz aşağıda açıklanmıştır:
- Chrome 101 veya sonraki sürümlerini kullanın.
chrome://flags/#privacy-sandbox-ads-apisvechrome://flags/#enable-fenced-frameskullanarak Privacy Sandbox API'sini ve Fenced Frame'i etkinleştirin. Daha fazla bilgi için Özel Korumalı Alan'ın gizlilik özelliklerini test etme başlıklı makaleyi inceleyin.- Gerçek Zamanlı Teklif API'sini kullanarak onay için bir reklam öğesi gönderin.
- Teklif veren tarafından sağlanan reklamveren sayfasını kullanarak teklif verene ait ilgi alanına dayalı gruba tarayıcı ekleyin.
Protected Audience açık artırmasını tetiklemek için Google tarafından sağlanan aşağıdaki test yayıncı sayfasını kullanın:
https://fledge-testing.uc.r.appspot.com/?nid=allow_all
Tarayıcı içi ilgi alanı grubu, geleneksel sunucu tarafı teklifleriyle rekabet edebileceği için açık artırmayı kazanmak için yeterince yüksek teklif vermelidir. Google ayrıca her iş ortağı için özel bir test yayıncı sayfası sağlar. Bu sayfada açık artırmaya yalnızca ilgili iş ortağı katılabilir. Tarayıcı içi açık artırmaları iş ortağına özel bir sayfada 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. Yani kazanan teklif sahibi,
reportWin()tarafından ping yanıtı alır. - Test yayıncı sayfası konsolu, aşağıdaki bilgileri içeren her teklif için bir hata ayıklama mesajı kaydeder:
renderUrl: Teklifin oluşturma URL'si.interestGroupOwner: Teklifin ilgi alanı grubu sahibi.accepted: Teklif kabul edildiyse bu alantrue, teklifscoreAd()tarafından reddedildiysefalseolur.externalBidStatus: TeklifscoreAd()içinde reddedildiyse durum kodu. Değerler reklam öğesi durumu kodlarıdır.
2. aşama: (İsteğe bağlı) Oluşturulmayan öğeler 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ın testin bir sonraki aşamasına geçmesini sağlar.
Google, Protected Audience açık artırmalarını yürütmek için az miktarda canlı trafik ayırır. Ardından, Google ve iş ortağının artık Protected Audience açık artırmasını manuel olarak tetiklemesi gerekmez. Protected Audience açık artırmasının sonucu oluşturulmaz. Bu sayede entegrasyonu büyük ölçekte test edebiliriz.
Hazır olduğunuzda hesap yöneticinizle iletişime geçin veya Authorized Buyers Yardım Merkezi üzerinden bir destek kaydı oluşturun. Google, bu aşama için hesabı etkinleştirir.
3. aşama: Oluşturma denemesi
Google ve iş ortağı, Protected Audience açık artırmalarını oluşturmadan büyük ölçekte doğruladıktan sonra Google, iş ortağının Protected Audience açık artırmasını kazanan reklamı oluşturmasına olanak tanıyabilir. Google'da 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öneticinizle iletişime geçin veya Authorized Buyers Yardım Merkezi üzerinden bir destek kaydı oluşturun. Google, bu aşama için hesabı etkinleştirir.
Ek Özellikler
Aşağıdaki özellikler, temel protokolün uzantılarıdır.
Paralelleştirme
Paralelleştirme, trustedBiddingSignalsUrl içinde belirtilen alıcı tarafından güvenilen sunuculara yapılan isteklerle birlikte bağlamsal reklam isteğini 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 koordineli denemeler desteğini etkiler. Paralelleştirme, cihaz üzerinde ilgi 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 paralelleştirmenin cihaz üzerinde açık artırmalarda uygunluklarını nasıl etkileyebileceği konusunda bilgi sahibi olmaları gerekir. Koordineli denemeler için deneme grubu kimlikleri, paralel açık artırmalarda henüz desteklenmemektedir.
Yayın akışı özeti
Paralel açık artırma akışının özeti aşağıda verilmiştir:
Cihaz üzerinde ilgi grubu alıcı uygunluğu
Paralel açık artırmalarda, navigator.runAdAuction çağrısı, bağlamsal reklam yanıtı döndürülmeden önce gerçekleşir. Alıcı tarafından güvenilen sunucu çağrılarını başlatmak için navigator.runAdAuction, interestGroupBuyers parametresinin değer olarak iletilmesini gerektirir. Kalan açık artırma parametreleri ise bağlamsal reklam yanıtından sonra çözümlenebilen JavaScript sözlerini kabul eder. interestGroupBuyers, bağlamsal reklam yanıtından önce iletildiğinden bağlamsal reklam yanıtı (teklif yanıtları dahil), söz konusu istek için paralelleştirilmiş açık artırmaya hangi alıcıların katılacağını seçmek üzere kullanılamaz. Bunun yerine Google'ın yayıncı etiketi, aynı alandaki önceki interestGroupBuyers yürütmelerinden gelen navigator.runAdAuction parametresini kullanıcının tarayıcısında önbelleğe alır.
Paralelleştirme ile ilgili dikkat edilmesi gereken birkaç önemli nokta vardır:
Alıcı güvenilir sunucu istekleri için gerekli olmayan açık artırma sinyalleri (ör.
perBuyerSignals), paralel olmayan açık artırmalarda olduğu gibi GZT teklif yanıtlarında belirtilmeye devam edebilir. Bu sinyallerle ilgili sözler yerine getirildikten sonra, cihaz üzerinde açık artırmanın kalan adımları, paralel olmayan açık artırma akışında olduğu gibi tamamlanır.Paralelleştirme, ilgi grubu alıcılarının listesini önbelleğe almaya dayandığından, paralelleştirme önbelleği boş veya süresi dolmuş olabileceğinden Google her zaman paralel açık artırma yapmaz. Önbellek boşsa veya süresi dolmuşsa Google, standart bir paralel olmayan Protected Audience API açık artırması çalıştırır ve ilgi alanı grubu alıcı önbelleğini oluşturmak için paralel olmayan açık artırmaya katılmak üzere alıcı amaç bilgisini kullanır.
Geçerli yayıncı alanında herhangi bir teklif veren için en az bir alıcı önbelleğe alınmışsa Google, teklif isteğinde belirtilecek paralel bir açık artırma yürütür:
- 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 edilen belirli bir teklif veren için kayıtlı her ilgi alanı grubu alıcısı kaynağına karşılık gelen bir girişi olur:
ParallelAuctionBuyer- Google GZT Protokolü:
BidRequest.adslot.interest_group_auction.parallel_auction_buyer - OpenRTB:
BidRequest.imp.ext.interest_group_auction.pbuyer
- Google GZT Protokolü:
Paralel bir açık artırma yürütülürse ancak önbellekte belirli bir alıcı kaynağı yoksa söz konusu alıcı, mevcut cihaz içi açık artırmaya eklenemez. Bu durum, belirli bir ilgi alanı grubu alıcı kaynağı için
parallelized=TrueileParallelAuctionBuyergirişi olmayan bir istek tarafından belirtilir. Ancak teklif yanıtlarına geçerli ve uygunInterestGroupBuyer(lar) ekleyerek ilgi gösteren teklif verenlerin teklif yanıtlarına karşılık gelen ilgi grubu alıcısının kaynakları önbelleğe eklenir ve bu kaynaklar aynı tarayıcı ve alan adından gelen gelecekteki paralelleştirilmiş 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ü:
Bir teklif verenin teklif yanıtında katılma niyetini belirtmediği, önbelleğe alınmış alıcı kaynakları (paralel açık artırmanın
interestGroupBuyersparametresine dahil edilir) alıcı tarafından güvenilen bir sunucu çağrısı alabilir ancak paralel açık artırmaya katılmaz.