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

Bir reklam alıcı (DSP'ler ve reklamverenler) olarak, reklamveren sitesinde tanımladığınız ilgi alanı grubunu hedeflemek için yayıncı sitesinde bir Protected Audience reklam açık artırmasına katılmak isteyebilirsiniz. Protected Audience açık artırmasına katılarak, tanımladığınız müşterilerinize gizliliği korumaya yönelik bir şekilde diğer sitelerde ulaşabilirsiniz.

Protected Audience açık artırmasında teklifi oluşturmak için mantığı siz sağlarsınız ve tarayıcı bu mantığı kullanarak teklifi hesaplar. Bu, teklifi doğrudan gönderdiğiniz ve mantığı sağlamadığınız diğer açık artırma mimarilerinden farklıdır.

Teklif oluşturma mantığınızı generateBid() JavaScript işlevinde sağlarsınız ve dosya sunucunuzda barındırılır. Bir kullanıcıyı ilgi grubuna eklediğinizde bu dosyanın konumu, ilgi 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 generateBid() işlevinizi, dış bağlamla iletişimi sınırlı olan güvenli ve yalıtılmış bir ortamda her ilgi alanı grubu için yürütür. generateBid() yürütüldüğünde tarayıcı, işlevdeki sinyalleri bağımsız değişken olarak iletir. Bu sinyaller, yayıncının birinci taraf verileri, satıcının verileri ve gerçek zamanlı veriler gibi farklı kaynaklardan çeşitli bilgiler 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 tercih edilebilirlik 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() aşağıdaki 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

Bir teklif değerini hesaplamak için generateBid() içindeki kod, işlevin 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 nesne döndürür: