Скидки в защищенной аудитории

Реализация сделок, также известных как частная торговая площадка (PMP), на аукционе защищенной аудитории.

Обзор

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

  • Идентификатор места исходит от покупателя и представляет собой идентификатор, представляющий клиента покупателя. Идентификатор места может иметь значение для выставления счетов, например, если на место предоставляется скидка у данного продавца.
  • Идентификатор сделки исходит от покупателя или продавца и представляет собой идентификатор, представляющий соглашение между покупателем и продавцом. Идентификатор сделки может иметь такие свойства, как стоимость/цена, обязательство по объему, информация об аудитории, эксклюзивность и т. д.

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

Прохождение

Для облегчения сделок на аукционе Защищенной аудитории необходимо выполнить следующие шаги:

  1. Покупатель регистрирует идентификаторы сделки и места в конфигурации группы интересов перед запуском аукциона.
    • Идентификаторы сделок и мест можно установить в поле выбираемых идентификаторов отчетов ( selectableBuyerAndSellerReportingIds ).
    • Если идентификатор места один и тот же для всех сделок, то этот идентификатор места можно установить в buyerAndSellerReportingId , а идентификаторы сделок можно установить в поле выбираемых идентификаторов отчетности ( selectableBuyerAndSellerReportingIds ).
  2. Во время формирования ставок становятся доступны идентификаторы сделки и места. Покупатель выбирает идентификатор сделки из selectableBuyerAndSellerReportingIds . Покупатель создает ставку, которая включает идентификатор сделки, связанный с этой ставкой, возвращая selectedBuyerAndSellerReportingId . Ставка может выиграть аукцион только в том случае, если возвращенный идентификатор сделки является k-анонимным наряду с другими идентификаторами отчетности и выбранными свойствами группы интересов.
  3. Во время оценки объявлений продавцу становятся доступны выбранные идентификаторы сделки и места.
  4. Идентификаторы сделки и места становятся доступными в функциях отчетности продавца.
  5. Идентификаторы сделки и места становятся доступными в функциях отчетности покупателя.

1. Регистрация идентификаторов сделок и мест

Покупатель регистрирует идентификаторы сделки и места в конфигурации группы интересов перед запуском аукциона. Идентификаторы сделки и места задаются в selectableBuyerAndSellerReportingIds как массив строк. Если идентификатор места один и тот же для всех сделок и их не нужно повторять, идентификатор места можно добавить в поле buyerAndSellerReportingId , которое принимает строку:

const interestGroupConfig = {
  owner: 'https://buyer.example',
  name: 'example-ig',
  ad: [
    {
      renderURL: 'https://buyer.example/ad.html',
      selectableBuyerAndSellerReportingIds: ['deal123', 'deal456', 'deal789'], // Deal IDs
      buyerAndSellerReportingId: 'seat123', // Seat ID

      // Though it is not used to facilitate deals, the buyer
      // reporting ID can be defined with other reporting IDs
      buyerAndReportingId: 'brid123'
    },
  ],
};

navigator.joinAdInterestGroup(interestGroupConfig);

Если идентификатор места для сделок отличается, можно использовать следующую настройку:

const interestGroupConfig = {
  owner: 'https://buyer.example',
  name: 'example-ig',
  ad: [
    {
      renderURL: 'https://buyer.example/ad.html',
      selectableBuyerAndSellerReportingIds: [
        'deal123seat123',
        'deal456seat456',
        'deal789seat456'
      ], // Deal and Seat IDs
    },
  ],
};

navigator.joinAdInterestGroup(interestGroupConfig);

2. Идентификаторы сделок и мест для покупателей во время формирования ставок.

Во время формирования ставки покупатель решает, хочет ли он делать ставку по идентификатору сделки. В generateBid() покупатель может выбрать идентификатор сделки из selectableBuyerAndSellerReportingIds и вернуть значение как selectedBuyerAndSellerReportingId . Ставка отклоняется, если идентификатор выбранной сделки отсутствует в массиве selectableBuyerAndSellerReportingIds .

