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

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

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

Вы указываете логику генерации ставок в функции 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() возвращает объект со следующими свойствами: