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

Protected Audience API (eski adıyla FLEDGE)

Chrome, Özel Korumalı Alan'ın bir parçası olarak Korunan Kitle API: Tarayıcı içi bir API Reklamverenlerin ve reklam teknolojisi şirketlerinin ilgi alanı grubunu hedefleyen reklamlar göstermesine olanak tanıyan üçüncü taraf çerezlerine dayanmadan, kullanıcıları siteler arası çerezlere karşı korurken izleyebilirsiniz.

Chrome, bir kaynak çalıştırıyor deneme karşı korumanız gerekir. 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 şunları elde edebilir:

Protected Audience API akışlarının etkisi hakkında bilgi edinin ve bunları deneyin.
Herkese açık forumlarda API iyileştirmeleri hakkında geri bildirim alın: örneğin GitHub.
İhtiyaç duymadan API aracılığıyla kişiselleştirilmiş reklamcılığı desteklemeye hazırlanın. üçüncü taraf çerezlerini kullanabilir.

Test etmek isteyen Authorized Buyers alıcıları İlk Katılım bölümünü inceleyin.

Yayın akışı özeti

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

Akış diyagramı

Teklif veren, her reklamveren için ilgi alanı gruplarını korumak amacıyla belirlemektir. Reklamverenler çoğu zaman teklif verenin etiketini reklamverenin sayfasını kullanabilirsiniz.
Bir 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ının kullanıcıyı bir ilgi alanı grubuna eklemesini ister.
Son kullanıcı, bir yayıncının web sayfasını ziyaret eder. Kullanıcının tarayıcısı istekleri Google'ın yayıncı reklam etiketi.
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. Bkz. Daha fazla bilgi için Teklif isteği değişiklikleri bölümüne göz atın.
Teklif veren, interest_group_bidding alanı olan bir BidResponse döndürür. Teklif veren interest_group_bidding belirtmezse Google açık artırmaya teklif verenin interestGroupBuyers bölgesindeki kaynağını dahil et yapılandırma. Teklif yanıtı, interest_group_bidding.per_buyer_signals dizesini de içerebilir. per_buyer_signals, teklif verenin teklif verme işlevine aktarılacak: açık artırmadır. Teklif yanıtı değişikliklerini görün bölümünü inceleyin.
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, her katılımcı alıcıdan gelen içerik sinyalleri dahil olabilir. (interest_group_bidding.per_buyer_signals üzerinden gönderilen), bağlama dayalı kazanan bilgileri ve teklif uygunluğu ayarlarını içerir.
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 şunları içerir: daha önce şu şekilde iade etmiş olan alıcılar: interest_group_bidding Açık artırma yapılandırmasında interestGroupBuyers.
Google, her uygun teklif verenin per_buyer_signals öğesini Protected'e iletir. Kitle açık artırma yapılandırması.
Belirli bir teklif verenin ilgi grupları trustedBiddingSignalsUrl ise, tarayıcı her grubun trustedBiddingSignalsUrl: Her grup için gerçek zamanlı sinyalleri getirmek üzere. 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ımı, teklifi hesaplar ve bir reklam öğesi seçer. generateBid() şunlara erişebilir: teklif veren ve güvenilir teklif verenin sağladığı per_buyer_signals sinyallerine geçiş yapacaktır.
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 sıralanır ve yayıncı korumaları, reklam politikaları ve diğer ölçütlere göre filtrelenir kısıtlar.
Tarayıcı, uygun ilgi alanı grubu teklifleriyle bir açık artırma gerçekleştirir. İlgili içeriği oluşturmak için kullanılan içeriğe dayalı teklifin en üst sırada yer alması 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 incelemeye gönderebilirsiniz Gerçek Zamanlı Teklif Verme API'si veya otomatik reklam öğesi tarama. Şunun için Reklam Öğeleri: Korunan Kitle tarayıcı içi ilgi alanı grubu reklam açık artırmaları içermelidir İnceleme için renderUrls.

renderUrls gereksinimleri:

API üzerinden gönderilen renderUrl, kullanılan renderUrl ile eşleşmelidir. karar verebilirsiniz.
Her renderUrl yalnızca tek bir reklamvereni veya reklamı temsil edebilir pek de iyi olmadığını unutmayın. Belirli bir renderUrl, adına reklam oluşturmak için kullanılamaz birden fazla reklamveren var. 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 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ı.

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

Şuna göre kodlanan reklam öğesi için bildirilen hedef URL'ler grubu: RFC2396'ya gönderin.

Ö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ı Bidding API'sinde reklam öğesini 15 gün sonra 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

Boyutları kullanarak raporlama metriklerinin (gösterimler gibi) dökümünü alabilirsiniz tarafından sağlanan bilgiler (örneğin, kampanya kimliği veya reklamveren kimliği). 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, Yetkilendirilen raporlarda yeni bir boyut olarak Alıcının Raporlama Aracı'nı Alıcı Raporlama Kimliği boyutu olarak ayarlayın.

Sunucu tarafı açık artırma

Teklif isteği değişiklikleri

Aşağıda, deneme:

Google GZT protokolü erken bağlantı
OpenRTB erken bağlantısı

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

Teklif isteklerinde auction_environment adlı yeni bir alan var.

Google GZT Protokolü: BidRequest.adslot.auction_environment
OpenRTB: BidRequest.imp.ext.auction_environment

Bu alanı, tüm reklam gruplarına özel gösterim fırsatlarını Protected Audience tarayıcı içi ilgi grubu açık artırmasını destekler. yalnızca geleneksel sunucu tarafı exchange açık artırmasını destekler. İlgili içeriği oluşturmak için kullanılan 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): Şuna sahip istekler: Protected Audience desteğinde bağlamsal bir açık artırma exchange'in sunucuları ve ilgi alanı grubu teklifi ile son açık artırma gerçekleşir. tarayıcıda

Protected Audience reklam alanı boyutunu belirtme

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

Google GZT 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 gösterir piksel cinsinden belirtin.

