Prueba de origen de FLEDGE RTB

Como parte de Privacy Sandbox, Chrome propuso FLEDGE: una API en el navegador que permite a los anunciantes y a las empresas de tecnología publicitaria mostrar anuncios segmentados por grupo de intereses sin depender de cookies de terceros y, al mismo tiempo, proteger a los usuarios del seguimiento entre sitios.

Chrome está ejecutando una prueba de origen para FLEDGE. Authorized Buyers puede participar en las pruebas de origen de FLEDGE en el inventario de publicadores de Ad Manager. Tú (los ofertantes) pueden usar la prueba de origen para hacer lo siguiente:

  • Itera y aprende sobre la eficacia de los flujos de FLEDGE.
  • Genera comentarios sobre posibles mejoras de la API en foros públicos (por ejemplo, GitHub).
  • Prepárate para admitir la publicidad personalizada a través de la API de FLEDGE sin depender de las cookies de terceros.

Los compradores de Authorized Buyers interesados en realizar pruebas deben consultar la sección de integración para obtener más detalles.

Resumen del flujo de entrega

A continuación, se incluye un resumen del flujo de publicación de anuncios de FLEDGE para los socios de Authorized Buyers:

alt_text

  1. Un ofertante trabaja con sus anunciantes para mantener grupos de interés para cada anunciante. A menudo, los anunciantes agregaban la etiqueta de un ofertante a la página del anunciante para agregar un navegador a los grupos de interés.
  2. Un usuario final visita la página de un anunciante. La página puede contener la etiqueta del ofertante.
  3. La etiqueta del ofertante invoca la API de FLEDGE joinAdInterestGroup(). Esta llamada solicita al navegador que agregue al usuario a un grupo de interés.
  4. El usuario final visita una página web del publicador. El navegador del usuario solicita la etiqueta de anuncio del publicador de Google.
  5. La etiqueta de anuncio del publicador de Google envía una solicitud de anuncio contextual a un servidor de Google.
  6. Google envía solicitudes de ofertas contextuales a los ofertantes participantes. Consulta la sección Cambios en las solicitudes de oferta para obtener más información.
  7. El ofertante muestra un BidResponse con el campo interest_group_bidding. Si el ofertante no especifica interest_group_bidding, Google no incluye su origen en interestGroupBuyers en la configuración de la subasta. La respuesta a la oferta también puede contener interest_group_bidding.per_buyer_signals. per_buyer_signals se pasará a la función de ofertas del ofertante durante la subasta en el navegador. Consulta la sección Cambios en las respuestas a ofertas para obtener más información.
  8. Google ejecuta la subasta del servidor y muestra una respuesta de oferta al navegador. La subasta del servidor considera las ofertas tradicionales del servidor. La respuesta a la oferta puede contener información sobre una oferta ganadora contextual (si existe).
  9. La respuesta a la oferta contiene una configuración de subasta para la subasta en el navegador. Esto puede incluir indicadores contextuales de cada comprador participante (que se enviaron a través de interest_group_bidding.per_buyer_signals), información contextual del ganador y configuración de elegibilidad para las ofertas.
  10. La etiqueta de publicador de Google invoca la API de FLEDGE runAdAuction() para iniciar la subasta del grupo de interés en el dispositivo. Google solo incluye a los compradores que mostraron previamente interest_group_bidding como interestGroupBuyers en la configuración de la subasta.
  11. Google pasa el per_buyer_signals de cada ofertante apto a la configuración de la subasta de FLEDGE.
  12. Si los grupos de interés de un ofertante específico especificaron la trustedBiddingSignalsUrl, el navegador realiza una solicitud al trustedBiddingSignalsUrl de cada grupo para recuperar señales en tiempo real de cada grupo. Consulta los detalles en la especificación de FLEDGE.
  13. El navegador invoca el generateBid() del ofertante para cada grupo de interés que participa y es apto para participar en la subasta integrada en el navegador. En este paso, se calcula la oferta y se selecciona una creatividad. generateBid() tiene acceso al per_buyer_signals proporcionado por el ofertante y a los indicadores de ofertas de confianza para el grupo de intereses determinado.
  14. El navegador invoca el elemento scoreAd() del vendedor (en este caso, el de Google) para asignar una clasificación a cada oferta en la subasta de anuncios del grupo de interés. Las ofertas se clasifican y filtran según las protecciones del publicador, las políticas de anuncios y otras restricciones.
  15. El navegador realiza una subasta con las ofertas aptas del grupo de interés. La oferta contextual mejor clasificada participa en la subasta en el navegador.
  16. Después de la subasta, si hay un ganador del grupo de interés, el navegador invoca al reportResult() del vendedor y al reportWin() del ofertante para notificar a cada parte sobre el ganador de la subasta en el navegador.
  17. Si el anuncio del grupo de interés gana, la etiqueta del editor de Google renderiza el anuncio en un marco cercado.

