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

Satıcı kılavuzu: reklam açık artırmaları çalıştırma

Protected Audience API reklam açık artırması için satıcı API kılavuzu ve referanslar.

Bu makalede, deneysel Protected Audience API'nin mevcut iterasyonunda kullanılan reklam açık artırması için teknik bir referans bulunmaktadır.

Kullanım ömrü boyunca geliştirici kılavuzunu okuyun döngüsünü takip edin ve Protected Audience API açıklayıcısına bakarak satıcıların cihaz üzerinde açık artırmaları nasıl yürüttüğü.

Geliştirici değil misiniz? Protected Audience API'ye genel bakış sayfasını inceleyin.

Protected Audience API reklam açık artırması nedir?

Protected Audience API reklam açık artırması, Tarayıcı, bir reklam seçmek için kullanıcının cihazında çalışır. Gizliliği korumak için, tüm reklamlar Satıcı ve alıcılardan alınan açık artırma kodu izole JavaScript'te çalıştırılır iletişim kuramayan iş akışlarını çok şanslıydık.

Protected Audience API reklam açık artırmasında altı aşama — Bu şemada, Protected Audience API reklam açık artırmasının her aşaması özetlenmektedir.

Kullanıcı reklamların görüntülendiği bir siteyi ziyaret eder.
Satıcının kodu navigator.runAdAuction() yürütür. Bu, reklam alanının satılık olduğunu ve kimlerin teklif verebileceğini belirler. Satıcılar bir komut dosyası da içermelidir Bu da her bir teklifin scoreAd() olarak derecelendirilmesini sağlar.
Not: Açık artırma başlamadan önce satıcı, kullanılabilir.
Davet edilen alıcının kodu, teklif (alakalı bir reklamın URL'si) oluşturmak için yürütülür ve diğer verileri içerir. Teklif komut dosyası gerçek zamanlı verileri sorgulayabilir, geri kalan reklam kampanyası bütçesi gibi, alıcının Anahtar/Değer hizmeti.
Satıcının kodu her teklifi puanlar ve kazananı seçer. Bu mantık teklif değerini ve diğer verileri döndürür. Daha iyi olmayan reklamlar içeriğe dayalı kazanan reddedilir. Satıcı kendi Gerçek zamanlı veriler için Anahtar/Değer hizmeti.
Kazanan reklam opak bir değer olarak döndürülür ve çizili çerçeve'yi seçin. Hem satıcı hem de yayıncı bu değeri görüntüleyemez.
Açık artırma satıcıya ve kazanan alıcılara bildirilir.
Not: Satıcının reportResult() ve alıcının reportWin()'sı arama içerebilir sendReportTo() adlı konuma. Bu kullanılabilir geçici olarak toplu raporlama Özel Toplama.

Açık artırma ne zaman yapılır?

Protected Audience API, tek başına veya programatik açık artırmalarla çalıştırılabilir. Çok satıcılı hesaplarda programatik açık artırma:

Kullanıcı, katılımcı bir siteyi ziyaret eder.
Mevcut bir reklam alanına yönelik içeriğe dayalı bir reklam bulmak için başka bir satıcı tarafından programatik açık artırma yürütülür.
Protected Audience API açık artırması yapılıyor.
scoreAd()Alıcının tekliflerini ilk açık artırmanın sonuçlarıyla karşılaştırır.

İçeriğe dayalı kazananı geçemeyen teklifler reddedilir.

Protected Audience API reklam açık artırmasını kimler düzenler?

Reklam alanı satmak için açık artırma yürütebilecek birden fazla taraf vardır.

Örneğin:

İçerik yayıncısı: Web sitesinde reklam içeriği barındırmak için kendisi adına hareket etme.
Arz tarafı platformu (STP): Yayıncıyla çalışma ve başka hizmetler sağlama.
Üçüncü taraf komut dosyası: Reklam açık artırmalarına katılımı sağlamak için yayıncı adına hareket etme.

Protected Audience API ile bir satıcının üç işi olur:

Yayıncı kurallarını zorunlu kılın: Hangi alıcılar ve hangi tekliflerin uygun olduğu.
Açık artırma mantığını çalıştır: JavaScript'in çalışması iş akışını istenen puandır.
Açık artırma sonucunu bildirin.

Bu işler programatik olarak, satıcı tarafından sağlanan kodla JavaScript işlevini çağırarak reklam açık artırması başlatır navigator.runAdAuction()

API işlevleri

`runAdAuction()`

Satıcı, navigator.runAdAuction() kodunu çağırarak bir reklam açık artırması başlatmak için kullanıcının tarayıcısına istekte bulunur.

Örneğin:

const auctionConfig = {
  seller: 'https://ssp.example',
  decisionLogicUrl: ...,
  trustedScoringSignalsUrl: ...,
  interestGroupBuyers: ['https://dsp.example', 'https://buyer2.example', ...],
  auctionSignals: {...},
  sellerSignals: {...},
  sellerTimeout: 100,
  perBuyerSignals: {
    'https://dsp.example': {...},
    'https://another-buyer.example': {...},
    ...
  },
  perBuyerTimeouts: {
    'https://dsp.example': 50,
    'https://another-buyer.example': 200,
    '*': 150,
    ...
  },
  componentAuctions: [
    {
      'seller': 'https://some-other-ssp.example',
      'decisionLogicUrl': ...,
      ...
    },
    ...
  ]
};

try {
  const auctionResultPromise = navigator.runAdAuction(auctionConfig);
} catch (error) {
  // Handle error.
}

runAdAuction(),URNurn:uuid:<something> reklam açık artırması sonucu Bu öğenin kodu yalnızca çitle ayrılmış bir çerçeveye geçirildiğinde tarayıcı tarafından çözülebilir oluşturma için: Yayıncı sayfası kazanan reklamı denetleyemiyor.

Not: joinAdInterestGroup() içeren komut dosyasının kaynağı , ilgi alanı grubu sahibinin kaynağıyla eşleşmelidir. Bu nedenle joinAdInterestGroup() ve ilgi grubu sahibi, mevcut dokümanın kaynağıyla eşleşir ( Örneğin, kendi ilgi alanı gruplarına sahip bir web sitesi). runAdAuction aynı değere sahip değil bu nedenle, <script> etiketi kullanmak büyük olasılıkla kaynaklar arası iframe'dir.

decisionLogicUrl komut dosyası, her bir reklamı ve reklam öğelerini dikkate alır. teklif ve meta verileri kullanır ve ardından buna sayısal bir değer atar skoruna dahildir.

`auctionConfig` tesis

Not: additionalBids, şu anki Protected Audience API uygulamasında desteklenmez. Açık Artırmayı Okuyun Katılımcılar Daha fazla bilgi için Protected Audience API açıklayıcısına göz atın.

seller

Zorunlu

Örnek: 'https://ssp.example'

Rol: Satıcının kökeni.

decisionLogicUrl

Zorunlu

Örnek: 'https://ssp.example/auction-decision-logic.js'

Rol: Açık artırma iş akışı JavaScript'inin URL'si.

trustedScoringSignalsUrl

İsteğe bağlı

Örnek: 'https://ssp.example/scoring-signals'

Rol: Satıcının güvenilir sunucusunun URL'si.

interestGroupBuyers

Zorunlu

Örnek: ['https://dsp.example', 'https://buyer2.example', ...]

Rol: Açık artırmada teklif vermek istenen tüm ilgi alanı grubu sahiplerinin kaynakları.

Notlar: Satıcı, tüm ilgi alanı gruplarının teklif vermesine izin vermek için interestGroupBuyers: değerini belirtebilir. Reklamlar, daha sonra ilgi alanı grubu sahibinin dahil edilmesi dışındaki ölçütlere göre kabul edilir veya reddedilir. Örneğin, satıcı kendi politikalarına uygun olduğunu onaylamak için reklam öğelerini inceleyebilir.

auctionSignals

İsteğe bağlı

Örnek: {...}

Rol: Sayfa bağlamı, açık artırma türü vb.hakkında satıcı bilgileri

sellerSignals

İsteğe bağlı

Örnek: {...}

Rol: Yayıncı ayarlarına dayalı bilgiler, içeriğe dayalı reklam isteğinde bulunma vb.

sellerTimeout

İsteğe bağlı

Örnek: 100

Rol: Satıcının scoreAd() komut dosyasının maksimum çalışma zamanı (ms).

perBuyerSignals

İsteğe bağlı

Örnek:

{'https://dsp.example': {...}, 'https://another-buyer.example': {...}, ... }

Rol: Her bir alıcının sunucusundan gelen, sayfayla ilgili bağlamsal sinyaller.

perBuyerTimeouts

İsteğe bağlı

Örnek: 50

Rol: Belirli bir alıcının generateBid() komut dosyalarının maksimum çalışma zamanı (ms).

componentAuctions

İsteğe bağlı

Örnek:

[{'seller': 'https://www.some-other-ssp.com', 'decisionLogicUrl': ..., ...}, ...]

Rol: Bileşen açık artırmaları için ek yapılandırmalar.

`decisionLogicUrl`

decisionLogicUrl, açık artırma yapılandırma nesnesinin bir özelliğidir. runAdAuction() adresine iletildi. Bu URL, scoreAd() işlevini kullanın. Bu mantık, her reklamın bir kez çalıştırılması için ve ara hedefler belirlenir.

scoreAd(adMetadata, bid, auctionConfig, trustedScoringSignals, browserSignals) {
  ...
  return desirabilityScoreForThisAd;
}

`browserSignals`

browserSignals, tarayıcı tarafından oluşturulan bir nesnedir. Aşağıdaki bilgiler de buna dahildir: satıcının bildiği ve satıcının açık artırma komut dosyasının neyi, doğrulayın:

{
  topWindowHostname: 'publisher.example',
  interestGroupOwner: 'https://dsp.example',
  renderUrl: 'https://cdn.example/render',
  adComponents: ['https://cdn.com/ad-component-1', ...],
  biddingDurationMsec: 12,
  dataVersion: 1 /* DValue from the seller's Key/Value service response. */
}

Açık artırma başlamadan önce satıcı, kullanılabilir. scoreAd() mantığının bir bölümü, şunları yapamayan reklamları reddeder: içerik açısından kazananı yendi.

`scoreAd()`

scoreAd(), şu bağımsız değişkenleri alır:

Argüman	Rol
`adMetadata`	Alıcı tarafından sağlanan rastgele meta veriler.
`auctionConfig`	Açık artırma yapılandırma nesnesi `navigator.runAdAuction()` işlevine aktarıldı.
`bid`	Sayısal teklif değeri.
`trustedScoringSignals`	Açık artırma anında satıcının güvenilir sunucusundan alınan ve satıcının reklamla ilgili görüşünü temsil eden değerler.

Sık sorulan sorular

Açık artırmanın kazananı nasıl belirlenir ve kim tarafından seçilir?

Satıcı, her bir reklamın istenirlik puanını belirlemek için puanlama mantığını sağlar ve tarayıcı, en yüksek puanı kazanan reklam olarak seçer.

Satıcı, scoreAd() işlevine bir mantık ekliyor ve tarayıcı, işlevi bunun dışındaki kodla sınırlı iletişimi olan bir iş akışında yürütüyor. Tarayıcının kendisi reklamları puanlamaz. Puanlama mantığını yürütmek ve en yüksek puana sahip teklifi seçmek yalnızca tarayıcıya sorumludur.

Tüm Protected Audience API referansları

API referans kılavuzları mevcuttur:

Protected Audience API için geliştirici kılavuzu.
Korunan Kitle ilgi alanı grupları ve teklif oluşturma ile ilgili reklam alıcı rehberi.
Korunan Kitle reklam açık artırmaları ile ilgili reklam satıcısı kılavuzu.
Açık artırma sonuçlarını raporlama kılavuzu
Korunan Kitle için en iyi uygulamalar reklam açık artırması gecikmesi
Korunan Kitle ile ilgili sorunları giderme

Protected Audience API açıklayıcısı da özellik desteği ve kısıtlamalar hakkında ayrıntılı bilgi sağlar.

Satıcı kılavuzu: reklam açık artırmaları çalıştırma

Protected Audience API reklam açık artırması nedir?

Açık artırma ne zaman yapılır?

Protected Audience API reklam açık artırmasını kimler düzenler?

API işlevleri

runAdAuction()

auctionConfig tesis

decisionLogicUrl

browserSignals

scoreAd()

Sık sorulan sorular

Açık artırmanın kazananı nasıl belirlenir ve kim tarafından seçilir?

Tüm Protected Audience API referansları

`runAdAuction()`

`auctionConfig` tesis

`decisionLogicUrl`

`browserSignals`

`scoreAd()`