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

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

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

Si bien muchas empresas de tecnología publicitaria alientan 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 verificar 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 recopilar los datos.

Dimensiones, claves y valores

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

Dimensiones

Para comprender cómo tus campañas generan ingresos, como se describe aquí, deberás hacer 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 que definiste.

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

Las dimensiones que deseas hacer un seguimiento para este ejemplo 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 utilizan 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 (o simplemente clave) es un fragmento de datos que representa los valores de las dimensiones que se rastrean. Posteriormente, los datos se agregan según cada clave de agregación.

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

Cuando un usuario ubicado en la ubicación geográfica con el ID 7 ve un anuncio de la campaña con el ID 12 y, luego, realiza una conversión comprando un producto de la categoría de productos 25, puedes establecer una clave de agregación similar a la que se muestra en la siguiente imagen:

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

¿Qué son los valores agregables?

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

• Es 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 de resumen).
• Son los ingresos de cada compra (el valor de la compra). Una vez que se agreguen y estén disponibles en un informe de resumen, este será el ingreso total (valor de resumen).

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

Cuando un usuario ubicado en la ubicación geográfica con el ID 7 ve un anuncio de la campaña con el ID 12 y, luego, genera una conversión comprando un producto de la categoría de producto 25 por USD 120 (suponiendo que su moneda es el dólar estadounidense), puede establecer una clave de agregación y valores agregables como los siguientes:

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 sobre tus objetivos de medición.

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

Desde las claves y los valores hasta los 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 {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 de {clave de agregación, valor agregable} no se ve exactamente así, pero, por ahora, concentré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 correlacionar la conversión con una vista o un clic anterior).

Un informe agregable contiene lo siguiente:

• Las contribuciones que configuraste
• Son los 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 y, entre otras cosas, 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 manera 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). Tanto Bucket como value son cadenas de bytes.

Informes de resumen

Los informes agregables se agregan 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 en formato de 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 para un objetivo de medición determinado, que se suma de todos los informes agregables disponibles, con un nivel de ruido adicional.

Ejemplo:

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

En la práctica, los informes de resumen se codifican de manera 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). Tanto bucket como value son cadenas de bytes.

Claves de agregación en la práctica

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

Estructura de la clave

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, observamos que los valores agregables pueden hacer un seguimiento de diferentes objetivos de medición, como el valor de compra o el recuento de compras. Quieres verificar que el servicio de agregación sumará los valores agregables del mismo tipo.

Para ello, dentro de cada clave, codifica un fragmento de datos que te indique qué representa el valor de resumen, es decir, 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 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, que es la cantidad de ceros y unos en 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 Cómo comprender 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 la dimensión. Según su cardinalidad, cada dimensión debe representarse con 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, lo que es menos de las 200 necesarias.

8 bits almacenarían 2⁸ = 256 opciones distintas, que son más que 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, deben estar codificadas en hexadecimal. En los informes de resumen, las claves aparecerán en formato binario (y se denominarán buckets).

Cómo establecer dos piezas clave para una llave 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 geografía se conocen cuando se publica el anuncio (momento de publicación del anuncio), la categoría del producto se conocerá a partir de un evento de activación, cuando el usuario complete una conversión (momento de la 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 ubicación geográfica) 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 llaves se denominan piezas de la llave.

Una clave se calcula tomando el OR (v) de sus partes.

Ejemplo:

• Pieza clave del lado de la fuente = 0x159
• Pieza de clave del activador = 0x400
• Clave = 0x159 v 0x400 = 0x559

Alineación de las piezas clave

Con dos partes de clave de 64 bits extendidas a 128 bits con relleno o desplazamientos 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 de la fuente = 0xa7e297e7c8c8d0540000000000000000
• Pieza de clave del activador = 0x0000000000000000674fbe308a597271
• Clave = 0xa7e297e7c8c8d0540000000000000000 v 0x0000000000000000674fbe308a597271 = 0xa7e297e7c8c8d054674fbe308a597271

Varias claves por clic o vista del 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 hace un seguimiento de la combinación ID de geografía × ID de campaña.
• Otra clave que hace un seguimiento de la combinación de tipo de creatividad y el ID de la campaña.

Consulta la Estrategia B para ver otro ejemplo.

Cómo codificar dimensiones en claves

Cuando solicitas informes de resumen, debes indicarle al servicio de agregación a qué métricas deseas acceder. Para ello, solicita informes de resumen para un determinado conjunto 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 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 forma confiable según los valores de las dimensiones que representan.
• Cuando definas las claves para las que deseas solicitar informes de resumen, deberás generar o acceder de forma confiable y sobre la marcha a las mismas claves que se establecieron cuando el usuario vio o hizo clic en un anuncio 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 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 de campañas, regiones geográficas y productos específicos.

La categoría del producto, el ID de ubicación geográfica y el ID de la campaña deben ser dimensiones en tus claves. Además, como deseas hacer un seguimiento de dos objetivos de medición diferentes (la cantidad de compras y el valor de las compras), debes agregar una dimensión dentro de tu clave que haga un seguimiento del tipo de clave. Esto te permitirá definir lo que representa realmente el valor agregable cuando recibas pares {clave, valor agregable} en los informes de resumen.

Con estos objetivos de medición, tu llave 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, analicemos 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, el Caribe y Oceanía
• 16 campañas diferentes

Esta es la cantidad de bits que necesitarías 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 las compras, lo que significa que hay dos posibilidades distintas. Por lo tanto, un bit es suficiente para almacenar esta información.

• 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 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 mayor valor numérico) es el que se encuentra 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 usarías un mapa de estructura de claves para decodificar una clave.

Tomemos 0b1100100111100 como una clave de ejemplo arbitraria y supongamos que sabes 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.

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.

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 que deseas hacer un seguimiento y sus valores. Para generar la parte de la clave del lado de la fuente, genera un hash de esta cadena y considera agregar un sufijo de ceros de 64 bits para alinearlo con la parte de la clave del lado del activador y facilitar el razonamiento sobre OR.
   • Pieza clave del lado de la 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 de claves. COUNT es un poco más simple 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 parte de la clave del activador, genera un hash de esta cadena y agrega un prefijo de 64 bits de ceros:
   • Pieza de clave del lado del activador = <64-bit 00000000…><64-bit hex hash("productCategory=25")>
4. El navegador combina estas partes de la clave con el operador OR 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 quieras solicitar un informe de resumen para esta clave, genéralo sobre la marcha:
   • Según las dimensiones que te interesan, genera una clave del lado de la fuente y del activador como lo hiciste antes.
     • Pieza clave del lado de la fuente
       = <64-bit hex hash("COUNT, campaignID=12, geoID=7"))><64-bit 00000000…>
     • Pieza de clave del lado 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, combina estas partes clave con el operador OR 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 utilizas este enfoque basado en hash:

• Siempre usa el mismo orden de las dimensiones. Esto garantiza que tus hashes 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 lograr esto es ordenar las dimensiones alfanuméricamente. Esto es lo que haremos en el ejemplo, excepto que siempre haremos que COUNT o VALUE sean el primer elemento de la dimensión. Esta es una elecció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. Quieres evitar 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 hashes usados anteriormente (que se deben almacenar 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 las 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 asociados a una sola fuente (clic o vista del anuncio), ningún valor puede ser superior a un cierto límite de contribución.

Nos referiremos a este límite como CONTRIBUTION_BUDGET. En la explicación, este límite se denomina presupuesto de 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 informes de resumen.

Ejemplo: Una conversión por clic o vista

En 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 hacer un 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, el Caribe y Oceanía
• 29 categorías de productos diferentes

Qué se debe medir

Si bien muchas empresas de tecnología publicitaria alientan 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 verificar que los resultados agregados sean detallados y precisos para estos importantes eventos de conversión. De hecho, cuantas más métricas midas, menor será tu presupuesto de contribución por métrica y, por lo tanto, más ruidoso será cada valor. Por lo tanto, debes seleccionar con cuidado qué medir.

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

Seguirás midiendo la cantidad y el valor de las compras, y accederás a una variedad de estadísticas agregadas importantes, como el valor total de las compras y los desgloses geográficos. Esto administra el ruido de manera eficaz y, al mismo tiempo, confirma un método de ajuste directo 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 monedas 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 una moneda de referencia de tu elección. También puedes realizar esa conversión sobre la marcha, cuando el usuario compra un elemento.

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

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

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.

Dividirás 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 un 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 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 se asocia a todas las dimensiones de las que realizas un seguimiento.
• Puedes acumular estos valores de resumen junto con cada una de estas dimensiones, por lo que estas acumulaciones pueden ser tan detalladas como la cantidad de dimensiones que tengas.

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

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

"¿Cuántos ingresos generó cada uno de mis productos en 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 el valor medido entre cada campaña no se deben solo al ruido. Obtén más información para lograrlo en Cómo comprender el ruido.

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

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

Cada una de estas estructuras clave se divide en dos tipos clave 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.

Obtendrás 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 superficiales":

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

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

Decisión: Estrategia A

La estrategia A es más simple: 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. Si sumas esos datos, también sumas el ruido.

Este no es el caso de la estrategia B, en la que los valores de resumen expuestos en los informes de resumen ya te brindan la información que necesitas. Esto significa que la estrategia B probablemente generará un impacto menor 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 basarte en 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 decidir hacer lo siguiente:

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

En este ejemplo, supongamos que el recuento y el valor de las compras semanales 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 de 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 podrías 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, puedes registrar claves y valores cuando los usuarios hagan clic en los anuncios o los vean y, luego, generen una conversión.

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

Establece las piezas clave del lado de la 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 de clave, que se conoce en el momento de la publicación de anuncios.

Generemos las piezas clave:

Ahora, establezcamos las piezas 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 las claves no aparecerán en los informes finales. Solo se usan cuando se configuran claves en el navegador, de modo que las partes de la clave del lado de la fuente y del lado del activador se puedan correlacionar entre sí y combinar en una clave completa.

Opcional: Informes a nivel del evento

Si necesitas usar informes a nivel del evento junto con informes agregables, verifica 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 correlacionarse.

Por ejemplo, puedes usar ambos informes si planeas utilizar 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 realiza una conversión, generalmente se envía una solicitud de píxel al servidor de tecnología publicitaria. Cuando recibamos esta solicitud, ocurrirá lo siguiente:

• Establece las partes de la clave del lado de la conversión (del lado del activador) para completar la clave. Configurarás estas piezas clave con el encabezado Attribution-Reporting-Register-Aggregatable-Trigger-Data.
• Establece el valor agregable para esa conversión con el encabezado Attribution-Reporting-Register-Aggregatable-Values.

Configura las partes de la clave del lado del activador para completar la clave

Generemos las piezas clave:

Ahora, establezcamos las piezas 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 clave a varias claves, ya que enumeras varios IDs de clave en source_keys. La pieza clave se agregará a ambas claves.

Cómo establecer valores agregables

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

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

No establecerás estos valores 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 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 máximo de compra 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.

Tu factor de ajuste para el valor de compra debería ser el siguiente:

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

Tu factor de ajuste 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 del anuncio (evento fuente).

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 correlaciona la conversión con una vista o un clic anteriores y genera un informe agregable, que incluye la carga útil encriptada junto a los metadatos del informe.

A continuación, se muestra un ejemplo de los datos que se podrían encontrar en la carga útil del informe agregable, si se pudiera leer en texto no cifrado:

[
  {
    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 las sugerencias que se ofrecen en Procesamiento por lotes.
• Genera las claves para 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 las compras) para el ID de campaña 12 × ID de ubicación geográfica 7 × categoría de producto 25, haz lo siguiente:
  • Genera la parte de la clave del origen, 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.

Cómo controlar el informe de resumen

En última instancia, recibirás un informe de resumen que puede tener el siguiente aspecto:

[
  {"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 los valores

• El número 2,558,500 hace referencia a la cantidad de compras de esta clave, ajustada según el factor de ajuste que calculaste anteriormente. El factor de ajuste para el recuento de compras fue de 32,768. Divide 2,558,500 entre el presupuesto de contribución del objetivo: 2,558,500 USD/32,768 USD = 156.15 compras.
• 687,060 → 687,060/22 = USD 31,230 de valor total de compra.

Como resultado, los informes de resumen te brindan 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.