Bu boyut, içeriğe dayalı isteğin boyutlarından farklı olabilir (Adslot.widthveAdslot.height veya OpenRTB'de: BidRequest.imp.banner.format).

İç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 reklam oluşturulabilirliğini belirtme

Protected Audience reklamlarının oluşturulması veya oluşturulması, geçerli olan entegrasyon aşaması (bkz. oluşturma olmayan denemesi için) gerekir. render_interest_group_ads teklif isteğindeki alan, kazanan Protected Audience reklamının öğesi oluşturulur.

Google GZT Protokolü: BidRequest.adslot.interest_group_auction.render_interest_group_ads.
OpenRTB: BidRequest.imp.ext.interest_group_auction.render_interest_group_ads.

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

Protected Audience API testi kapsamındaki bağlamsal teklif istekleri, Google Analytics 4'ten kullanılabildiğinde geleneksel çerez tabanlı tanımlayıcıları google_user_id (OpenRTB'deki BidRequest.user.id) ve hosted_match_data (OpenRTB'de BidRequest.user.buyerid) alanları. Varlık teklif isteklerindeki bu tür tanımlayıcıların kullanılması, mevcut tüm tanımlayıcılara tabi olmaya gizlilik politikaları. Şu veriler için çerez tabanlı tanımlayıcılara güvenmemenizi öneririz: testler sırasında hedefleme ve teklif verme amaçları doğrultusunda üçüncü taraf çerezleri artık kullanılamadığında satın alma işlemi gerçekleştirir.

Google, aynı zamanda çerez tabanlı tanımlayıcıların kullanıldığı küçük ölçekli denemeler Protected Audience API testi kapsamındaki teklif isteklerinden çıkartılır. Bu üçüncü taraf çerezlerine yönelik desteğin sonlandırılmasının olası etkisini değerlendirmektir.

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

2023'e hazırlanmak için üçüncü taraf çerezlerine yönelik desteğin sonlandırılması (üçüncü taraf çerezleri) Chrome artık 2024 yılında Chrome destekli testler.

Siteler ve satıcılar, Chrome'un sağladığı testleri kullanarak sistemlerini 3PCD. 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ı 3D model deneme grubuna karşılık gelen tarayıcı içi Chrome API'sini kullanabilirsiniz.

Google, GZT teklifine Chrome API'nin değiştirilmemiş etiketini iletir isteğinde bulunabilirsiniz. Google, tek bir etiketin küçük trafik dilimleri nedeniyle , gizliliği sınırlı bağlamlarda her zaman etiketi içermez.

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ırmaya katılımını belirtme

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

Google GZT Protokolü: BidResponse.interest_group_bidding
OpenRTB: BidResponse.ext.igbid

Bağlama dayalı bir teklif yanıtı sağlamanız gerekir. Kullanıcı adının içeriğe dayalı bir teklif dahil etmektir. InterestGroupBidding nesnesi, kaynaklardan biriyle eşleşmesi gereken, ilgi alanı grubu sahibinin origin parametresi yapılandırdığından emin olun. origin, açık artırmaya eklendi Google Yayıncı Etiketi şunu çağırdığında yapılandırmanın interestGroupBuyers: runAdAuction().

Alıcı içerik sinyallerini uygulayın (perBuyerSignals)

İçeriğe dayalı teklif yanıtına, Google perBuyerSignals bağımsız değişken. Bu, Protokole bağlı olarak aşağıdaki alanları görebilirsiniz:

Google GZT: BidResponse.interest_group_bidding.per_buyer_signals
OpenRTB: BidResponse.ext.igbid.igbuyer.buyerdata

Alıcı içeriğe dayalı oluşturma sinyallerini uygulama

İ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, sinyalleri, reklam öğesinin görünümünü ve tarzını özelleştirmek için kullanılabilir performansın ne kadar yüksek olduğunu gösterir.

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:

Google GZT: BidResponse.interest_group_bidding.interest_group_buyer.rendering_signals
OpenRTB: BidResponse.ext.igbid.igbuyer.rsig

Farklı makro son ekleri olan en fazla 3 farklı oluşturma sinyali grubu eklenebilir 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.

İlgi alanı grubu alıcısının Protected'e katılımı reddedilir. Sinyaller URL açısından güvenli değilse makro son ekleri benzersiz değilse kitle açık artırması veya 3'ten fazla sinyal grubu sağlanmalıdır.

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

Protected Audience bölümünde teklifi, teklif hesaplaması ve son açık artırmanın cihaz üzerinde yerel olarak yapılması bekleniyor. Bu, Nihai açık artırmanın bütünlüğünü etkileyebilecek potansiyel kötüye kullanım vektörleri (kazanan teklif fiyatı gibi)

Google'ın Protected Audience API testi sırasında desteklenen bir çözüm olarak GZT iş ortakları için her bir teklif stratejisinde beklenen maksimum teklif değeri bağlama dayalı teklif yanıtı vermelidir. Beklenen maksimum teklif, teklif işlevinizin döndürmesi beklenir. Kazanan teklif tarayıcı içi açık artırma bu tutarı aşarsa, kazanan teklif sayılmaz. faturalandırılabilir etkinlik olarak kabul edilir. Bu yaklaşım değiştirilebilir.

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

Google GZT 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ını ilişkilendirmek için bir faturalandırma kimliği seçmelidir grup teklifinin gösterimlerini şu alanları kullanarak gruplayın:

Google GZT 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 GZT protokolü: BidRequest.adslot.matching_ad_data.billing_id.
OpenRTB: BidRequest.imp.ext.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ı, faturalandırma kimliğini girin. İki faturalandırma kimliği yapılandırmak istiyorsanız hesap yöneticinizle iletişime geçin. alt hesap için.

Her faturalandırma kimliği için günlük bütçe ayarlamak mümkündür. Bize ulaşın hesap yöneticisinin alt hesapların faturalandırma kimliklerine ilişkin günlük bütçeyi ayarlamasıdır.

Şuna teklif vermeye uygun bütçeye sahip tüm alt hesapların faturalandırma kimlikleri: gösterimi, harcama ilişkilendirme 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 tekliftir. BGBM birimi cinsinden 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'ın bu URL'yi inceleyip onaylaması gerekiyor. Aksi takdirde URL filtrelenecek elde eder.
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};
}

