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 ver 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 sobre cómo los navegadores registran los grupos de interés.
¿No eres desarrollador? Consulta la descripción general de la API de Protected Audience.
Grupos de interés 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 al 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 ninguna otra persona.
Funciones de API
Ejemplo de uso
Este es el ejemplo de la guía sobre cómo definir los datos del público, que muestra cómo crear un grupo de interés y pedirle 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 pasa 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 el JSON), mientras que llamar a navigator.joinAdInterestGroup()
reemplazará cualquier grupo de interés existente.
Las actualizaciones se realizan mediante el mejor esfuerzo y pueden fallar en las siguientes condiciones:
- Tiempo de espera de la solicitud de red (actualmente, 30 segundos).
- Otra falla de la red.
- Error de análisis de JSON.
La frecuencia de las actualizaciones es de una por día como máximo.
Las actualizaciones se pueden cancelar si se dedicó demasiado tiempo contiguo a la actualización, aunque esto no impone ningún límite de frecuencia a las actualizaciones canceladas (restantes). Las actualizaciones que fallan debido a errores de red se reintentan después de una hora, mientras que las actualizaciones que fallan debido a desconexión de Internet se reintentan de inmediato tras volver a conectarse.
Actualizaciones manuales
Las actualizaciones a los grupos de intereses que pertenecen al origen del fotograma 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 finalice 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 intereses cargados para una subasta se actualizan automáticamente después de que esta finaliza, sujetos a los mismos límites de frecuencia que las actualizaciones manuales.
Para cada propietario que tiene, al menos, un grupo de interés que participa 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.