Ein Worklet mit gemeinsam genutztem Speicher zum Ausführen von A/B-Tests verwenden
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 sind A/B-Tests, in Chrome 104.0.5086.0 und höher.
Sie können einen Nutzer einer Testgruppe zuweisen und diese Gruppe dann unter „Freigegeben“ speichern Speicher, auf den in einer standortübergreifenden Umgebung zugegriffen werden kann.
A/B-Tests ausprobieren
Wenn Sie A/B-Tests mit gemeinsam genutztem Speicher testen möchten, müssen 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
Um zu sehen, ob ein Test die gewünschte Wirkung erzielt, können Sie A/B-Tests für mehrere Websites durchführen. Als Werbetreibender oder Ersteller von Content können Sie je nach der Gruppe, der der Nutzer zugewiesen ist, unterschiedliche Inhalte oder Anzeigen rendern. Die Gruppenzuweisung wird im freigegebenen Speicher gespeichert, kann aber nicht exfiltriert werden.
In diesem Fall gilt Folgendes:
ab-testing.js
sollte in einen Frame eingebettet werden, der eine Kontroll- und zwei Testinhalte abbildet. Das Skript ruft das Worklet mit freigegebenem Speicher für den Test auf.ab-testing-worklet.js
ist das Worklet mit freigegebenem Speicher, das angibt, welcher Gruppe der Nutzer zugewiesen ist und bestimmt, welche Anzeige ausgeliefert wird.
// Randomly assigns a user to a group 0 or 1
function getExperimentGroup() {
return Math.round(Math.random());
}
async function injectContent() {
// Register the Shared Storage worklet
await window.sharedStorage.worklet.addModule('ab-testing-worklet.js');
// Assign user to a random group (0 or 1) and store it in Shared Storage
window.sharedStorage.set('ab-testing-group', getExperimentGroup(), {
ignoreIfPresent: true,
});
// Run the URL selection operation
const fencedFrameConfig = await window.sharedStorage.selectURL(
'ab-testing',
[
{ url: `https://your-server.example/content/default-content.html` },
{ url: `https://your-server.example/content/experiment-content-a.html` }
],
{
resolveToConfig: true
}
);
// Render the chosen URL into a fenced frame
document.getElementById('content-slot').config = fencedFrameConfig;
}
injectContent();
class SelectURLOperation {
async run(urls, data) {
// Read the user's experiment group from Shared Storage
const experimentGroup = await sharedStorage.get('ab-testing-group');
// Return the corresponding URL (first or second item in the array)
return urls.indexOf(experimentGroup);
}
}
register('ab-testing', 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.
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.
- GitHub: Lesen Sie den Angebot, Whitepaper aufrufen, Fragen stellen und an Diskussionen teilnehmen.
- Ankündigungen zur Shared Storage API: Auf unserer Mailingliste können Sie frühere Ankündigungen ansehen oder ihnen beitreten.
- Support für Entwickler: Hier können Sie Fragen stellen und sich an Diskussionen zum Repository für den Privacy Sandbox-Entwicklersupport.