Servicio de agregación

El servicio de agregación genera informes resumidos de datos detallados de conversiones y mediciones de alcance a partir de informes agregables sin procesar. Las tecnologías publicitarias tienen dos puntos de entrada principales agregados del lado del cliente para generar informes de embudos al servicio de agregación, ya sea a través de la API de Attribution Reporting o la API de Private Aggregation.

Estado de implementación

Disponibilidad

Propuesta Estado
Compatibilidad con el servicio de agregación para Amazon Web Services (AWS) en la API de Attribution Reporting y la API de Private Aggregation
Explicación
Disponible
Compatibilidad del servicio de agregación con Google Cloud en la API de Attribution Reporting y la API de Private Aggregation
Explicación
Disponible
Inscripción en el sitio del servicio de agregación y agregación de orígenes múltiples. La inscripción de sitios incluye la asignación de un sitio a cuentas de nube (AWS o GCP). Para agregar varios orígenes, deben ser del mismo sitio.
Preguntas frecuentes en GitHub
Documentación de la API de agregación de sitios
Disponible
El valor de epsilon del servicio de agregación se mantendrá como un rango de hasta 64 para facilitar la experimentación y los comentarios sobre diferentes parámetros.
Envía comentarios sobre epsilon de ARA.
Enviar comentarios sobre el parámetro épsilon de PAA.
Disponible. Proporcionaremos un aviso anticipado al ecosistema antes de que se actualicen los valores del rango de épsilon.
Filtrado de contribuciones más flexible para las consultas del servicio de agregación
Explicación
Disponible
Proceso para la recuperación del presupuesto después de desastres (errores, parámetros de configuración incorrectos, etcétera)
Explicación
Disponible
Mecanismo para revisar el porcentaje de IDs compartidos que recupera una tecnología publicitaria mediante la recuperación del presupuesto y suspender las recuperaciones futuras para recuperaciones excesivas planificadas para el 1ᵉʳ semestre de 2025
Accenture opera como uno de los coordinadores de AWS
Blog para desarrolladores
Disponible
Parte independiente que opera como uno de los coordinadores de Google Cloud
Blog de desarrolladores
Disponible
Compatibilidad del servicio de agregación con los informes de depuración agregados en la API de Attribution Reporting
Explicación
Disponible

Términos y conceptos clave

Si estás considerando usar el servicio de agregación en tu flujo de trabajo de tecnología publicitaria, los siguientes términos y conceptos deberían brindarte más información sobre lo que este nuevo flujo de agregación puede ofrecer a tu equipo:

Término Descripción
Servicio de agregación Es un servicio operado por tecnología publicitaria que procesa informes agregables para crear un informe de resumen.
Informes agregables

Los informes agregables son informes encriptados que se envían desde dispositivos de usuarios individuales. Estos informes contienen datos sobre el comportamiento y las conversiones de los usuarios en diferentes sitios. El anunciante o la tecnología publicitaria definen las conversiones (a veces llamadas eventos de activación de atribución) y las métricas asociadas. Cada informe se encripta para evitar que varias partes accedan a los datos subyacentes.

Obtén más información sobre los informes agregables.
Contabilidad de informes agregables Un registro distribuido ubicado en ambos coordinadores que hace un seguimiento del presupuesto de privacidad asignado y aplica el requisito de 'No Duplicates' estándar. Este es el mecanismo de preservación de la privacidad, ubicado y ejecutado dentro de coordinadores, que garantiza que ningún informe pase por el servicio de agregación más allá del presupuesto de privacidad asignado. Obtén más información sobre las estrategias de lote para saber cómo se relacionan con los informes agregables.
Presupuesto de la contabilidad de informes agregables Referencias al presupuesto que garantizan que los informes no se procesen más de una vez.
Entorno de ejecución confiable (TEE)

Un entorno de ejecución confiable es una configuración especial de hardware y software informático que permite a terceros verificar las versiones exactas del software que se ejecuta en la computadora. TEEs permite que terceros verifiquen que el software hace exactamente lo que un fabricante de software afirma que sí lo hace, nada más o menos.

Para obtener más información sobre los TEE que se usan para las propuestas de Privacy Sandbox, lee la explicación de los servicios de la API de Protected Audience y la explicación del servicio de agregación.

Coordinadores

