Creative-Rotation

Über den freigegebenen Speicher können Sie festlegen, welches Creative ein Nutzer auf verschiedenen Websites sieht.

Bei der Shared Storage API handelt es sich um eine Sandbox-Angebot für allgemeine Zwecke, websiteübergreifende Speicherung, die viele mögliche Anwendungsfälle. Ein solches Beispiel ist die Creative-Rotation, zum Testen in Chrome 104.0.5086.0 und höher.

Mit der Creative-Rotation können Sie Daten wie Creative-ID, Datenansicht und Nutzerinteraktionen, um zu ermitteln, für welche sehen in unterschiedlichen Websites.

Führen Sie ein Shared Storage-Worklet aus, um eine URL aus einer bereitgestellten Liste auszuwählen, basierend auf dem und das Creative dann in einem abgegrenzten Frame rendern. Dies kann verwendet werden, um neue Anzeigen oder andere Inhalte auszuwählen.

Creative-Rotation ausprobieren

Wenn Sie die Creative-Rotation mit freigegebenem Speicher testen möchten, prüfen Sie, ob Sie Chrome 104.0.5086.0 oder höher verwenden. Alle APIs zum Datenschutz bei Werbung unter chrome://settings/adPrivacy aktivieren.

Sie können freigegebenen Speicher auch mit dem Flag --enable-features=PrivacySandboxAdsAPIsOverride,OverridePrivacySandboxSettingsLocalTesting,SharedStorageAPI,FencedFrames in der Befehlszeile aktivieren.

Mit Codebeispielen experimentieren

Ein Werbetreibender oder Ersteller möchte vielleicht unterschiedliche Strategien und die Inhalte oder Creatives rotieren, um die Effektivität zu steigern. Mit dem freigegebenen Speicher lassen sich verschiedene Rotationsstrategien ausführen, z. B. sequenzielle Rotation und gleichmäßig verteilte Rotation über verschiedene Websites hinweg

In diesem Fall gilt Folgendes:

  • creative-rotation.js ist in einen Frame eingebettet. Dieses Skript legt fest, welche Anzeigen am wichtigsten sind ( Gewichtung), und ruft das Worklet auf, um zu bestimmen, welcher Inhalt angezeigt werden soll.
  • creative-rotation-worklet.js ist das freigegebene Speicher-Worklet, das die gewichtete Verteilung für die Inhalte bestimmt und die Ergebnisse zurückgibt, die angezeigt werden sollen.

creative-rotation.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 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 sharedStorage.get('creative-rotation-index');
        index = parseInt(currentIndex, 10);
        const nextIndex = (index + 1) % urls.length;

        await 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);

Anwendungsfälle

Dies sind nur einige der möglichen Anwendungsfälle für freigegebenen Speicher. Wir werden Wir fügen weitere Beispiele hinzu, Feedback erhalten und neue Anwendungsfälle zu entdecken.

Inhaltsauswahl

Auswählen und präsentieren unterschiedlichen Content auf verschiedenen Websites in Fenced Frames basierend auf Informationen im freigegebenen Speicher erfasst. Das Ausgabegate für diese Anwendungsfälle ist die URL-Auswahl.

  • Creative-Rotation: Daten wie Creative-ID, Anzahl der Aufrufe und Nutzerinteraktionen speichern, um zu ermitteln, welche Creative-Nutzer auf verschiedenen Websites sehen.
  • A/B-Tests: Sie können einen Nutzer einer Testgruppe zuweisen und diese Gruppe dann im freigegebenen Speicher speichern, damit sie websiteübergreifend darauf zugreifen kann.
  • Benutzerdefinierte Nutzererfahrung: Benutzerdefinierte Inhalte und Calls-to-Action basierend auf dem Registrierungsstatus eines Nutzers oder einem anderen Nutzerstatus teilen

Zusammenfassende Berichte erstellen

Sammeln Sie Informationen mit freigegebenem Speicher und erstellen Sie einen verrauschten, aggregierten Zusammenfassungsbericht. Das Ausgabegate für diese Anwendungsfälle ist das Private Aggregation API

  • Unique Reach-Messung: Viele Content-Ersteller und Werbetreibende möchten wissen, wie viele einzelne Menschen die Inhalte sahen. Mit freigegebenen Speicher den ersten Nutzer aufzeichnen Ihre Anzeige, Ihr eingebettetes Video oder Ihre Publikation gesehen haben und Duplikate vermeiden und Zählen desselben Nutzers auf verschiedenen Websites. Anschließend können Sie mit der Private Aggregation API einen zusammenfassenden Bericht über die Reichweite erstellen.
  • Analyse der demografischen Merkmale: Ersteller von Inhalten möchten oft die demografischen Merkmale ihrer Zielgruppe. Mit Shared Storage können Sie demografische Daten der Nutzer in einem Kontext, wie z. B. Ihre eigene Website, und verwenden Sie zusammengefasste und Berichterstellung für viele andere Websites, wie zum Beispiel eingebettete Inhalte.
  • Messung der Häufigkeit über T+: Manchmal auch als „effektive Häufigkeit“ bezeichnet, gibt es oft eine Mindestanzahl bevor die Nutzer bestimmte Inhalte erkennen oder sich daran erinnern. Kontext der Anzeigenaufrufe). Mit freigegebenem Speicher können Sie Berichte erstellen an einzelnen Nutzern, die einen Inhalt mindestens K-mal aufgerufen haben.

Interagieren und Feedback geben

Der Vorschlag für den freigegebenen Speicher wird derzeit diskutiert und kann sich ändern. . Wir würden uns freuen, wenn Sie diese API ausprobieren und uns Feedback geben.