Descripción general de la API de Protected Audience

Subastas de anuncios integradas en el dispositivo para publicar anuncios de remarketing y públicos personalizados, sin seguimiento de terceros en varios sitios.

¿A quién está dirigido este artículo?

En este artículo, se abordan los conceptos básicos de la API de Protected Audience y se explican algunos conceptos pero no entra en muchos detalles técnicos.

Consulta el glosario para conocer los términos usados en Documentación de Protected Audience. Al final de este artículo, obtendrás información sobre cómo participar y compartir comentarios.

¿Qué es la API de Protected Audience?

La API de Protected Audience es una Privacy Sandbox para publicar casos de uso de remarketing y públicos personalizados, diseñados para terceros no pueden realizar un seguimiento del comportamiento de navegación del usuario en sitios.

La API de Protected Audience permite que el navegador elija las subastas integradas en el dispositivo para elegir anuncios relevantes sitios web que el usuario visitó anteriormente.

La API de Protected Audience es el primer experimento que se implementa en Chromium dentro del TURTLEDOVE. El la diferencia entre Protected Audience y TURTLEDOVE corresponden principalmente a la separación de la función en el dispositivo del comprador y el vendedor de anuncios En las siguientes secciones, se explica cómo funciona la API de Protected Audience.

API de Protected Audience en un minuto

Para obtener una descripción general más detallada de la API de Protected Audience, lee el Guía para desarrolladores de la API de Protected Audience

Una descripción general de cada etapa del ciclo de vida de la API de Protected Audience .
El ciclo de vida de la API de Protected Audience.

La API de Protected Audience usa grupos de interés para permitir que los sitios mostrar anuncios relevantes para sus usuarios.

Por ejemplo, cuando un usuario visita un sitio que quiere anunciar sus productos el propietario de un grupo de interés (como el plataforma orientada a la demanda (DSP)) puede pedirle al navegador del usuario que agregue membresías para el grupo de interés. Si la solicitud se realiza correctamente, el navegador registrará lo siguiente:

  • El nombre del grupo de interés, por ejemplo, "bicicletas personalizadas".
  • El propietario del grupo de interés, por ejemplo, "https://dsp.example".
  • La información de configuración del grupo de interés que permite que el navegador acceda a código de oferta, código de anuncio y datos en tiempo real, si se invita al propietario del grupo a realiza una oferta en una subasta de anuncios.

Luego, cuando el usuario visita un sitio que tiene espacio publicitario disponible, el vendedor (un proveedor orientado a la venta (SSP), o el sitio sí mismo) pueden usar Protected Audience para ejecutar una subasta de anuncios y seleccionar los anuncios más adecuados para mostrar al usuario. El vendedor llama al navigator.runAdAuction() , que proporciona una lista de propietarios de grupos de interés invitados a ofertar.

Solo los grupos de intereses a los que pertenece el navegador y cuyos propietarios fueron invitados a ofertar pueden proporcionar ofertas.

El código de oferta se recupera de una URL proporcionada en el nombre del grupo de interés. configuración. Este código proporciona datos sobre el grupo de interés y información del vendedor, junto con datos contextuales sobre la y desde el navegador.

Cada grupo de interés que presenta una oferta se conoce como comprador.

Cuando el navegador llama a la función para ejecutar la subasta de anuncios, el código de cada comprador genera una oferta con la ayuda de datos en tiempo real proporcionados por su Servicio de par clave-valor de Protected Audience. Luego, el vendedor recibe estas ofertas, así como los datos en tiempo real del vendedor, y la puntuación de cada la oferta. La oferta con la puntuación más alta gana la subasta.

El anuncio ganador se muestra en una marco vallado. La URL de la creatividad del anuncio se especifica en la oferta, y el origen debe coincidir con uno de la lista proporcionada por la configuración del grupo de interés.

El vendedor puede informar el resultado de la subasta (reportResult()), y los compradores pueden informar sus logros (reportWin()).

Obtén más información sobre los informes de subasta de Protected Audience.

¿Por qué necesitamos la API de Protected Audience?

Comprender los intereses de los usuarios puede permitir anuncios más relevantes que solo elegir anuncios basados en el contenido del sitio (orientación contextual) o mediante el uso de información proporcionados por un usuario al sitio en el que aparece el anuncio (segmentación de datos de origen).

Tradicionalmente, las plataformas de anuncios aprendían sobre los intereses de los usuarios al hacer un seguimiento de sus el comportamiento de los usuarios en los sitios. Los navegadores necesitan una forma de habilitar las plataformas de anuncios para seleccionar anuncios relevantes, de modo que los editores de contenido obtengan ingresos por anuncios sin tener que el seguimiento de conversiones.

El objetivo de la API de Protected Audience es acercar la plataforma web a un estado en el que el navegador del usuario en su dispositivo (no el anunciante ni las plataformas de tecnología publicitaria) información sobre lo que le interesa a esa persona.

¿Cómo puedo probar la API de Protected Audience?

  • En la guía para desarrolladores de la API de Protected Audience, se describe cómo usar la API y cómo realizar pruebas locales.

  • protected-audience-demo.web.app proporciona una explicación de una implementación básica de Protected Audience para el anunciante y el publicador . En el video de demostración de Protected Audience, se explica cómo funciona este código y se muestra una vista previa a usar las Herramientas para desarrolladores de Chrome para la depuración.

¿Qué configuración del navegador está disponible?

Los usuarios pueden ajustar su participación en las pruebas de Privacy Sandbox en Chrome de la siguiente manera: habilitar o inhabilitar la configuración de nivel superior en chrome://settings/adPrivacy Durante las pruebas iniciales, los usuarios pueden inhabilitar la API de Protected Audience con el Configuración de Privacy Sandbox.

Chrome planea permitir que los usuarios vean y administren la lista de grupos de interés en todos los sitios que visitaron. Al igual que con la política de Tecnologías de zonas de pruebas, la configuración del usuario puede evolucionar con los comentarios de los usuarios, reguladores y otros.

Actualizaremos los parámetros de configuración disponibles en Chrome a medida que progrese la API de Protected Audience, basados en pruebas y comentarios. En el futuro, ofreceremos parámetros de configuración más detallados para administrar Protected Audience y en los datos asociados.

Los llamadores de API no pueden acceder a la membresía de grupo cuando los usuarios navegan en modo Incógnito y se quita la membresía cuando los usuarios borran los datos del sitio.

¿Puedo inhabilitar la API de Protected Audience?

Obtén información para bloquear el acceso a la API de Protected Audience, como propietario del sitio o como usuario individual.

Conceptos clave

¿Deseas obtener más información sobre la terminología de Protected Audience? Consulta las Glosario de Privacy Sandbox.

¿Qué es un grupo de interés?

Un grupo de interés de la API de Protected Audience representa a un grupo de personas con un interés en común, que corresponden a una lista de remarketing.

Cada grupo de interés de la API de Protected Audience tiene un propietario. Los distintos tipos de propietarios crearán diferentes tipos de grupos de interés con distintos casos de uso.

El propietario solicita al navegador del usuario que agregue la membresía de su grupo de interés. Para ello, debe hacer lo siguiente: llamando a la función de JavaScript navigator.joinAdInterestGroup(), lo que proporciona Información, como datos sobre anuncios relevantes para el grupo de interés y una URL para el código JavaScript que se usa en las ofertas. Los datos de los grupos de interés (como los anuncios) pueden se actualice y se podrá habilitar un grupo de interés por hasta 30 días.

Tipos de grupos de interés

En la siguiente tabla, se proporcionan ejemplos de diferentes tipos de grupos de interés y propietarios de la API de Protected Audience.

