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

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

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

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

Во время аукциона браузер извлекает вашу логику ставок, указанную в поле biddingLogicUrl , и выполняет generateBid() для каждой группы интересов в безопасной изолированной среде, которая ограничена в общении с внешним контекстом. При выполнении 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() возвращает объект со следующими свойствами: