Сделайте ставку на аукционе, чтобы купить рекламное место

Как покупатель рекламы (DSP и рекламодатели), вы можете быть заинтересованы в участии в аукционе рекламы Protected Audience на сайте издателя, чтобы нацелить рекламу на группу интересов, которую вы определили на сайте рекламодателя. Участвуя в аукционе Protected Audience, вы можете охватить своих идентифицированных клиентов на других сайтах, сохраняя конфиденциальность.

В аукционе Protected Audience вы предоставляете логику для генерации ставки, а браузер вычисляет ставку, используя эту логику. Это отличается от других архитектур аукциона, где вы отправляете ставку напрямую, а не предоставляете логику.

Вы предоставляете свою логику генерации ставок в функции JavaScript generateBid() , и файл размещается на вашем сервере. Когда вы добавляете пользователя в группу интересов , местоположение этого файла передается в конфигурацию группы интересов как biddingLogicUrl .

Во время аукциона браузер извлекает вашу логику ставок, указанную в поле biddingLogicUrl , и выполняет вашу функцию generateBid() для каждой группы интересов в безопасной изолированной среде, которая ограничена в своей коммуникации с внешним контекстом. Когда выполняется generateBid() , браузер передает сигналы в функцию в качестве аргументов. Эти сигналы содержат различную информацию из разных источников, например, данные первой стороны издателя, данные продавца, данные в реальном времени и многое другое. Вы можете использовать эти сигналы для расчета ставки, а значение возвращается из вызова generateBid() . После отправки ставок браузер выполнит логику оценки продавца для каждой ставки, чтобы вычислить оценку желательности продавца.

generateBid()

Ниже описаны аргументы функции generateBid() и структура ставки, возвращаемой функцией:

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)
  };
}

Аргументы

generateBid() принимает следующие аргументы:

Сигналы браузера

Объект browserSignals имеет следующие свойства:

{
  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
}

Рассчитать ставку

Для расчета значения ставки код в generateBid() может использовать свойства параметров функции.

Например:

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

Вернуть ставку

generateBid() возвращает объект со следующими свойствами: