Información sobre las claves de agregación para Attribution Reporting

Qué son las claves de agregación, cómo se usan en la API de Attribution Reporting y cómo puedes convertir objetivos en claves

Como empresa de tecnología publicitaria que publica campañas en varias ubicaciones para distintas categorías de productos, quieres ayudar a los anunciantes a responder las siguientes preguntas:

1. ¿Cuántas compras de cada categoría de producto generó cada una de mis campañas en cada región geográfica?
2. ¿Cuántos ingresos generó cada categoría de producto de cada una de mis campañas en cada región geográfica?

Si bien muchas empresas de tecnología publicitaria recomiendan a los anunciantes configurar diversos tipos de conversión, centrarse en las conversiones más importantes, como las compras, es una buena manera de garantizar que los resultados del resumen sean detallados y precisos para estos eventos importantes.

Para ello, tendrás que pensar en las preguntas que quieres responder antes de que se recopilen los datos.

Dimensiones, claves y valores

Para responder estas preguntas, veamos las dimensiones, las claves y los valores.

Nota: Las claves de agregación que se analizan en este documento son específicas de la API de Attribuion Reporting.

Dimensiones

Para comprender cómo tus campañas generan ingresos, como se describe a continuación, te recomendamos hacer un seguimiento de las siguientes dimensiones:

• ID de la campaña publicitaria: El identificador de la campaña específica.
• ID geográfico: La región geográfica donde se publicó el anuncio.
• Categoría de producto: El tipo de producto, tal como lo definiste.

Si bien se conocen las dimensiones ID de campaña y ID geográfico cuando se publica el anuncio (tiempo de publicación de anuncios), la categoría de producto se conocerá desde un evento activador cuando el usuario completa una conversión (horario de conversión).

Nota: Para el diagrama de este documento, mostraremos las dimensiones de la siguiente manera: - Dimensiones conocidas en el momento de la publicación de anuncios sobre un fondo verde. - Dimensiones conocidas al momento de la conversión sobre un fondo amarillo y subrayados.

Las dimensiones de las que desea hacer un seguimiento en este ejemplo se muestran en la siguiente imagen:

Dimensiones a las que se les debe realizar un seguimiento

¿Qué son las claves de agregación (buckets)?

Los términos clave de agregación y bucket hacen referencia a lo mismo. La clave de agregación se usa en las APIs del navegador que se usan para configurar los informes. El término bucket se usa en los informes agregables y de resumen y en las APIs del servicio de agregación.

Una clave de agregación es un dato que representa los valores de las dimensiones de las que se hace un seguimiento. Luego, los datos se agregan junto con cada clave de agregación.

Por ejemplo, supongamos que realizas un seguimiento de las dimensiones Categoría de producto, ID geográfico y ID de campaña.

Cuando un usuario ubicado en el ID geográfico 7 ve un anuncio para el ID de campaña 12 y, luego, realiza una conversión comprando un producto en la categoría 25, puede configurar una clave de agregación como la que se muestra en la siguiente imagen:

Más adelante, verás que una clave de agregación no tiene el mismo aspecto en la práctica, pero, por ahora, nos enfocaremos en la información que contiene la clave.

¿Qué son los valores agregables?

Para responder a tus preguntas sobre las dimensiones que describimos, debes saber lo siguiente:

• Indica la cantidad de compras (el recuento de compras). Una vez agregada y disponible en un informe de resumen, este será el recuento total de compras (valor del resumen).
• Es el ingreso de cada compra (el valor de compra). Una vez agregados y disponibles en un informe de resumen, estos serán los ingresos totales (valor del resumen).

Cada uno de estos elementos (el recuento de compras de una conversión y el valor de compra de una conversión) es un valor agregable. Puedes considerar a los valores agregables como los valores de tus objetivos de medición.

Pregunta	Valor agregable = Objetivo de medición
		Cuántas compras...	Recuento de compras
Cuántos ingresos...	Valor de compra

Cuando un usuario con el ID geográfico 7 ve un anuncio para el ID de campaña 12 y, luego, realiza una conversión comprando un producto de la categoría de producto 25 por USD 120 (suponiendo que tu moneda sea USD), puedes establecer una clave de agregación y valores agregables con el siguiente aspecto:

Clave y valores agregables. Ten en cuenta que los valores agregables están en negrita sobre un fondo azul.

Los valores agregables se suman por clave entre muchos usuarios para generar estadísticas agregadas, en forma de valores de resumen en los informes de resumen.

Los valores agregables se suman para generar estadísticas agregadas para tus objetivos de medición.

Ten en cuenta que este diagrama omite la desencriptación y representa un ejemplo simplificado sin ruido aplicado. En la siguiente sección, describiremos este ejemplo con ruido.

De claves y valores a informes

Ahora veamos cómo se relacionan las claves y los valores agregables con los informes.

Informes agregables

Cuando un usuario hace clic en un anuncio o lo ve y luego genera una conversión, le indicas al navegador que almacene un par {aggregation key, aggregatable value}.

Nota: En el <a href="https://github.com/WICG/conversion-measurement-api/blob/main/AGGREGATE.md">explicación</a>, un par de {aggregation key, aggregatable value} también se denomina contribución de histograma: representa la forma en que esta conversión (y las dimensiones y los valores asociados a ella) contribuye al informe de resumen.

En nuestro ejemplo, cuando un usuario hace clic en un anuncio o lo ve, y luego genera una conversión, le indicas al navegador que genere dos contribuciones (una por cada objetivo de medición).

Más adelante, verás que un informe agregable de {aggregation key, aggregatable value} no se ve exactamente como este, pero por ahora nos enfocaremos en la información que contiene el informe.

Cuando le indicas al navegador que genere dos contribuciones, este generará un informe agregable (si puede hacer coincidir la conversión con una vista o un clic anterior).

Un informe agregable contiene lo siguiente:

• Las contribuciones que configuraste.
• Metadatos sobre el evento de clic o vista y el evento de conversión: el sitio en el que se produjo la conversión y mucho más Consulta todos los campos de un informe agregable.

Los informes agregables tienen formato JSON e incluyen, entre otros datos, un campo de carga útil que se utilizará como entrada de datos para el informe de resumen final.

La carga útil contiene una lista de contribuciones, cada una de las cuales es un par de {aggregation key, aggregatable value}:

• bucket: la clave de agregación, codificada como una cadena de bytes.
• value: el valor agregable para ese objetivo de medición, codificado como una cadena de bytes.

Por ejemplo:

{
  "data": [
    {
      "bucket": "111001001",
      "value": "11111010000",
    }
  ],
  "operation": "histogram"
}

En la práctica, los informes agregables están codificados de una manera que hace que los buckets y los valores se vean diferentes al del ejemplo anterior (es decir, un bucket puede tener el aspecto \u0000\u0000\x80\u0000). Bucket y value son strings de bytes.

Resumen de informes

Los informes agregables incluyen muchos navegadores y dispositivos (usuarios) de la siguiente manera:

• Una tecnología publicitaria solicita informes de resumen para un conjunto determinado de claves y un conjunto determinado de informes agregables que provienen de muchos navegadores (usuarios) diferentes.
• Los informes agregables se desencriptan a través del servicio de agregación.
• Para cada clave, se suman los valores de los informes que se pueden agregar.
• El ruido se agrega al valor de resumen.

El resultado es un informe de resumen que contiene un conjunto de pares {aggregation key, summary value}.

Un informe de resumen contiene un conjunto de pares clave-valor con estilo de diccionario JSON. Cada par contiene lo siguiente:

• bucket: la clave de agregación, codificada como una cadena de bytes.
• value: el valor de resumen en decimal de un objetivo de medición determinado, resumido de todos los informes agregables disponibles, con un nivel de ruido agregado.

Ejemplo:

[
  {"bucket": "111001001", "value": "2558500"}, 
  {"bucket": "111101001", "value": "3256211"}, 
  {...}
]

En la práctica, los informes de resumen están codificados de una manera que hará que los buckets y los valores se vean diferentes de los indicados en el ejemplo (es decir, un bucket puede tener el aspecto \u0000\u0000\x80\u0000). Bucket y value son strings de bytes.

Claves de agregación en la práctica

Las empresas de tecnología publicitaria definen las claves de agregación (buckets), por lo general, en dos pasos: cuando se ve un anuncio o se hace clic en él, y cuando un usuario genera una conversión.

Estructura clave

Usaremos el término estructura de clave para designar el conjunto de dimensiones codificadas en una clave.

Por ejemplo, ID de campaña x GeoID x categoría de producto es una estructura clave.

Tipos de claves

Los valores agregables se suman para una clave determinada en varios usuarios o navegadores. Sin embargo, observamos que los valores agregables pueden hacer un seguimiento de diferentes objetivos de medición, como un valor de compra o un recuento de compras. Deseas asegurarte de que el servicio de agregación sume valores agregables del mismo tipo.

Para hacerlo, dentro de cada clave, codifica un dato que te indique lo que representa el valor del resumen: el objetivo de medición al que se refiere esta clave. Una forma de hacerlo es crear una dimensión adicional para tu clave que represente el tipo de objetivo de medición.

Con el ejemplo anterior, este tipo de objetivo de medición tendría dos valores posibles diferentes:

• El recuento de compras es el primer tipo de objetivo de medición.
• El valor de compra es el segundo tipo de objetivo de medición.

Si tuvieras n objetivos de medición, el tipo de objetivo de medición tendría n tipos de valores diferentes.

Puedes considerar las dimensiones de una clave como una métrica. Por ejemplo, "la cantidad de compras de un producto determinado por campaña y por ubicación geográfica".

Tamaño de la clave y de la dimensión

El tamaño máximo de la clave se define en bits; el número de ceros y unos en objetos binarios para crear la clave completa. La API permite una longitud de clave de 128 bits.

Este tamaño permite claves muy detalladas, pero las claves más detalladas tienen más probabilidades de generar valores más ruidosos. Obtén más información sobre el ruido en Información sobre el ruido.

Como se mencionó antes, las dimensiones se codifican en la clave de agregación. Cada dimensión tiene una determinada cardinalidad, es decir, la cantidad de valores distintos que puede tomar. Según su cardinalidad, cada dimensión debe representarse con una cierta cantidad de bits. Con n bits, es posible expresar 2n opciones distintas.