Propietario Ejemplo Interés Ejemplo Casos de uso
Advertiser Fabricante de bicicletas Productos Personas que vieron páginas de productos para una categoría específica de bicicletas. Remarketing para personas que interactuaron con la marca en el pasado.
Editor Sitio web de noticias Contenido Personas que leen sobre ciclismo. Los publicadores pueden usar datos de origen para permitir para comprar anuncios relevantes para los lectores en su sitio. R el grupo de interés de un publicador podría permitir que hagan lo mismo cuando esas personas navegan por otros sitios. Los publicadores pueden hacer lo siguiente: cobran por la capacidad de mostrar anuncios en segmentos específicos de su público.
Tecnología de anuncios DSP Categoría de productos Personas que mostraron interés en equipos de ciclismo. Una empresa de tecnología publicitaria podría crear y administrar un grupo de interés de personas que creen que están interesadas en comprar alguna categoría de artículo. Este grupo de interés podría usarse para anunciar productos en sitios que venden cosas en esa categoría (y que trabajan para la empresa de tecnología publicitaria).

Chrome permite hasta 1,000 grupos de interés por propietario y hasta 1,000 grupos de interés. propietarios. Estos límites están diseñados como barandillas protectoras, por lo que no deben alcanzarse en el funcionamiento normal.

¿Qué es un comprador?

En la API de Protected Audience, un comprador es una parte que posee un grupo de interés y oferta en una subasta de anuncios.

Por ejemplo:

Los compradores tienen tres trabajos:

  • Elige si quieres participar en una subasta.
  • Elige los anuncios y calcula una oferta.
  • Informa el resultado de la subasta.

Estos trabajos se realizan de manera programática, en el código que proporciona el comprador que se ejecuta. durante una subasta de anuncios de la API de Protected Audience.

Cuando un comprador solicita al navegador de un usuario que agregue un grupo de interés a los grupos de los que es miembro (llama al función de JavaScript navigator.joinAdInterestGroup()) el comprador proporciona al navegador lo siguiente:

  • Es una URL para el código de oferta, que se usará cuando el vendedor ejecute una subasta de anuncios.
  • Posiblemente, las URLs de las creatividades de anuncios para el grupo de interés. (Las URL del anuncio pueden agregarse más adelante con una actualización).
  • Una lista de claves de datos que se consultarán y la URL del servicio de par clave-valor del comprador para habilitar el código de oferta a fin de obtener datos en tiempo real durante una subasta.

El código del comprador también puede incluir una función reportWin() para informar el resultado de la subasta.

¿Quién ejecuta una subasta de anuncios?

Existen varias partes que podrían realizar una subasta para vender espacio publicitario.

Por ejemplo:

  • Publicador de contenido: Actúa por su cuenta para alojar contenido de anuncios en su sitio web.
  • Plataforma de proveedores (SSP): Trabajar con el publicador y proporcionar otros servicios
  • Secuencia de comandos de terceros: Actúa para un publicador que permite la participación en las subastas de anuncios.

Con la API de Protected Audience, un vendedor de un espacio publicitario tiene tres trabajos:

  • Aplicar las reglas del publicador: que indiquen qué compradores y qué ofertas son aptos
  • Lógica de subasta: ejecución de JavaScript en worklets para calcular puntuación de deseabilidad de cada oferta.
  • Informa el resultado de la subasta.

Estas tareas se realizan de manera programática, en el código que proporciona el vendedor cuando inicia un anuncio. subasta llamando a la función de JavaScript navigator.runAdAuction().

¿Cómo funciona una subasta de anuncios de la API de Protected Audience?

En el siguiente diagrama, se describe cada etapa de una subasta de anuncios de la API de Protected Audience:

Seis etapas de una subasta de anuncios de la API de Protected Audience .
Etapas de la subasta de anuncios de Protected Audience.

En la API de Protected Audience, una subasta de anuncios es una colección de pequeños programas de JavaScript que el navegador ejecuta en la cuenta del usuario para elegir un anuncio. Para preservar la privacidad, se ejecuta todo el código de subasta de anuncios del vendedor y los compradores en worklets de JavaScript aislados que no pueden comunicarse con el mundo exterior.

Un vendedor (un publicador o una plataforma de proveedores) inicia una subasta de anuncios de Protected Audience en un sitio en el que se vende espacio publicitario (como un sitio sitio). El vendedor elige compradores para participar en la subasta indica qué espacio está en venta y brinda criterios adicionales para el anuncio. Cada comprador es el propietario de un grupo de interés.

