pushNotifications push-notifications
La propriété pushNotifications vous permet de configurer des notifications push pour les applications web. Cette fonctionnalité permet à votre application web de recevoir des messages transmis par un serveur, même si le site web n’est pas actuellement chargé dans le navigateur.
Conditions préalables prerequisites
Avant de configurer des notifications push, vérifiez que vous disposez des éléments suivants :
- Autorisation utilisateur : les utilisateurs doivent explicitement accorder une autorisation pour les notifications
- Service worker : un service worker enregistré est nécessaire au fonctionnement des notifications push
- Clés VAPID : générez des clés VAPID (Voluntary Application Server Identification) pour une communication sécurisée.
- ID de l’application : ID de l’application utilisé lors de l’enregistrement des clés VAPID dans Adobe Journey Optimizer -> Canaux -> Paramètres de notification push -> Informations d’identification push
- Identifiant du jeu de données de suivi : identifiant du jeu de données système nommé « Jeu de données d’événement d’expérience de suivi Push AJO ». Obtenir ceci à partir de Adobe Journey Optimizer -> Jeux de données
Générer des clés VALIDES generate-vapid-keys
Pour générer des clés VAPID, installez le package NPM web-push et exécutez :
npm install web-push -g
web-push generate-vapid-keys
Cette action génère une paire de clés publique et privée. Utilisez la clé publique dans votre configuration de Web SDK et stockez la clé privée dans le canal de notifications push de Adobe Journey Optimizer.
Installation du service worker
Le code du service worker doit être diffusé à partir du même domaine que le site web. Téléchargez le code du service worker à partir du réseau CDN d’Adobe et hébergez le fichier JavaScript à partir de votre propre serveur. Le code du service worker Web SDK est disponible en utilisant la structure d’URL suivante :
- Minifié :
https://cdn1.adoberesources.net/alloy/[VERSION]/alloyServiceWorker.min.js - Complet :
https://cdn1.adoberesources.net/alloy/[VERSION]/alloyServiceWorker.js
Voici un exemple d’installation du service worker :
<script>
navigator.serviceWorker.register("/alloyServiceWorker.js", { scope: "/" });
</script>
Mise en œuvre
Définissez l’objet pushNotifications lors de l’exécution de la commande configure :
alloy("configure", {
datastreamId: "ebebf826-a01f-4458-8cec-ef61de241c93",
orgId: "ADB3LETTERSANDNUMBERS@AdobeOrg",
pushNotifications: {
vapidPublicKey: "BEl62iUYgU[...]KGP4jAQlJz",
applicationId: "my-app-id",
trackingDatasetId: "4dc19305cdd27e03dd9a6bbe",
},
});
Propriétés properties
vapidPublicKeyapplicationIdtrackingDatasetIdConsidérations importantes important-considerations
- Sécurité : les abonnements aux notifications push sont liés à la clé publique VALIDE spécifique utilisée pendant l’abonnement. Si vous modifiez des clés VALIDES, les abonnements existants sont automatiquement désabonnés et recréés avec la nouvelle clé.
- Mise en cache : le SDK Web gère automatiquement les mises à jour des abonnements en comparant l’ECID actuel et les détails de l’abonnement avec les valeurs mises en cache. Les données d’abonnement ne sont envoyées que lorsque des modifications sont détectées.
- Exigence du service worker : les notifications push nécessitent un service worker enregistré. Assurez-vous que votre service worker est correctement configuré pour gérer les événements push.
Configuration des notifications push à l’aide de l’extension de balise Web SDK configure-push-notifications-tag-extension
L’extension de balise Web SDK équivalente à cette propriété est la section Push notifications lors de la configuration de l’extension.
Étapes suivantes next-steps
Après avoir configuré les notifications push, utilisez la commande sendPushSubscription pour enregistrer les abonnements push avec Adobe Experience Platform.