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.jssollte 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.jsist 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);
Use cases
All available use cases for Select URL API can be found in this section. We'll continue to add examples as we receive feedback and discover new test cases.
- Rotate ad creatives: Store data, such as creative ID and user interaction, to determine which creative users' see across different sites.
- Select ad creatives by frequency: Use view count data to determine which creative users' see across different sites.
- Run A/B testing: You can assign a user to an experiment group, then store that group in Shared Storage to be accessed cross-site.
- Customize experience for known customers: Share custom content and calls-to-action based on a user's registration status or other user states.
Feedback geben und erhalten
Der Vorschlag für die Select URL API befindet sich in der aktiven Diskussion und Entwicklung und kann sich ändern.
Wir würden uns sehr über Ihr Feedback zur Select URL API freuen.
- Angebot: Sehen Sie sich das detaillierte Angebot an.
- Diskussion: Nehmen Sie an der laufenden Diskussion teil, um Fragen zu stellen und Ihre Erkenntnisse zu teilen.
Auf dem Laufenden bleiben
- Mailingliste: Melden Sie sich für unsere Mailingliste an, um aktuelle Informationen und Ankündigungen zu den APIs „Select URL“ und „Shared Storage“ zu erhalten.
Benötigst du Hilfe?
- Entwicklersupport: Im Repository für den Privacy Sandbox-Entwicklersupport können Sie sich mit anderen Entwicklern austauschen und Antworten auf Ihre Fragen erhalten.