Rotar creatividades de anuncios

Usar el almacenamiento compartido para determinar qué creatividad ve un usuario en los distintos sitios

La API de Shared Storage es una propuesta de Privacy Sandbox para el almacenamiento de uso general entre sitios, que admite muchos casos de uso posibles. Un ejemplo de este tipo es la rotación de creatividades, que está disponible para probar en Chrome 104.0.5086.0 y versiones posteriores.

Con la rotación de creatividades, puedes almacenar datos, como el ID de la creatividad, la cantidad de vistas y la interacción del usuario, para determinar qué creatividades ven los usuarios en los diferentes sitios.

Ejecutar un worklet de almacenamiento compartido para seleccionar una URL de una lista proporcionada, según los datos almacenados, y, luego, renderizar esa creatividad en un marco vallado. Se puede usar para seleccionar anuncios nuevos o algún otro tipo de contenido.

Probar la rotación de creatividades

Para experimentar con la rotación de creatividades con el almacenamiento compartido, confirme que usa Chrome 104.0.5086.0 o una versión posterior. Luego, habilita la marca Experimento de las APIs de anuncios de Privacy Sandbox en chrome://flags/#privacy-sandbox-ads-apis.

Habilita el experimento de las APIs de anuncios de Privacy Sandbox para poder usar estas APIs

También puedes habilitar el almacenamiento compartido con la marca --enable-features=PrivacySandboxAdsAPIsOverride,OverridePrivacySandboxSettingsLocalTesting,SharedStorageAPI,FencedFrames en la línea de comandos.

Experimenta con muestras de código

Es posible que un anunciante o un productor de contenido desee aplicar diferentes estrategias a una campaña y rotar el contenido o las creatividades para aumentar la eficacia. El almacenamiento compartido se puede usar para ejecutar diferentes estrategias de rotación, como la rotación secuencial y la distribuida uniformemente, en distintos sitios.

En este ejemplo:

  • creative-rotation.js está incorporado en un marco. Esta secuencia de comandos establece qué anuncios son los más importantes ( peso) y llama al worklet para determinar qué contenido se debe mostrar.
  • creative-rotation-worklet.js es el worklet de almacenamiento compartido que determina la distribución ponderada del contenido y devuelve los resultados que se deben mostrar.

creatividad-rotación.js

// Ad config with the URL of the content, a probability weight for rotation, and the clickthrough rate.
const DEMO_CONTENT_CONFIG = [
  {
    url: 'https://your-server.example/contents/content-1.html',
    weight: 0.7,
  },
  {
    url: 'https://your-server.example/contents/content-2.html',
    weight: 0.2,
  },
  {
    url: 'https://your-server.example/contents/content-3.html',
    weight: 0.1,
  },
];

// Set the mode to sequential and set the starting index to 0.
async function seedStorage() {
  await window.sharedStorage.set('content-rotation-mode', 'sequential', {
    ignoreIfPresent: true,
  });

  await window.sharedStorage.set('content-rotation-index', 0, {
    ignoreIfPresent: true,
  });
}

async function injectAd() {
  // Load the worklet module
  await window.sharedStorage.worklet.addModule('content-rotation-worklet.js');

  // Initially set the storage to sequential mode for the demo
  seedStorage();

  // Run the URL selection operation to determine the next content rendered.
  const urls = DEMO_CONTENT_CONFIG.map(({ url }) => ({ url }));
  const fencedFrameConfig = await window.sharedStorage.selectURL('content-rotation', urls, { 
    data: DEMO_CONTENT_CONFIG,
    resolveToConfig: true
  });

  // Render the opaque URL into a fenced frame
  document.getElementById('content-slot').config = fencedFrameConfig;
}

injectAd();

creative-rotation-worklet.js.

class SelectURLOperation {
  async run(urls, data) {
    // Read the rotation mode from Shared Storage
    const rotationMode = await this.sharedStorage.get('content-rotation-mode');

    // Generate a random number to be used for rotation
    const randomNumber = Math.random();

    let index;

    switch (rotationMode) {
      /**
       * Sequential rotation
       * - Rotates the contents in order
       * - Example: A -> B -> C -> A ...
       */
      case 'sequential':
        const currentIndex = await this.sharedStorage.get('creative-rotation-index');
        index = parseInt(currentIndex, 10);
        const nextIndex = (index + 1) % urls.length;

        await this.sharedStorage.set('content-rotation-index', nextIndex);
        break;

      /**
       * Weighted rotation
       * - Rotates the contentswith weighted probability
       * - Example: A=70% / B=20% / C=10%
       */
      case 'weighted-distribution':
        
        // Sum the weights cumulatively, and find the first URL where the
        // sum exceeds the random number. The array is sorted in
        // descending order first.
        let weightSum = 0;
        const { url } = data
          .sort((a, b) => b.weight - a.weight)
          .find(({ weight }) => {
            weightSum += weight;
            return weightSum > randomNumber;
          });

        index = urls.indexOf(url);
        break;

      default:
        index = 0;
    }
    return index;
  }
}

register('content-rotation', SelectURLOperation);

Casos de uso

Estos son solo algunos de los posibles casos de uso del almacenamiento compartido. Seguiremos agregando ejemplos a medida que recibimos comentarios y descubramos nuevos casos de uso.

Selección de contenido

Selecciona y muestra contenido diferente en distintos sitios web en marcos vallados según la información recopilada en el almacenamiento compartido. La puerta de salida para estos casos de uso es la selección de la URL.

  • Rotación de creatividades: Almacena datos, como el ID de la creatividad, la cantidad de vistas y la interacción de los usuarios, para determinar qué creatividades verán los usuarios en los diferentes sitios.
  • Pruebas A/B: Puedes asignar un usuario a un grupo experimental y, luego, almacenarlo en el almacenamiento compartido para que se pueda acceder a él entre sitios.
  • Experiencias del usuario personalizadas: Comparte contenido personalizado y llamados a la acción basados en el estado de registro de un usuario o en otros estados del usuario.

Genera informes de resumen

Recopila información con el almacenamiento compartido y genera un informe resumido y ruidoso. La puerta de salida para estos casos de uso es la API de agregación privada.

  • Medición de alcance único: Muchos productores y anunciantes de contenido quieren saber cuántas personas únicas vieron su contenido. Usa el almacenamiento compartido para registrar la primera vez que un usuario vio tu anuncio, video incorporado o publicación, y evita que ese mismo usuario se duplique en sitios diferentes. Luego, puedes usar la API de Private Aggregation para generar un informe de resumen de tu alcance.
  • Medición de datos demográficos: Los productores de contenido suelen querer comprender los datos demográficos de su público. Puedes usar el almacenamiento compartido para registrar datos demográficos de los usuarios en un contexto en el que los tengas, como tu sitio de origen, y usar informes agregados para generar informes sobre ellos en muchos otros sitios, como el contenido incorporado.
  • Medición de frecuencia K+: A veces se describe como "frecuencia efectiva", a menudo, hay una cantidad mínima de vistas antes de que un usuario reconozca o recuerde cierto contenido (a menudo, en el contexto de vistas de anuncios). Puedes usar el almacenamiento compartido para crear informes de usuarios únicos que hayan visto contenido al menos K veces.

Interactúa y comparte comentarios

La propuesta de almacenamiento compartido se encuentra en debate activo y sujeta a cambios en el futuro. Si pruebas esta API y tienes comentarios, nos encantaría recibirlos.