Usa un worklet de almacenamiento compartido para identificar a los clientes conocidos.
La API de Shared Storage es una propuesta de Privacy Sandbox para el almacenamiento entre sitios de uso general, que admite muchos casos de uso posibles. Un ejemplo es la identificación de clientes conocidos, que está disponible para probar en Chrome 104.0.5086.0 y versiones posteriores.
Puedes almacenar en el almacenamiento compartido si el usuario se registró en tu sitio y, luego, renderizar un elemento separado en función de si el estado almacenado del usuario (es un cliente “conocido”).
Establece clientes conocidos
Para experimentar con la identificación de clientes conocidos en 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
Es posible que desees renderizar un elemento diferente en función de si el usuario se vio en otro sitio. Por ejemplo, un proveedor de pagos puede querer mostrar un botón "Registrarse" o "Comprar ahora" en función de si el usuario se registró en el sitio del proveedor de pagos. El almacenamiento compartido se puede usar para establecer el estado del usuario y personalizar su experiencia en función de ese estado.
En este ejemplo:
known-customer.js
está incorporado en un marco. Esta secuencia de comandos establece las opciones para los botones que deben mostrarse en un sitio, "Registrarse" o "Comprar ahora".known-customer-worklet.js
es el worklet de almacenamiento compartido que determina si el usuario es conocido. Si el usuario es conocido, se devuelve la información. Si el usuario es desconocido, se devuelve esa información para mostrar el botón "Register" y el usuario se marca como conocido para el futuro.
// The first URL for the "register" button is rendered for unknown users.
const BUTTON_URLS = [
{ url: `https://${advertiserUrl}/ads/register-button.html` },
{ url: `https://${advertiserUrl}/ads/buy-now-button.html` },
];
async function injectButton() {
// Load the worklet module
await window.sharedStorage.worklet.addModule('known-customer-worklet.js');
// Set the initial status to unknown ('0' is unknown and '1' is known)
window.sharedStorage.set('known-customer', 0, {
ignoreIfPresent: true,
});
// Run the URL selection operation to choose the button based on the user status
const fencedFrameConfig = await window.sharedStorage.selectURL('known-customer', BUTTON_URLS, {
resolveToConfig: true
});
// Render the opaque URL into a fenced frame
document.getElementById('button-slot').src = fencedFrameConfig;
}
injectButton();
class SelectURLOperation {
async run(urls) {
const knownCustomer = await this.sharedStorage.get('known-customer');
// '0' is unknown and '1' is known
return parseInt(knownCustomer);
}
}
register('known-customer', SelectURLOperation);
Use cases
These are only some of the possible use cases for Shared Storage. We'll continue to add examples as we receive feedback and discover new use cases.
Content selection
Select and display different content on different websites in fenced frames based on information collected in Shared Storage. The output gate for these use cases is URL selection.
- Creative rotation: Store data, such as creative ID, view counts, and user interaction, to determine which creative users' see across different sites.
- A/B testing: You can assign a user to an experiment group, then store that group in Shared Storage to be accessed cross-site.
- Custom user experiences: Share custom content and calls-to-action based on a user's registration status or other user states
Generate summary reports
Collect information with Shared Storage and generated a noisy, aggregated summary report. The output gate for these use cases is the Private Aggregation API.
- Unique reach measurement: Many content producers and advertisers want to know how many unique people saw their content. Use Shared Storage to record the first time a user saw your ad, embedded video, or publication, and prevent duplicative counting of that same user on different sites. You can then use the Private Aggregation API to output a summary report for your reach.
- Demographics measurement: Content producers often want to understand the demographics of their audience. You can use Shared Storage to record user demographic data in a context where you have it, such as your first-party site, and use aggregated reporting to report on it across many other sites, such as embedded content.
- K+ frequency measurement: Sometimes described as "effective frequency," there is often a minimum number views before a user will recognize or recall certain content (often in the context of advertisement views). You can use Shared Storage to build reports of unique users that have seen a piece of content at least K number of times.
Interactúa y comparte tus comentarios
La propuesta de almacenamiento compartido se está debatiendo y está sujeta a cambios en el futuro. Si pruebas esta API y tienes comentarios, nos encantaría recibirlos.
- GitHub: Consulta el la propuesta, llegar al informe, presentar preguntas y participar en el debate.
- Anuncios de la API de Shared Storage: únete a nuestra lista de distribución o mira anuncios anteriores.
- Asistencia para desarrolladores: Haz preguntas y únete a debates en el Repo de asistencia para desarrolladores de Privacy Sandbox.