Un coordinador es una entidad responsable de la administración de claves y la contabilidad de informes agregables. El coordinador mantiene una lista de hashes de parámetros de configuración aprobados del servicio de agregación y configura el acceso a las claves de desencriptación.

ID compartido Valor calculado que consta de: shared_info, reporting_origin, destination_site (disponible solo para la API de Attribution Reporting), source_registration-time (disponible solo para la API de Attribution Reporting), scheduled_report_time y version. Esto significa que varios informes pertenecen al mismo ID compartido si comparten los mismos atributos del campo shared_info. Esto desempeña un papel importante en la Contabilidad de informes agregables. Obtén más información sobre los servidores de confianza.
Informe de resumen

Un informe de resumen es un tipo de informe de la API de Attribution Reporting y la API de Private Aggregation. Un resumen incluye datos agregados del usuario y puede tener datos de conversiones detallados con ruido agregado. Los informes de resumen se componen de informes agregados. Los informes de resumen permiten una mayor flexibilidad y un modelo de datos más rico que los informes a nivel del evento, en particular para algunos casos de uso, como los valores de conversión.

Origen de los informes

El origen de los informes es la entidad que recibe informes agregables, es decir, la plataforma que se llama API de Attribution Reporting. Los informes agregables se envían desde de usuarios a una URL conocida asociada al informe origen. Este origen del informe se debe designar durante la inscripción.

Vinculación de contribución Los informes agregables pueden contener una cantidad arbitraria de incrementos de contador. Por ejemplo, un informe puede contener un recuento de los productos que un usuario vio en el sitio de un anunciante. La suma de incrementos en todos los informes agregables relacionados con un único evento fuente no debe exceder un límite determinado: "L1=2^16". Obtén más información en la explicación de los informes agregables.
Ruido y escalamiento Se agrega cierta cantidad de datos estadísticos a los informes de resumen como parte del proceso de agregación, que también funciona para preservar la privacidad y garantizar que los informes finales proporcionen información de medición anonimizada. Obtén más información sobre el mecanismo de ruido aditivo, que se extrae de la distribución de Laplace.
Certificación

La certificación es un mecanismo para autenticar la identidad de software, por lo general, con hashes criptográficos o firmas. Para la propuesta de servicio de agregación, la certificación hace coincidir el código que se ejecuta en el servicio de agregación operado por la tecnología publicitaria con el código fuente abierto.

Obtén más información sobre la certificación.

Obtenga más información sobre la historia del servicio de agregación en nuestra explicación y la lista completa de condiciones.

Casos de uso de agregación

Considera los siguientes recorridos de los desarrolladores para la medición de anuncios y sus correspondientes bibliotecas cliente de medición.

Caso de uso Punto de entrada Descripción
Optimización de ofertas API de Attribution Reporting (Chrome y Android) Usa los informes agregados para transferir indicadores de conversión y optimizar las ofertas.
Medición multiplataforma API de Attribution Reporting (Chrome y Android) Utiliza las capacidades de medición web y de aplicaciones para obtener visibilidad del rendimiento en Chrome y Android.
Informes de conversiones API de Attribution Reporting (Chrome y Android) Crea informes de conversiones agregados adaptados a las necesidades de las campañas de los clientes (incluye las CTC y las VTC).
Medición del alcance de la campaña API de Shared Storage y API de Private Aggregation (Chrome) Utiliza variables de vista de anuncio en varios sitios para medir el alcance de la campaña.
Informes demográficos API de Shared Storage y API de Private Aggregation (Chrome) Utilice la reproducción de anuncios en varios sitios y la información demográfica para medir el alcance por datos demográficos.
Análisis de la ruta de conversión API de Storage compartido y API de agregación privada (Chrome) Guarda la vista de anuncios en varios sitios y las variables de conversión para realizar análisis agregados de la ruta de conversión.
Efectividad de conversiones y de marca API de Shared Storage y API de Private Aggregation (Chrome) Informes sobre grupos de prueba y control, y sobre la información de sondeo para medir el aumento de la marca y la incrementalidad
Depuración de subastas API de Protected Audience y API de Private Aggregation (Chrome) Usa informes agregados para depurar.
Distribución de ofertas API de Protected Audience y API de Private Aggregation (Chrome) Usar informes agregados para captar la distribución de los valores de las ofertas para las subastas