Por ejemplo, una dimensión País puede tener una cardinalidad de 200, ya que hay alrededor de 200 países en el mundo. ¿Cuántos bits se necesitan para codificar esta dimensión?

7 bits solo almacenarían 27 =128 opciones distintas, que es menor que los 200 necesarios.

8 bits almacenaría 28 =256 opciones distintas, que es más que los 200 necesarios, por lo que puedes usar n=8 bits para codificar esta dimensión.

Codificación de claves

Cuando configuras claves en el navegador, estas deben estar codificadas en hexadecimales. En los informes de resumen, las claves aparecerán en formato binario (y se denominarán buckets).

Nota: Por lo general, los datos hexadecimales tienen el prefijo 0x ("x" para hexadecimal). Por ejemplo, 0x19 es 19 en hexadecimal; eso es 25 en el decimal, no 19. Por lo general, los números binarios llevan el prefijo 0b ("b" para binarios). Por ejemplo, 0b11001 es 11001 en binario, es decir, 25 en decimal, no 11,001.

Establece dos piezas clave para una clave completa

Supongamos que usas una clave para hacer el seguimiento de las siguientes dimensiones:

• Campaign ID
• ID geográfico
• Categoría de producto

Si bien se conocen las dimensiones ID de campaña y ID geográfico cuando se publica el anuncio (tiempo de publicación de anuncios), la categoría de producto se conocerá a partir de un evento activador, cuando el usuario completa una conversión (horario de conversión).

En la práctica, esto significa que establecerás una clave en dos pasos:

1. Deberás configurar una parte de la clave (ID de campaña x ID geográfico) cuando se haga clic o se vea.
2. Establecerás la segunda parte de la clave, Categoría de producto, en el momento de la conversión.

Estas diferentes partes de las claves se denominan piezas clave.

Una clave se calcula tomando el XOR (^) de sus elementos clave.

Ejemplo:

• Pieza de clave del código fuente = 0x159
• Pieza de clave del activador = 0x400
• Clave = 0x159 ^ 0x400 = 0x559

Alinear las piezas clave

Con dos partes de clave de 64 bits extendidas a 128 bits con rellenos/desplazamientos de 64 bits bien ubicados (los dieciséis ceros), las piezas clave XOR equivalen a concatenarlos, lo que es más fácil de razonar y verificar:

• Pieza de clave del código fuente = 0xa7e297e7c8c8d0540000000000000000
• Pieza de clave del activador = 0x0000000000000000674fbe308a597271
• Clave =
  • 0xa7e297e7c8c8d0540000000000000000 ^ 0x0000000000000000674fbe308a597271 =
  • 0xa7e297e7c8c8d054674fbe308a597271

Varias claves por clic o vista en el anuncio

En la práctica, puedes establecer varias claves por evento de fuente de atribución (clic o vista del anuncio). Por ejemplo, puedes configurar lo siguiente:

• Una clave que realiza un seguimiento del ID geográfico x ID de la campaña.
• Otra clave para hacer un seguimiento del tipo de creatividad x el ID de la campaña.

Consulta la Estrategia B para obtener otro ejemplo.

Codifica dimensiones en claves

Cuando solicites informes de resumen, debes indicarle al servicio de agregación a qué métricas deseas acceder. Para ello, debes solicitar informes de resumen para un conjunto determinado de claves de agregación.

Los informes de resumen contienen pares {key, summary value} sin procesar, sin información adicional sobre la clave. Esto significa lo siguiente:

• Cuando configures claves a medida que el usuario ve un anuncio o hace clic en él y, luego, genera una conversión, debes establecer las claves de manera confiable en función de los valores de las dimensiones que representan.
• Cuando definas las claves para las que deseas solicitar informes de resumen, deberás generar de forma confiable o acceder en el momento a las mismas claves que las que configuraste cuando el usuario vio un anuncio o hizo clic en él y generó una conversión, según los valores de las dimensiones para las que deseas ver datos agregados.

Codifica dimensiones con mapas de estructura clave

Para codificar dimensiones en claves, puedes crear y mantener un mapa de estructura de claves con anticipación, una vez que definas tus claves (antes de la publicación de anuncios).

Un mapa de estructura clave representa cada una de tus dimensiones y su posición en la clave.

En la práctica, crear y mantener mapas de estructura clave significa que debes implementar y mantener la lógica del decodificador. Si buscas un método que no requiera que lo hagas, considera usar un enfoque basado en hash en su lugar.

Por ejemplo:

Supongamos que planea realizar un seguimiento de las compras y de los valores de compra de campañas, regiones geográficas y productos específicos.

La categoría de producto, el ID de ubicación geográfica y el ID de campaña deben ser dimensiones en tus claves. Además, debido a que deseas hacer un seguimiento de dos objetivos de medición diferentes (recuento de compras y valor de compra), debes agregar una dimensión dentro de tu clave que realice el seguimiento del tipo de clave. Esto te permitirá definir lo que representa en realidad el valor agregable cuando se reciben pares {key, aggregatable value} en los informes de resumen.

Con estos objetivos de medición, su clave tiene las siguientes dimensiones:

• Categoría de producto
• Tipo de objetivo de medición
• ID geográfico
• Campaign ID

Ahora, si observas cada dimensión, supongamos que para tu caso de uso necesitas hacer un seguimiento de lo siguiente:

• 29 categorías de productos diferentes.
• 8 regiones geográficas diferentes: América del Norte, América Central, América del Sur, Europa, África, Asia, Caribe y Oceanía.
• 16 campañas diferentes.

Esta es la cantidad de bits que necesitarías para codificar cada dimensión de tu clave:

• Categoría de producto: 5 bits (25 = 32 > 29).
• Tipo de objetivo de medición: 1 bit. El objetivo de medición es el recuento de compras o el valor de compra, lo que significa dos posibilidades distintas; por lo tanto, un bit es suficiente para almacenarlo.

• ID geográfico: 3 bits (23 = 8). También puedes definir un mapa de dimensiones para el ID geográfico para saber qué región geográfica representa cada valor binario. El mapa de dimensiones para tu dimensión de ID geográfico podría tener el siguiente aspecto:

  Valor binario en la clave	Ubicación geográfica
  000	Norteamérica
  001	América Central
  010	Sudamérica
  011	Europa
  100	África
  101	Asia
  110	Caribeño/a
  111	Oceanía

• ID de campaña: 4 bits (24 = 16)

Las claves que siguen esta estructura tendrían una longitud de 13 bits (5 + 1 + 3 + 4).

En este ejemplo, el mapa de estructura de claves para estas claves se vería de la siguiente manera:

El orden de las dimensiones dentro de la clave depende de ti.

Para ilustrar cómo las dimensiones conforman una estructura clave, usaremos una representación binaria, por lo que el ID de campaña (primeros bits) es el que se encuentra más a la derecha y la categoría de producto (últimos bits) es la que está más a la izquierda.

Dentro de cada dimensión, el bit más significativo (el que lleva el mayor valor numérico) es el bit más a la izquierda. El bit menos significativo, el que lleva el valor numérico más pequeño, es el bit que se encuentra más a la derecha.

Veamos cómo puedes usar un mapa de estructura de claves para decodificar una clave.

Tomemos 0b1100100111100 como una clave de ejemplo arbitraria y supongamos que tienes una manera de saber que esta clave sigue el mapa de estructura clave en la ilustración anterior.

Según el mapa de estructura clave, esta clave se decodificaría de la siguiente manera:

11001 0 011 1100

Por lo tanto, la clave 0b1100100111100 representa la cantidad de compras de la categoría de producto 25 para el ID de campaña 12 que se lanzó en Europa.

Codifica dimensiones con una función hash

En lugar de usar un mapa de estructura de claves, puedes usar una función hash para generar claves de forma dinámica y de forma coherente y confiable.

Esto funciona de la siguiente manera:

1. Selecciona un algoritmo de hash.
2. Cuando publiques anuncios, genera una cadena que incluya todas las dimensiones a las que quieres hacer un seguimiento y sus valores. Para generar la pieza de clave del lado del código fuente, genera un hash en esta cadena y considera agregar un sufijo de ceros de 64 bits para alinearla con la pieza de clave del activador y hacer que XOR sea más fácil de entender.
   • Pieza de clave del lado del código fuente
     = <Hash hexadecimal de 64 bits("COUNT, campaignID=12, geoID=7"))><64 bits 00000000...>
   • Ten en cuenta que COUNT codifica lo mismo que MeasurementGoalType=0 en el enfoque de mapa de estructura clave. COUNT es un poco más eficiente y explícito.
3. En el momento de la conversión, genera una cadena que incluya todas las dimensiones de las que deseas hacer un seguimiento y sus valores. Para generar una pieza de clave del activador, genera un hash de esta string y agrega un prefijo de ceros de 64 bits:
   • Pieza de clave del activador = <64 bit 00000000...><Hash hexadecimal de 64 bits("productCategory=25")>
4. El navegador realiza XOR en estas piezas clave para generar una clave.
   • Clave de agregación de 128 bits
     = <Hash de la pieza de clave hexadecimal del lado del código fuente de 64 bits><Hash de la pieza de clave hexadecimal de 64 bits>
5. Más adelante, cuando tengas todo listo para solicitar un informe de resumen de esta clave, créalo sobre la marcha:
   • En función de las dimensiones que te interesen, genera una pieza de clave del lado del código fuente y otra del activador como lo hiciste anteriormente.
     • Pieza de clave del lado del código fuente
       = <Hash hexadecimal de 64 bits("COUNT, campaignID=12, geoID=7"))><64 bits 00000000...>
     • Pieza de clave del activador
       = <64 bits 00000000...><Hash hexadecimal de 64 bits("productCategory=25")>
     • pieza de clave del activador = toHex(hash("productCategory=25"))
   • Al igual que con el navegador, aplica XOR estas partes clave para generar la misma clave que el navegador generó anteriormente.
     • Clave de agregación de 128 bits
       = <Hash de la pieza de clave del lado del código fuente de 64 bits><Hash de la pieza de clave del lado del código fuente de 64 bits>

Estas son algunas sugerencias prácticas si utilizas este enfoque basado en hash:

• Usa siempre el mismo orden de las dimensiones. Esto garantiza que tus hash se puedan regenerar de manera confiable. ("COUNT, CampaignID=12, GeoID=7" no generará el mismo hash que "COUNT, GeoID=7, CampaignID=12"). Una forma sencilla de lograrlo es ordenar las dimensiones de manera alfanumérica. Esto es lo que haremos en el ejemplo, excepto por el hecho de que siempre haremos que COUNT o VALUE sea el primer elemento de la dimensión. Esta es una opción para facilitar la lectura, ya que COUNT o VALUE codifica información que es conceptualmente ligeramente diferente a todas las demás dimensiones.
• Realiza un seguimiento del conjunto de dimensiones que usas en las claves. Quieres evitar generar claves basadas en un conjunto de dimensiones que nunca utilizaste.
• Las colisiones de hash son poco frecuentes si se usa una función hash adecuada, pero la comprobación de los hashes usados anteriormente (que deben almacenarse para interpretar los resultados del servicio de agregación) puede evitar la introducción de claves nuevas que entran en conflicto con las claves más antiguas.

Consulta cómo usar claves basadas en hash en la práctica en el ejemplo de una conversión por clic o vista.

Valores agregables en la práctica

La empresa de tecnología publicitaria establece valores agregables cuando un usuario genera una conversión.

Para proteger la privacidad del usuario, las contribuciones de cada usuario tienen un límite superior. En todos los valores agregables asociados a una sola fuente (clic o vista del anuncio), ningún valor puede superar un límite de contribución determinado.

Nos referiremos a este límite como CONTRIBUTION_BUDGET. En la explicación, este límite se denomina presupuesto L1, pero es el mismo que el CONTRIBUTION_BUDGET.

Para obtener un análisis detallado del presupuesto de contribución, consulta Presupuesto de contribución para obtener informes de resumen.

Ejemplo: una conversión por clic o vista

Para este ejemplo, supongamos que deseas responder las siguientes preguntas:

• ¿Qué categorías de productos son las más valiosas en cada región?
• ¿Qué estrategias de campaña son las más eficaces en cada región?

Supongamos también que para tu caso de uso necesitas estadísticas semanales.

También debes realizar el seguimiento de lo siguiente:

• 16 campañas diferentes.
• 8 regiones geográficas diferentes: América del Norte, América Central, América del Sur, Europa, África, Asia, Caribe y Oceanía.
• 29 categorías de productos diferentes.

Qué se debe medir

Si bien muchas empresas de tecnología publicitaria recomiendan a los anunciantes configurar diversos tipos de conversión, centrarse en las conversiones más importantes, como las compras, es una buena manera de garantizar que los resultados agregados sean detallados y precisos para estos eventos de conversión importantes. De hecho, cuantas más métricas midas, menor será el presupuesto de contribución por métrica y, por lo tanto, más ruidoso puede ser cada valor. Por lo tanto, debes seleccionar cuidadosamente qué medir.

En este ejemplo, nos centraremos en las configuraciones de campañas que miden solo una conversión por clic o vista: una compra.

Aún podrás medir tanto el recuento de compras como el valor de compra y accederás a una variedad de estadísticas agregadas importantes, como el valor total de la compra y el desglose geográfico. Esto mantiene el ruido razonable y garantiza un enfoque de escalamiento simple para tu presupuesto de contribución.

¿Qué ocurre con las monedas?

Si publicas campañas en diferentes regiones, debes tener en cuenta las monedas. Intenta hacer lo siguiente:

• Haz que la moneda sea una dimensión dedicada en las claves de agregación.
• También puedes inferir la moneda a partir del ID de una campaña y convertir todas las monedas a una de referencia.

En este ejemplo, supondremos que puedes inferir la moneda a partir de un ID de campaña. Esto te permite convertir cualquier valor de compra de la moneda local del usuario a la moneda de referencia que elijas. También puedes realizar esa conversión sobre la marcha, cuando el usuario compre un artículo.

Con esta técnica, todos los valores agregables están en la misma moneda de referencia y, por lo tanto, se pueden sumar para generar un valor total de compra agregado (un valor de compra resumido).

Convierte los objetivos en claves

Con tus objetivos y métricas de medición, tienes varias opciones para tu estrategia clave. Enfoquémonos en dos de estas estrategias:

• Estrategia A: una estructura clave detallada
• Estrategia B: dos estructuras de claves comunes.

Estrategia A: un árbol profundo (una estructura clave detallada)

En la estrategia A, utilizas una estructura clave detallada, que incluye todas las dimensiones que necesitas:

Todas tus claves usan esta estructura.

Debes dividir esta estructura clave en dos tipos clave para admitir dos objetivos de medición.

• Tipo de clave 0: tipo de objetivo de medición = 0, que decides definir como un recuento de compras.
• Tipo de clave 1: tipo de objetivo de medición = 1, que decides definir como valor de compra.

Los informes de resumen se ven de la siguiente manera:

Puedes considerar la estrategia A como una estrategia de “árbol profundo”:

• Cada valor de resumen en los informes de resumen se asocia a todas las dimensiones a las que les realizas un seguimiento.
• Puedes combinar estos valores de resumen junto con cada una de estas dimensiones, de manera que los resúmenes puedan abarcar tanto la cantidad de dimensiones que tengas.

Con la estrategia A, responderías tus preguntas de la siguiente manera:

Pregunta	Respuesta
¿Qué categorías de productos son las más valiosas en cada región?	Suma los recuentos de compras y los valores resumidos que están en los informes de resumen, en todas las campañas. Indica el recuento y el valor de compras por ID de ubicación geográfica × categoría de producto. Para cada región, compara el valor de compra y la cantidad de diferentes categorías de producto.
¿Qué estrategias de campaña son las más eficaces en cada región?	Suma los recuentos de compras y los valores resumidos que están en los informes de resumen, en todas las categorías de productos. Esto te proporciona el recuento y el valor de las compras por ID de campaña x ID de ubicación geográfica. En cada región, compara el valor de compra y el recuento para distintas campañas.

Con la estrategia A, también puedes responder directamente esta tercera pregunta:

“¿Qué cantidad de ingresos por cada producto generó cada una de mis campañas en cada región geográfica?”.

Aunque los valores de resumen serán ruidosos, puedes determinar cuándo las diferencias en los valores medidos entre cada campaña no se deben solo al ruido. Obtén información para lograrlo en Información sobre el ruido.

Estrategia B: Dos árboles superficiales (dos estructuras de claves comunes)

En la estrategia B, usas dos estructuras de claves comunes, cada una de las cuales incluye un subconjunto de las dimensiones que necesitas:

Debes dividir cada una de estas estructuras de claves en dos tipos de claves para admitir dos objetivos de medición.

• Tipo de objetivo de medición = 0, que decides definir como un recuento de compras.
• Tipo de objetivo de medición = 1, que decides definir como un valor de compra.

El resultado es cuatro tipos de claves:

• Tipo de clave I-0: estructura clave I, recuento de compras.
• Tipo de clave I-1: estructura clave I, valor de compra
• Tipo de clave II-0: Estructura clave II, recuento de compras.
• Tipo de clave II-1: Estructura clave II, valor de compra

Los informes de resumen se ven de la siguiente manera:

Puedes considerar la estrategia B como una estrategia de “dos árboles superficiales”:

• Los valores de resumen en los informes de resumen se asignan a uno de dos conjuntos pequeños de dimensiones.
• Puedes fusionar estos valores de resumen junto con cada una de las dimensiones de estos conjuntos. Esto significa que los resúmenes no son tan profundos como en la opción A, ya que hay menos dimensiones con las que combinar.

Con la estrategia B, responderías tus preguntas de la siguiente manera:

Pregunta	Respuesta
¿Qué categorías de productos son las más valiosas en cada región?	Accede directamente a los recuentos y valores de compras resumidos que están en los informes de resumen.
¿Qué estrategias de campaña son las más eficaces en cada región?	Accede directamente a los recuentos y valores de compras resumidos que están en los informes de resumen.

Decisión: Estrategia A

La estrategia A es más simple; todos los datos siguen la misma estructura de clave, lo que significa que solo debes mantener una estructura clave.

Sin embargo, con la estrategia A, debes sumar los valores de resumen que recibes en los informes de resumen para responder algunas de tus preguntas. Cada uno de estos valores de resumen es ruidoso. Si sumas esos datos, también sumas el ruido.

Este no es el caso con la estrategia B, en la que los valores de resumen expuestos en los informes de resumen ya te proporcionan la información que necesitas. Esto significa que la estrategia B probablemente generará un impacto menor por el ruido que la estrategia A.

¿Cómo deberías determinar qué estrategia usar? En el caso de los anunciantes o las campañas existentes, puedes utilizar los datos históricos para determinar si el volumen de conversiones es más adecuado en la estrategia A o B. Sin embargo, en el caso de los anunciantes o las campañas nuevos, puedes decidir lo siguiente:

• Recopilar un mes de datos con las claves detalladas (estrategia A). Debido a que vas a extender la duración de la recopilación de datos, los valores del resumen serán más altos y el ruido será relativamente menor.
• Evalúa con una precisión razonable el recuento de conversiones y el valor de compra semanales.

Nota: No confíes en los recuentos de informes ni en los datos disponibles solo a través de los informes de depuración como fuente de información en tus diseños. En el futuro, cambiarán los datos disponibles en los informes de depuración y se generarán informes ruidosos junto con informes reales, por lo que estos indicadores solo deben usarse para validar tu estrategia de implementación y prueba.

En este ejemplo, supongamos que el recuento de compras semanales y el valor de compra son lo suficientemente altos como para que la estrategia A genere un porcentaje de ruido que consideres aceptable para tu caso de uso.

Debido a que la estrategia A es más simple y genera un impacto de ruido que no afecta tu capacidad para tomar decisiones, decides usar la estrategia A.

Selecciona un algoritmo de hash

Decides adoptar un enfoque basado en hash para generar tus claves. Para ello, debes seleccionar un algoritmo de hash que admita ese enfoque.

Supongamos que seleccionaste SHA-256. También puedes usar un algoritmo más simple y menos seguro, como MD5.

En el navegador: Cómo establecer claves y valores