El vendedor proporciona al navegador un código para puntuar las ofertas, el cual incluye el valor de cada oferta, la de la creatividad del anuncio y otros datos que muestra cada comprador. Durante la subasta, las ofertas de los compradores y el de puntuación de oferta del vendedor pueden recibir datos de su Servicios de par clave-valor. Una vez que se elige un anuncio (en un marco vallado para preservar privacidad) el vendedor y el comprador ganador pueden informar el resultado de la subasta.

  1. Un usuario visita un sitio que muestra anuncios.
  2. El código del vendedor inicia una subasta. El vendedor especifica cuál es el de venta y quiénes pueden ofertar, así como un método para puntuar esas ofertas.
  3. El código del comprador invitado se ejecuta para generar una oferta (URL para un anuncio relevante). la creatividad y otros datos. La secuencia de comandos de licitación puede consultar datos en tiempo real como el presupuesto restante de la campaña publicitaria, del par clave-valor del comprador servicio.
  4. El código del vendedor califica cada oferta y selecciona un ganador. Esta lógica usa el el valor de la oferta y otros datos para mostrar la deseabilidad de una oferta y rechazar un anuncio que no supera al ganador del anuncio contextual. El vendedor puede usar sus propios Servicio de par clave-valor para datos en tiempo real. Antes comienza una subasta, el vendedor encuentra el mejor anuncio contextual para la espacio publicitario.
  5. El anuncio ganador se muestra como un objeto de configuración de marco vallado cuando se establece la marca resolveToConfig en la configuración de la subasta. La configuración se usa para navegar por el marco vallado a la creatividad del anuncio, y la URL de la creatividad se oculta para el vendedor y el publicador. Si la marca resolveToConfig se establece en false o no se pasa, el anuncio ganador se muestra como un URN opaco que se puede usar para renderizar el anuncio en un iframe. El objeto de configuración de marco vallado está disponible a partir de M114.
  6. Se informa la subasta al vendedor y a los compradores ganadores.

Se está discutiendo un mecanismo de denuncia para los compradores perdedores.

¿Qué es un servicio de par clave-valor de la API de Protected Audience?

El servicio de par clave-valor de la API de Protected Audience permite que las tecnologías publicitarias consulten datos en tiempo real cuando el comprador realiza una oferta y que los vendedores califiquen los anuncios mientras preservan la privacidad. Puedes obtener más información sobre el servicio de par clave-valor de la API de Protected Audience y otros en los servicios de la API de Protected Audience.

El servicio de par clave-valor se implementa en la infraestructura de nube propia de la tecnología publicitaria y se ejecuta en un entorno de ejecución confiable. Una solicitud a un servicio de par clave-valor no puede generar un registro a nivel del evento ni tener otros efectos secundarios. El servicio de par clave-valor también admitirá funciones definidas por el usuario (UDF) que permiten que las tecnologías publicitarias ejecuten su propia lógica personalizada dentro del servicio de par clave-valor.

Un comprador o vendedor proporciona una lista de "claves" para especificar los datos que requieren de un servicio de par clave-valor de la API de Protected Audience. El servicio de par clave-valor responde con un valor para cada clave.

El código de servicio de clave-valor de la API de Protected Audience ahora está disponible en un repositorio de GitHub de Privacy Sandbox. Los desarrolladores de Chrome y Android pueden usar este servicio.

Obtén más información sobre el servicio de par clave-valor de la API de Protected Audience en el Explicación de la API y la explicación del modelo de confianza.

¿Cómo se incorporan los datos en tiempo real a las subastas?

Es posible que los compradores o vendedores en una subasta de anuncios necesiten acceso a de datos no estructurados. Por ejemplo, tal vez los compradores quieran calcular el presupuesto restante de una campaña publicitaria es posible que el vendedor deba verificar que las creatividades de anuncios cumplan con las políticas de los publicadores.

Para cumplir con los requisitos de privacidad de la API de Protected Audience, el servicio de par clave-valor proporciona los datos en tiempo real necesarios durante una subasta de anuncios. Cuando cada comprador llama a navigator.joinAdInterestGroup(), especifica una URL de servicio de par clave-valor y las claves que se consultarán al servicio durante una subasta. Del mismo modo, cuando el vendedor llama a navigator.runAdAuction() para ejecutar una subasta de anuncios, proporciona una URL para su servicio de par clave-valor. Se consultará el servicio de par clave-valor del vendedor con la URL de renderización de la creatividad.

