Bu sayfa, Cloud Translation API ile çevrilmiştir.

Protected Audience API (eski adıyla FLEDGE)

Chrome, Özel Korumalı Alan'ın bir parçası olarak Protected Audience API'yi önerdi. Bu tarayıcı içi API, reklamverenlerin ve reklam teknolojisi şirketlerinin üçüncü taraf çerezlerine ihtiyaç duymadan ilgi alanı grubu hedefli reklamlar göstermesine olanak tanır. Ayrıca kullanıcıları siteler arası izlemeden korur.

Chrome, Protected Audience API için bir kaynak denemesi yürütüyor. Authorized Buyers programı kapsamındaki kullanıcılar Ad Manager yayıncı envanterinde Protected Audience API testi. Teklif verenler, Protected Audience API'yi test ederek aşağıdakileri yapabilir:

Protected Audience API akışlarının etkinliği hakkında bilgi edinmek için deneme yapın.
Herkese açık forumlarda (ör. GitHub) API'de yapılabilecek iyileştirmeler hakkında geri bildirim oluşturun.
İhtiyaç duymadan API aracılığıyla kişiselleştirilmiş reklamcılığı desteklemeye hazırlanın. üçüncü taraf çerezlerini kullanabilir.

Test etmek isteyen Authorized Buyers, ayrıntılar için İlk katılım bölümüne göz atmalıdır.

Yayın akışı özeti

Authorized Buyers iş ortakları için Protected Audience reklam yayınlama akışının özetini aşağıda bulabilirsiniz:

Akış diyagramı

Teklif verenler, her reklamveren için ilgi alanı gruplarını korumak amacıyla reklamverenleriyle birlikte çalışır. Reklamverenler, ilgi alanı gruplarına tarayıcı eklemek için genellikle reklamveren sayfasına teklif veren etiketi ekler.
Son kullanıcı, reklamverenin sayfasını ziyaret eder. Sayfada, teklif verenin kapanış etiketinin hemen öncesine yapıştırın.
Teklif verenin etiketi, joinAdInterestGroup() Protected Audience API'yi çağırır. Bu çağrı, tarayıcıdan kullanıcıyı bir ilgi alanı 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, Google sunucusuna içeriğe dayalı bir reklam isteğinde bulunur.
Google, katılımcı teklif verenlere bağlama dayalı teklif istekleri gönderir. Daha fazla bilgi için Teklif isteği değişiklikleri bölümüne bakın.
Teklif veren, InterestGroupBidding içeren bir teklif yanıtı döndürür. mesajı gösterilir. OpenRTB'de bu, BidResponse.ext.igbid alanıyla, desteği sonlandırılan Google GZT protokolünde ise BidResponse.interest_group_bidding alanıyla belirtilir. Teklif veren, Bu bilgilerde Google, teklif verenin kaynağını interestGroupBuyers açık artırma yapılandırması. InterestGroupBidding, 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.buyerdata alanıyla, desteği sonlandırılan Google GZT protokolünde ise BidResponse.interest_group_bidding.interest_group_buyers.per_buyer_signals alanıyla belirtilir. Daha fazla bilgi için Teklif yanıtı değişiklikleri bölümüne bakın.
Google, sunucu tarafında açık artırmayı çalıştırır ve emin olun. Sunucu tarafı açık artırma, geleneksel, sunucu tarafı teklifleri dikkate alır. Teklif yanıtı, bağlamsal olarak kazanan bir teklifle ilgili bilgiler içerebilir (eğer herhangi biri).
Teklif yanıtı, tarayıcı içi için bir açık artırma yapılandırması içerir açık artırmadır. Buna, katılan her alıcıdan gelen bağlamsal sinyaller (OpenRTB'nin buyerdata veya desteği sonlandırılan Google RTB protokolünün per_buyer_signals üzerinden gönderilen), bağlamsal kazanan bilgileri ve teklif uygunluğu ayarları dahil olabilir.
Google'ın yayıncı etiketi, runAdAuction() Protected Audience API'yi çağırıyor cihaz üzerinde ilgi grubu açık artırmasını başlatmak için. Google yalnızca açık artırma yapılandırması sırasında InterestGroupBidding alanına InterestGroupBuyer olarak dahil edilen alıcıları içerir.
Google, uygun her teklif verenin isteğe bağlı, alıcıya özel sinyallerini Protected Audience açık artırma yapılandırması.
Belirli bir teklif verenin ilgi alanı grupları trustedBiddingSignalsUrl değerini belirttiyse tarayıcı, her grup için gerçek zamanlı sinyaller almak üzere her grubun trustedBiddingSignalsUrl değerine istek gönderir. Görüntüleyin Protected Audience API'ye giderek daha fazla bilgi edinebilirsiniz. spesifikasyonlarını inceleyin.
Tarayıcı, her ilgi alanı grubu için teklif verenin generateBid() öğesini çağırır Tarayıcı içi açık artırmaya katılmayı etkinleştirmiş ve uygun bulunan reklamlar, 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ı, şunları yapmak için satıcının (bu örnekte Google'ın) scoreAd() öğesini çağırır. ilgi alanı grubu reklam açık artırmasındaki her teklife bir sıralama atama. 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 yüksek puanlı 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ı her birini bilgilendirecek şekilde satıcının reportResult() ve teklif verenin reportWin() açık artırmanın kazananı hakkında biraz daha fazla bilgi sahibi olmanızı sağlar.
Bir ilgi alanı grubu reklamı kazanırsa, Google'ın yayıncı etiketi reklamı iframe'dir.

Yayın akışı ayrıntıları

Reklam sunmadan önce

Reklam öğesi incelemesi

Reklam öğelerinin şuradan yayınlanabilmesi için önce Google tarafından incelenip onaylanması gerekir: Protected Audience'ın tarayıcı içi açık artırmaları. Reklam öğelerini Gerçek Zamanlı Teklif Verme API'si aracılığıyla veya otomatik reklam öğesi taraması aracılığıyla incelemeye gönderebilirsiniz. Protected Audience tarayıcı içi ilgi alanı grubu reklam açık artırmaları için reklam öğeleri, inceleme için renderUrls içermelidir.

renderUrls gereksinimleri:

API aracılığıyla gönderilen renderUrl, ilgi alanı grubu reklam açık artırmasında kullanılan renderUrl ile eşleşmelidir.
Her renderUrl yalnızca tek bir reklamvereni veya reklamı temsil edebilir pek de iyi olmadığını unutmayın. Belirli bir renderUrl, birden fazla reklamveren adına reklam oluşturmak için kullanılamaz. Her renderUrl tek bir reklam öğesiyle eşlenmelidir.
renderUrl öğesinin, Google tarafından çevrimdışı erişilebilir ve getirilebilir olması gerekir en fazla 7 gün boyunca reklam öğesi inceleme sistemlerini kontrol eder.

Real-time Bidding API

Teklif verenler, daha fazla bilgi için Gerçek Zamanlı Teklif Verme API'yı kullanarak ilgi grubu teklifi.

Otomatik reklam öğesi tarama

Teklif verenler, görünmeyen reklam öğeleri için otomatik reklam öğesi taramayı ayarlayabilir. Gerçek Zamanlı Teklif Verme API'si aracılığıyla yüklenmiştir.

Otomatik reklam öğesi taramayı ayarlarsanız Google, reklam öğelerini açık artırmaya çalışır ve uygun olmaları için bunları otomatik olarak tarar. yararlanabilirsiniz.

Otomatik reklam öğesi taramasını etkinleştirmek için:

İlgi alanı grubu reklam öğesinin tüm renderUrl kaynaklarını Authorized Buyer hesabı.

Reklam öğesinin HTTP yanıtına aşağıdaki özel HTTP başlıklarını ekleyin:

Authorized-Buyers-Creative-ID

dize

Alıcıya özel reklam öğesi kimliği. Reklam öğesi kimliğinin maksimum uzunluğu: 128 bayt.

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 öğesinin geçerlilik süresi

Reklam öğeleri 15 gün boyunca onaylanır. Reklam öğelerini Gerçek Zamanlı Teklif Verme API'si ile gönderirseniz 15 gün sonra reklam öğesini yeniden göndermeniz gerekir. Bir proje yöneticisinin reklam öğesi tarama özelliği, tarama işlemi tarafından otomatik olarak yeniden taranır.

Alıcı Raporlama Kimliği

Raporlama metriklerini (ör. gösterimler) alıcı tarafından sağlanan boyutları (ör. kampanya kimliği veya reklamveren kimliği) kullanarak ayrıntılı olarak inceleyebilirsiniz. Bir ilgi alanı grubu harcaması için boyut belirtin, şunlar için bir buyerAndSellerReportingId belirtin: reklamınızın gösterilmesini sağlayabilirsiniz. Ek hizmetleri göster Protected Audience hakkında daha fazla bilgi dokümanlarına göz atın.

Aşağıdaki örnek, buyerAndSellerReportingId alanının nasıl ekleneceğine ilgi grubu yapılandırması:

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 olarak görünür.

Sunucu tarafı açık artırma

Teklif isteği değişiklikleri

Aşağıda, denemede kullanılacak desteklenen protokollerin eski sürümleri verilmiştir:

OpenRTB erken bağlantısı
Google GZT protokolü (desteği sonlandırıldı) erken bağlantı

İlgi alanı grubu açık artırma desteğini belirtme

Teklif isteklerinde, ilgi alanı grubu açık artırmalarının desteklendiğini gösteren yeni bir alan bulunur:

OpenRTB:
- BidRequest.imp.ext.ae
- BidRequest.imp.ext.igbid
Google GZT Protokolü (desteği sonlandırılmış):
- BidRequest.adslot.supported_auction_environment
- BidRequest.adslot.interest_group_bidding_allowed

Protected Audience tarayıcı içi ilgi alanı grubu açık artırmasını destekleyen gösterim fırsatlarını ve yalnızca geleneksel sunucu tarafı exchange açık artırmasını destekleyen fırsatları ayırt etmek için bu alanı kullanabilirsiniz. İlgili içeriği oluşturmak için kullanılan AuctionEnvironment sıralaması aşağıdaki değerlere sahip olabilir:

SERVER_SIDE_AUCTION (OpenRTB JSON: 0): kazanan reklam exchange'in sunucularında yayınlanır.
ON_DEVICE_INTEREST_GROUP_AUCTION (OpenRTB JSON: 1): Exchange'in sunucularında içeriğe dayalı açık artırmanın, ilgi alanı grubu teklifli sisteminin ve son açık artırmanın tarayıcıda çalıştığı, Protected Audience desteğine sahip istekler.
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 nihai kazanan reklamı belirlemek için puanlama mantığı Teklif verme ve açık artırma sunucularında çalışır.

Protected Audience reklam alanı boyutunu belirtin

Teklif isteğinde, size Korumalı Kitle reklam alanı boyutu:

OpenRTB:
- BidRequest.imp.ext.interest_group_auction.width
- BidRequest.imp.ext.interest_group_auction.height
Google GZT Protokolü (desteği sonlandırıldı):
- BidRequest.adslot.interest_group_auction.width
- BidRequest.adslot.interest_group_auction.height

Bu alanlar, Protected Audience açık artırması için reklam alanının boyutunu gösterir piksel cinsinden belirtin.

Bu boyut, bağlamsal istekteki boyutlardan farklı olabilir. Örneğin, OpenRTB'nin BidRequest.imp.banner.format.w ve BidRequest.imp.banner.format.h alanları veya kullanımdan kaldırılan Google GZT protokolünün BidRequest.adslot.width ve BidRequest.adslot.height alanları için geçerlidir.

İçeriğe dayalı isteğin birden fazla boyutu olabilir. Cihaz üzerinde açık artırmayı kazanan cihaz Reklamın yalnızca tek bir sabit alan boyutunu doldurması beklenir.

Protected Audience reklamlarının oluşturulabilirliğini belirtme

Protected Audience reklamları, mevcut entegrasyon aşamasına bağlı olarak oluşturulabilir veya oluşturulmayabilir (oluşturmayan deneme bölümüne bakın). Teklif isteğinde render_interest_group_ads alanı, kazanan Protected Audience reklamının oluşturulup oluşturulmayacağını belirtir.

OpenRTB: BidRequest.imp.ext.interest_group_auction.render_interest_group_ads
Google GZT Protokolü (desteği sonlandırıldı): BidRequest.adslot.interest_group_auction.render_interest_group_ads

Kullanıcı tanımlayıcılarına bağımlılığı en aza indirin.

Protected Audience API testinin kapsamına giren bağlamsal teklif istekleri, tarayıcıda mevcut olduğunda geleneksel çerez tabanlı tanımlayıcıları (ör. BidRequest.user.id ve BidRequest.user.buyerid alanları veya desteği sonlandırılan Google RTB protokolündeki BidRequest.google_user_id ve BidRequest.hosted_match_data) taşımaya devam edebilir. Teklifte bu tür tanımlayıcıların varlığı istekleri mevcut gizlilik politikalarına tabidir. Üçüncü taraf çerezleri artık kullanılamadığında verimli satın alma işlemine daha iyi hazırlanmak için test sırasında hedefleme ve teklif verme amacıyla çerez tabanlı tanımlayıcılara güvenmemenizi öneririz.

Google, çerez tabanlı tanımlayıcıların Protected Audience API testinin kapsamı dahilindeki teklif isteklerinden çıkartıldığı küçük ölçekli denemeler de yürütebilir. Bu inceleme, üçüncü taraf çerezlerine yönelik desteğin sonlandırılmasının olası etkisini değerlendirmek içindir.

Chrome'un sağladığı üçüncü taraf çerezleri desteğinin sonlandırılması testi

Chrome, 2024'te üçüncü taraf çerezlerine yönelik desteğin sonlandırılmasına hazırlanmak için artık Chrome tarafından desteklenen test sunuyor.

Siteler ve tedarikçiler, sistemlerini 3PCD kapsamında test etmek için Chrome tarafından desteklenen testleri kullanabilir. Testte, Chrome tarayıcılar bir 3PCD deneme grubuna atandı, A veya B modundan birini seçin. Her tarayıcıya tutarlı bir etiket atanır deneme amaçlı 100'den az olarak kullanılabilecek ve tarayıcı içi Chrome API'sini kullanabilirsiniz.

Google, RTB teklif isteğinde Chrome API'den değiştirilmemiş etiketi iletir. Google, tek bir etiketin küçük trafik dilimleri nedeniyle etiketi her zaman gizlilik sınırlamaları olan bağlamlara dahil etmez.

Etiketi görüntüleyebileceğiniz alanlar şunlardır:

OpenRTB: BidRequest.device.ext.cdep.
Google GZT Protokolü (desteği sonlandırılmış): BidRequest.device.cookie_deprecation_label.

Teklif yanıtı değişiklikleri

İlgi grubu açık artırmasına katılımı belirtme

InterestGroupBidding nesnesini döndürerek tarayıcı içi açık artırma bağlama dayalı teklif yanıtı:

OpenRTB: BidResponse.ext.igbid
Google GZT Protokolü (desteği sonlandırılmış): BidResponse.interest_group_bidding

Bağlama dayalı bir teklif yanıtı sağlamanız gerekir. Yanıtın bağlamsal teklif içermesi gerekmez. InterestGroupBidding nesnesi, Her bir InterestGroupBuyer için origin (kaynaklardan biriyle eşleşmelidir) yapılandırdığından emin olun. Google Yayıncı Etiketi runAdAuction()'yi çağrdığında origin, açık artırma yapılandırmasının interestGroupBuyers alanına eklenir.

Alıcı içerik sinyallerini uygulayın

Google'ın perBuyerSignals bağımsız değişkeni aracılığıyla cihaz üzerinde teklif verme işlevine JSON nesnesi olarak dağıttığı bağlamsal teklif yanıtına bir alıcının sinyallerini ekleyebilirsiniz. Bu, Protokole bağlı olarak aşağıdaki alanları görebilirsiniz:

OpenRTB: BidResponse.ext.igbid.igbuyer.buyerdata
Google RTB (desteği sonlandırıldı): BidResponse.interest_group_bidding.per_buyer_signals

Alıcı bağlamsal oluşturma sinyallerini yayma

İlgi alanı grubu reklam öğeleri, oluşturma sırasında sınırlı içerik sinyalleri kullanabilir Bu sinyalleri bağlama dayalı teklif yanıtı üzerinden göndermek ve almak bunları, makro genişletmeyi kullanarak oluşturma URL'si isteğinde kullanı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.

Bir alıcının oluşturma sinyallerini URL güvenli dize olarak serileştirilmiş bağlama dayalı teklif yanıtıdır. Google, kazanan ilgi alanında bu yanıtı değiştirir. oluşturarak URL'yi ${RENDER_DATA_buyer.origin.example[_OPTIONAL_SUFFIX]} makrosu.

Oluşturma sinyalleri, teklif yanıtında aşağıdakilerle belirtilebilir protokole bağlı olarak aşağıdaki URL'leri kullanabilirsiniz:

OpenRTB: BidResponse.ext.igbid.igbuyer.rsig
Google GZT (desteği sonlandırılmış): BidResponse.interest_group_bidding.interest_group_buyer.rendering_signals

Farklı makro son ekleri olan en fazla 3 farklı oluşturma sinyali grubu dahil edilebilir kullanabilirsiniz. Örneğin, yalnızca reklam öğeleri için geçerli olan belirli bir sinyal grubunu eşleştirmek amacıyla kullanılabilir oluşturma URL'sinde karşılık gelen makroyla seçin.

Sinyaller URL açısından güvenli değilse, makro son ekleri 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.

Maksimum tarayıcı içi teklif fiyatını belirtin

Protected Audience bölümünde teklifi, teklif hesaplaması ve son açık artırmanın cihaz üzerinde yerel olarak yapılması bekleniyor. Bu durum, kazanan teklif fiyatı gibi nihai açık artırma sonuçlarının bütünlüğünü etkileyebilecek olası kötüye kullanım vektörleri oluşturabilir.

Google'ın RTB iş ortakları için Protected Audience API testi sırasında desteklediği bir azaltma yöntemi olarak, her bağlamsal teklif yanıtında bir beklenen maksimum teklif değeri belirtebilirsiniz. Beklenen maksimum teklif, teklif işlevinizin dönmesi beklenir. Tarayıcı içi açık artırmadan bildirilen kazanan teklif bu tutarı aşıyorsa kazanan teklif faturalandırılabilir etkinlik olarak sayılmaz. Bu yaklaşımda değişiklik yapılabilir.

Teklif yanıtında, beklenen maksimum teklif değerini şu alanları kullanın:

OpenRTB: BidResponse.igbid.igbuyer.maxbid(BGBM para birimi cinsinden ifade edilir)
Google GZT protokolü (desteği sonlandırıldı): BidResponse.interest_group_bidding.interest_group_buyers.max_bid_cpm_micros (microBGBM cinsinden ifade edilir)

Gösterimleri birden çok hesapla ilişkilendirme

Teklif veren, ilgi alanını ilişkilendirmek için bir faturalandırma kimliği seçmelidir grup teklifinin gösterimlerini şu alanları kullanarak gruplayın:

OpenRTB: BidResponse.igbid.igbuyer.billing_id
Google GZT protokolü (desteği sonlandırıldı): BidResponse.interest_group_bidding.interest_group_buyers.billing_id

Seçilen faturalandırma kimliği, teklif isteğinde bulunan uygun bir faturalandırma kimliği olmalıdır:

OpenRTB: BidRequest.imp.ext.billing_id
Google GZT protokolü (desteği sonlandırıldı): BidRequest.adslot.matching_ad_data.billing_id

İlgi alanı grubu teklifi gösterimlerinin ilişkilendirileceği faturalandırma kimliği sağlandığında teklif veren, Protected Audience açık artırmasına katılmaz.

Alt hesaplarda 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 de 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 ayarlayabilirsiniz. Alt hesapların fatura kimlikleri için günlük bütçeyi ayarlamak üzere hesap yöneticinizle iletişime geçin.

Gösterim için teklif vermeye uygun kullanılabilir bütçesi olan tüm alt hesapların fatura kimlikleri, harcama ilişkilendirmesi seçimi için teklif isteğinde görünür. Ulaşma kimliğini bir ilgi alanı grubu faturalandırma kimliğine ilişkin bütçeyi değiştirmek üzere hesap yöneticinize gönderin.

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: bağlama dayalı yanıtta

Aşağıdaki parametreler döndürülür:

ad: Google bu alanı yoksayar.
bid: Açık artırmaya giren sayısal bir teklif. BGBM biriminde olmalıdır (mikro değil).
render: Teklifin kazanması durumunda reklam öğesini görüntülemek üzere oluşturulan URL açık artırmadır. Google bu URL'yi inceleyip onaylamalıdır. Aksi takdirde URL açık artırmadan filtrelenir.
allowComponentAuction: true olmalıdır. Google şu anda, Google Haritalar'da teklif stratejisidir.

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 birimleri cinsinden yerleştirilir.

Teklif para birimi hem bağlamsal teklif yanıtında hem de generateBid değerinin döndürülen 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, currency Teklif yanıtında InterestGroupBuyer mesaj var.

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 verenler, generateBid işlevlerinde bağlamsal teklif yanıtında belirtilen para biriminde teklif döndürmelidir. Yeni bidCurrency özelliğini generateBid işlevinin döndürdüğü değer:

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 bunlardan biri 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 reklam öğesi politikası ve yayıncı denetimleri yaptırımı, tarayıcı içi ilgi alanı grubu teklifleri için daha kısıtlayıcı olabilir.

Dijital Hizmetler Yasası desteği

Dijital Hizmetler Yasası 26. Maddesi uyarınca yayıncılar, alıcıların reklam içi şeffaflık açıklamalarını 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ğinde BidRequest.regs.dsa.required ve BidRequest.dsa.pubrender değerlerine (kullanımı sonlandırılan Google GZT protokolünde sırasıyla BidRequest.dsa.dsa_support ve BidRequest.dsa.publisher_rendering_support) bakarak alıcı şeffaflığı sunmaları gereken fırsatları belirleyebilir.

Protected Audience API açık artırmalarına katılmak isteyen bir teklif veren olduğunda Teklif isteğinde, DSA şeffaflığının gösterilmesi gerektiğini belirten sinyali alır. Protected Audience API aracılığıyla yayınlanan reklamlarla ilgili olarak, gerekli bilgileri düzgün bir şekilde görüntüleyebilir ve BidResponse.ext.igbid.igbuyer.dsaadrender. (BidResponse.interest_group_bidding.interest_group_buyers.dsa_buyer_render inç desteği sonlandırılan Google GZT protokolü) geçerlidir. 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.

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:

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çıklamalı kılavuzunun Oluşturma ve Reklam Etkinlikleri ile İlgili Alıcı Raporları bölümüne bakın.

Makrolar

Protected Audience API reklam öğesine atıfta bulunan renderUrl, makro adı verilen bir veya daha fazla yer tutucu içerebilir. İlgi alanı grubu açık artırması sona erdikten sonra ancak oluşturma işleminden ö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'a, GDPR geçerliyse 1'e genişler. Belgelere göz atın.
`${GDPR_CONSENT_XXXX}`	Şeffaflık ve ve İstekle ilişkili izin (TC) dizesi Şeffaflık ve İzin (TC) dizesi boş veya geçersiz, bu makro genişlemiyor. TC dizesini bir URL'de IAB GVL'ye kayıtlı bir tedarikçiye iletmek için bu makroyu kullanın. `XXXX` kısmını, IAB GVL'ye kayıtlı tedarikçinin IAB GVL kimliğiyle değiştirin. TC dizesi boş veya geçersizse bu makro genişletilmez. `${GDPR_CONSENT_XXXX}` makrosuna sahip reklam öğeleri şu şekilde olabilir: sizin gönderdiğiniz IAB GVL kimliğiyle ilişkili IAB GVL'ye kayıtlı sağlayıcı ise eklenen eklemek kullanıcı iznine sahip değil. `${GDPR_CONSENT_XXXX}` makrosu, `renderUrl`.
`${ADDL_CONSENT}`	Ek İstekle ilişkili kullanıcı rızası (Eİ) dizesi
`${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. `buyer.origin.example` yer tutucusunu kaynak ile değiştirin Bu ilgi alanı grubu alıcısına ait Teklif yanıtında `interest_group_buyers.origin`. en fazla üç farklı sağlamak için bir `_OPTIONAL_SUFFIX` ekleyin sinyal değerlerini oluşturabilirsiniz.

Gösterim sayımı

GZT iş ortaklarıyla Protected Audience API testi yapılırken Google, Tarayıcı reportResult() işlevini çağırdığında ve daha sonra sendReportTo() çağrısıyla Google'ın raporlama URL'sini getirir.

Google tarafından Protected Audience'ta gösterimleri saymak için kullanılan etkinlikten. tarayıcı içi açık artırmalar, sayım için kullanılan etkinlikten farklı olabilir gösterim sayıları farklı olabilir.

Google'ın Protected Audience API'yi test etme hedeflerinden biri de azaltmaktır.

Faturalandırılabilir gösterimlerin ilişkilendirilmesi

Teklif verenin Protected Audience'taki tarayıcı içi açık artırmalardan yaptığı tüm harcamalar ilgi alanına ait eşlemeye göre tek bir teklif veren hesabıyla ilişkilendirilir teklif veren için yapılandırılan grup sahibi kaynakları. Harcamaların bir teklif verenin farklı alt kol 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 harcama 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 Korunan Kitle için uygun teklif istekleri almaz.

Hesap, bu süreden sonra sunucu tarafı içeriğe dayalı açık artırmalara katılmaya devam edebilir. Protected Audience sınırına ulaştı. Örneğin, Protected Audience sınırı, teklif isteği uygun olsa bile auction_environment = SERVER_SIDE_AUCTION ile bir teklif isteği (OpenRTB JSON: 0) alabilir Protected Audience açık artırması talep ediyor.

Gerçek zamanlı geri bildirim ve kazanmak için minimum teklif

Gerçek zamanlı geri bildirim almak için kaydolan 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 verenin teklif yanıtında 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. İlgili içeriği oluşturmak için kullanılan ilgi alanı grubu alıcısı geri bildiriminde aşağıdaki bilgiler yer alır nesne:

Geri bildirim nesnesinin geri bildirim türü INTEREST_GROUP_BUYER_FEEDBACK olur.
İlgi alanı grubu alıcısının kaynağı.
İlgi alanı grubu alıcısı için genel açık artırmayı kazanmak üzere verilmesi gereken minimum teklif.
İlgi alanı grubu alıcısı için, genel açık artırmanın sunucu tarafı bileşeninden en yüksek puanlı teklifi geçmek üzere kazanılması gereken minimum teklif.
İlgi alanı grubu alıcısının durum kodu. Olası durum kodları interest-group-buyer-status-codes.txt dosyasında tanımlanır.

Protokol belgelerine bakın: Authorized Buyers GZT ve OpenRTB Uzantıları girin.

Teklif geri bildirimi bildirimi

Chrome, Google Chrome'un geçici bir hata ayıklama API Ad Manager'ın gerçek zamanlı olarak göndermesine olanak tanıyan Protected Audience API için Korumalı Kitle teklifi. Bu bildirim, tekliflerin olası nedenlerini içerir diğer bir teklifle ilgili daha fazla bilgiyi aşağıda bulabilirsiniz.

Teklif verenler, Protected Audience hata ayıklama teklif geri bildirim bildirimlerini göndermek için kullanılır. Bu statik URL, Protected Audience açık artırması tamamlandıktan sonra seçili makroların değiştirilmesiyle Google sunucularından alınır. Aşağıdaki makrolar desteklenir:

%%GOOGLE_QUERY_ID%%: Bu makro, Protected Audience özellikli bağlamsal teklif isteğinde gönderilen Google sorgu kimliğiyle değiştirilir. İçinde Bunun belirtilen OpenRTB protokolü BidRequest.ext.google_query_id, desteği sonlandırılmış Google GZT protokolü BidRequest.google_query_id kullanır.
%%INTEREST_GROUP_OWNER%%: İlgi alanı grubu sahibinin kaynağı.
%%BID_CPM%%: generateBid() işlevinde alıcı tarafından belirtilen BGBM cinsinden teklif fiyatı.
%%RENDER_URL%%: Reklam öğesinin oluşturma URL'si.
%%STATUS%%: Teklif scoreAd() içinde reddedilirse durum kodu. Değerler reklam öğesi durum kodlarıdır.

Burada, teklif verenin hesap yöneticisine sağlayabileceği bir statik URL örneği 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 sırasında Google GZT iş ortakları için desteklenir teşvik etmek anlamına gelir. PLTD'yi test etmeyi planlıyorsanız ek kaynaklar ve yapılandırma gerektiğinden entegrasyon sırasında hesap yöneticinize bildirin.

Oryantasyon

Protected Audience API'yi nasıl test edebileceğiniz aşağıda açıklanmıştır:

Adımlar

İstek formunu doldurun. Protected Audience API denemesine katılın.
İstek formunu gönderdikten sonra hesap yöneticinizle iletişime geçin 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ındaki adımlarla entegrasyon.

Reklam Öğesi İncelemesi

Ürün düzeyinde reklamlarla (birden fazla parçadan oluşan reklamlar) teklif vermek için Protected Audience API açık artırmalarında şu gereksinimleri yerine getirin:

Reklam öğesi incelemesi sırasında üst düzey renderUrls'yi ayırt etmek için bileşen reklamın kapsayıcısı (üst düzey renderUrl olarak da adlandırılır) için renderUrl içine &pltd=True sorgu parametresini ekleyin.
Bileşen reklamın kapsayıcısı şu durumlarda temsili bir reklam öğesi oluştur: Google tarafından reklam öğesi incelemesi için getirildi. Bir Arkadaş Bitkiler projesinin temsili bir reklam oluşturma döndürülmesi durumunda, Google reklam öğesi inceleme sistemi tarafından ayarlanan validation=True sorgu parametresi.

Entegrasyon kontrol listesi

Protected Audience API'yi dolduracak bir teklif isteği uç noktası oluşturun içeriğe dayalı teklif yanıtındaki alakalı alanlar (örneğin, interest_group_bidding
Kullanıcının tarayıcısına katılmak için reklamverenin sayfalarında etiketleme uygulayın. seçmeniz gerekir.
generateBid() ve reportWin() işaretlemelerini uygulayın.
İlgi alanı grubu sahip kökenlerini seçin ve bunları Yetkili Alıcı hesabına ekleyin.
- İlgi alanı grubu sahibinin kaynakları, generateBid() işlevleri barındırılır.
- Hesap yöneticisine ulaşın veya Yetkili alıcı Yardım Merkezi'ni bu adımı tamamlayın.
Protected Audience API testiyle alakalı envanter için önceden hedefleme ayarlayın.
Reklam öğeleri API'si 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ı) Bir test reklamvereni sayfası oluşturun. Bu sayfa, Google mühendislerinin alıcının tarayıcılarını, ilgi alanı grubu alıcınızın sahip olduğu ilgi alanı gruplarına kaynak. Bu sayede Protected Audience açık artırmalarını manuel olarak tetikleyebiliriz.
(İsteğe bağlı) Şu konularla ilgili geri bildirim almak için hesabınızda gerçek zamanlı geri bildirimi etkinleştirin: Alıcıların bir Protected Audience'a dahil edilmeyi talep ettiği ilgi alanı grubu alıcıları açık artırmadır.
(İsteğe bağlı) Hesap yöneticinizle iletişime geçerek Protected Audience teklifi sağlayan sunucudan sunucuya bir bildirim alma cihaz üzerinde Protected Audience'tan gelen bir teklifin durumuna ilişkin geri bildirim açık artırma teklif stratejisine geçiş yapar. 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 aşağıda açıklanmıştır. oluşturulur ve gösterimi kaydedin:

Chrome 101 veya sonraki sürümleri kullanın.
chrome://flags/#privacy-sandbox-ads-apis ve chrome://flags/#enable-fenced-frames kullanarak Privacy Sandbox API'yi ve Çitli Çerçeve'yi etkinleştirin. Daha fazla bilgi için Özel Korumalı Alan'ı test etme başlıklı makaleyi inceleyin.
Gerçek Zamanlı Teklif Verme'yi kullanarak bir reklam öğesini onay için gönderme API.
Sahibine ait teklif verene tarayıcı eklemek için teklif veren tarafından sağlanan reklamveren sayfasını kullanın ilgi grubu.
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ı tekliflerle rekabet edebileceğinden açık artırmayı kazanacak kadar yüksek teklif vermelidir. Google ayrıca her iş ortağı için yalnızca ilgili iş ortağının açık artırmaya katılabileceği özel bir test yayıncı sayfası da sağlar. İş ortağına özel bir sayfada tarayıcı içi açık artırmaları güvenilir bir şekilde kazanmak daha kolay olabilir.
Aşağıdakileri doğrulayın:
1. Beklenen kazanan reklam oluşturulur.
2. Açık artırma sonucu sunucu tarafına gönderilir. Yani kazanan teklif veren, reportWin() tarafından geri ping alır.
3. Test yayıncı sayfası konsolu, her teklif için bir hata ayıklama mesajı günlüğe kaydeder ve şu bilgileri ekleyin:
  - renderUrl: Teklifin oluşturma URL'si.
  - interestGroupOwner: Teklifin ilgi alanı grubu sahibi.
  - accepted: Teklif kabul edilmişse bu alan true ve false (teklif scoreAd() tarafından reddedilmişse)
  - externalBidStatus: Teklifin reddedilmesi için kullanılacak durum kodu scoreAd(). Değerler reklam öğesi durumudur ekleyebilirsiniz.

2. Aşama: (İsteğe bağlı) Oluşturma dışı deneme

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ına geçirir.

Google, Protected Audience açık artırmalarını çalıştırmak için az miktarda canlı trafik ayırır. Böylece Google'ın ve iş ortağının bir Protected Audience açık artırması. Protected Audience açık artırmasının sonucu oluşturulmaz. Bu sayede entegrasyonu geniş ölçekte test edebiliriz.

Hazır olduğunuzda hesap yöneticinizle iletişime geçin veya Authorized Buyers Yardım Merkezi üzerinden destek kaydı oluşturun. Google, hesabı bu aşama için etkinleştirir.

3. Aşama: Oluşturma Denemesi

Google ve iş ortağı Protected Audience açık artırmalarını geniş ölçekte doğruladıktan sonra oluşturmazsanız Google, iş ortağının Korumalı Kitle kazanan reklam. 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ılan 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 destek kaydı oluşturun. Google, hesabı bu aşama için etkinleştirir.

Ek Özellikler

Aşağıdaki özellikler, temel protokolün uzantılarıdır.

Paralelleştirme

Paralelleştirme, uçtan uca açık artırma gecikmesini %30 oranında azaltan bir içeriğe dayalı reklam isteğini, alıcı güvenilir sunucuları trustedBiddingSignalsUrl içinde belirtilir.

Paralelleştirme gecikmeyi azaltır ancak ilgi alanı grubunu etkiler uygun olup olmadığına ve koordine denemeler yapabilirsiniz. Paralelleştirme, katılan tüm teklif verenler için geçerlidir. cihaz üzerinde ilgi grubu açık artırmasıdır. Teklif verenlerin işlem yapması gerekmez. paralel açık artırmalara katılır ancak paralelleştirmenin cihaz üzerinde açık artırmalarda uygunluk durumlarını nasıl etkileyebileceğine bakalım. Koordine denemeler için deneme grubu kimlikleri henüz desteklenmiyor karar verebilir.

Yayın akışı özeti

Paralel açık artırma akışının özetini aşağıda bulabilirsiniz: Akış şeması

Cihaz üzerinde ilgi alanı grubu alıcı uygunluğu

Paralel açık artırmalarda navigator.runAdAuction adlı kullanıcının görüşmesi önce gerçekleşir içeriğe dayalı reklam yanıtı döndürülür. Alıcı güvenilir sunucu çağrılarını başlatmak için navigator.runAdAuction, interestGroupBuyers parametresinin değer olarak iletilmesini gerektirir. Diğer açık artırma parametreleri ise bağlamsal reklam yanıtından sonra çözülebilecek JavaScript Promise'leri kabul eder. Başlangıç interestGroupBuyers, içeriğe dayalı reklam yanıtından önce iletilir, bağlama dayalı reklam yanıtı (teklif yanıtları dahil) paralel hale getirilmiş açık artırmaya hangi alıcıların katılacağını seçmek için kullanılamaz seçmeniz gerekir. Bunun yerine Google'ın yayıncı etiketi, kullanıcının tarayıcısında, önceki taramanın interestGroupBuyers parametresi Aynı alan adında navigator.runAdAuction yürütme işlemi gerçekleştirildi.

Paralelleştirmeyle ilgili dikkat edilmesi gereken birkaç önemli nokta vardır:

Alıcı güvenilir sunucu istekleri için gerekli olmayan açık artırma sinyalleri GZT teklif yanıtlarında belirtilmeye devam edilebilir (ör. perBuyerSignals) paralel olmayan açık artırmalarda olduğu gibidir. Bu sinyaller için verilen sözler çözüldükten sonra cihaz üzerinde açık artırmanın kalan adımları, paralel olmayan açık artırma akışıyla aynı şekilde tamamlanır.
Paralelleştirme, ilgi alanı grubu alıcılarının listesinin önbelleğe alınmasına bağlı olduğundan, paralelleştirme önbelleği boş veya süresi dolmuş olabileceğinden Google her zaman paralel açık artırma yayınlamaz. Önbellek boşsa veya süresi dolmuşsa Google, standart bir paralel olmayan Protected Audience API açık artırması yapar ve ilgi alanı grubu alıcı önbelleğini oluşturmak için paralel olmayan açık artırmaya katılmak üzere alıcı amacını kullanır.
Herhangi bir teklif veren için en az bir alıcı mevcut yayıncı için önbelleğe alındıysa Google, bu bilgileri kullanarak Bu değer, teklif isteğinde belirtilir:
- Google GZT Protokolü: BidRequest.adslot.interest_group_auction.parallelized
- OpenRTB: BidRequest.imp.ext.interest_group_auction.parallelized
Belirli bir teklif veren için kayıtlı olan her ilgi grubu alıcı kaynağı dahil edilen tüm reklam gruplarına karşılık gelen ParallelAuctionBuyer girişi:
- Google GZT Protokolü: BidRequest.adslot.interest_group_auction.parallel_auction_buyer
- OpenRTB: BidRequest.imp.ext.interest_group_auction.pbuyer
Paralel açık artırma yapılırsa ancak belirli bir alıcı kaynağı söz konusu alıcı, cihazdaki mevcut cihaza eklenemez. açık artırmadır. Bu durum, belirli bir ilgi alanı grubu alıcı kaynağı için ParallelAuctionBuyer girişi bulunmayan parallelized=True içeren bir istekle belirtilir. Ancak, teklif yanıtlarına geçerli ve uygun InterestGroupBuyer'ler ekleyerek ilgi alanı belirten teklif verenler için, ilgili ilgi alanı grubu alıcı kaynaklarının önbelleğe eklenmesi gerekir. Bu kaynaklar, aynı tarayıcı ve alandan gelecek gelecekteki paralelleştirilmiş istekler için uygun olur. İlgi alanı grubu açık artırmalarına katılma niyeti aşağıdaki alanlarda belirtilebilir:
- Google GZT Protokolü: BidResponse.adslot.interest_group_bidding.interest_group_buyers
- OpenRTB: BidResponse.ext.igbid.igbuyer
Teklif verenin teklif yanıtında katılma niyetini 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.