Ahora que elegiste una estructura de clave y un algoritmo de hash, está todo listo para que registres las claves y los valores cuando los usuarios hacen clic en los anuncios o los ven y, luego, generan una conversión.

A continuación, se muestra una descripción general de los encabezados que configurarás para registrar claves y valores en el navegador:

Establece las piezas clave del código fuente

Cuando un usuario haga clic en un anuncio o lo ve, configura las claves de agregación en el encabezado Attribution-Reporting-Register-Aggregatable-Source. En esta etapa, para cada clave, solo puedes configurar la parte de la clave, o pieza de clave, que se conoce al momento de la publicación de anuncios.

Generemos los componentes clave:

Pieza de clave del lado del código fuente para el ID de clave...	Cadena que contiene los valores de dimensión que quieres establecer	Hash de esta cadena como hexadecimal, cortado a los primeros 64 bits (64/4 = 16 caracteres^1)	Hash hexadecimal con ceros agregados para simplificar el proceso de XOR. Esta es la pieza de clave del lado del código fuente.
key_purchaseCount	CONTAR, ID de campaña=12, ID geográfico=7	0x3cf867903fbb73ec	0x3cf867903fbb73ec0000000000000000
key_purchaseValue	VALOR, ID de campaña=12, ID geográfico=7	0x245265f432f16e73	0x245265f432f16e730000000000000000

¹Cada dígito hexadecimal representa cuatro bits (dígitos binarios).

Ahora establezcamos los componentes clave:

// Upon receiving the request from the publisher site
res.set(
  "Attribution-Reporting-Register-Aggregatable-Source",
  JSON.stringify(
   [{
    "id": "key_purchaseCount", 
    "key_piece": "0x3cf867903fbb73ec0000000000000000"
    }, {
    "id": "key_purchaseValue", 
    "key_piece": "0x245265f432f16e730000000000000000"
    }]
))

Ten en cuenta que los IDs de clave no aparecerán en los informes finales. Solo se usan cuando se configuran claves en el navegador, de modo que las piezas de clave de la fuente y del activador puedan asignarse entre sí y combinarse en una clave completa.

Opcional: informes a nivel del evento

Si necesitas usar informes a nivel del evento junto con informes agregables, asegúrate de que, para una fuente determinada, los datos a nivel del evento (ID del evento de fuente y datos del activador) y la clave de agregación puedan coincidir.

Puedes usar ambos informes si, por ejemplo, planeas usar informes a nivel del evento para ejecutar modelos sobre qué tipos de anuncios tienden a generar la mayor cantidad de compras.

Un usuario genera una conversión.

Cuando un usuario genera una conversión, por lo general, se envía una solicitud de píxel al servidor de tecnología publicitaria. Cuando recibamos esta solicitud, ocurrirá lo siguiente:

• Establece las piezas clave de la conversión (lado del activador) para completar la clave. Deberás establecer estos elementos clave mediante el encabezado Attribution-Reporting-Register-Aggregatable-Trigger-Data.
• Establece el valor agregable para esa conversión a través del encabezado Attribution-Reporting-Register-Aggregatable-Values.

Establece las piezas de clave del lado del activador para completar la clave

Generemos los componentes clave:

Pieza de clave del activador para el ID de clave...	Cadena que contiene los valores de dimensión que quieres establecer	Hash de esta cadena como hexadecimal, cortado a los primeros 64 bits (64/4 = 16 caracteres^1)	Hash hexadecimal con ceros agregados para simplify el uso de XOR. Esta es la pieza de clave del lado del código fuente.
key_purchaseCount	Categoríadeproducto=25	0x1c7ce88c4904bbe2	0x0000000000000000f9e491fe37e55a0c
key_purchaseValue	(igual)	(igual)	(igual)

¹Cada dígito hexadecimal representa cuatro bits (dígitos binarios).

Ahora establezcamos los componentes clave:

// Upon receiving the pixel request from the advertiser site
res.set(
  "Attribution-Reporting-Register-Aggregatable-Trigger-Data",
  JSON.stringify(
    [
      // Each dictionary independently adds pieces to multiple source keys
      { "key_piece": "0x0000000000000000f9e491fe37e55a0c",
        "source_keys": ["key_purchaseCount", "key_purchaseValue"]}, 
    ]
))

Observa cómo agregas la misma pieza de clave a varias claves. Para ello, enumera varios IDs de clave en source_keys: la pieza de clave se agregará a ambas claves.

Configura valores agregables

Antes de establecer los valores agregables, debes escalarlos verticalmente para reducir el ruido.

Supongamos que se realizó una compra para el tipo de producto 25 por USD 52.

No los configurará directamente como valores agregables:

• key_purchaseCount: 1 conversión
• key_purchaseValue: USD 52

En cambio, antes de registrar estos valores agregables, debes escalarlos para minimizar el ruido.

Tienes dos objetivos en los que invertir tu presupuesto de contribución, por lo que puedes decidir dividirlo en dos.

En este caso, a cada objetivo se le asigna un máximo de CONTRIBUTION_BUDGET/2 (=65,536/2=32,768).

