pushNotifications push-notifications
Med egenskapen pushNotifications kan du konfigurera push-meddelanden för webbprogram. Med den här funktionen kan webbprogrammet ta emot meddelanden som har skickats från en server, även när webbplatsen inte har lästs in i webbläsaren.
Förhandskrav prerequisites
Innan du konfigurerar push-meddelanden måste du se till att du har:
- Användarbehörighet: Användare måste uttryckligen ge behörighet för meddelanden
- Tjänstarbetare: En registrerad tjänstarbetare krävs för att push-meddelanden ska fungera
- VAPID-nycklar: Generera VAPID-nycklar (Voluntary Application Server Identification) för säker kommunikation
- Program-ID: Program-ID:t som används när VAPID-nycklarna sparas i Adobe Journey Optimizer -> Kanaler -> Push-inställningar -> Push-autentiseringsuppgifter
- Datauppsättnings-ID för spårning: ID:t för systemdatauppsättningen med namnet"AJO Push Tracking Experience Event Dataset". Hämta detta från Adobe Journey Optimizer -> Dataset
Generera VAPID-nycklar generate-vapid-keys
Om du vill generera VAPID-nycklar installerar du NPM-paketet web-push och kör:
npm install web-push -g
web-push generate-vapid-keys
Den här åtgärden genererar ett nyckelpar för offentlig och privat nyckel. Använd den offentliga nyckeln i din Web SDK-konfiguration och lagra den privata nyckeln i Adobe Journey Optimizer push-meddelandekanal.
Installera servicearbetaren
Tjänstarbetarens kod måste hanteras från samma domän som webbplatsen. Hämta koden för servicearbetare från Adobe CDN och lagra JavaScript-filen på din egen server. Koden för Web SDK-tjänstarbetare är tillgänglig med följande URL-struktur:
- Minified:
https://cdn1.adoberesources.net/alloy/[VERSION]/alloyServiceWorker.min.js - Fullständig:
https://cdn1.adoberesources.net/alloy/[VERSION]/alloyServiceWorker.js
Här följer ett exempel på hur du installerar servicearbetaren:
<script>
navigator.serviceWorker.register("/alloyServiceWorker.js", { scope: "/" });
</script>
Implementering
Ange objektet pushNotifications när du kör kommandot configure:
alloy("configure", {
datastreamId: "ebebf826-a01f-4458-8cec-ef61de241c93",
orgId: "ADB3LETTERSANDNUMBERS@AdobeOrg",
pushNotifications: {
vapidPublicKey: "BEl62iUYgU[...]KGP4jAQlJz",
applicationId: "my-app-id",
trackingDatasetId: "4dc19305cdd27e03dd9a6bbe",
},
});
Egenskaper properties
vapidPublicKeyapplicationIdtrackingDatasetIdViktiga överväganden important-considerations
- Säkerhet: Push-prenumerationer är kopplade till den specifika VAPID-offentliga nyckeln som används under prenumerationen. Om du ändrar VAPID-nycklar kommer befintliga prenumerationer automatiskt att avbrytas och återskapas med den nya nyckeln.
- Cachelagring: SDK hanterar automatiskt prenumerationsuppdateringar genom att jämföra den aktuella ECID- och prenumerationsinformationen med cachelagrade värden. Prenumerationsdata skickas endast när ändringar identifieras.
- Krav för servicearbetare: Push-meddelanden kräver en registrerad servicearbetare. Kontrollera att din servicearbetare är korrekt konfigurerad för att hantera push-händelser.
Konfigurera push-meddelanden med hjälp av taggtillägget Web SDK configure-push-notifications-tag-extension
Webbtaggtillägget för SDK som är ekvivalent med den här egenskapen är avsnittet Push notifications när tillägget konfigureras.
Nästa steg next-steps
När du har konfigurerat push-meddelanden använder du kommandot sendPushSubscription för att registrera push-prenumerationer hos Adobe Experience Platform.