Detalles del flujo de entrega

Antes de la publicación de anuncios

Revisión de creatividades

Google debe revisar y aprobar las creatividades antes de que puedan publicarse desde las subastas en el navegador de FLEDGE. Puede enviar creatividades para su revisión a través de la API de Ofertas en tiempo real. Las creatividades que se usarán en las subastas de anuncios del grupo de interés en el navegador de FLEDGE deben subirse con sus renderUrls especificadas. Las URL de renderización especificadas deben coincidir con las URL de renderización de los anuncios almacenados como parte del grupo de interés en el navegador en el que desea ofertar en la subasta de grupos de interés en el navegador. Una URL de procesamiento se puede asociar con una sola creatividad para un ofertante determinado.

Subasta del servidor

Cambios en la solicitud de oferta

Las siguientes son versiones preliminares de protocolos compatibles para usar en el experimento:

Indicar el respaldo de la subasta del grupo de interés

Las solicitudes de oferta tienen un campo nuevo, auction_environment.

  • Protocolo de RTB de Google: BidRequest.adslot.auction_environment
  • OpenRTB: BidRequest.imp.ext.auction_environment

Puede usar este campo para diferenciar entre las oportunidades de impresión que admiten la subasta del grupo de interés en el navegador FLEDGE y las que solo admiten la subasta de intercambio del servidor tradicional. La enumeración auction_environment puede tener los siguientes valores:

  • SERVER_SIDE_AUCTION (OpenRTB JSON: 0): Subastas tradicionales del servidor.
  • ON_DEVICE_INTEREST_GROUP_AUCTION (JSON de OpenRTB: 1): Solicitudes con asistencia de FLEDGE, en las que una subasta contextual se ejecuta en los servidores del intercambio y las ofertas del grupo de intereses y la subasta final se ejecutan en el navegador.
Indicar el tamaño del espacio publicitario de FLEDGE

La solicitud de oferta incluye los siguientes campos para brindarte el tamaño del espacio publicitario de FLEDGE:

  • Protocolo de RTB de Google:
    • BidRequest.adslot.interest_group_auction.width
    • BidRequest.adslot.interest_group_auction.height
  • OpenRTB:
    • BidRequest.imp.ext.interest_group_auction.width
    • BidRequest.imp.ext.interest_group_auction.height

Estos campos indican el tamaño del espacio publicitario para la subasta de FLEDGE en píxeles.

Este tamaño puede ser diferente de los tamaños de la solicitud contextual (Adslot.width y Adslot.height, o en OpenRTB: BidRequest.imp.banner.format).

La solicitud contextual puede tener varios tamaños. Se espera que el anuncio ganador de la subasta en el dispositivo ocupe un solo tamaño de espacio fijo.

Minimiza la dependencia de los identificadores de usuario

Las solicitudes de ofertas contextuales incluidas en el alcance de la prueba de prueba de origen de FLEDGE pueden continuar con los identificadores basados en cookies tradicionales cuando están disponibles desde el navegador, como los campos google_user_id (BidRequest.user.id en OpenRTB) y hosted_match_data (BidRequest.user.buyerid en OpenRTB). La presencia de estos identificadores en las solicitudes de ofertas seguirá sujeta a las políticas de privacidad existentes. Te recomendamos que no dependas de los identificadores basados en cookies para la orientación y las ofertas durante la prueba de prueba de origen a fin de prepararte mejor para una compra eficiente cuando las cookies de terceros ya no estén disponibles.

Google también puede ejecutar experimentos a pequeña escala en los que los identificadores basados en cookies se oculten de las solicitudes de oferta dentro del alcance de la prueba de origen de FLEDGE. El objetivo es evaluar el impacto potencial de la baja de las cookies de terceros.

Cambios en la respuesta a la oferta

Indicar la participación en la subasta del grupo de interés

Eres responsable de indicar explícitamente tu intención de participar en la subasta en el navegador. Para ello, debes mostrar el objeto InterestGroupBidding en la respuesta a la oferta contextual:

  • Protocolo de RTB de Google: BidResponse.interest_group_bidding.
  • OpenRTB: BidResponse.ext.igbid.

