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 los objetivos en claves.

Como empresa de tecnología publicitaria que publica campañas en varias ubicaciones para varias 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 para cada categoría de producto generó cada una de mis campañas en cada región geográfica?

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

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

Dimensiones, claves y valores

Para responder estas preguntas, analicemos 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 sus campañas generan ingresos, tal como se describe aquí, le recomendamos que realice un seguimiento de las siguientes dimensiones:

• ID de la campaña publicitaria: Es el identificador de la campaña específica.
• ID de geografía: Es la región geográfica en la que se publicó el anuncio.
• Categoría de producto: El tipo de producto tal como lo definiste.

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

Nota: En el diagrama de este documento, mostraremos las dimensiones de la siguiente manera:

• Dimensiones conocidas al momento de la publicación de anuncios sobre un fondo verde.
• Dimensiones conocidas en el momento de la conversión con un fondo amarillo y subrayadas.

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

Dimensiones de seguimiento

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

Los términos clave de agregación y bucket se refieren a lo mismo. La clave de agregación se usa en las APIs del navegador que se usan para configurar 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 a las que se les hace un seguimiento. Luego, los datos se agregan junto con cada clave de agregación.

Por ejemplo, supongamos que haces un seguimiento de las dimensiones Product category, Geography ID y Campaign ID.

Cuando un usuario ubicado en el ID de ubicación geográfica 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, puedes establecer una clave de agregación similar a la que se muestra en la siguiente imagen:

Más adelante, verás que una clave de agregación no se ve exactamente como esta en la práctica, pero, por ahora, enfoquémonos en la información contenida en 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 que se agreguen y estén disponibles en un informe de resumen, este será el recuento total de compras (valor del resumen).
• Los ingresos de cada compra (el valor de compra). Una vez que se agreguen y estén disponibles en un informe de resumen, estos serán los ingresos totales (valor del resumen).

Cada uno de ellos (el recuento de compras de una conversión y el valor de compra de una conversión) es un valor agregable. Puedes pensar en 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ánto ingresos…	Valor de compra

Cuando un usuario ubicado en el ID de geografía 7 ve un anuncio del ID de campaña 12 y, más tarde, 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 un valor de agregación y valores agregables que se vean de la siguiente manera:

Clave de agregación 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 en 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 según tus objetivos de medición.

Ten en cuenta que este diagrama omite la desencriptación y representa un ejemplo simplificado sin aplicar ruido. 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 ve un anuncio o hace clic en él, y luego genera una conversión, usted le indica al navegador que almacene un par {aggregation key, aggregatable value}.

Nota: En la explicación, un par de {clave de agregación, valor agregable} también se denomina contribución de histograma, ya que representa cómo esta conversión (y las dimensiones y valores asociados con ella) contribuyen 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 objetivo de medición).

Más adelante, verás que un informe agregable {aggregation key, aggregatable value} no se ve exactamente igual, pero, por ahora, enfoquémonos en la información que contiene el informe.

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

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 en un informe agregable.

Los informes agregables tienen formato JSON y, entre otros elementos, incluyen un campo de carga útil que se usará 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 {clave de agregación, valor agregable}:

• bucket: Es la clave de agregación, codificada como una cadena de bytes.
• value: Es 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 hará que los buckets y los valores se vean diferentes que en el ejemplo anterior (es decir, un bucket puede verse como \u0000\u0000\x80\u0000). Bucket y value son cadenas de bytes.

Resumen de informes

Los informes agregables se agrupan en 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 con el servicio de agregación.
• Para cada clave, se suman los valores agregables de los informes agregables.
• Se agrega ruido al valor del resumen.

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

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

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

Ejemplo:

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

En la práctica, los informes de resumen se codifican de una manera que hará que los buckets y los valores se vean diferentes de lo que se indica en el ejemplo (es decir, un bucket puede verse como \u0000\u0000\x80\u0000). Bucket y value son cadenas de bytes.

Claves de agregación en la práctica

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

Estructura de claves

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

Por ejemplo, ID de campaña × ID geográfico × 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, hemos visto que los valores agregables pueden hacer un seguimiento de diferentes objetivos de medición, como un valor de compra o un recuento de compras. Debes asegurarte de que el servicio de agregación sume valores agregables del mismo tipo.

Para ello, dentro de cada clave, codifica un dato que te indique qué 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.

Si usamos nuestro 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 por ubicación geográfica".

Tamaño de la clave, tamaño de la dimensión

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

Este tamaño permite claves muy detalladas, pero es más probable que las claves más detalladas generen valores más contaminados. Puedes obtener más información sobre el ruido en Comprende el ruido.

Como se presentó antes, las dimensiones se codifican en la clave de agregación. Cada dimensión tiene una cierta cardinalidad, es decir, la cantidad de valores distintos que puede tomar. Según su cardinalidad, cada dimensión debe estar representada por una cierta cantidad de bits. Con n bits, es posible expresar 2ⁿ 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 2⁷ = 128 opciones distintas, que es menos de las 200 necesarias.

8 bits almacenarían 2⁸ = 256 opciones distintas, que son más de las 200 necesarias, por lo que puedes usar n = 8 bits para codificar esta dimensión.

Codificación de claves

Cuando configures claves en el navegador, estas deben estar codificadas en hexadecimal. En los informes de resumen, las claves aparecerán en formato binario (y se nombrarán como buckets).

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

Establece dos piezas de clave para una clave completa

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

• ID de la campaña
• ID de ubicación geográfica
• Categoría de producto

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

En la práctica, esto significa que debes configurar una clave en dos pasos:

1. Establecerá una parte de la clave (ID de campaña × ID geográfico) en el momento del clic o la vista.
2. Establecerás la segunda parte de la clave, la categoría de producto, en el momento de la conversión.

Estas diferentes partes de las claves se denominan piezas clave.

Para calcular una clave, se toma el OR (v) de sus partes clave.

Ejemplo:

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

Alineación de los elementos clave

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

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

Varias claves por clic o vista de anuncio

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

• Una clave que realiza un seguimiento del ID de geografía × ID de campaña
• Otra clave que realiza un seguimiento del tipo de creatividad × ID de la campaña

Consulta la Estrategia B para ver otro ejemplo.

Codificación de dimensiones en claves

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

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

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

Cómo codificar dimensiones con mapas de estructura de claves

Para codificar dimensiones en claves, puedes crear y mantener un mapa de estructura de claves con anticipación, después de definir tus claves (antes del momento de publicación de anuncios).

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

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

Por ejemplo:

Supongamos que planeas hacer un seguimiento de las compras y los valores de compra para 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 a tu clave que realice un seguimiento del tipo de clave. Esto te permitirá definir qué representa realmente el valor agregable cuando recibas pares {clave, valor agregable} en los informes de resumen.

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

• Categoría de producto
• Tipo de objetivo de medición
• ID de ubicación geográfica
• ID de la campaña

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

• 29 categorías de productos diferentes.
• 8 regiones geográficas diferentes: Norteamérica, Centroamérica, Sudamérica, Europa, África, Asia, el Caribe y Oceanía.
• 16 campañas diferentes.

Esta es la cantidad de bits que necesitas para codificar cada dimensión en tu clave:

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

• ID de ubicación geográfica: 3 bits (2³ = 8) También definirías un mapa de dimensiones para el ID de geografía para saber qué región geográfica representa cada valor binario. Tu mapa de dimensiones para la dimensión ID geográfico podría verse de la siguiente manera:

  Valor binario en la clave	Geografía
  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 la campaña: 4 bits (2⁴ = 16)

Las claves que siguen esta estructura tendrían 13 bits de longitud (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 la 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 se encuentra más a la izquierda.

Dentro de cada dimensión, el bit más significativo (el que tiene el valor numérico más alto) 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 más a la derecha.

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

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

Según el mapa de estructura de claves, 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 dinámicamente, de manera coherente y confiable.

Esto funciona de la siguiente manera:

1. Selecciona un algoritmo de hash.
2. En el momento de la publicación de anuncios, genera una cadena que incluya todas las dimensiones a las que deseas hacer un seguimiento y sus valores. Para generar la parte de clave del código fuente, cifra esta cadena y considera agregar un sufijo de 64 bits de ceros para alinearlo con la parte de clave del activador y facilitar el razonamiento sobre el O.
   • Pieza de clave del código fuente
     = <64-bit hex hash("COUNT, campaignID=12, geoID=7"))><64-bit 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 ágil y explícito.
3. En el momento de la conversión, genera una cadena que incluya todas las dimensiones a las que deseas hacer un seguimiento y sus valores. Para generar un fragmento de clave del activador, hashea esta cadena y agrega un prefijo de ceros de 64 bits:
   • Pieza de clave del activador = <64-bit 00000000…><64-bit hex hash("productCategory=25")>
4. El navegador OR estos elementos clave para generar una clave.
   • Clave de agregación de 128 bits
     = <64-bit hex source-side key piece hash><64-bit hex source-side key piece hash>
5. Más adelante, cuando tengas todo listo para solicitar un informe de resumen para esta clave, genera la clave sobre la marcha:
   • Según las dimensiones que te interesan, genera una clave del lado del activador y del lado de la fuente como lo hiciste antes.
     • Pieza de clave del código fuente
       = <64-bit hex hash("COUNT, campaignID=12, geoID=7"))><64-bit 00000000…>
     • Pieza de clave del activador
       = <64-bit 00000000…><64-bit hex hash("productCategory=25")>
     • Pieza de clave del activador = toHex(hash("productCategory=25"))
   • Al igual que el navegador, O estos fragmentos de clave para generar la misma clave que el navegador generó antes.
     • Clave de agregación de 128 bits
       = <64-bit source-side key piece hash><64-bit source-side key piece hash>

A continuación, se incluyen algunas sugerencias prácticas si usas este enfoque basado en hash:

• Usa siempre el mismo orden de las dimensiones. Esto garantiza que tus valores hash se puedan volver a generar de forma confiable. ("COUNT, CampaignID=12, GeoID=7" no generará el mismo hash que "COUNT, GeoID=7, CampaignID=12"). Una forma directa de lograrlo es ordenar las dimensiones de forma 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. Se trata de una opción para facilitar la lectura, ya que COUNT o VALUE codifican información conceptualmente diferente de todas las demás dimensiones.
• Haz un seguimiento del conjunto de dimensiones que utilizas en las claves. Evita generar claves basadas en un conjunto de dimensiones que nunca usaste.
• Las colisiones de hash son poco frecuentes si se usa una función hash adecuada, pero verificar los hash usados anteriormente (que deberían almacenarse para interpretar los resultados del servicio de agregación) puede evitar la incorporación de claves nuevas que entran en conflicto con las claves más antiguas.

Descubre 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 realiza una conversión.

Para proteger la privacidad del usuario, las contribuciones de cada usuario tienen un límite superior. En todos los valores agregables que se asocian a una sola fuente (clic o vista del anuncio), ningún valor puede ser superior a 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 igual al CONTRIBUTION_BUDGET.

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

Ejemplo: una conversión por clic o vista

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

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

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

También debes hacer un seguimiento de lo siguiente:

• 16 campañas diferentes.
• 8 regiones geográficas diferentes: Norteamérica, Centroamérica, Sudamérica, Europa, África, Asia, el Caribe y Oceanía.
• 29 categorías de productos diferentes.

Qué se debe medir

Si bien muchas empresas de tecnología publicitaria animan a los anunciantes a configurar una variedad de tipos de conversiones, enfocarse 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á tu presupuesto de contribución por métrica y, por lo tanto, es probable que cada valor sea más ruidoso. Por lo tanto, debes seleccionar con cuidado qué medir.

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

Podrás medir tanto el recuento como el valor de compra, y accederás a una variedad de estadísticas agregadas importantes, como el valor total de compra y los desgloses geográficos. Esto mantiene el ruido en un nivel razonable y garantiza un enfoque de escalamiento simple para tu presupuesto de contribución.

¿Qué sucede con las monedas?

Publicar campañas en diferentes regiones implica que se deben tener en cuenta las monedas. Intenta realizar 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 de un ID de campaña y convertir todas las monedas a una moneda 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 determinado 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 compra 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 de compra total agregado (un valor de compra de resumen).

Convierte los objetivos en claves

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

• Estrategia A: Una estructura clave detallada.
• Estrategia B: dos estructuras clave generales.

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

En la estrategia A, usas una estructura de claves detallada que incluye todas las dimensiones que necesitas:

Todas tus claves usan esta estructura.

Dividiste esta estructura de claves en dos tipos de claves para admitir dos objetivos de medición.

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

Los informes de resumen se ven de la siguiente manera:

Puedes pensar en la estrategia A como una estrategia de "un árbol profundo":

• Cada valor de resumen en los informes de resumen está asociado a todas las dimensiones de las que realizas un seguimiento.
• Puedes consolidar estos valores de resumen junto con cada una de estas dimensiones, de modo que estos resúmenes puedan ser tan detallados como la cantidad de dimensiones que tengas.

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

Pregunta	Respuesta
¿Qué categorías de productos son las más valiosas en cada región?	Suma los recuentos y valores de compras de resumen que se encuentran en los informes de resumen de todas las campañas. Esto te brinda el recuento y el valor de las compras por ID geográfico × categoría de producto. Para cada región, compara el valor de compra y el recuento de las diferentes categorías de productos.
¿Qué estrategias de campaña son más eficaces en cada región?	Suma los recuentos y valores de compras de resumen que se encuentran en los informes de resumen en todas las categorías de productos. Obtén el recuento y el valor de compras por ID de campaña × ID de ubicación geográfica. Para cada región, compara el valor de compra y el recuento de las diferentes campañas.

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

"¿Cuántos ingresos por cada producto generó cada una de mis campañas en cada región geográfica?"

Si bien los valores de resumen serán ruidosos, puedes determinar cuándo las diferencias en el valor medido entre cada campaña no se deben solo a ruido. Obtén más información para hacerlo en Cómo comprender el ruido.

Estrategia B: dos árboles poco profundos (dos estructuras de claves gruesas)

En la estrategia B, se usan dos estructuras de clave generales, cada una con un subconjunto de las dimensiones que necesitas:

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

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

El resultado son cuatro tipos de claves:

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

Los informes de resumen se ven de la siguiente manera:

Puedes pensar en la estrategia B como una estrategia de "dos árboles poco profundos":

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

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 de resumen que se encuentran en los informes de resumen.
¿Qué estrategias de campaña son más eficaces en cada región?	Accede directamente a los recuentos y valores de compras de resumen que se encuentran en los informes de resumen.

Decisión: Estrategia A

La estrategia A es más simple, ya que todos los datos siguen la misma estructura de claves, lo que también significa que solo tienes una estructura de claves para mantener.

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 tiene ruido. Cuando sumas esos datos, también sumas el ruido.

No es el caso de la estrategia B, en la que los valores de resumen que se muestran en los informes de resumen ya te brindan la información que necesitas. Esto significa que es probable que la estrategia B genere un menor impacto del ruido que la estrategia A.

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

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

Nota: No confíes en los recuentos de informes ni en los datos disponibles solo a través de informes de depuración como fuente de confianza en tus diseños. En el futuro, cambiarán los datos disponibles en los informes de depuración, y los informes contaminados se generarán 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.

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

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, establece claves y valores

Ahora que decidiste una estructura de claves y un algoritmo de hash, ya puedes registrar claves y valores cuando los usuarios hagan clic en los anuncios o los vean y, luego, generen conversiones.

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

Establece elementos clave del lado del código fuente

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

Generemos las piezas clave:

Pieza de clave del lado de la fuente para el ID de clave…	Es la cadena que contiene los valores de dimensión que deseas establecer.	Hash de esta string como hexadecimal, recortado a los primeros 64 bits (64/4 = 16 caracteres^1)	Hash hexadecimal con ceros agregados para simplificar la operación OR. Esta es la pieza clave del lado del código fuente.
key_purchaseCount	COUNT, CampaignID=12, GeoID=7	0x3cf867903fbb73ec	0x3cf867903fbb73ec00000000000000000
key_purchaseValue	VALUE, CampaignID=12, GeoID=7	0x245265f432f16e73	0x245265f432f16e730000000000000000

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

Ahora, configuremos los elementos 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 los fragmentos de claves del lado del activador y del lado de la fuente se puedan asignar 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 la fuente y datos del activador) y la clave de agregación coincidan.

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

Un usuario genera una conversión.

Cuando un usuario realiza una conversión, por lo general, se envía una solicitud de píxel al servidor de tecnología publicitaria. Una vez recibida esta solicitud, sucederá lo siguiente:

• Coloca las piezas clave de la conversión (la parte del activador) para completar la clave. Deberás establecer estas partes 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 piezas de claves del activador para completar la clave.

Generemos los elementos clave:

Pieza de clave del activador para el ID de clave...	Es la cadena que contiene los valores de dimensión que deseas establecer.	Hash de esta string como hexadecimal, recortado a los primeros 64 bits (64/4 = 16 caracteres^1)	Hash hexadecimal con ceros agregados para simplificar el operador OR. Esta es la pieza clave del código fuente.
key_purchaseCount	ProductCategory=25	0x1c7ce88c4904bbe2	0x0000000000000000f9e491fe37e55a0c
key_purchaseValue	(igual)	(igual)	(igual)

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

Ahora, configuremos los elementos 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 distintas claves con una lista de varios IDs de clave en source_keys (la pieza se agregará a ambas claves).

Configura valores agregables

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

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

No los establecerás 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 el presupuesto de contribución, por lo que puedes decidir dividir el presupuesto de contribución 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 escalamiento para el recuento de compras es 32,768/1 = 32,768, ya que decidiste realizar, como máximo, una compra por clic o vista en el anuncio (evento de fuente).

Ahora puedes establecer estos valores:

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

En la práctica, deberías configurarlos de la siguiente manera, con 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 hace coincidir la conversión con una vista o un clic anteriores y genera un informe agregable, que incluye la carga útil encriptada junto con los metadatos del informe.

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

[
  {
    key: 0x3cf867903fbb73ecf9e491fe37e55a0c, // = source-side key piece OR 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 OR 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.

Solicita un informe resumido

• Informes agregables por lotes. Sigue los consejos que se ofrecen en Ejecución por lotes.
• Genera las claves de las que deseas ver los datos. Por ejemplo, para ver los datos de resumen de COUNT (cantidad total de compras) y VALUE (valor total de compras) para el ID de campaña 12 × ID de geografía 7 × Categoría de producto 25:
  • Genera la parte de clave del lado del código fuente, como lo hiciste cuando la configuraste en el navegador.
  • Genera la pieza de clave del activador, como lo hiciste cuando la configuraste en el navegador.

Métrica que deseas solicitar^1	Pieza clave del código fuente	Pieza de clave del activador	Clave para solicitar al servicio de agregación^2
Cantidad 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 × ID de ubicación geográfica 7 × Categoría de producto 25). ² Clave para solicitar al servicio de agregación = Pieza de clave del lado del origen O Pieza de la clave del activador.

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

Cómo controlar el informe de resumen

En última instancia, recibirás un informe resumido que puede ser así:

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

El primer bucket es la clave COUNT en formato binario. El segundo bucket es la clave VALUE en formato binario. Ten en cuenta que, si bien las claves son heterogéneas (COUNT en comparación con VALUE), se incluyen en el mismo informe.

Nota: En la práctica, los informes de resumen se codifican de una manera que hace que los buckets y los valores se vean diferentes de lo que acabas de ver (es decir, un bucket puede parecerse a \u0000\u0000\x80\u0000). Bucket y value son cadenas de bytes. Puedes encontrar un ejemplo aquí.

Reduce la escala de los valores

• 2,558,500 hace referencia a la cantidad de compras de esta clave, ajustada según el factor de escalamiento que calculaste anteriormente. 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 = USD 31,230 de valor total de compras.

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
  ```

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