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

Mimari

Teklif Verme ve Açık Artırma Hizmetleri'nin açık artırma mimarisini öğrenin

Genel Bakış

Teklifli Sistem ve Açık Artırma (B&A) Hizmetleri, reklam alıcıları ve satıcıları için Protected Audience (PA) açık artırmasını kolaylaştırmak amacıyla Güvenilir Yürütme Ortamında (TEE) çalışan bir dizi hizmet sağlar. Bu sayfada, B&A'nın PA açık artırmasında kullanılabileceği çeşitli açık artırma yapılandırmaları açıklanmaktadır.

Tanımlar

Terim	Açıklama
Protected Audience açık artırması	Siteler arası veriler içeren bir reklam açık artırması
İçeriğe dayalı açık artırma	Siteler arası veriler içermeyen bir reklam açık artırması. Bu açık artırma, mevcut Gerçek Zamanlı Teklif (GZT) açık artırma yolunu izler.
Birleştirilmiş açık artırma isteği	Satıcının JavaScript kodu tarafından tarayıcıdan gönderilen ve hem Protected Audience açık artırması hem de bağlama dayalı açık artırma için yükü içeren bir istek.
Satıcı Reklam Hizmeti (SAS)	Tarayıcıdan gelen birleştirilmiş açık artırma isteğini işlemekten sorumlu hizmet. Bu, satıcının mevcut RTB reklam sunucusu olabilir. SAS, hem bağlama dayalı hem de korumalı kitle açık artırmalarını koordine etmekten sorumludur.
Alıcı Reklam Hizmeti	İçeriğe dayalı açık artırma teklifi göndermekten sorumlu hizmet. Bu, alıcının mevcut ORTB reklam sunucusu olabilir.

Alıcılar ve satıcılar için hizmetler

B&A Hizmetleri, alıcılar ve satıcılar için dört hizmetten oluşur:

Alıcılar için Teklif Verme Hizmeti ve Alıcı Ön Uç (BFE) Hizmeti kullanılabilir.
Satıcılar Açık Artırma Hizmeti ve Satıcı Ön Uç (SFE) Hizmeti'ni kullanabilir.

Katılımcı	Hizmet	Açıklama
Alım sorumlusu	Alıcı Ön Uç (BFE) Hizmeti	Hizmet, satıcının SFE'sinden gelen `GetBids` isteğini işler. Yükün şifresini çözmekten, K/V sinyallerini getirmekten ve Teklif Verme Hizmeti'nin `GenerateBids` işlevini çağırmaktan sorumludur.
Alım sorumlusu	Bidding Hizmeti	Hizmet, BFE'den gelen `GenerateBids` isteğini işler. Alıcının teklif verme mantığını çalıştırmaktan ve teklif oluşturmaktan sorumludur.
Satıcı	Satıcı Kullanıcı Arayüzü (SFE) Hizmeti	Hizmet, Satıcı Reklam Hizmeti'nden gelen `SelectAd` isteğini işler. Yükün şifresini çözmekten, BFE'nin `GetBids` işlemini çağırmaktan, K/V sinyallerini getirmekten, Açık Artırma Hizmeti'nin `ScoreAd` işlemini çağırmaktan ve ardından şifrelenmiş B&A açık artırma sonucunu SAS'a döndürmekten sorumludur. Hizmet, sunucu tarafından yönetilen çok satıcılı açık artırmada üst düzey satıcının yığınının bir parçası olduğunda SAS'den gelen `GetComponentAuctionCiphertexts` isteğini de işler.
Satıcı	Auction Hizmeti	Hizmet, SFE'den gelen `ScoreAd` isteğini işler. Satıcının puanlama mantığını çalıştırmaktan ve bir teklifin arzu edilirlik puanını sağlamaktan sorumludur.

Web için PA B&A açık artırmasının mimarisi

Aşağıdaki şemada, tek bir satıcı ve tek bir alıcıyla B&A Hizmetleri'nin kullanıldığı temel Protected Audience açık artırması açıklanmaktadır. Kalın kırmızı kenarlı kutular, TEE'de çalışan hizmetleri temsil eder:

İstemci tarafı JavaScript kodu, birleştirilmiş açık artırma isteğini SSP'ye gönderir. SAS, SFE'ye bir istek gönderir ve SFE, teklif için BFE'ye bir istek gönderir

(Tam boyutlu şema)

SSP'nin yayıncı sayfasındaki JavaScript kodu, navigator.getInterestGroupAdAuctionData() çağrısı yaparak şifrelenmiş B&A reklam açık artırma verilerini oluşturur.
- Bu şifrelenmiş yük, alıcının verilerini içerir ve yalnızca TEE'deki bir SFE içinde şifresi çözülebilir.
STP JavaScript kodu, Satıcı Reklam Hizmeti'ne birleştirilmiş bir açık artırma isteği gönderir.
- Birleştirilmiş açık artırma isteği hem açık metin ORTB bağlamsal açık artırma yükünü hem de şifrelenmiş B&A açık artırma yükünü içerir.
- Satıcı Reklam Hizmeti, mevcut reklam sunucunuzdur ve TEE'de çalışmaz.
Satıcı reklam hizmeti, içerikle ilgili açık artırma teklifini ve sonraki PA açık artırmasına iletilecek alıcı sinyallerini istemek için TTP'nin GZT hizmetini çağırır.
- Bu, bir alıcının PA açık artırmasına katılma niyetini belirttiği bir adım olabilir.
Bağlamsal açık artırma tamamlandıktan sonra SAS, SelectAd isteğini SFE Hizmeti'ne gönderir.
- İçeriğe dayalı açık artırma kazanan teklif ve alıcı sinyalleri, SelectAd istek yüküne eklenir.
SSP'nin SFE Hizmeti, GetBids isteğiyle DSP'nin BFE Hizmeti'ni çağırır.
DSP'nin BFE'si, GenerateBids isteğiyle Teklif Verme Hizmeti'ni çağırır.
Teklif SFE tarafından alındıktan sonra ScoreAd çağrısı Açık Artırma Hizmeti'ne yapılır.
- En yüksek arzu puanına sahip teklif SAS'a döndürülür ve ardından sayfadaki JavaScript koduna yönlendirilir.
Şifrelenmiş B&A açık artırma sonucu navigator.runAdAuction() çağrısına iletilerek açık artırma tarayıcıda tamamlanır.

Açık artırma yapılandırmaları

B&A Hizmetleri'nin kullanıldığı Protected Audience açık artırması aşağıdaki şekillerde yapılandırılabilir:

B&A alıcıları olan tek satıcılı açık artırma
Cihaz üzerinde alıcılar ve B2B alıcılar ile karma modlu açık artırma
Cihaz tarafından veya sunucu tarafından düzenlenebilen çok satıcılı açık artırma

Katılımcı sayısı

Bu kılavuzda, her açık artırma yapılandırmasını açıklamak için aşağıdaki katılımcılar kullanılır:

Katılımcı	Açıklama
`DSP-A`	Cihaz üzerinde alıcı
`DSP-B`	Cihaz üzerinde alıcı
`DSP-X`	B&A alıcı
`DSP-Y`	B&A alıcı
`SSP-TOP`	Üst düzey satıcı
`SSP-OD`	Yalnızca cihaz üzerinde satıcı
`SSP-BA`	Yalnızca B&A satıcısı
`SSP-MIX`	Karma modda çalışan satıcı

Dört DSP vardır:

DSP-A ve DSP-B yalnızca cihaz üzerinde açık artırmalara katılır
DSP-X ve DSP-Y hem cihaz üzerinde açık artırmalara hem de B&A açık artırmalarına katılır

Dört SSP vardır ve her satıcı farklı bir açık artırma yapılandırması kullanır:

SSP-OD yalnızca cihaz üzerinde açık artırma düzenler
SSP-BA yalnızca B&A açık artırması düzenler
SSP-MIX karma modlu bir açık artırma düzenler
SSP-TOP çok satıcılı açık artırma düzenler:
- SSP-OD/BA/MIX, SSP-TOP'un çok satıcılı açık artırmasında bileşen satıcısı olarak katılır.

Tek satıcılı B&A açık artırması

Tek satıcılı kurulumda, bir satıcı birden fazla alıcının katıldığı bir açık artırma düzenler. Satıcı bir B&A açık artırması yayınlıyorsa alıcıların açık artırmaya teklif göndermek için B&A Hizmetleri alıcı yığınını çalıştırması gerekir. Alıcıların ve satıcıların aynı bulut sağlayıcıyı kullanması gerekmez.

Tek bir SFE'nin teklif almak için birden fazla BFE ile iletişim kurduğu tek satıcılı mimari

(Tam boyutlu şema)

Önceki kurulumda SSP-BA, DSP-X ve DSP-Y'nin B&A Hizmetleri alıcı grubunu kullanarak katıldığı bir B&A açık artırması düzenler. Satıcının reklam hizmeti, önce DSP-X ve DSP-Y için bağlama dayalı bir açık artırma, ardından SelectAd isteğini satıcının SFE Hizmeti'ne göndererek Protected Audience açık artırması yürütür. İçeriğe dayalı açık artırmanın kazanan teklifi ve her alıcıya ait sinyaller SelectAd çağrısına iletilir. Ardından SFE Hizmeti, DSP-X ve DSP-Y'nin BFE'sine GetBids istekleri gönderir. BFE, teklif oluşturmak için Teklifli Sistem Hizmetini çağırır.

Şifrelenmiş B&A açık artırma sonucu istemciye döndürülür ve runAdAuction() çağrısına iletilir. Tek satıcılı açık artırma yapılandırması aşağıdaki gibi görünür:

await navigator.runAdAuction({
  seller: 'https://ssp-ba.example',
  requestId: 'g8312cb2-da2d-4e9b-80e6-e13dec2a581c',
  serverResponse: Uint8Array(560) [193, 120, 4, …] // Encrypted B&A auction result
})

requestId değeri, istemcideki getInterestGroupAdAuctionData() çağrısından, serverResponse verileri ise sunucu tarafı B&A açık artırmasından gelir.

Karma modlu açık artırma

Karma mod yapılandırmasında alıcılar, satıcının açık artırmasına cihaz üzerinden veya B&A üzerinden katılabilir. Mavi oklar cihaz üzerinde açık artırma yolunu, kırmızı oklar ise B&A açık artırma yolunu temsil eder:

Alıcıların tekliflerini cihaz üzerinde veya B2B'den gönderebildiği karma modlu bir satıcı mimarisi

(Tam boyutlu şema)

Bu kurulumda DSP-A ve DSP-B, tekliflerini cihaz üzerinde gönderen alıcılar, DSP-X ve DSP-Y ise tekliflerini B&A'yı kullanarak gönderen alıcılardır. Cihaz üzerinde alıcılar, tarayıcıda cihaz üzerinde bir PA açık artırmasına, B&A alıcıları ise tek satıcılı açık artırma bölümünde açıklanan B&A açık artırma kurulumuna katılır.

Bağlamsal açık artırma, kazanan teklifi ve alıcı sinyallerini toplamak için önce tüm alıcılar için yürütülür. Ardından B&A açık artırması çalıştırılır ve bağlamsal açık artırmadan gelen alıcı sinyalleri SFE'ye gönderilen SelectAd isteğine aktarılır. SFE'den döndürülen şifrelenmiş B&A açık artırma sonucu tarayıcıya yönlendirilir. B&A açık artırması tamamlandıktan sonra sonucu, cihaz üzerinde alıcıların katıldığı cihaz üzerinde açık artırmaya aktarılır.

Açık artırmanın cihaz üzerinde olan kısmı için karma modlu tek satıcılı açık artırma yapılandırması aşağıdaki gibi görünür:

await navigator.runAdAuction({
  seller: 'https://ssp-mix.example',
  decisionLogicURL: 'https://ssp-ba.example/score-ad.js',
  componentAuctions: [
    // B&A auction
    {
      seller: 'https://ssp-mix.example',
      requestId: 'f5135cb2-da2d-4e9b-80e6-e13dec2a581c',
      serverResponse: Uint8Array(560) [133, 20, 14, …]
    },
    // On-device auction
    {
      seller: 'https://ssp-mix.example',
      interestGroupBuyers: ['https://dsp-a.example', 'https://dsp-b.example'],
      decisionLogicURL: 'https://ssp-mix.example/on-device-score-ad.js',
    }
  ]
})

Cihaz üzerinde ve B&A açık artırmalarının paralelleştirilmesi

Paralelleştirme olmadan açık artırmalar sırayla yürütülür. Önce içerik açık artırması, ardından B&A açık artırması ve son olarak cihaz üzerinde açık artırma çalışır. Paralelleştirme uygulandığında, içerik açık artırması önce tekrar çalışır ancak B&A açık artırması sona ermeden önce cihaz üzerinde açık artırmayı paralel olarak başlatmak için sonucu ve sinyalleri istemciye geri aktarılır.

Bağlamsal açık artırma teklifinin, sinyallerin ve SelectAd sonucunun tarayıcı JavaScript koduna nasıl geri aktarıldığını açıklayan bir şema