Debe proporcionar una respuesta a la oferta contextual. No se requiere que la respuesta incluya una oferta contextual. El objeto InterestGroupBidding debe contener el origin del propietario del grupo de interés, que debe coincidir con uno de los orígenes configurados por el ofertante para su cuenta. El origin se agrega al interestGroupBuyers de la configuración de subasta cuando Google Publisher Tag llama a runAdAuction().

Propagar indicadores contextuales del comprador (porBuyerSignals)

Puedes incluir indicadores del comprador en la respuesta a la oferta contextual, que Google propagará como un objeto JSON a su función de ofertas en el dispositivo a través del argumento perBuyerSignals. Esto se puede incluir en la respuesta a la oferta con los siguientes campos según el protocolo:

  • RTB de Google: BidResponse.interest_group_bidding.per_buyer_signals
  • OpenRTB: BidResponse.ext.igbid.igbuyer.buyerdata
Especificar el precio de oferta máximo en el navegador

En la propuesta FLEDGE, se espera que el cálculo de la oferta y la subasta final se ejecuten de forma local en el dispositivo. Esto puede crear vectores de abuso potenciales que puedan afectar la integridad de los resultados finales de la subasta, como el precio de oferta ganador.

Como mitigación admitida durante la prueba de origen de FLEDGE por parte de Google para sus socios de RTB, puede especificar un valor de oferta máxima esperado en cada respuesta de oferta contextual. La oferta máxima esperada es el precio de oferta máximo que se espera que muestre la función de ofertas. Si la oferta ganadora informada de la subasta en el navegador supera este importe, la oferta ganadora no se cuenta como un evento facturable. Este enfoque está sujeto a cambios en respuesta a los comentarios de la prueba de origen.

En la respuesta a la oferta, puedes especificar el valor de oferta máximo esperado en los siguientes campos:

  • Protocolo de RTB de Google: BidResponse.interest_group_bidding.interest_group_buyers.max_bid_cpm_micros (expresado en microCPM).
  • OpenRTB: BidResponse.igbid.igbuyer.maxbid(expresado en unidades de moneda de CPM)

Durante la subasta en el navegador

Generar ofertas en el navegador

Utilice las generateBid() para generar ofertas en el navegador.

Google proporciona los siguientes parámetros:

  • auctionSignals: vacío.
  • perBuyerSignals: Es un objeto de JavaScript de los mismos indicadores que proporciona el ofertante en la respuesta contextual.

Se muestran los siguientes parámetros:

  • ad: Google ignora este campo.
  • bid: Es una oferta numérica que ingresa en la subasta. Debe estar en unidades de CPM en USD (no en micros).
  • render: Es la URL renderizada para mostrar la creatividad si la oferta gana la subasta. Google debe revisar y aprobar esta URL; de lo contrario, se la filtrará de la subasta.
  • allowComponentAuction: Debe ser true. Actualmente, Google admite pruebas de subastas de varios vendedores.

Por ejemplo:

function generateBid(...) {
  ...
  return {'ad': 'example',
          'bid': ad.metadata.bid,
          'render': ad.renderUrl,
          'allowComponentAuction': true};
}

Consulta la sección Ofertas en el dispositivo de la especificación de FLEDGE para obtener una explicación de la función generateBid().

Compatibilidad con monedas

Google solo admite ofertas enviadas en unidades de CPM en dólares estadounidenses en subastas de FLEDGE. La compatibilidad con más monedas de oferta podría estar disponible más adelante.

Verificaciones de calidad de anuncios

La aplicación de los controles del publicador y la política de creatividades puede ser más restrictiva para las ofertas del grupo de interés en el navegador durante las pruebas de origen de FLEDGE para los socios de RTB.

Filtro de ofertas

Google aplica controles de publicadores y políticas de anuncios durante la subasta en el dispositivo.

Después de la subasta en el navegador

Informe el resultado de la subasta al comprador: reportWin()

Google no propaga los siguientes argumentos:

Usa reportWin() para denunciar el resultado de la subasta al comprador.

  • auctionSignals
  • sellerSignals

Consulta la sección Informes de compradores sobre los eventos de anuncios y renderización de la explicación de FLEDGE para obtener más información. Google no propaga los siguientes argumentos:

Recuento de impresiones

Durante la prueba de origen de FLEDGE con socios de RTB, Google registrará impresiones cuando el navegador llame a su función reportResult() y, posteriormente, obtenga la URL de informes de Google en una llamada a sendReportTo().

Dado que el evento que utiliza Google para registrar impresiones en las subastas en el navegador de FLEDGE puede ser diferente del evento que usan los socios compradores de RTB, el recuento de impresiones puede variar.

Uno de los objetivos de Google para probar FLEDGE en las pruebas originales es identificar y reducir estas discrepancias.

Atribución de las impresiones facturables

Toda la inversión de un ofertante de las subastas integradas en el navegador de FLEDGE se atribuye a una sola cuenta del ofertante según la asignación de los orígenes del propietario del grupo de interés configurada para el ofertante. No se admite la atribución de gastos a diferentes cuentas de licencias secundarias de un ofertante.

Límite del presupuesto diario

Durante las pruebas de prueba de origen de FLEDGE, cada cuenta tiene un límite de presupuesto diario de FLEDGE a nivel de la cuenta. El límite de presupuesto diario limita el riesgo en el entorno de subastas en el navegador. Una vez que se alcanza el límite de presupuesto diario, la cuenta ya no recibe solicitudes de ofertas aptas para FLEDGE. La cuenta puede seguir participando en las subastas contextuales del servidor después de alcanzar el límite de FLEDGE. Por ejemplo, una cuenta de ofertante que alcanza el límite de FLEDGE puede recibir una solicitud de oferta con auction_environment = SERVER_SIDE_AUCTION (OpenRTB: 0), incluso si la solicitud de oferta es apta para una subasta de FLEDGE.

Notificación de oferta mínima para ganar

Como mecanismo temporal, Google proporciona una notificación dedicada de servidor a servidor a fin de comunicar la oferta mínima para ganar valores de las subastas FLEDGE del dispositivo. Este mecanismo de publicación está sujeto a cambios. Los ofertantes pueden comunicarse con su administrador de cuentas a fin de establecer una URL estática que se usará para entregar la oferta mínima para ganar notificaciones. Si un ofertante responde a una solicitud de oferta contextual con el campo interest_group_bidding especificado, se llama a la URL estática después de que finaliza la subasta FLEDGE en el dispositivo. La URL estática admite las siguientes macros:

  • %%GOOGLE_QUERY_ID%%: Esta macro se reemplaza por el ID de la consulta de Google (BidRequest.google_query_id en el protocolo Authorized Buyer y BidRequest.ext.google_query_id en el protocolo OpenRTB) que se envió en la solicitud de oferta contextual para una oportunidad habilitada para FLEDGE.
  • %%TD_AUCTION_MIN_TO_WIN%%: Esta macro se reemplaza por la oferta mínima para ganar el valor de la subasta FLEDGE en el dispositivo. Las unidades están en CPM de la moneda de la cuenta del ofertante.
    • Tenga en cuenta que, actualmente, la oferta mínima para ganar valores en la subasta de FLEDGE del dispositivo no tiene en cuenta las ofertas perdedoras de FLEDGE. Esto significa que si una oferta gana la subasta en el dispositivo, su oferta mínima para ganar será la máxima de la oferta contextual más alta y cualquier mínimo de subasta aplicable.

En el caso de las ofertas enviadas con una respuesta de oferta contextual, la oferta mínima para ganar la subasta del servidor seguirá proporcionándose mediante el mecanismo de comentarios en tiempo real; este valor actualmente no tiene en cuenta ninguna oferta de FLEDGE.

Nivel de producto TURTLEDOVE

Los anuncios compuestos por varias piezas o TURTLEDOVE a nivel del producto (PLTD) son compatibles con los socios de RTB de Google durante la prueba de prueba de origen de FLEDGE. Infórmale al administrador de cuentas durante la integración si planeas probar la PLTD, ya que se requieren recursos y configuración adicionales.

Integración

Para unirse a la prueba de origen de FLEDGE RTB, siga estos pasos:

Pasos

  1. Completa el formulario de solicitud para unirte al experimento de FLEDGE.
  2. Después de enviar el formulario de solicitud, comunícate con tu administrador de cuentas o envía un ticket a través del Centro de ayuda de Authorized Buyers.
  3. Google creará una cuenta exclusiva para probar la prueba de origen de FLEDGE. Esto simplificará las pruebas, ya que aislará los problemas potenciales en una cuenta separada.
  4. Una vez configurada la cuenta, Google y el socio pueden verificar la integración mediante los pasos que se indican en Etapas de prueba.

