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

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

Qué son las claves de agregación, cómo se usan en la API de Attribution Reporting y cómo puedes traducir 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 por 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 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 del resumen 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.

Dimensiones

Para comprender cómo tus campañas generan ingresos, como se describe aquí, te recomendamos que realices 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: Es 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).

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

¿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 de servicios de agregación.

Una clave de agregación (clave, en resumen) es un dato que representa los valores de las dimensiones a las que se les hace un seguimiento. Luego, los datos se agregan en función de cada clave de agregación.

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

Cuando un usuario ubicado en el ID de geografía 7 ve un anuncio del ID de campaña 12 y, más tarde, genera una conversión comprando un producto de la categoría de producto 25, puedes establecer un valor de clave de agregación similar al de la siguiente imagen:

Más adelante, verás que una clave de agregación no se ve exactamente así en la práctica, pero por ahora, centrémonos en la información que contiene.

¿Qué son los valores agregables?

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

• Es la cantidad de compras (el recuento de compras). Una vez que se agrupen y estén disponibles en un informe de resumen, este será el recuento total de compras (valor de 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 que se puede agregar. Puedes considerar los valores agregables como los valores de tus objetivos de medición.

Cuando un usuario ubicado en el ID de geografía 7 ve un anuncio del ID de campaña 12 y, más tarde, genera 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:

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 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, más tarde, genera una conversión, le indicas al navegador que almacene un par {clave de agregación, valor agregable}.

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 {clave de agregación, valor agregable} no se ve exactamente así, pero por ahora, centré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 se codifican de una manera que hará que los buckets y los valores se vean diferentes a los del ejemplo anterior (es decir, un bucket puede verse como \u0000\u0000\x80\u0000). Bucket y value son cadenas de bytes.

Informes de resumen

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.
• El servicio de agregación desencripta los informes agregables.
• 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 {clave de agregación, valor de resumen}.

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 decimal de un objetivo de medición determinado, que se suma 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

Las empresas de tecnología publicitaria definen las claves de agregación (buckets), por lo general, en dos pasos: cuando se hace clic en un anuncio o se lo 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 codificadas 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.

En 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 pensar en 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 y tamaño de la dimensión

El tamaño máximo de la clave se define en bits, la cantidad 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 ruidosos. Puedes obtener más información sobre el ruido en Comprende el ruido.

Como se mencionó anteriormente, las dimensiones se codifican en la clave de agregación. Cada dimensión tiene una cardinalidad determinada, es decir, la cantidad de valores distintos que puede tomar. Según su cardinalidad, cada dimensión debe estar representada por una cantidad determinada 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).

Establece dos partes de la clave para obtener 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 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 del producto se conocerá a partir de un evento activador, cuando el usuario complete una conversión (tiempo de conversión).

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

1. Establecerás una parte de la clave (ID de campaña × ID de geografía) en el momento del clic o de la vista.
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 fragmentos de clave.

Para calcular una clave, se toma el O (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 partes de clave de 64 bits extendidas a 128 bits con rellenos o compensaciones de 64 bits colocados con cuidado (los dieciséis ceros), la operación OR de las partes de clave equivale 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 establecer varias claves por evento de fuente de atribución (clic o vista del anuncio). Por ejemplo, puedes establecer lo siguiente:

• Es 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 × el 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 {clave, valor de resumen} 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 o acceder de forma confiable a las mismas claves que se establecieron 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.

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, cuando definas tus claves (antes del tiempo 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 de campañas, regiones geográficas y productos específicos.

La categoría de producto, el ID de geografía y el ID de campaña deben ser dimensiones en tus claves. Además, como deseas realizar un seguimiento de dos objetivos de medición diferentes (cantidad de compras y valor de compra), debes agregar una dimensión dentro de tu clave que haga 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

Ahora, si analizamos 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: 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 de compras o el valor de compra, lo que significa dos posibilidades distintas. Por lo tanto, un bit es suficiente para almacenarlo.

• ID de geografía: 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 de clave, usaremos una representación binaria, por lo que el ID de la campaña (primeros bits) es el más a la derecha y la categoría de producto (últimos bits) es la más a la izquierda.

Dentro de cada dimensión, el bit más significativo (el que tiene el mayor valor numérico) es el bit más a la izquierda. El bit menos significativo (el que tiene el valor numérico más bajo) 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 lanzado en Europa.

Codificación de dimensiones con una función hash

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

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 de las que deseas hacer un seguimiento y sus valores. Para generar la parte de clave del lado 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 lado del activador y facilitar el razonamiento sobre el O.
   • Pieza clave del lado 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 del mapa de estructura de claves. 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 de 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 de esta clave, genéralo 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 clave del lado 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 sencilla de lograrlo es ordenar las dimensiones de forma alfanumérica. Esto es lo que haremos en el ejemplo, excepto que siempre haremos que COUNT o VALUE sea el primer elemento de la dimensión. Esta es una opción para mejorar la legibilidad, ya que COUNT o VALUE codifican información que es conceptualmente un poco diferente de todas las demás dimensiones.
• Haz un seguimiento del conjunto de dimensiones que usas 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 de hash adecuada, pero la verificación en comparación con los hashes utilizados anteriormente (que deben almacenarse para interpretar los resultados del servicio de agregación) puede evitar la introducción de claves nuevas que colisionen con claves anteriores.

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

Para proteger la privacidad del usuario, las contribuciones de cada usuario tienen un límite superior. Entre todos los valores agregables asociados con una sola fuente (clic o vista de 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 de L1, pero es igual que 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

En 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 las 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 cuidadosamente 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.

Seguirás midiendo el recuento de compras y el valor de las compras, y accederás a una variedad de estadísticas globales importantes, como el valor total de las compras 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?

Ejecutar 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, suponemos 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).

Traduce 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 de claves detallada.
• Estrategia B: Dos estructuras de claves gruesas

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: El tipo de objetivo de medición = 0, que decides definir como un registro 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 tienen el siguiente aspecto:

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:

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?"

Aunque los valores del resumen tendrán ruido, puedes determinar cuándo las diferencias en el valor medido entre cada campaña no se deben solo al ruido. Obtén 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, usas dos estructuras de claves generales, cada una de las cuales incluye 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 tienen el siguiente aspecto:

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

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

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

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 es ruidoso. 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 los anunciantes o las campañas 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 precisión razonable el recuento de conversiones semanales y el valor de las compras.

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 del anuncio.

Generemos los elementos clave:

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 puedan coincidir.

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. Cuando recibamos esta solicitud, ocurrirá lo siguiente:

• Establece los fragmentos de clave del lado de la conversión (del activador) para completar la clave. Establecerás estos elementos clave a través del 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 activador para completar la clave

Generemos los elementos clave:

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"]
    },
  ])
);

Ten en cuenta que agregas la misma parte de clave a varias claves enumerando varios IDs de clave en source_keys. La parte de clave se agregará a ambas claves.

Establece 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 ajustarlos para minimizar el ruido.

Tienes dos objetivos para invertir tu presupuesto de contribución, por lo que podrías 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 máximo de compra de 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 hacer un seguimiento de, como máximo, una compra por clic o vista de anuncio (evento de origen).

Ahora puedes establecer estos valores:

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

En la práctica, los configurarías 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,
  })
);

Se genera el informe agregable

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 en la carga útil del informe agregable, si se pudiera 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 de resumen

• 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 parte de la clave del activador, como lo hiciste cuando la configuraste en el navegador.

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

Controla el informe de resumen

En última instancia, recibirás un informe de resumen que podría verse de la siguiente manera:

[
  {"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.

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 escalamiento 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.