Protected Audience API (eski adıyla FLEDGE)

Ö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:

Akış diyagramı

  1. 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.
  2. Bir son kullanıcı bir reklamverenin sayfasını ziyaret eder. Sayfa, teklif verenin etiketini içerebilir.
  3. 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.
  4. 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.
  5. Google'ın yayıncı reklam etiketi, Google sunucusuna içeriğe dayalı bir reklam isteği gönderir.
  6. 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.
  7. Teklif veren, interest_group_bidding alanıyla bir BidResponse döndürür. Teklif veren interest_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.
  8. 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.
  9. 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.
  10. 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 önce interest_group_bidding öğesini açık artırma yapılandırmasında interestGroupBuyers olarak iade eden alıcıları dahil eder.
  11. Google, her uygun teklif verenin per_buyer_signals değerini Korumalı Kitle açık artırma yapılandırmasına geçirir.
  12. 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 grubun trustedBiddingSignalsUrl öğesine istek gönderir. Protected Audience API spesifikasyonundaki ayrıntıları inceleyin.
  13. 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ğlanan per_buyer_signals ve belirli bir ilgi alanı grubu için güvenilir teklif verme sinyallerine erişebilir.
  14. 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.
  15. 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.
  16. 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 veren reportWin() özelliğini çağırır.
  17. 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ılan renderUrl ile eşleşmelidir.
  • Her renderUrl yalnızca tek bir reklamvereni veya reklam kampanyasını temsil edebilir. Belirli bir renderUrl, birden fazla reklamveren adına reklam oluşturmak için kullanılamaz. Her renderUrl 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:

İ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.widthveAdslot.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 indirme

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, 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
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.dsaadrenderOpenRTB protokolü için BidResponse.ext.igbid.igbuyer.dsaadrenderayarlayarak 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. XXXX kısmını, IAB GVL tescilli satıcının IAB GVL kimliğiyle değiştirin. TC dizesi boş veya geçersizse bu makro genişlemez.

Eklediğiniz IAB GVL kimliğiyle ilişkilendirilmiş IAB GVL'ye kayıtlı tedarikçinin kullanıcı izni yoksa ${GDPR_CONSENT_XXXX} makrosuna sahip reklam öğeleri engellenebilir.

${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.

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ünde BidRequest.google_query_id ve OpenRTB protokolünde BidRequest.ext.google_query_id) ile değiştirilir.
  • %%INTEREST_GROUP_OWNER%%: İlgi alanı grubu sahibinin kaynağı.
  • %%BID_CPM%%: Alıcı tarafından generateBid() işlevinde belirtilen BGBM teklif fiyatı.
  • %%RENDER_URL%%: Reklam öğesinin oluşturma URL'si.
  • %%STATUS%%: Teklif scoreAd() 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.

Tıklama etkinlikleri

Teklif verenler, Fenced Frame Reporting API'yi kullanarak Protected Audience reklamlarındaki tıklama etkinliklerini Google'a bildirebilir. Teklif verenler, tıklamaları Google'a bildirmek için click etkinlik türünü kullanmalıdır. Bir örnek verelim:

window.fence.reportEvent({
    'eventType': 'click',
    // Google does not require bidders to send data to Google in 'eventData'.
    // However, 'eventData' must be a non-null value, such as an empty string.
    'eventData': '',
    'destinations': ['direct-seller']
});

Ü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.

İlk Katılım

Protected Audience API'yi şu şekilde test edebilirsiniz:

Uygulanacak adımlar

  1. Protected Audience API denemesine katılmak için istek formunu doldurun.
  2. İstek formunu gönderdikten sonra hesap yöneticinize ulaşın veya Authorized Buyer Yardım Merkezi'ni kullanarak destek kaydı oluşturun.
  3. 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üzey renderUrl olarak da adlandırılır) ilişkin renderUrl öğ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() ve reportWin() 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.
  • 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:

  1. Chrome 101 veya sonraki bir sürümü kullanın.
  2. chrome://flags/#privacy-sandbox-ads-apis ve chrome://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.
  3. Gerçek Zamanlı Teklif Verme API'sini kullanarak reklam öğesini onaya gönderin.
  4. Teklif verenin sahip olduğu ilgi alanı grubuna tarayıcı eklemek için teklif veren tarafından sağlanan reklamveren sayfasını kullanın.

  5. 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.

  6. Aşağıdakileri doğrulayın:

    1. Beklenen kazanan reklam oluşturulur.
    2. 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.
    3. 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 edildiyse true ve teklif scoreAd() tarafından reddedildiyse false olur.
      • externalBidStatus: Teklif scoreAd() 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.