Aprende a actualizar los datos del público configurando una URL de actualización para un grupo de interés de la API de Protected Audience. Lee la guía para desarrolladores para obtener información sobre el ciclo de vida completo de la API de Protected Audience y consulta la explicación de la API de Protected Audience para obtener una propuesta detallada de cómo los navegadores registran los grupos de intereses.
¿No eres desarrollador? Consulta la descripción general de la API de Protected Audience.
Grupos de intereses de la API de Protected Audience
Un grupo de interés de la API de Protected Audience representa a un grupo de personas con un interés común, que corresponde a una lista de remarketing. Cada grupo de interés de la API de Protected Audience tiene un propietario.
Los propietarios de grupos de interés actúan como compradores en la subasta de anuncios de la API de Protected Audience. La pertenencia a un grupo de interés se almacena en el navegador y en el dispositivo del usuario, y no se comparte con el proveedor del navegador ni con nadie más.
Funciones de API
Ejemplo de uso
Este es el ejemplo de la guía sobre cómo definir datos del público que muestra cómo crear un grupo de interés y pedir al navegador que se una a él.
const interestGroup = {
owner: 'https://dsp.example',
name: 'custom-bikes',
biddingLogicUrl: ...,
biddingWasmHelperUrl: ...,
updateUrl: ...,
trustedBiddingSignalsUrl: ...,
trustedBiddingSignalsKeys: ['key1', 'key2'],
userBiddingSignals: {...},
ads: [bikeAd1, bikeAd2, bikeAd3],
adComponents: [customBike1, customBike2, bikePedal, bikeFrame1, bikeFrame2],
};
navigator.joinAdInterestGroup(interestGroup, 7 * kSecsPerDay);
updateUrl
proporciona una URL que muestra JSON para actualizar los atributos del grupo de interés. Debe tener el mismo origen que owner
.
Actualizar atributos
updateUrl
especifica un servidor web que muestra JSON que define las propiedades del grupo de interés, correspondientes al objeto del grupo de interés que se pasó a joinAdInterestGroup()
.
Esto permite que el propietario del grupo actualice periódicamente los atributos del grupo de interés. En la implementación actual, se pueden cambiar los siguientes atributos:
biddingLogicUrl
biddingWasmHelperUrl
trustedBiddingSignalsUrl
trustedBiddingSignalsKeys
ads
priority
Los campos no especificados en el JSON no se reemplazarán (solo se actualizarán los campos especificados en JSON), mientras que la llamada a navigator.joinAdInterestGroup()
reemplaza cualquier grupo de interés existente.
Las actualizaciones se basan en el mejor esfuerzo y pueden fallar en las siguientes condiciones:
- Se agotó el tiempo de espera de la solicitud de red (actualmente, 30 segundos).
- Otra falla de red.
- Error de análisis de JSON.
El límite de frecuencia de las actualizaciones es de una por día.
Las actualizaciones se pueden cancelar si se dedicó demasiado tiempo contiguo a estas actualizaciones, aunque esto no impone ningún límite de frecuencia a las actualizaciones canceladas (restantes). Las actualizaciones que fallen debido a errores de red se reintentan después de una hora y las actualizaciones que fallan debido a la desconexión de Internet se reintentan de inmediato cuando se vuelve a conectar.
Actualizaciones manuales
Las actualizaciones de grupos de interés que pertenecen al origen del marco actual se pueden activar manualmente con navigator.updateAdInterestGroups()
.
El límite de frecuencia evita que las actualizaciones se realicen con demasiada frecuencia: las llamadas repetidas a navigator.updateAdInterestGroups()
no realizan ninguna acción hasta que haya transcurrido el período de límite de frecuencia (actualmente, un día).
El límite de tasa se restablece si se vuelve a llamar a navigator.joinAdInterestGroup()
para el mismo grupo de interés owner
y name
.
Actualizaciones automáticas
Todos los grupos de interés que se cargan para una subasta se actualizan automáticamente después de que esta finaliza, sujeto a los mismos límites de frecuencia que las actualizaciones manuales.
Para cada propietario con al menos un grupo de interés que participe en una subasta, es como si se llamara a navigator.updateAdInterestGroups()
desde un iframe cuyo origen coincida con ese propietario.
Todas las referencias de la API de Protected Audience
Las guías de referencia de la API están disponibles:
- Guía para desarrolladores sobre la API de Protected Audience
- Guía para compradores de anuncios sobre los grupos de interés y la generación de ofertas de Protected Audience.
- Guía para vendedores de anuncios sobre las subastas de anuncios de Protected Audience.
- Guía para informar los resultados de las subastas
- Prácticas recomendadas para la latencia de subasta de anuncios de Protected Audience
- Cómo solucionar problemas de Protected Audience
La explicación de la API de Protected Audience también proporciona detalles sobre la compatibilidad y las restricciones de funciones.