Creative-Rotation

Verwenden Sie einen freigegebenen Speicher, um festzulegen, welches Creative ein Nutzer auf verschiedenen Websites sieht.

Die Shared Storage API ist eine Privacy Sandbox-Lösung für die allgemeine, websiteübergreifende Speicherung, die viele mögliche Anwendungsfälle unterstützt. Ein Beispiel hierfür ist die Creative-Rotation, die in Chrome 104.0.5086.0 und höher getestet werden kann.

Bei der Creative-Rotation können Sie Daten wie die Creative-ID, die Anzahl der Aufrufe und die Nutzerinteraktion speichern, um zu bestimmen, welche Creative-Nutzer auf den verschiedenen Websites zu sehen sind.

Führen Sie ein Worklet für freigegebenen Speicher aus, um anhand der gespeicherten Daten eine URL aus einer bereitgestellten Liste auszuwählen, und rendern Sie dann das Creative in einem Fenced Frame. Damit lassen sich neue Anzeigen oder andere Inhalte auswählen.

Creative-Rotation ausprobieren

Wenn Sie die Creative-Rotation mit freigegebenem Speicher testen möchten, müssen Sie Chrome 104.0.5086.0 oder höher verwenden. Aktivieren Sie dann unter chrome://flags/#privacy-sandbox-ads-apis das Flag für den Test der Privacy Sandbox Ads APIs.

Privacy Sandbox Ads APIs-Test aktivieren, um diese APIs zu verwenden

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

Mit Codebeispielen experimentieren

Ein Werbetreibender oder Content-Ersteller möchten möglicherweise unterschiedliche Strategien auf eine Kampagne anwenden und die Inhalte oder Creatives rotieren, um die Effektivität zu steigern. freigegebener Speicher kann verwendet werden, um verschiedene Rotationsstrategien, wie z. B. sequenzielle Rotation und gleichmäßig verteilte Rotation, über verschiedene Websites hinweg auszuführen.

In diesem Fall gilt Folgendes:

  • creative-rotation.js ist in einen Frame eingebettet. Dieses Skript legt fest, welche Anzeigen die wichtigsten ( Gewichtung) sind, und ruft das Worklet auf, um zu bestimmen, welcher Inhalt angezeigt werden soll.
  • creative-rotation-worklet.js ist das Worklet des freigegebenen Speichers, das die gewichtete Verteilung der Inhalte und Rückgaben bestimmt, 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 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);

Anwendungsfälle

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

Inhaltsauswahl

Wählen Sie anhand der im freigegebenen Speicher erfassten Informationen unterschiedliche Inhalte auf verschiedenen Websites in Fencing Frames aus. Das Ausgabegatter für diese Anwendungsfälle ist die URL-Auswahl.

  • Creative-Rotation: Daten wie die Creative-ID, die Anzahl der Aufrufe und die Nutzerinteraktion speichern, um zu bestimmen, welche Creative-Nutzer auf den verschiedenen Websites präsentiert werden.
  • A/B-Tests: Sie können einen Nutzer einer Testgruppe zuweisen und diese Gruppe dann im freigegebenen Speicher für den websiteübergreifenden Zugriff speichern.
  • Benutzerdefinierte Inhalte: Teilen Sie benutzerdefinierte Inhalte und Calls-to-Action basierend auf dem Registrierungsstatus eines Nutzers oder einem anderen Nutzerstatus.

Zusammenfassungsberichte erstellen

Sammeln Sie Informationen im freigegebenen Speicher und generieren Sie einen ungenauen, zusammenfassenden Bericht. Das Ausgabegatter für diese Anwendungsfälle ist die Private Aggregation API.

  • Unique Reach-Messung: Viele Ersteller und Werbetreibende von Content möchten wissen, wie viele einzelne Nutzer ihre Inhalte gesehen haben. Verwenden Sie den freigegebenen Speicher, um zu erfassen, wann ein Nutzer zum ersten Mal Ihre Anzeige, Ihr eingebettetes Video oder Ihre Publikation gesehen hat. So vermeiden Sie doppelte Zählungen desselben Nutzers auf verschiedenen Websites. Anschließend können Sie mit der Private Aggregation API einen zusammenfassenden Bericht für Ihre Reichweite ausgeben.
  • Messung demografischer Merkmale: Ersteller von Inhalten möchten oft die demografischen Merkmale ihrer Zuschauer ermitteln. Sie können den freigegebenen Speicher verwenden, um demografische Daten von Nutzern in einem Kontext zu erfassen, in dem sie verfügbar sind, z. B. auf Ihrer eigenen Website. Mithilfe von aggregierten Berichten können Sie über viele andere Websites Berichte dazu erstellen, beispielsweise für eingebettete Inhalte.
  • K+-Häufigkeitsmessung: Wird manchmal als „effektive Häufigkeit“ bezeichnet. Es gibt oft eine Mindestanzahl von Aufrufen, bevor ein Nutzer bestimmte Inhalte erkennt oder sich an diese erinnert (häufig im Kontext von Anzeigenaufrufen). Mit freigegebenem Speicher können Sie Berichte für einzelne Nutzer erstellen, die einen Inhalt mindestens K-mal angesehen haben.

Reagieren und Feedback geben

Das Angebot für den freigegebenen Speicher wird derzeit diskutiert und kann sich in Zukunft ändern. Wenn Sie diese API testen und Feedback haben, freuen wir uns darauf, von Ihnen zu hören.