Lista de verificación de integración

  • Configura un extremo de solicitud de oferta que propagará los campos relacionados con FLEDGE en la respuesta de la oferta contextual (por ejemplo, interest_group_bidding).
  • Implementa el etiquetado en las páginas del anunciante para unir el navegador del usuario con el grupo de interés.
  • Implementa generateBid() y reportWin().
  • Selecciona los orígenes del propietario del grupo de interés y agrégalos a la cuenta de Authorized Buyers.
    • Los orígenes del propietario del grupo de interés deben coincidir con los orígenes en los que se alojan las funciones generateBid().
    • Comunícate con el administrador de cuentas o envía un ticket a través del Centro de ayuda de Authorized Buyers para completar este paso.
  • Configure la orientación previa para el inventario relevante para las pruebas de FLEDGE.
  • Envíe las creatividades para su revisión y aprobación a través de la API de Creative.
  • (Opcional) Configure los extremos de los indicadores de ofertas de confianza.
  • (Opcional) Configura una página del anunciante de prueba que permita a los ingenieros de Google agregar su navegador a los grupos de interés que pertenecen al origen del comprador del grupo de interés. Esto nos permite activar manualmente las subastas de FLEDGE.
  • (Opcional) Comunícate con tu administrador de cuentas para configurar una URL estática a fin de recibir una notificación de servidor a servidor que contenga la oferta mínima para ganar valor de las subastas FLEDGE del dispositivo. Consulte la oferta mínima para ganar notificaciones si desea conocer los detalles.

Etapas de prueba

Etapa 1: Prueba manual

A continuación, le indicamos cómo activar manualmente una subasta de FLEDGE, asegurarse de que el anuncio se pueda renderizar y registrar la impresión:

  1. Usa Chrome 101 o una versión posterior.
  2. Habilita la API de Privacy Sandbox y el marco cercado mediante chrome://flags/#privacy-sandbox-ads-apis y chrome://flags/#enable-fenced-frames. Obtén más información en Prueba la zona de pruebas de privacidad.
  3. Envíe una creatividad para su aprobación mediante la API de Ofertas en tiempo real.
  4. Utilice la página del anunciante proporcionada por el ofertante para agregar un navegador al grupo de interés que es propiedad del ofertante.
  5. Usa la siguiente página del publicador de prueba proporcionada por Google para activar una subasta de FLEDGE:

    https://fledge-testing.uc.r.appspot.com/?nid=allow_all

    El grupo de interés en el navegador debe ofertar lo suficiente como para ganar la subasta, ya que podría competir contra las ofertas convencionales del servidor. Google también proporciona una página de publicador de prueba dedicada para cada socio, en la que solo el socio determinado puede participar en la subasta. Puede ser más fácil ganar subastas en el navegador de manera confiable en una página específica del socio.

  6. Verifica lo siguiente:

    1. Se renderiza el anuncio ganador esperado.
    2. El resultado de la subasta se envía al servidor (lo que significa que un ofertante ganador recibe un ping desde reportWin()).
    3. La consola del editor de pruebas registra un mensaje de depuración para cada oferta con la siguiente información:
      • renderUrl: Es la URL de renderización de la oferta.
      • interestGroupOwner: Es el propietario del grupo de interés de la oferta.
      • accepted: Este campo es verdadero si se aceptó la oferta y falso si scoreAd() rechazó la oferta.
      • externalBidStatus: Es un código de estado si la oferta se rechazó en scoreAd(). Los valores son códigos de estado de creatividades.

Etapa 2: Experimento sin procesamiento

Después de que Google y el socio verifiquen de forma manual que el socio puede participar en la subasta de FLEDGE, Google lo habilita para la siguiente etapa de pruebas. Google asigna una pequeña cantidad de tráfico en vivo para ejecutar subastas de FLEDGE. Luego, Google y el socio ya no necesitan activar manualmente una subasta de FLEDGE. El resultado de la subasta de FLEDGE no se procesa. Esto nos permite probar la integración a gran escala.

Comunícate con tu administrador de cuentas o envía un ticket a través del Centro de ayuda de Authorized Buyers cuando estés listo. Google habilitará la cuenta de prueba para esta etapa.

Etapa 3: Experimento de procesamiento

Una vez que Google y el socio verifiquen las subastas de FLEDGE a gran escala sin renderizarlas, podrán habilitar el anuncio ganador de FLEDGE. Google tiene una pequeña cantidad de tráfico en el que las subastas de FLEDGE son aptas para publicarse y se renderizan los anuncios ganadores del grupo de interés. Las ofertas participantes del navegador de los ofertantes participantes compiten con las ofertas tradicionales.

Comunícate con tu administrador de cuentas o envía un ticket a través del Centro de ayuda de Authorized Buyers cuando estés listo. Google habilitará la cuenta de prueba para esta etapa.