Flujo de extremo a extremo

En el siguiente diagrama, se muestra el servicio de agregación en acción. Nos enfocaremos en el flujo integral, desde la recepción de los informes desde la Web y los dispositivos móviles hasta la creación de informes de resumen en el servicio de agregación.

Flujo del servicio de agregación de extremo a extremo

  1. Recupera la clave pública para generar informes encriptados.
  2. Informes agregables encriptados que se envían a los servidores de tecnología publicitaria para recopilarlos, transformarlos y agruparlos en lotes.
  3. El servidor de tecnología publicitaria agrupa los informes (en formato avro) y los envía al servicio de agregación implementado. (La tecnología publicitaria debe completarla).
  4. Recuperar informes agregados para desencriptarlos
  5. Recupera claves de desencriptación de los coordinadores.
  6. El servicio de agregación desencripta informes para la agregación y la contaminación.
  7. El servicio de contabilidad de informes agregables verifica si queda algún presupuesto de privacidad para generar un informe de resumen de los informes agregables determinados.
  8. Envía el informe de resumen final.

En el diagrama, puedes ver la relación general que tiene el servicio de agregación con las principales APIs de medición de clientes: la API de Attribution Reporting, la API de Private Aggregation y los coordinadores.

El flujo comienza con diferentes APIs de medición, como la API de Attribution Reporting o la API de Private Aggregation, que generan informes a partir de varias instancias de navegador. Chrome toma la clave pública del servicio de alojamiento de claves en el coordinador para encriptar los informes antes de que se envíen al origen de informes de la tecnología publicitaria. Las claves públicas se rotan cada siete días.

Una vez que el origen de informes de la tecnología publicitaria recibe estos informes, se debe configurar para recopilarlos y convertirlos al formato avro, y enviarlos a la instancia del servicio de agregación implementada. Consulta las estrategias por lotes.

Una vez que la tecnología publicitaria está lista para agruparse en lotes, crea una solicitud por lotes al servicio de agregación en la que los informes se desencriptan recuperando las claves de desencriptación del servicio de hosting de claves y se agregan y se generan con ruido para crear un informe de resumen. Ten en cuenta que esto depende de si hay suficiente presupuesto de privacidad para generar los informes de resumen finales.

La tecnología publicitaria aloja el extremo de origen de informes donde se recopilan los informes, y el servicio de agregación se implementa en la nube de la tecnología publicitaria.

Agrupación en lotes de informes agregables

El flujo de informes no estaría completo sin la ayuda del servidor de origen de informes designado. Este es el origen que una plataforma de tecnología publicitaria habría enviado en el proceso de inscripción. Las principales acciones de las que es responsable el origen de los informes son recopilar, transformar y agrupar los informes agregables recibidos y prepararlos para que se envíen al servicio de agregación implementado de la tecnología publicitaria en Google Cloud o Amazon Web Services. Obtén más información para preparar tus informes agregables.

Ahora que conoces el concepto general, veamos en detalle los componentes que se implementarán en tu servicio de agregación.

Componentes de la nube

El servicio de agregación consta de varios componentes de servicios en la nube. Las secuencias de comandos de Terraform proporcionadas aprovisionan y configuran todos los componentes necesarios del servicio en la nube.

Componentes de la nube del servicio de agregación

Servicio de frontend

Servicio de Cloud administrado: Cloud Function (Google Cloud) o API Gateway (Amazon Web Services)

Frontend Service es una puerta de enlace sin servidores que funciona como punto de entrada de las llamadas a la API de Aggregation para la creación de trabajos y la recuperación del estado del trabajo. Es responsable de recibir las solicitudes de los usuarios del servicio de agregación, validar los parámetros de entrada e iniciar el proceso de programación del trabajo de agregación.

Hay dos APIs disponibles en el servicio de frontend:

Extremo Descripción
createJob Esta API activa un trabajo del servicio de agregación. Requiere información para activar un trabajo, como el ID del trabajo, los detalles de almacenamiento de entrada, los detalles de almacenamiento de salida, el origen de los informes y mucho más.
getJob Esta API muestra el estado de un trabajo para un ID de trabajo especificado. Proporciona información sobre el estado del trabajo, como "Recibido", "En curso" o "Finalizado". Además, si el trabajo se completa, muestra su resultado, incluidos los mensajes de error que se encontraron durante la ejecución del trabajo.