Supongamos que el valor de compra máximo para un solo usuario, según el historial de compras de todos los usuarios del sitio, es de USD 1,500. Puede haber valores atípicos, por ejemplo, muy pocos usuarios que gastaron más de esa suma, pero puedes decidir ignorarlos.

El factor de escala para el valor de compra debe ser el siguiente:

((CONTRIBUTION_BUDGET/2) / 1,500) = 32,768/1,500 = 21.8~ 22

Tu factor de escala para el recuento de compras es 32,768/1 = 32,768, ya que decidiste hacer un seguimiento de, como máximo, una compra por clic en el anuncio o vista (evento de fuente).

Ahora puedes configurar estos valores:

• key_purchaseCount: 1 × 32,768 = 32,768
• key_purchaseValue: 52*22 = 1,144

En la práctica, deberías establecerlas de la siguiente manera, utilizando el encabezado dedicado Attribution-Reporting-Register-Aggregatable-Values:

// Instruct the browser to schedule-send a report
res.set(
  "Attribution-Reporting-Register-Aggregatable-Values",
  JSON.stringify(
    {
  "key_purchaseCount": 32768,
  "key_purchaseValue": 1144,
    }
))

El informe agregable se genera

El navegador asocia la conversión a una vista o un clic anterior y genera un informe agregable, que incluye la carga útil encriptada junto a los metadatos del informe.

El siguiente es un ejemplo de los datos que se podrían encontrar en la carga útil del informe agregable, si fuera legible en texto simple:

[ {
  key: 0x3cf867903fbb73ecf9e491fe37e55a0c, // = source-side key piece XOR conversion-side key piece for the key key_purchaseCount 
  value: 32768 // the scaled value for 1 conversion, in the context of [CONTRIBUTION_BUDGET/2]
}, {
  key: 0x245265f432f16e73f9e491fe37e55a0c, // source-side key piece XOR conversion-side key piece for the key key_purchaseValue 
  value: 1144 // the scaled value for $52, in the context of [CONTRIBUTION_BUDGET/2] 
}]

Aquí, puedes ver dos contribuciones separadas en un solo informe agregable.

Cómo solicitar un informe de resumen

• Informes agregables por lotes. Sigue las sugerencias que se ofrecen en Agrupación en lotes.
• Genera las claves cuyos datos deseas ver. Por ejemplo, para ver los datos resumidos de COUNT (cantidad total de compras) y VALUE (valor total de la compra) para el ID de campaña 12 x ID geográfico 7 x categoría de producto 25:
  • Genera la pieza de clave del lado del código fuente, como lo hiciste cuando la configuraste en el navegador.
  • Genera la pieza de clave del lado del activador, como lo hiciste cuando la configuraste en el navegador.

Métrica que deseas solicitar^1	Pieza de clave del lado del código fuente	Pieza de clave del activador	Clave para solicitar al servicio de agregación^2
Recuento total de compras (COUNT)	0x3cf867903fbb73ec 0000000000000000	0x00000000000000 00f9e491fe37e55a0c	0x3cf867903fbb73 ecf9e491fe37e55a0c.
Valor total de compra (VALUE)	0x245265f432f16e73 0000000000000000	0x0000000000000000 f9e491fe37e55a0c	0x245265f432f16e73 f9e491fe37e55a0c

¹ Métrica que deseas solicitar (para el ID de campaña 12 x el ID de ubicación geográfica 7 x la categoría de producto 25). ²Clave para solicitar al servicio de agregación = Pieza de clave del lado del origen XOR Pieza de clave del activador.

• Solicita datos de resumen al servicio de agregación para estas claves.

Cómo controlar el informe de resumen

Por último, recibirás un informe de resumen similar al siguiente:

[
  {"bucket": "00111100111110000110011110010000001111111011101101110011111011001111100111100100100100011111111000110111111001010101101000001100", 
    "value": "2558500"}, 
  {"bucket": "00100100010100100110010111110100001100101111000101101110011100111111100111100100100100011111111000110111111001010101101000001100", 
    "value": "687060"}, 
… 
]

El primer bucket es la clave COUNT en binario. El segundo bucket es la clave VALUE en objeto binario. Ten en cuenta que, si bien las claves son heterogéneas (COUNT frente a VALUE), están incluidas en el mismo informe.

Nota: En la práctica, los informes de resumen están codificados de una manera que hace que los buckets y los valores se vean diferentes a los que acabas de ver (es decir, un bucket puede tener el siguiente aspecto: \u0000\u0000\x80\u0000). Bucket y value son strings de bytes. Aquí encontrarás un ejemplo.

Reduce la escala de los valores

• 2,558,500 se refiere a la cantidad de compras para esta clave, escalada por el factor de escala calculado con anterioridad. El factor de escala para el recuento de compras fue de 32,768. Divide 2,558,500 por el presupuesto de contribución del objetivo: 2,558,500/32,768 = 156.15 compras.
• 687,060 → 687,060/22 = valor de compra total de USD 31,230.

Como resultado, los informes de resumen te proporcionan las siguientes estadísticas:

Within the reporting time period, campaign #12
run in Europe drove about 156 purchases (± noise)
for the product category #25.

Within the reporting time period, campaign #12
run in Europe drove $31,230 of purchases (± noise)
for the product category #25.