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 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-uns des cas d'utilisation possibles du stockage partagé. Nous d'ajouter des exemples au fur et à mesure recevoir des commentaires et découvrir de nouveaux cas d'utilisation.
Sélection de contenu
Sélectionner et afficher différents contenus sur différents sites Web dans cadres cloisonnés en fonction des informations collectées dans Shared Storage. La porte de sortie pour ces cas d'utilisation 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 l'interaction des utilisateurs, afin d'identifier les créations sur les différents sites.
- Tests A/B: Vous pouvez affecter un utilisateur à un groupe de test, puis stocker ce groupe dans le stockage partagé pour qu'il puisse y accéder intersite.
- Expériences utilisateur personnalisées: Partagez du contenu personnalisé et des incitations à l'action en fonction de l'état d'inscription ou d'autres états des utilisateurs
Générer des rapports récapitulatifs
Collecter des informations avec Shared Storage et générer un rapport récapitulatif agrégé comportant beaucoup de bruit. Pour ces cas d'utilisation, la porte de sortie API Private Aggregation
- Mesure de la Unique Reach: De nombreux producteurs et annonceurs de contenu souhaitent connaître le nombre de personnes ont vu leur contenu. Utiliser le stockage partagé pour enregistrer la première fois qu'un utilisateur vu votre annonce, vidéo intégrée ou publication, et éviter les doublons pour chaque même utilisateur sur différents sites. Vous pouvez ensuite générer un rapport récapitulatif sur votre audience à l'aide de l'API Private Aggregation.
- Mesure des données démographiques: Les producteurs de contenu souhaitent souvent connaître les données démographiques de leurs audience cible. Vous pouvez utiliser le stockage partagé pour enregistrer les données démographiques des utilisateurs dans un le contexte dans lequel elles se trouvent (votre site propriétaire, par exemple), et utilisez des données pour générer des rapports les concernant sur de nombreux autres sites, comme le contenu intégré.
- Mesure de la fréquence K+: Parfois décrit comme « fréquence effective », il y a souvent un nombre minimum vues avant qu'un utilisateur ne reconnaisse ou ne se souvienne de certains contenus (souvent dans le contexte des visionnages de l'annonce). Vous pouvez utiliser Shared Storage pour créer des rapports d'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.