function generateBid(interestGroup, ...) {
  const [{
    buyerAndSellerReportingId, // 'seat123'
    selectableBuyerAndSellerReportingIds // ['deal123', 'deal456', 'deal789']
    buyerAndReportingId // 'brid123' - Not used for deals, but the value is available
  }] = interestGroup.ads;

  // ...

  return {
    bid: 1,
    render: 'https://buyer.example/ad.html',
    selectedBuyerAndSellerReportingId: 'deal456', // Buyer selects a deal ID
  };
}

Ставка с возвращаемым значением для selectedbuyerAndSellerReportingId может выиграть аукцион только в том случае, если значение selectedbuyerAndSellerReportingId является совместно k-анонимным вместе со значением buyerAndSellerReportingId (если присутствует), buyerReportingId (если присутствует), владельцем группы интересов, URL-адресом сценария назначения ставок, URL-адресом отображения и объявлением. размер (размер объявления исключен из этой проверки как минимум до первого квартала 2025 г.).

Даже если selectablebuyerAndSellerReportingIds определен в конфигурации группы интересов, generateBid() по-прежнему может возвращать ставку, которая не включает selectedbuyerAndSellerReportingId ; в этом случае идентификаторы отчетов, предоставленные функциям отчетности, если эта ставка выиграет, будут соответствовать поведению невыбираемого идентификатора отчетов .

В тех случаях, когда generateBid() запускается повторно, поскольку первоначальный вызов не создал ни одной ставки с объявлениями, прошедшими проверку анонимности k, тогда selectableBuyerAndSellerReportingIds , которые не прошли проверку анонимности k, не будут присутствовать в группе интересов на повторный запуск.

3. Идентификаторы сделок и мест для продавцов во время оценки рекламы.

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

function scoreAd(..., browserSignals, ...) {
  const {
    buyerAndSellerReportingId, // 'seat123'
    selectedBuyerAndSellerReportingIds, // 'deal456'
  } = browserSignals;

  // ...
}

4. Идентификаторы сделок и мест для отчетов продавцов.

Напомним, что ставка может выиграть аукцион только в том случае, если selectedBuyerAndSellerReportingId , buyerAndSellerReportingId (если присутствует) и buyerReportingId (если присутствует) являются k-анонимными с владельцем группы интересов, URL-адресом сценария назначения ставок, URL-адресом отображения и размером объявления (размер объявления исключается из эту проверку как минимум до первого квартала 2025 года). Таким образом, значения идентификатора отчетности, включающие selectedBuyerAndSellerReportingId всегда будут доступны внутри reportResult() . Обратите внимание: несмотря на то, что buyerReportingId проверяется на k-анонимность, это значение доступно только для функции отчетности о покупателях, но не для функции отчетности о продавцах.

function reportResult(..., browserSignals, ...) {
  const {
    buyerAndSellerReportingId, // 'seat123'
    selectedBuyerAndSellerReportingIds // 'deal456'
  } = browserSignals;

  // ...
}

5. Идентификаторы сделок и мест для отчетов о покупателях.

Та же концепция, что и отчеты продавцов, применима и к отчетам покупателей. Напомним, что ставка может выиграть аукцион только в том случае, если selectedBuyerAndSellerReportingId , buyerAndSellerReportingId (если присутствует) и buyerReportingId (если присутствует) являются k-анонимными с владельцем группы интересов, URL-адресом сценария назначения ставок, URL-адресом отображения и размером объявления (размер объявления исключается из эту проверку как минимум до первого квартала 2025 года). Таким образом, значения идентификатора отчетности, включающие selectedBuyerAndSellerReportingId всегда будут доступны внутри reportWin() .

function reportWin(..., browserSignals, ...) {
  const {
    buyerAndSellerReportingId, // 'seat123'
    selectedBuyerAndSellerReportingId // 'deal456'
    buyerAndReportingId // 'brid123' - Not used for deals, but the value is available
  } = browserSignals;
}

Привлекайте и делитесь отзывами