Reklam alanı satın almak için açık artırmada teklif verme

Bir reklam alıcısı (TTP'ler ve reklamverenler) olarak, bir reklamı reklamverenin sitesinde tanımladığınız ilgi alanı grubuna hedeflemek için yayıncı sitesinde Protected Audience reklam açık artırmasına katılmak isteyebilirsiniz. Protected Audience açık artırmasına katılarak tanımlanmış müşterilerinize diğer sitelerde gizliliği koruyacak şekilde ulaşabilirsiniz.

Protected Audience açık artırmasında, teklifin oluşturulması için gereken mantığı sağlarsınız ve tarayıcı bu mantığı kullanarak teklifi hesaplar. Bu, teklifi mantığı sağlamak yerine doğrudan gönderdiğiniz diğer açık artırma mimarilerinin aksinedir.

Teklif oluşturma mantığınızı generateBid() JavaScript işlevinde sağlarsınız ve dosya sunucunuzda barındırılır. Bir ilgi alanı grubuna kullanıcı eklediğinizde, bu dosyanın konumu ilgi alanı grubu yapılandırmasına biddingLogicUrl olarak aktarılır.

Açık artırma sırasında tarayıcı, biddingLogicUrl alanında belirtilen teklif verme mantığınızı getirir ve her ilgi alanı grubu için generateBid() işlevinizi, dış bağlamla iletişimi sınırlı olan güvenli izole bir ortamda yürütür. generateBid() yürütüldüğünde tarayıcı, sinyalleri bağımsız değişken olarak işleve aktarır. Bu sinyaller; yayıncının birinci taraf verileri, satıcı verileri ve gerçek zamanlı veriler gibi farklı kaynaklardan gelen çeşitli bilgileri içerir. Teklifi hesaplamak için bu sinyalleri kullanabilirsiniz. Değer, generateBid() çağrısından döndürülür. Teklifler gönderildikten sonra, tarayıcı satıcının istenirlik puanını hesaplamak için her teklifte satıcının puanlama mantığını yürütür.

generateBid()

Aşağıda, generateBid() işlevinin bağımsız değişkenleri ve işlevden döndürülen teklifin yapısı açıklanmaktadır:

generateBid(interestGroup, auctionSignals, perBuyerSignals,
    trustedBiddingSignals, browserSignals, directFromSellerSignals) {
  return {
    ad: adObject,
    adCost: optionalAdCost,
    bid: bidValue,
    bidCurrency: 'USD',
    render: {
      url: renderURL,
      width: renderWidth,
      height: renderHeight
    },
    adComponents: [
      {url: adComponent1, width: componentWidth1, height: componentHeight1},
      {url: adComponent2, width: componentWidth2, height: componentHeight2},
      // ...
    ],
    allowComponentAuction: false,
    modelingSignals: 123 // 0-4095 integer (12-bits)
  };
}

Bağımsız değişkenler

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

Tarayıcı sinyalleri

browserSignals nesnesi aşağıdaki özelliklere sahiptir:

{
  topWindowHostname: 'publisher.example',
  seller: 'https://ssp.example',
  topLevelSeller: 'https://www.top-level-ssp.com',
  requestedSize: {width: 100, height: 200},  /* if specified in auction config */
  joinCount: 3,
  recency: 3600000,
  bidCount: 17,
  prevWinsMs: [[timeDeltaMs1,ad1],[timeDeltaMs2,ad2],...],
  wasmHelper: ...
  dataVersion: 1,
  adComponentsLimit: 40
}

Teklif hesaplama

generateBid() içindeki kod, bir teklif değerini hesaplamak için işlev parametrelerinin özelliklerini kullanabilir.

Örneğin:

function generateBid(interestGroup, auctionSignals, perBuyerSignals,
    trustedBiddingSignals, browserSignals) {
  return {
   //  ...
    bid: auctionSignals.is_above_the_fold ? perBuyerSignals.atf_value : perBuyerSignals.btf_value,
    // ...
  }
}

Teklif döndürme

generateBid(), aşağıdaki özelliklere sahip bir nesneyi döndürür: