Identifier les clients connus à l'aide d'un Worklet de stockage partagé
L'API Shared Storage est un service Proposition de bac à sable pour le stockage intersites à usage général, cas d'utilisation possibles. Un exemple est d'identifier les clients connus, ce qui est dans Chrome 104.0.5086.0 et versions ultérieures.
Vous pouvez indiquer si l'utilisateur s'est inscrit sur votre site dans Shared Storage, affiche alors un élément distinct selon que l'état enregistré par l'utilisateur (est à l'utilisateur un « connu » client).
Définir les clients connus
Pour tester l'identification des clients connus dans le stockage partagé, vérifiez que vous utilisez Chrome 104.0.5086.0 ou une version ultérieure. Activez toutes les API Ad Privacy sous chrome://settings/adPrivacy
.
Vous pouvez également activer le stockage partagé à l'aide de l'option --enable-features=PrivacySandboxAdsAPIsOverride,OverridePrivacySandboxSettingsLocalTesting,SharedStorageAPI,FencedFrames
dans la ligne de commande.
Tester des exemples de code
Vous pouvez souhaiter afficher un élément différent selon que l'utilisateur a été vu ou non sur un autre site. Par exemple, un fournisseur de services de paiement peut souhaiter afficher un bouton "Enregistrer" ou "Acheter" selon que l'utilisateur s'est inscrit ou non sur le site du fournisseur de services de paiement. Le stockage partagé permet de définir l'état de l'utilisateur et de personnaliser son expérience en fonction de cet état.
Dans cet exemple :
known-customer.js
est intégré dans un frame. Ce script définit les options pour lesquelles le bouton "S'inscrire" doit être affiché sur un site. ou "Acheter maintenant".known-customer-worklet.js
est le Worklet de stockage partagé qui détermine si l'utilisateur est connu. Si l'utilisateur est connu, les informations sont renvoyées. Si l'utilisateur est inconnu, cette information est renvoyée et la mention "Register" (S'inscrire) s'affiche. et l'utilisateur est marqué comme connu à l'avenir.
// 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);
Cas d'utilisation
Ce ne sont là que quelques cas d'utilisation possibles du stockage partagé. Nous continuerons d'ajouter des exemples à mesure que nous recevons des commentaires et découvrons de nouveaux cas d'utilisation.
Sélection de contenu
Sélectionnez et affichez différents contenus sur différents sites Web dans des frames cloisonnés en fonction des informations collectées dans le stockage partagé. Dans ces cas d'utilisation, la porte de sortie est la sélection d'URL.
- Rotation des créations : stockez des données telles que l'ID de la création, le nombre de vues et les interactions des utilisateurs afin de déterminer quelles créations les utilisateurs voient sur différents sites.
- Tests A/B : vous pouvez affecter un utilisateur à un groupe de test, puis stocker ce groupe dans un espace de stockage partagé pour qu'il soit accessible sur plusieurs sites.
- Expériences utilisateur personnalisées : partagez du contenu personnalisé et des incitations à l'action en fonction de l'état d'inscription de l'utilisateur ou d'autres états de l'utilisateur
Générer des rapports de synthèse
Collecter des informations avec le stockage partagé et générer un rapport récapitulatif agrégé bruyant La porte de sortie pour ces cas d'utilisation est l'API Private Aggregation.
- Mesure de la couverture unique : de nombreux créateurs de contenus et annonceurs souhaitent savoir combien de personnes uniques ont vu leur contenu. Utilisez le stockage partagé pour enregistrer la première fois qu'un utilisateur a vu votre annonce, vidéo intégrée ou publication. Vous éviterez ainsi que le même utilisateur soit comptabilisé deux fois sur différents sites. Vous pouvez ensuite utiliser l'API Private Agrégation pour générer un rapport récapitulatif pour votre couverture.
- Mesure des données démographiques : les producteurs de contenu souhaitent souvent comprendre les données démographiques de leur audience. Vous pouvez utiliser le stockage partagé pour enregistrer les données démographiques des utilisateurs dans le contexte dont vous disposez, par exemple votre site propriétaire, et utiliser des rapports agrégés pour générer des rapports les concernant sur de nombreux autres sites, comme le contenu intégré.
- Mesure de la fréquence des k+ : parfois décrite comme "fréquence effective", un nombre de vues minimal est souvent requis avant qu'un utilisateur reconnaisse ou se souvienne certains contenus (souvent dans le contexte des vues d'une publicité). Vous pouvez utiliser le stockage partagé pour créer des rapports sur les utilisateurs uniques ayant vu un contenu au moins K fois.
Interagir et partager des commentaires
La proposition de stockage partagé est en cours de discussion et est susceptible d'être modifiée. à l'avenir. Si vous essayez cette API et que vous avez des commentaires, n'hésitez pas à nous en faire part.
- GitHub: consultez les proposition, livre blanc sur la portée, poser des questions et participer aux discussions.
- Annonces concernant l'API Shared Storage: rejoignez ou consultez les annonces précédentes sur notre liste de diffusion
- Assistance aux développeurs: posez des questions et participez à des discussions sur le Dépôt de l'assistance pour les développeurs Privacy Sandbox.