pushNotifications push-notifications
La proprietà pushNotifications consente di configurare le notifiche push per le applicazioni Web. Questa funzione consente all’app web di ricevere messaggi inviati da un server, anche quando il sito web non è attualmente caricato nel browser.
Prerequisiti prerequisites
Prima di configurare le notifiche push, assicurati di disporre di:
- Autorizzazione utente: gli utenti devono concedere esplicitamente l'autorizzazione per le notifiche
- Lavoratore del servizio: per il funzionamento delle notifiche push è necessario un processo di lavoro del servizio registrato
- Chiavi VAPID: genera chiavi VAPID (Voluntary Application Server Identification) per comunicazioni protette
- ID applicazione: ID app utilizzato per il salvataggio delle chiavi VAPID in Adobe Journey Optimizer -> Canali -> Impostazioni push -> Credenziali push
- ID del set di dati di tracciamento: l'ID del set di dati di sistema denominato "Set di dati dell'evento di tracciamento push di AJO". Ottieni questo da Adobe Journey Optimizer -> Set di dati
Genera chiavi VAPID generate-vapid-keys
Per generare le chiavi VAPID, installare il pacchetto NPM web-push ed eseguire:
npm install web-push -g
web-push generate-vapid-keys
Questa azione genera una coppia di chiavi pubblica e privata. Utilizza la chiave pubblica nella configurazione del Web SDK e archivia la chiave privata nel canale delle notifiche push di Adobe Journey Optimizer.
Installa il service worker
Il codice di service worker deve essere gestito dallo stesso dominio del sito Web. Scarica il codice del service worker dalla rete CDN di Adobe e ospita il file JavaScript dal tuo server. Il codice di lavoro del servizio Web SDK è disponibile utilizzando la seguente struttura URL:
- Minificato:
https://cdn1.adoberesources.net/alloy/[VERSION]/alloyServiceWorker.min.js - Completo:
https://cdn1.adoberesources.net/alloy/[VERSION]/alloyServiceWorker.js
Di seguito è riportato un esempio di installazione di service worker:
<script>
navigator.serviceWorker.register("/alloyServiceWorker.js", { scope: "/" });
</script>
Implementazione
Impostare l'oggetto pushNotifications durante l'esecuzione del comando configure:
alloy("configure", {
datastreamId: "ebebf826-a01f-4458-8cec-ef61de241c93",
orgId: "ADB3LETTERSANDNUMBERS@AdobeOrg",
pushNotifications: {
vapidPublicKey: "BEl62iUYgU[...]KGP4jAQlJz",
applicationId: "my-app-id",
trackingDatasetId: "4dc19305cdd27e03dd9a6bbe",
},
});
Proprietà properties
vapidPublicKeyapplicationIdtrackingDatasetIdConsiderazioni importanti important-considerations
- Sicurezza: le sottoscrizioni push sono associate alla chiave pubblica VAPID specifica utilizzata durante la sottoscrizione. Se modifichi le chiavi VAPID, le sottoscrizioni esistenti vengono automaticamente annullate e ricreate con la nuova chiave.
- Memorizzazione in cache: Web SDK gestisce automaticamente gli aggiornamenti delle sottoscrizioni confrontando l'ECID corrente e i dettagli delle sottoscrizioni con i valori memorizzati nella cache. I dati di abbonamento vengono inviati solo quando vengono rilevate modifiche.
- Requisito del lavoratore del servizio: le notifiche push richiedono un lavoratore del servizio registrato. Assicurati che il tuo service worker sia configurato correttamente per gestire gli eventi push.
Configurare le notifiche push tramite l’estensione tag Web SDK configure-push-notifications-tag-extension
L'estensione tag Web SDK equivalente a questa proprietà è la sezione Push notifications durante la configurazione dell'estensione.
Passaggi successivi next-steps
Dopo aver configurato le notifiche push, utilizza il comando sendPushSubscription per registrare le sottoscrizioni push con Adobe Experience Platform.