Para las pruebas iniciales, se usa el modelo “Trae tu propio servidor”. A largo plazo, las tecnologías publicitarias deberán usar los servicios de clave-valor de la API de Protected Audience de código abierto que se ejecuten en entornos de ejecución de confianza para recuperar datos en tiempo real.

Para garantizar que el ecosistema disponga del tiempo suficiente para realizar pruebas, no pretendemos exigir el uso de servicios de par clave-valor de código abierto ni entornos de ejecución confiables hasta algún momento después de la baja de las cookies de terceros. Enviaremos una notificación importante a los desarrolladores para que comiencen a realizar pruebas y adopción antes de que se lleve a cabo esta transición.

¿Cómo se usan los datos de origen en una subasta de Protected Audience?

Los datos de origen son datos que pertenecen al sitio sobre sus usuarios. Por ejemplo, si un usuario especificó su color favorito en el sitio del anunciante o del publicador, ese color se considera como datos de origen.

En una subasta de Protected Audience, el anunciante puede usar sus datos de origen para determinar la membresía del grupo de interés publicitario y también puede pasar datos al grupo de interés como userBiddingSignals. Los datos de origen del anunciante solo estarán disponibles para los compradores durante el paso de generación de ofertas y no lo están para los vendedores.

Por ejemplo, si el anunciante conoce el color favorito del usuario, el valor se puede establecer en la configuración del grupo de interés como userBiddingSignals cuando el usuario se agrega a un grupo de interés:

const interestGroup = {
  owner: 'https://example-buyer.com',
  name: 'running-shoes',
  userBiddingSignals: {
    favoriteColor: 'blue' // First-party data
  },
  // ...other interest group settings
};

navigator.joinAdInterestGroup(interestGroup, 3600);

El publicador también puede pasar sus datos de origen estableciendo los indicadores en la configuración de la subasta cuando inicia la subasta y puede controlar quién recibe los datos de origen. Cuando un publicador pasa los datos de origen como auctionSignals, están disponibles para compradores y vendedores. Cuando los datos se pasan como sellerSignals, solo están disponibles para el vendedor, y cuando se pasan como perBuyerSignals, solo para los compradores especificados. El publicador también puede pasar datos de origen a las subastas de componentes. El publicador y los participantes de la subasta deben acordar antes qué datos de origen se deben compartir y cómo se les debe dar formato.

En el siguiente ejemplo, se describe cómo el publicador puede pasar los datos de origen a varios participantes de la subasta:

const auctionConfig = {
  seller: 'https://example-seller.com',
  auctionSignals: {
    favoriteColor: 'blue', // Both buyer and seller will receive this signal
  },
  sellerSignals: {
    favoriteIceCreamFlavor: 'chocolate', // Only the seller will receive this signal
  },
  perBuyerSignals: {
    'https://example-buyer.com': {
      favoriteDrink: 'tea', // Only a specific buyer will receive this signal
    },
  },
  // The same pattern applies to the component auction
  componentAuctions: [{
    seller: 'https://example-component-seller.com',
    auctionSignals: { ... },
    sellerSignals: { ... },
    perBuyerSignals { ... }
  }],
  // ...other auction settings
};

navigator.runAdAuction(auctionConfig);

Más información

Para obtener una descripción general más detallada de la API de Protected Audience, lee el Guía para desarrolladores de la API de Protected Audience

Desarrolladores

Si tienes todo listo para comenzar a trabajar con la API de Protected Audience, consulta experimentar y participar.

Redactamos una guía para desarrolladores de la API y creamos una demostración de la API de Protected Audience, que ofrece una explicación de la implementación básica de la API de Protected Audience. En el video de demostración de la API de Protected Audience, se explica cómo funciona el código de demostración y se muestra cómo usar las Herramientas para desarrolladores de Chrome para la depuración de la API de Protected Audience.

Interactúa y comparte tus comentarios