Consulta la documentación de la API de Aggregation Service.

Cola de trabajos

Servicio en la nube administrado: Pub/Sub (Google Cloud) o Amazon SQS (Amazon Web Services)

La cola de trabajos es una cola de mensajes que almacena las solicitudes de trabajo para el servicio de agregación. El servicio de frontend inserta mensajes de solicitud de trabajo en la cola, que luego el trabajador de agregación consume para procesar la solicitud de trabajo.

Almacenamiento en la nube

Servicio en la nube administrado: Google Cloud Storage (Google Cloud)/Amazon S3 (Amazon Web Services) El almacenamiento en la nube se usa para almacenar archivos de entrada y salida que usa el servicio de agregación (por ejemplo, archivos de informes encriptados, informes de resumen de salida, etcétera).

Base de datos de metadatos de trabajos

Servicio de nube administrado: Spanner (Google Cloud)/DynamoDB (Amazon Web Services)

La base de datos de metadatos de trabajos almacena y realiza un seguimiento del estado de los trabajos de agregación. La base de datos registra metadatos como la hora de creación, la hora solicitada, la hora de actualización y el estado (por ejemplo: Recibida, En curso, Finalizada, etcétera). El trabajador de agregación actualiza la base de datos de metadatos de trabajo a medida que avanza el trabajo.

Trabajador de agregación

Servicio de nube administrado: Compute Engine con espacio confidencial (Google Cloud)/Amazon Web Services EC2 con Nitro Enclave (Amazon Web Services)

El trabajador de agregación procesa las solicitudes de trabajo iniciadas por una solicitud de trabajo en la cola de trabajos y desencripta las entradas encriptadas con claves recuperadas del servicio de generación y distribución de claves (KGDS) en los coordinadores. Para minimizar la latencia de procesamiento de trabajos, las claves de desencriptación se almacenan en caché en Aggregation Worker por un período de 8 horas y se pueden usar en los trabajos que procesa esa instancia de trabajador.

El trabajador opera dentro de una instancia del entorno de ejecución confiable (TEE). Cada trabajador maneja solo un trabajo a la vez. La tecnología publicitaria puede configurar varios trabajadores para procesar trabajos en paralelo estableciendo la configuración del ajuste de escala automático. Con el ajuste de escala automático, la cantidad de trabajadores se ajusta de forma dinámica según la cantidad de mensajes restantes en la cola de trabajos. La cantidad mínima y máxima de trabajadores para el ajuste de escala automático se puede configurar a través del archivo de entorno de Terraform. Puedes encontrar más información sobre el ajuste de escala automático en las siguientes secuencias de comandos de Terraform. [Amazon Web Services / Google Cloud]

El trabajador de agregación llama al servicio de contabilidad de informes agregables para la contabilidad de informes agregables. El servicio de contabilidad de informes agregables garantizará que los trabajos solo se ejecuten si aún no se superó el límite del presupuesto de privacidad. (Consulta la regla "Sin duplicados"). Si el presupuesto está disponible, se genera un informe de resumen con los agregados ruidosos. Consulta detalles adicionales sobre la contabilidad del informe agregable.

El trabajador de agregación actualiza los metadatos del trabajo en la base de datos de metadatos del trabajo, incluidos los códigos de devolución de trabajo adecuados y los contadores de errores de informes en caso de fallas parciales de informes. Los usuarios pueden recuperar el estado con la API de recuperación de estado de trabajo (getJob).

Para obtener una descripción más detallada del servicio de agregación, consulta nuestra explicación.

Próximos pasos

Ahora que conoces los aspectos destacados del servicio de agregación, es momento de que implementes tu propia instancia a través de Google Cloud o Amazon Web Services, consulta la sección de introducción o, si necesitas más información sobre cómo operar un servicio de agregación implementado, sigue este vínculo para obtener más información sobre cómo operar el servicio de agregación.

Solución de problemas

Consulta nuestro documento Códigos de error y mitigaciones comunes para obtener descripciones más detalladas de los mensajes de error, lo que puede haber causado el error que tienes y los próximos pasos para mitigarlo.

Obtén asistencia y envía comentarios