(Tam boyutlu şema)

İstemcideki JavaScript kodu, birleştirilmiş açık artırma isteğini SAS'a gönderir ve SAS, bağlama dayalı açık artırmayı ve PA B&A açık artırmasını başlatır. SAS, bir alıcının RTB sunucusundan yanıt aldığında, tüm teklifler alındıktan sonra cihaz üzerinde açık artırma için alıcı sinyalleri, bağlamsal açık artırma kazananı ile birlikte tarayıcıya geri aktarılabilir. Yayınlanan alıcı sinyalleri, cihaz üzerinde teklif oluşturmak için kullanılır ve teklifler puanlanırken içerik açık artırması kazananı teklif tabanı olarak kullanılır.

SAS'te satıcı, bağlama dayalı açık artırma verilerini tarayıcıya aktarırken Ad-Auction-Result-Nonce yanıt başlığında ayarlanan bir UUID tek seferlik oluşturur. B&A açık artırması için SFE'ye yapılan SelectAd çağrısında aynı tek seferlik sayı kullanılır ve bu tek seferlik sayı, SFE'den döndürülen SelectAd yanıtına dahil edilir. İstemci tarafı açık artırma aşamasında tarayıcı, Ad-Auction-Result-Nonce yanıt üstbilgisindeki tek seferlik şifreyi şifrelenmiş açık artırma sonucu yükündeki tek seferlik şifreyle eşleştirir.

Karma modlu paralelleştirme hakkında daha fazla bilgi edinmek için açıklamayı inceleyin.

Çok satıcılı açık artırma

B&A ile PA çok satıcılı açık artırma yapmanın iki yolu vardır:

Her bileşen satıcısının reklam hizmetine yapılan çağrının tarayıcıdan geldiği cihaz tarafından yönetilen açık artırma
Her bileşen satıcısının reklam hizmetine yapılan çağrının üst düzey satıcının reklam hizmetinden geldiği sunucu tarafından yönetilen açık artırma

Cihaz tarafından koordine edilen çok satıcılı açık artırma

Cihaz tarafından yönetilen çok satıcılı açık artırmada her bileşen satıcısı, açık artırmasını istediği yapılandırmada çalıştırabilir. Cihaz üzerinde satıcılar, B2B satıcılar ve karma mod satıcılarının tümü üst düzey açık artırmaya katılabilir.

Farklı açık artırma yapılandırmaları çalıştıran birden fazla satıcının açık artırma sonuçlarını üst düzey satıcıya nasıl gönderebileceğini açıklayan bir şema

(Tam boyutlu şema)

Bu kurulumda, üst düzey satıcı olan SSP-TOP, SSP-OD, SSP-BA ve SSP-MIX'ın katıldığı çok satıcılı bir açık artırma düzenler:

Yalnızca cihaz üzerinde PA açık artırması yapan SSP-OD, cihaz üzerinde bileşen açık artırması yapılandırmasını üst düzey satıcıya gönderir.
B&A açık artırması yürüten SSP-BA, Satıcı Reklam Hizmeti'ne birleştirilmiş açık artırma isteği gönderir ve kendi bağlamsal ve B&A açık artırmalarını yürütür. Sonuçlar üst düzey satıcıya gönderilir.
Karma modda açık artırma yürüten SSP-MIX, B&A açık artırmasını önce sunucuda yürütür, ardından hem B&A açık artırma sonucunu hem de cihaz üzerinde açık artırma yapılandırmasını gönderir.

Üst düzey satıcı, her satıcıdan bileşen açık artırma yapılandırmalarını toplar ve aşağıdakine benzer bir açık artırma yapılandırması oluşturur:

await navigator.runAdAuction({
  seller: 'https://ssp-top.example',
  decisionLogicURL: 'https://ssp-top.example/score-ad.js',
  componentAuctions: [
    // SSP-BA's B&A-only auction
    {
      seller: 'https://ssp-ba.example',
      requestId: 'g8312cb2-da2d-4e9b-80e6-e13dec2a581c',
      serverResponse: Uint8Array(560) [193, 120, 4, …] // Encrypted B&A auction result
    },
    // SSP-MIX's B&A auction of mixed-mode
    {
      seller: 'https://ssp-mix.example',
      requestId: 'f5135cb2-da2d-4e9b-80e6-e13dec2a581c',
      serverResponse: Uint8Array(560) [133, 20, 4, …] // Encrypted B&A auction result
    }.
    // SSP-MIX's on-device auction of mixed-mode
    {
      seller: 'https://ssp-mix.example',
      interestGroupBuyers: ['https://dsp-a.example', 'https://dsp-b.example'],
      decisionLogicURL: 'https://ssp-mix.example/score-ad.js',
    }
    // SSP-OD's on-device auction
    {
      seller: 'https://ssp-od.example',
      interestGroupBuyers: ['https://dsp-a.example', 'https://dsp-b.example'],
      decisionLogicURL: 'https://ssp-od.example/score-ad.js',
    }
  ]
})

