Creative nach Häufigkeit auswählen

Führen Sie ein Shared Storage-Worklet aus, um eine URL auszuwählen und in einem abgegrenzten Frame zu rendern.

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 Beispiel ist die Häufigkeitskontrolle, in Chrome Beta 104.0.5086.0 und höher testen.

Führen Sie ein Worklet-Skript aus, um eine URL aus einer bereitgestellten Liste auf Grundlage der gespeicherten und diese URL dann in einem abgegrenzten Frame rendern. Damit können Sie neue Anzeigen oder anderen Content zu erstellen, wenn das Frequency Capping erreicht ist.

Creative-Auswahl nach Häufigkeit testen

Um die Creative-Auswahl nach Häufigkeit mit freigegebenem Speicher und abgegrenzten Frames zu testen, müssen Sie Chrome 104.0.5086.0 oder höher installiert ist. 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

Zum Auswählen und Erstellen einer intransparenten URL registrieren Sie ein Worklet-Modul zum Lesen freigegebener Speicherdaten. Die Worklet-Klasse erhält eine Liste mit bis zu acht URLs und gibt den Index der gewählten URL zurück.

Wenn der Client sharedStorage.selectURL() aufruft, wird das Worklet führt eine intransparente URL aus und gibt sie zurück, die in einen Fencing Frame gerendert werden soll.

Nehmen wir an, Sie möchten eine andere Anzeige oder einen anderen Inhalt basierend auf der Häufigkeit auswählen, mit der ein Nutzer die Anzeige oder den Inhalt zuvor gesehen hat. Sie können zählen, wie oft ein Nutzer einen Inhalt angesehen hat, und diesen Wert im freigegebenen Speicher speichern. Nach dem Speichern steht der Wert im freigegebenen Speicher für verschiedene Quellen zur Verfügung.

Dann liest das Shared Storage-Worklet die Werte im freigegebenen Speicher und erhöht den Zähler mit jeder zusätzlichen Ansicht. Wenn die Anzahl die vordefinierte Grenze nicht erreicht hat, wird der Inhalt zurückgegeben, den Sie rendern möchten (Index 1). Andernfalls wird die Standard-URL zurückgegeben (Index 0).

In diesem Fall gilt Folgendes:

  • creative-selection-by-frequencyjs wird über den iFrame des Contenterstellers oder Werbetreibenden geladen und ist für zum Laden des Shared Storage-Worklets und zum Rendern der zurückgegebenen in einem abgegrenzten Frame.
  • creative-selection-by-frequency-worklet.js ist das freigegebene Speicher-Worklet, das den Häufigkeit ermitteln, mit der ermittelt wird, welche URL für einen Inhalt oder ein Creative zurückgegeben wird.

creative-selection-by-frequency.js

// The first URL is the default content or ad to be rendered when the frequency limits reached.
const CONTENT_URLS = [
  { url: `https://${contentProducerUrl}/default-content.html` },
  { url: `https://${contentProducerUrl}/example-content.html` },
];

async function injectAd() {
  // Load the worklet module.
  await window.sharedStorage.worklet.addModule('creative-selection-by-frequency-worklet.js');

  // Set the initial frequency count
  window.sharedStorage.set('frequency-count', 0, {
    ignoreIfPresent: true,
  });

  // Run the URL selection operation to choose an ad based on the frequency count in shared storage.
  const fencedFrameConfig = await window.sharedStorage.selectURL('creative-selection-by-frequency', CONTENT_URLS, {
    resolveToConfig: true
  });

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

injectAd();

creative-selection-by-frequency-worklet.js

const FREQUENCY_LIMIT = 5;

class CreativeSelectionByFrequencyOperation {
  async run(urls, data) {
    // Read the current frequency limit in shared storage
    const count = parseInt(await sharedStorage.get('frequency-count'));

    // Check if the frequency limit has been reached.
    if (count === FREQUENCY_LIMIT) {
      console.log('Frequency limit has been reached, and the default content will be rendered.');
      return 0;
    }

    // Set the new frequency count in shared storage
    await sharedStorage.set('frequency-count', count + 1);
    return 1;
  }
}

// Register the operation as 'creative-selection-by-frequency'.
register('creative-selection-by-frequency', CreativeSelectionByFrequencyOperation);

Anwendungsfälle

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

Inhaltsauswahl

Anhand von Informationen, die im freigegebenen Speicher erfasst wurden, können Sie unterschiedliche Inhalte auf verschiedenen Websites in abgegrenzten Frames auswählen und anzeigen. Das Ausgabe-Gatter für diese Anwendungsfälle ist die URL-Auswahl.

  • Creative-Rotation: Daten wie Creative-ID, Aufrufzahlen und Nutzerinteraktionen werden gespeichert, um zu ermitteln, welches Creative Nutzern auf verschiedenen Websites präsentiert wird.
  • A/B-Tests: Sie können einen Nutzer einer Testgruppe zuweisen und diese Gruppe dann im freigegebenen Speicher speichern, damit auf sie websiteübergreifend zugegriffen werden kann.
  • Personalisierte Nutzererfahrung: Sie können benutzerdefinierte Inhalte und Calls-to-Action basierend auf dem Registrierungsstatus oder anderen Nutzerstatus teilen.

Zusammenfassungsberichte erstellen

Informationen mit Shared Storage erfassen und einen ungenauen zusammengefassten Bericht erstellen Das Ausgabe-Gatter für diese Anwendungsfälle ist die Private Aggregation API.

  • Messung der Unique Reach: Viele Creator und Werbetreibende möchten wissen, wie viele einzelne Nutzer ihre Inhalte gesehen haben. Mit dem freigegebenen Speicher können Sie erfassen, wann ein Nutzer Ihre Anzeige, Ihr eingebettetes Video oder Ihre Publikation zum ersten Mal gesehen hat, und verhindern, dass derselbe Nutzer auf verschiedenen Websites doppelt gezählt wird. Anschließend können Sie mit der Private Aggregation API einen zusammenfassenden Bericht für Ihre Reichweite erstellen.
  • Demografische Analyse: Oft möchten Creator die demografische Zusammensetzung ihrer Zuschauer besser verstehen. Sie können den freigegebenen Speicher verwenden, um demografische Nutzerdaten in einem Kontext zu erfassen, in dem Sie sie haben, z. B. auf Ihrer Website, und aggregierte Berichte verwenden, um Berichte zu vielen anderen Websites zu erstellen, z. B. zu eingebetteten Inhalten.
  • Häufigkeitsmessung vom Typ „K +“: Manchmal auch als „effektive Häufigkeit“ bezeichnet. Es gibt oft eine Mindestanzahl von Aufrufen, bevor ein Nutzer bestimmte Inhalte erkennt oder sich daran erinnert (häufig im Zusammenhang mit Anzeigenaufrufen). Mit dem gemeinsamen Speicher können Sie Berichte zu einzelnen Nutzern erstellen, die sich einen Inhalt mindestens K-mal angesehen haben.

Feedback geben und erhalten

Der Vorschlag für die Shared Storage API befindet sich in der aktiven Diskussion und Entwicklung und kann sich daher ändern.

Wir würden uns sehr über Ihr Feedback zur Shared Storage API freuen.

Auf dem Laufenden bleiben

Benötigst du Hilfe?