Acuerdos en Protected Audience

Implementación de acuerdos, también conocido 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 precio preferido a los compradores en un subconjunto de inventario. Para facilitar las transacciones programáticas, se usan IDs de asiento y IDs de transacción:

  • El ID de licencia se origina en el comprador y es un identificador que representa a su cliente. Un ID de licencia puede tener implicaciones en la facturación, por ejemplo, si una licencia tiene un descuento con un vendedor determinado.
  • El 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 usando IDs de informes que permiten que los IDs de licencias 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 asientos en los informes de Protected Audience posteriores a la subasta para realizar transacciones y organizar los esfuerzos de facturación. Esperamos que los compradores, vendedores, agencias y anunciantes tengan estrategias personalizadas para interpretar y comprender el acuerdo y los IDs de los asientos que reciben.

Explicación

Los pasos para facilitar los acuerdos en una subasta de Protected Audience son los siguientes:

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

1. Registro de IDs de licencias y acuerdos

El comprador registra los IDs de acuerdo y licencia 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 licencia es el mismo para todos los acuerdos y no es necesario que se repita, este ID 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
      buyerAndReportingId: 'brid123'
    },
  ],
};

navigator.joinAdInterestGroup(interestGroupConfig);

Si el ID de licencia 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 licencias para compradores durante la generación de ofertas

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

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

  // ...

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

Una oferta con un valor mostrado para selectedbuyerAndSellerReportingId solo puede ganar la subasta si el valor de selectedbuyerAndSellerReportingId es en conjunto k-anónimo junto con buyerAndSellerReportingId (si está presente), buyerReportingId (si está presente) el propietario del grupo de interés, la URL de la secuencia de comandos de licitación, la URL de renderización y el tamaño del anuncio (el tamaño del anuncio se excluye de esta verificación al menos hasta el 1er trim. de 2025).

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

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

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

scoreAd() puede acceder al ID del acuerdo seleccionado, junto con un ID de la licencia, si está presente. El vendedor proporciona la puntuación de deseabilidad de la oferta ganadora teniendo en cuenta el ID del acuerdo y cualquier término especial. Si el vendedor no cree que se aplique el ID de acuerdo que eligió el comprador, rechazará la oferta y le asignará una puntuación de deseabilidad cero o negativa.

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

  // ...
}

4. IDs de acuerdos y licencias para los informes de vendedores

Recuerda que una oferta solo puede ganar la subasta si selectedBuyerAndSellerReportingId, buyerAndSellerReportingId (si está presente) y buyerReportingId (si está presente) son k-anónimas con el propietario del grupo de interés, la URL de la secuencia de comandos de licitación, la URL de renderización y el tamaño del anuncio (el tamaño del anuncio se excluye de esta verificación al menos hasta 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 marcó buyerReportingId para el k-anonimato, el valor solo está disponible para la función de informes del comprador y no para la función de informe del vendedor aquí.

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

  // ...
}

5. IDs de acuerdos y licencias 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ónimas con el propietario del grupo de interés, la URL de la secuencia de comandos de licitación, la URL de renderización y el tamaño del anuncio (el tamaño del anuncio se excluye de esta verificación al menos hasta 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'
    buyerAndReportingId // 'brid123' - Not used for deals, but the value is available
  } = browserSignals;
}

Interactúa y comparte tus comentarios