Sunucu tarafından yönetilen çok satıcılı açık artırma

Sunucu tarafından yönetilen çok satıcılı açık artırmada, bileşen satıcısının reklam hizmetlerine yapılan çağrılar üst düzey satıcının reklam hizmetinden yapılır. Bu kurulumda, bileşen satıcıları cihaz üzerinde veya karma modda açık artırma yayınlayamaz; tüm satıcılar B&A'yı, tüm alıcılar da tekliflerini B&A'yı kullanarak göndermelidir.

Üst düzey STP, Satıcı Reklam Hizmetine birleştirilmiş bir açık artırma isteği gönderir. Satıcı Reklam Hizmeti, GetComponentAuctionCipherTexts işlemini çalıştırmak için SFE'yi çağırır. Döndürülen şifrelenmiş metinler, her bileşen satıcısının kendi B&A açık artırmalarını yürüten reklam hizmetine gönderilir.

(Tam boyutlu şema)

Bu şemada SSP-TOP, SSP-BA-X ve SSP-BA-Y'nin katıldığı, sunucu tarafından koordine edilen çok satıcılı bir açık artırma yürütmektedir.

Tarayıcıdan üst düzey satıcının reklam hizmetine, tüm katılımcılar için içeriğe dayalı ve PA açık artırmalarını içeren tek bir birleşik açık artırma isteği gönderilir. Ardından SAS, yükü SFE'ye göndermek için GetComponentAuctionCiphertexts çağrısı yapar. SFE, yükün şifresini çözer, yükleri her bileşen satıcısına göre ayırır ve yeniden şifrelenmiş yükleri üst düzey satıcının SAS'ine döndürür.

GetComponentAuctionCiphertexts isteği ve yanıtı için proto tanımları şunlardır:

// Request sent from the top-level seller's ad service to SFE
message GetComponentAuctionCiphertextsRequest {
  bytes protected_auction_ciphertext = 1; // Generated in the browser
  repeated string component_sellers = 2; // The list of all component sellers
}

// Response returned from SFE to the top-level seller's ad service
message GetComponentAuctionCiphertextsResponse {
  // A map of component sellers and their re-encrypted payloads
  map<string, bytes> seller_component_ciphertexts = 1;
}

Her bileşen satıcısının yükü ile üst düzey satıcının SAS'i bileşen satıcılarının SAS'ini çağırır ve her bileşen SAS'i, bileşen B&A açık artırmasını yürütür. Ardından, bileşen açık artırmalarının sonuçları üst düzey satıcının SFE'sine döndürülür ve bileşen açık artırma teklifleri üst düzey satıcının Açık Artırma Hizmeti tarafından puanlanır. En yüksek arzu puanına sahip teklif SFE'ye döndürülür ve şifrelenmiş yük, istemciye döndürülecek şekilde SAS'e gönderilir. Tarayıcıda üst düzey satıcı, navigator.runAdAuction() işlevini çağırarak ve şifrelenmiş sunucu açık artırma sonucu yükü sağlayarak açık artırmayı tamamlar.

Sonraki adımlar

Bu kılavuzu okuduktan sonra aşağıdaki adımları uygulayabilirsiniz:

Daha fazla bilgi

Protected Audience için B&A'nın işleyiş şeklini daha iyi anlamak istiyorsanız GitHub'daki aşağıdaki açıklamaları inceleyin:
Uçtan Uca Yerel Test codelab'ini uygulayarak B&A ile Protected Audience'ı deneyin.
Satıcı entegrasyonu için Satıcı olarak B&A ile entegrasyon yapma başlıklı makaleyi inceleyin.

Sorularınız mı var?

Teklif ve Açık Artırma Hizmetleri deposunda bir sorun açarak Teklif ve Açık Artırma Hizmetleri hakkında soru sorun.
privacy-sandbox-dev-support deposunda bir sorun açarak genel olarak Özel Korumalı Alan hakkında soru sorabilirsiniz.