Cihaz üzerinde Protected Audience spesifikasyonuna bakın Teklif verme generateBid() işlevinin açıklaması için 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 işlevinin döndürülen değeri ve geçerli bir ISO 4217 alfa kodu olmalıdır. "USD", "EUR" veya "JPY" olarak değiştirebilirsiniz.

OpenRTB'de InterestGroupBuyer nesnesindeki yeni cur alanını kullanın Google'ın teklif yanıtı uzantısı

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şlevleri, teklifleri aşağıdaki para biriminde döndürmelidir: içeriğe dayalı teklif yanıtında belirtilir. Yeni bidCurrency özelliğini generateBid işlevinin döndürdüğü değer:

function generateBid(...) {
  ...
  return {'ad': ad,
          'bid': bid,
          'bidCurrency': 'EUR',
          ...};
}

İçeriğe dayalı teklif yanıtındaki para birimi farklıysa generateBid tarafından döndürülür veya içlerinden biri geçersiz para birimi döndürürse teklif, açık artırmadan önce filtrelenir.

Reklam kalitesi kontrolleri

Reklam öğesi politikası ve yayıncı denetimlerinin uygulanması, GZT için Protected Audience API testi sırasında tarayıcı içi ilgi grubu teklifleri iş ortakları.

Dijital Hizmetler Yasası desteği

Dijital Hizmetler Yasası'nın 26. Maddesi uyarınca yayıncılar, reklam içi şeffaflık açıklamaları. "Alıcılardan yalnızca DSA ile reklam göstermesini isteyin AEA'daki sitem veya uygulamamla ilgili şeffaflık bilgileri" kontrolü, satın alma uzmanı olarak görünürse, ilgi alanı grubu alıcıları alıcı şeffaflığı sağlamak için gereklidir alınan teklif istekleri: BidRequest.dsa.dsa_support BidRequest.dsa.publisher_rendering_support Google Authorized Buyers protokolü ve BidRequest.regs.dsa.required için ve OpenRTB protokolü için BidRequest.dsa.pubrender.

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.interest_group_bidding.interest_group_buyers.dsa_buyer_render. Google Authorized Buyers protokolüne veya BidResponse.ext.igbid.igbuyer.dsaadrenderOpenRTB protokolü için. Aksi halde 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, yayıncının kontroller ve reklam politikalar elde etti.

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() kullanın.

Bkz. Oluşturma ve Reklamla İlgili Alıcı Raporları Etkinlikler başlıklı makaleyi inceleyin.

Makrolar

Protected Audience API reklam öğesine referans veren renderUrl şunları içerebilir: bir veya daha fazla yer tutucu bulunur. İlgi grubu açık artırmasından sonra sona erer, ancak oluşturma işleminden önce makrolar, değerler. Cihaz üzerinde açık artırmada kullanılan renderUrl aşağıdakileri içerebilir makroları:

`${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 sağlayıcıya iletmek için bu makroyu kullanın. `XXXX` değerini, IAB GVL'ye kayıtlı olan IAB GVL kimliğiyle değiştirin yardımcı olur. TC dizesi boş veya geçersizse bu makro genişletilmez. `${GDPR_CONSENT_XXXX}` makrosu içeren 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]}`	Oluşturma zamanında alıcı sinyallerini içeren makro belirtilen URL'dir. `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ı farklı teklif verenin alt hesap hesapları desteklenmez.

Günlük bütçe sınırı

