Acuerdos en Protected Audience

Implementa acuerdos, también conocidos como mercado privado (PMP), en una subasta de Protected Audience

Descripción general

Los acuerdos, también conocidos como mercado privado (PMP), ofrecen acceso seleccionado o precios preferenciales para los compradores en un subconjunto de inventario. Para facilitar las transacciones programáticas, se usan IDs de asiento y IDs de transacción:

  • Un ID de asiento se origina en el comprador y es un identificador que representa al cliente del comprador. Un ID de asiento puede tener implicaciones de facturación, por ejemplo, si un asiento tiene un descuento con un vendedor determinado.
  • Un ID del acuerdo se origina en el comprador o el vendedor, y es un identificador que representa un acuerdo entre un comprador y un vendedor. Un ID de acuerdo puede tener propiedades como un costo o precio, un compromiso de volumen, información del público, exclusividad y mucho más.

Protected Audience facilita los acuerdos mediante el uso de IDs de informes, lo que permite que los IDs de asientos y acuerdos estén disponibles para las ofertas, la puntuación y los informes de las subastas. Los IDs de informes proporcionan un mecanismo para que las empresas de tecnología publicitaria reciban estos IDs de acuerdos y cuentas de comprador en los informes posteriores a la subasta de Protected Audience para realizar transacciones de acuerdos y organizar las iniciativas de facturación. Esperamos que los compradores, vendedores, agencias y anunciantes tengan estrategias personalizadas para interpretar y comprender los IDs de acuerdos y posiciones que reciben.

Explicación

A continuación, se indican los pasos para facilitar acuerdos en una subasta de Protected Audience:

  1. El comprador registra los IDs de asiento y acuerdo en la configuración del grupo de interés antes de que se ejecute la subasta.
    • Los IDs de la oferta y del asiento se pueden establecer en el campo IDs de informes seleccionables (selectableBuyerAndSellerReportingIds).
    • Si el ID de posición es el mismo para todas las ofertas, se puede establecer en buyerAndSellerReportingId, y los IDs de ofertas se pueden establecer en el campo de IDs de informes seleccionables (selectableBuyerAndSellerReportingIds).
  2. Durante la generación de ofertas, los IDs del acuerdo y del comprador estarán disponibles. El comprador selecciona un ID de acuerdo en selectableBuyerAndSellerReportingIds. El comprador genera una oferta que incluye un ID del acuerdo asociado a esa oferta devolviendo un selectedBuyerAndSellerReportingId. Una oferta solo puede ganar la subasta si el ID de acuerdo que se devolvió es k-anónimo junto con otros IDs de informes y propiedades seleccionadas del grupo de interés.
  3. Durante la puntuación de anuncios, los IDs de asiento y acuerdo seleccionados quedan disponibles para el vendedor.
  4. Los IDs de asiento y de acuerdo estarán disponibles en las funciones de informes del vendedor.
  5. Los IDs de asiento y de acuerdo estarán disponibles en las funciones de informes del comprador.

1. Registro de IDs de asientos y acuerdos

El comprador registra los IDs de asiento y de acuerdo en la configuración del grupo de interés antes de que se ejecute la subasta. Los IDs de la oferta y del asiento se establecen en selectableBuyerAndSellerReportingIds como un array de cadenas. Si el ID de asiento es el mismo para todas las ofertas y no es necesario repetirlo, se puede agregar en el campo buyerAndSellerReportingId, que acepta una cadena:

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
      buyerReportingId: 'brid123'
    },
  ],
};

navigator.joinAdInterestGroup(interestGroupConfig);

Si el ID de asiento es diferente para los acuerdos, se puede usar la siguiente configuración:

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. IDs de acuerdos y de compradores durante la generación de ofertas

Durante la generación de ofertas, el comprador decide si quiere ofertar por un ID de acuerdo. En generateBid(), el comprador puede seleccionar un ID de acuerdo de selectableBuyerAndSellerReportingIds y devolver el valor como selectedBuyerAndSellerReportingId. Se rechaza la oferta si el ID de acuerdo seleccionado no está en el array selectableBuyerAndSellerReportingIds.

function generateBid(interestGroup, ...) {
  const [{
    buyerAndSellerReportingId, // 'seat123'
    selectableBuyerAndSellerReportingIds // ['deal123', 'deal456', 'deal789']
    buyerReportingId // '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
  };
}

Una oferta con un valor devuelto para selectedbuyerAndSellerReportingId solo puede ganar la subasta si el valor de selectedbuyerAndSellerReportingId es k-anónimo de forma conjunta con buyerAndSellerReportingId (si está presente), buyerReportingId (si está presente), el propietario del grupo de interés, la URL de la secuencia de comandos de ofertas, la URL de renderización y el tamaño del anuncio (el tamaño del anuncio se excluye de esta verificación hasta, al menos, el primer trimestre de 2025).

Incluso si selectablebuyerAndSellerReportingIds se define en la configuración del grupo de interés, sigue siendo válido que generateBid() devuelva una oferta que no incluya un selectedbuyerAndSellerReportingId. En este caso, los IDs de informes proporcionados a las funciones de informes si gana esta oferta seguirán el comportamiento de ID de informes no seleccionable.

En los casos en los que se vuelve a ejecutar generateBid() porque la invocación inicial no produjo ninguna oferta con anuncios que pasaron las verificaciones de k-anonimato, los selectableBuyerAndSellerReportingIds que no pasen la verificación de k-anonimato no estarán presentes en el grupo de interés en la nueva ejecución.

3. IDs de acuerdos y de compradores para los vendedores durante la puntuación de anuncios

El ID del acuerdo seleccionado, junto con un ID de asiento si está presente, son accesibles para scoreAd(). El vendedor proporciona la puntuación de conveniencia de la oferta ganadora teniendo en cuenta el ID del acuerdo y las condiciones especiales. Si el vendedor no cree que se aplique el ID del acuerdo elegido por el comprador, rechaza la oferta asignándole una puntuación de conveniencia negativa o cero.

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

  // ...
}

4. ID de acuerdos y de compradores para los informes de los vendedores

Recuerda que una oferta solo puede ganar la subasta si selectedBuyerAndSellerReportingId, buyerAndSellerReportingId (si está presente) y buyerReportingId (si está presente) son k-anónimos con el propietario del grupo de interés, la URL de la secuencia de comandos de ofertas, la URL de renderización y el tamaño del anuncio (el tamaño del anuncio se excluye de esta verificación hasta, al menos, el primer trimestre de 2025). Por lo tanto, los valores de ID de informes que incluyen un selectedBuyerAndSellerReportingId siempre estarán disponibles dentro de reportResult(). Ten en cuenta que, aunque se verifica la k-anonimización de buyerReportingId, el valor solo está disponible para la función de informes del comprador, y no para la función de informes del vendedor en este caso.

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

  // ...
}

5. IDs de acuerdos y de compradores para los informes de compradores

El mismo concepto de los informes de vendedores se aplica a los informes de compradores. Recuerda que una oferta solo puede ganar la subasta si selectedBuyerAndSellerReportingId, buyerAndSellerReportingId (si está presente) y buyerReportingId (si está presente) son k-anónimos con el propietario del grupo de interés, la URL de la secuencia de comandos de ofertas, la URL de renderización y el tamaño del anuncio (el tamaño del anuncio se excluye de esta verificación hasta, al menos, el primer trimestre de 2025). Por lo tanto, los valores de ID de informes que incluyen un selectedBuyerAndSellerReportingId siempre estarán disponibles dentro de reportWin().

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

Interactúa y comparte comentarios