Obtén información para actualizar los datos de 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 conocer 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 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. El navegador almacena la membresía del grupo de intereses en el dispositivo del usuario y no la comparte con el proveedor del navegador ni con nadie más.
Funciones de la API
Ejemplo de uso
A continuación, se muestra el ejemplo de la guía sobre cómo definir datos de público en el que se explica cómo crear un grupo de interés y solicitarle al navegador que se una al grupo.
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);
El objeto updateUrl proporciona una URL que devuelve JSON para actualizar los atributos del grupo de interés. Debe tener el mismo origen que owner.
Actualiza atributos
updateUrl especifica un servidor web que devuelve JSON que define las propiedades del grupo de interés, lo que corresponde 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:
biddingLogicUrlbiddingWasmHelperUrltrustedBiddingSignalsUrltrustedBiddingSignalsKeysadspriority
No se sobrescribirá ningún campo que no se especifique en el JSON. Solo se actualizarán los campos especificados en el JSON, mientras que la llamada a navigator.joinAdInterestGroup() sobrescribe cualquier grupo de interés existente.
Las actualizaciones se realizan con el mejor esfuerzo y pueden fallar en las siguientes condiciones:
- Tiempo de espera de la solicitud de red (actualmente, 30 segundos).
- Otro error de red.
- Error de análisis de JSON.
Las actualizaciones están limitadas a un máximo de una por día.
Las actualizaciones se pueden cancelar si se dedicó demasiado tiempo contiguo a la actualización, aunque esto no impone ningún límite de velocidad en las actualizaciones canceladas (restantes). Las actualizaciones que fallan debido a errores de red se vuelven a intentar después de una hora, y las actualizaciones que fallan debido a la desconexión de Internet se vuelven a intentar inmediatamente después de restablecer la conexión.
Actualizaciones manuales
Las actualizaciones de los grupos de interés que pertenecen al origen del frame actual se pueden activar de forma manual con navigator.updateAdInterestGroups().
El límite de frecuencia evita que las actualizaciones se realicen con demasiada frecuencia: las llamadas repetidas a navigator.updateAdInterestGroups() no hacen nada hasta que transcurre el período del límite de frecuencia (actualmente, un día).
El límite de frecuencia 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 cargados para una subasta se actualizan automáticamente después de que se completa la subasta, sujetos a los mismos límites de frecuencia que las actualizaciones manuales.
Para cada propietario que tenga 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 coincide con el de 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.