Protected Audience API testi sırasında her hesabın hesap düzeyinde bir düzeyi vardır. Protected Audience harcama günlük bütçe sınırı. Günlük bütçe sınırı riski sınırlar inceleyebilirsiniz. Günlük bütçe sınırına ulaşıldığında, hesabı artık Protected Audience'a uygun teklif istekleri almıyor.

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 auction_environment = SERVER_SIDE_AUCTION ile bir teklif isteği (OpenRTB: 0) alabilir Protected Audience açık artırması.

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

Almayı kabul eden teklif verenler gerçek zamanlı geri bildirim bir kampanyaya dahil edilmeyi talep edilen ilgi alanı grubu alıcıları için geri bildirim alacak cihaz üzerinde Protected Audience açık artırması. Teklif verenin teklif verdiği her bir ilgi alanı grubu alıcısı bir teklif yanıtında belirtilmesi durumunda, Protected Audience açık artırmasında ilgi alanı grubu alıcısının verdiği çok sayıda teklif. İ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
İlgi alanı grubu alıcısının kaynağı.
İlgi alanı grubu alıcısının kazanacağı minimum tekliftir. genel açık artırmadır.
İlgi alanı grubu alıcısının onu geçmek için kazanması gereken minimum teklif genel açık artırmanın sunucu tarafı bileşeninde en yüksek sıralamaya sahip teklif.
İlgi alanı grubu alıcısının durum kodu. Olası durum kodları: şurada tanımlandığı: interest-group-buyer-status-codes.txt.

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, seçili makrolar değiştirilerek Google sunucularından getirilecek Protected Audience açık artırması tamamlandıktan sonra. Aşağıdaki makrolar desteklenir:

%%GOOGLE_QUERY_ID%%: Bu makro, Google Sorgu Kimliği ile değiştirilir (Authorized Buyer protokolünde BidRequest.google_query_id ve ve BidRequest.ext.google_query_id (OpenRTB protokolünde) Protected Audience özellikli içeriğe dayalı teklif isteği.
%%INTEREST_GROUP_OWNER%%: İlgi alanı grubu sahibinin kaynağı.
%%BID_CPM%%: Alıcı tarafından BGBM cinsinden belirtilen teklif fiyatı. generateBid() işlevi.
%%RENDER_URL%%: Reklam öğesinin oluşturma URL'si.
%%STATUS%%: Teklifin scoreAd() içinde reddedildiğini gösteren durum kodu. Değerler reklam öğesi durumudur ekleyebilirsiniz.

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'si.

Ürün düzeyi 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. Test etmeyi planlıyorsanız entegrasyon sırasında hesap yöneticinize bildirin PLTD'yi dahil edin.

Hazırlanıyor

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 veya Authorized Buyer Yardım sayfasını kullanarak Merkezi.
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:

Şu öğe için renderUrl bölümüne &pltd=True sorgu parametresini dahil edin: bileşen reklamın kapsayıcısını (üst düzey renderUrl olarak da adlandırılır) reklam öğesi incelemesi sırasında üst düzey renderUrls ayırt edilir.
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() uygulayın.
İlgi alanı grubu sahibi kaynaklarını seçin ve Authorized Buyer'a ekleyin hesap.
- İ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 ile alakalı envanter için ön hedefleme ayarlayın teşvik etmek anlamına gelir.
Reklam öğeleri aracılığıyla reklam öğelerini incelemeye ve onaya gönderme API.
(İ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. Teklif geri bildirimini inceleyin. bildirimi 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 bir sürümü kullanın.
Özel Korumalı Alan API'sini ve Fenced Frame'i aşağıdakileri kullanarak etkinleştir: chrome://flags/#privacy-sandbox-ads-apis ve chrome://flags/#enable-fenced-frames. Daha fazla bilgi için Gizliliği test etme korumalı alan kullanabilir.
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.
Korumalı bir doğrulamayı tetiklemek için Google tarafından sağlanan test yayıncısı sayfasını kullanın Kitle açık artırması:

https://fledge-testing.uc.r.appspot.com/?nid=allow_all

Tarayıcı içi ilgi grubu, açık artırmayı kazanacak kadar yüksek teklif vermelidir. Bu: Geleneksel sunucu tarafı teklifleriyle rekabet edebilir. Google ayrıca Her iş ortağı için özel test yayıncısı sayfası; burada yalnızca ilgili iş ortağı açık artırmaya katılabilir. Güvenilir bir şekilde kazanmak daha kolay olabilir tarayıcı içi açık artırmalar oluşturabilirsiniz.
Aşağıdakileri doğrulayın:
1. Beklenen kazanan reklam oluşturulur.
2. Açık artırma sonucu sunucu tarafında gönderilir (kazanan bir teklif veren anlamına gelir) reportWin() ürününden bir ping geri alır.
3. Test yayıncı sayfası konsolu, her teklif için bir hata ayıklama mesajı günlüğe kaydeder ve aşağıdaki bilgiler:
  - 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 şunları yapabileceğini manuel olarak doğruladıktan sonra, Protected Audience açık artırmasına katılması halinde Google, iş ortağının testin bir sonraki aşamasıdır.

Google, Protected Audience'ı çalıştırmak için az miktarda canlı trafik ayırır açık artırmadı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şturulur. Bu sayede, entegrasyonu geniş ölçekte test edebiliriz.

Hesap yöneticinize ulaşın veya Authorized Buyer üzerinden bir destek kaydı oluşturun Yardım Merkezi'ni ziyaret edin. 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, Protected'in Kitle açık artırmaları yayınlanmaya uygundur ve kazanan ilgi grubu reklamları, oluşturulur. Katılımcı teklif verenler geleneksel tekliflerle rekabet eden tarayıcı içi teklifler teklif verirsiniz.

Hesap yöneticinize ulaşın veya Authorized Buyer üzerinden bir destek kaydı oluşturun Yardım Merkezi'ni ziyaret edin. 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 dair 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

Aşağıda paralel açık artırma akışının bir özetini görebilirsiniz: Akış diyagramı .

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 Hizmetini başlatmak için çağrısına bağlı olarak, navigator.runAdAuction interestGroupBuyers parametresi bir değer olarak aktarılırken, geri kalan açık artırma parametreleri JavaScript'i kabul eder İçeriğe dayalı reklam yanıtından sonra çözülebilecek vaatler. 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ştirmede 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 sinyallerin Vaatleri çözümlendikten sonra, cihaz üzerinde açık artırma, paralel olmayan açık artırmayla aynı şekilde tamamlanır. açık artırma akışıdır.
Paralelleştirme, ilgi alanı grubu alıcılarının listesinin önbelleğe alınmasını temel aldığından Google her zaman paralel yapma önbelleği olduğundan paralel açık artırma yapmaz. boş veya süresi dolmuş olabilir. Önbellek boş veya süresi dolmuşsa Google standart paralel olmayan Protected Audience API açık artırmasını temsil eder ve ilgi alanı grubu alıcı önbelleğini oluşturmak için paralel olmayan açık artırmaya katılması gerekir.
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ır ancak belirli bir alıcı kaynağı söz konusu alıcı, cihazdaki mevcut cihaza eklenemez. açık artırmadır. Bu durum,parallelized=True Belirli bir ilgi alanı grubu alıcı kaynağı için ParallelAuctionBuyer girişi. Bununla birlikte, geçerli ve uygun öğe ekleyerek ilgilendiğinizi belirten teklif verenler Teklif yanıtındaki InterestGroupBuyer ilgili ilgi alanı grubu alıcısına önbelleğe eklenen kaynaklar ve bu kaynaklar gelecekte aynı tarayıcıdan ve alandan gelecek paralelleştirilecek istekler. İlgi 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
Önbelleğe alınan alıcı kaynakları (paralel açık artırmanın interestGroupBuyers parametresi) teklif verenin amaç belirtmediği teklif yanıtına katılması için alıcı tarafından güvenilen bir sunucu çağrısı alabilir ancak paralel açık artırmaya katılmaz.