Usa un worklet de almacenamiento compartido para ejecutar pruebas A/B.
La API de Shared Storage es una Propuesta de zona de pruebas para almacenamiento entre sitios de uso general, que admite muchas posibles casos de uso. Un ejemplo son las pruebas A/B, que están disponibles para probar en Chrome 104.0.5086.0 y versiones posteriores.
Puedes asignar un usuario a un grupo experimental y, luego, almacenarlo en la opción Compartidos Almacenamiento al que se accederá en un entorno entre sitios.
Prueba A/B Testing
Para experimentar con las pruebas A/B con el almacenamiento compartido, confirma que estés usando Chrome 104.0.5086.0 o una versión posterior. Habilita todas las APIs de privacidad en los anuncios de chrome://settings/adPrivacy
.
También puedes habilitar el almacenamiento compartido con la marca --enable-features=PrivacySandboxAdsAPIsOverride,OverridePrivacySandboxSettingsLocalTesting,SharedStorageAPI,FencedFrames
en la línea de comandos.
Experimenta con muestras de código
Para determinar si un experimento tiene el efecto deseado, puedes ejecutar pruebas A/B en varios sitios. Como anunciante o productor de contenido, puedes optar por renderizar contenido o anuncios diferentes según el grupo al que esté asignado el usuario. La asignación del grupo se guarda en el almacenamiento compartido, pero no se puede robar.
En este ejemplo:
ab-testing.js
debe estar incorporado en un marco, que asigna un control y dos contenidos del experimento. La secuencia de comandos llama al worklet de almacenamiento compartido del experimento.ab-testing-worklet.js
es el worklet de almacenamiento compartido que muestra a qué grupo está asignado el usuario y determina qué anuncio se muestra.
// 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.
Engage and share feedback
Note that the Select URL API proposal is under active discussion and development and subject to change.
We're eager to hear your thoughts on the Select URL API.
- Proposal: Review the detailed proposal.
- Discussion: Join the ongoing discussion to ask questions and share your insights.
Stay Informed
- Mailing List: Subscribe to our mailing list for the latest updates and announcements related to the Select URL and Shared Storage APIs.
Need Help?
- Developer Support: Connect with other developers and get answers to your questions in the Privacy Sandbox Developer Support repository.