Utilizza un worklet dello spazio di archiviazione condiviso per identificare i clienti noti.
L'API Shared Storage è una proposta Privacy Sandbox per l'archiviazione tra siti per uso generico, che supporta molti casi d'uso possibili. Un esempio è l'identificazione dei clienti noti, disponibili per i test in Chrome 104.0.5086.0 e versioni successive.
Puoi archiviare se l'utente si è registrato sul tuo sito nello spazio di archiviazione condiviso, quindi eseguire il rendering di un elemento separato a seconda che lo stato dell'utente sia Archiviato (l'utente è un cliente "noto").
Imposta clienti noti
Per sperimentare l'identificazione dei clienti noti nello spazio di archiviazione condiviso, verifica di utilizzare Chrome 104.0.5086.0 o versioni successive. Attiva poi il flag Esperimento API annunci Privacy Sandbox su chrome://flags/#privacy-sandbox-ads-apis
.
Puoi anche attivare l'archiviazione condivisa con il flag --enable-features=PrivacySandboxAdsAPIsOverride,OverridePrivacySandboxSettingsLocalTesting,SharedStorageAPI,FencedFrames
nella riga di comando.
Sperimenta con gli esempi di codice
Potresti voler visualizzare un elemento diverso a seconda che l'utente sia stato visto o meno su un altro sito. Ad esempio, un fornitore di servizi di pagamento potrebbe voler visualizzare un pulsante "Registrati" o "Acquista ora" a seconda che l'utente si sia registrato sul sito del fornitore di servizi di pagamento. Lo spazio di archiviazione condiviso può essere utilizzato per impostare lo stato dell'utente e personalizzare la sua esperienza in base a questo stato.
In questo esempio:
known-customer.js
è incorporato in un frame. Questo script imposta le opzioni per le quali il pulsante deve essere visualizzato su un sito: "Registrati" o "Acquista ora".known-customer-worklet.js
è il worklet dello spazio di archiviazione condiviso che determina se l'utente è noto. Se l'utente è noto, le informazioni vengono restituite. Se l'utente è sconosciuto, le informazioni vengono restituite per visualizzare il pulsante "Registrati" e l'utente viene contrassegnato come noto per il 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);
Casi d'uso
Questi sono solo alcuni dei possibili casi d'uso dell'archiviazione condivisa. Continueremo ad aggiungere esempi man mano che riceveremo feedback e scopriremo nuovi casi d'uso.
Selezione contenuti
Selezionare e visualizzare contenuti diversi su siti web diversi all'interno di frame recintati in base alle informazioni raccolte nello spazio di archiviazione condiviso. La porta di output per questi casi d'uso è la selezione dell'URL.
- Rotazione creatività: memorizza dati quali ID creatività, numero di visualizzazioni e interazione dell'utente per determinare quali creatività verranno visualizzate dagli utenti sui diversi siti.
- Test A/B: puoi assegnare un utente a un gruppo di esperimenti e poi archiviare il gruppo nello spazio di archiviazione condiviso per accedervi tra siti.
- Esperienze utente personalizzate: condividi contenuti e inviti all'azione personalizzati in base allo stato di registrazione di un utente o ad altri stati dell'utente.
Generare report di riepilogo
Raccogli informazioni con lo spazio di archiviazione condiviso e genera un report di riepilogo aggregato e fittizio. La porta di output per questi casi d'uso è l'API Private Aggregation.
- Misurazione della copertura unica: molti produttori di contenuti e inserzionisti vogliono sapere quante persone uniche hanno visto i loro contenuti. Utilizza lo spazio di archiviazione condiviso per registrare la prima volta che un utente ha visualizzato l'annuncio, il video incorporato o la pubblicazione ed evitare un conteggio duplicato dello stesso utente su siti diversi. Puoi quindi utilizzare l'API Private Aggregation per generare un report di riepilogo per la tua copertura.
- Misurazione dei dati demografici: i produttori di contenuti spesso vogliono conoscere i dati demografici del loro pubblico. Puoi utilizzare lo spazio di archiviazione condiviso per registrare i dati demografici degli utenti in un contesto in cui sono disponibili, ad esempio il tuo sito proprietario, e utilizzare i report aggregati per generare report in merito su molti altri siti, ad esempio i contenuti incorporati.
- Misurazione della frequenza K+: a volte, come si parla di "frequenza effettiva", è spesso previsto un numero minimo di visualizzazioni prima che un utente riconosca o richiami determinati contenuti (spesso nel contesto delle visualizzazioni pubblicitarie). Puoi usare lo spazio di archiviazione condiviso per creare report relativi a utenti unici che hanno visto un contenuto almeno K volte.
Interagisci e condividi il tuo feedback
La proposta di spazio di archiviazione condiviso è in fase di discussione attiva e soggetta a modifiche in futuro. Se provi questa API e hai un feedback, ci farebbe piacere conoscere la tua opinione.
- GitHub: leggi la proposta, solleva le domande e partecipa alla discussione.
- Annunci relativi all'API Shared Storage: visualizza o partecipa agli annunci precedenti nella nostra mailing list
- Assistenza per gli sviluppatori: poni domande e partecipa alle discussioni sul repository dell'assistenza per gli sviluppatori di Privacy Sandbox.