Push-meddelanden push-notifications
Att omedelbart kunna informera användare av Adobe Experience Manager (AEM) mobilappar om viktiga meddelanden är avgörande för värdet av en mobilapp och dess marknadsföringskampanjer. Här beskrivs de steg som måste vidtas för att din app ska kunna ta emot push-meddelanden. Du får även lära dig hur du konfigurerar och skickar push-meddelanden från AEM Mobile till appen som är installerad på telefonen. I det här avsnittet beskrivs även hur du konfigurerar funktionen Djuplänkning till dina push-meddelanden.
Om du vill använda push-meddelanden med AEM måste du använda olika tekniker. Först måste en leverantör av push-meddelandetjänster användas för att hantera meddelanden och enheter (AEM gör inte detta ännu). Två providers har konfigurerats med AEM: Amazon Simple Notification Service (eller SNS) och Pushwoosh. För det andra måste push-tekniken för det angivna mobiloperativsystemet gå via rätt tjänst - Apple Push Notification Service (eller APNS) för iOS-enheter och Google Cloud Messaging (eller GCM) för Android™-enheter. Även om AEM inte kommunicerar direkt med dessa plattformsspecifika tjänster måste viss relaterad konfigurationsinformation tillhandahållas av AEM tillsammans med meddelanden om att dessa tjänster ska utföra push-åtgärden.
Så här fungerar den när den har installerats och konfigurerats (se nedan):
- Ett push-meddelande skapas i AEM och skickas till tjänstleverantören (Amazon SNS eller Pushwoosh).
- Tjänsteleverantören tar emot den och skickar den till huvudleverantören (APNS eller GCM).
- Kärnleverantören skickar meddelandet till alla enheter som registrerats för den push-åtgärden. För varje enhet används mobildatanätverket eller WiFi, beroende på vad som är tillgängligt på enheten.
- Meddelandet visas på enheten om appen som den är registrerad för inte körs. En användare som trycker på meddelandet startar programmet och visar meddelandet i programmet. Om programmet redan körs visas bara meddelandet i appen.
Den här versionen av AEM har stöd för iOS och Android™-mobilenheter.
Översikt och procedur overview-and-procedure
Om du vill använda push-meddelanden i en AEM Mobile-app måste du utföra följande åtgärder på hög nivå.
En Experience Manager-utvecklare gör vanligtvis följande:
- Registrera dig hos Apple och Google meddelandetjänster
- Registrera dig hos en push-meddelandetjänst och konfigurera den
- Lägg till push-stöd i appen
- Förbered en telefon för testning
När en Experience Manager-administratör gör följande:
- Konfigurera push-AEM
- Skapa och distribuera appen
- Skicka ett push-meddelande
- Konfigurera djuplänkning (valfritt)
Steg 1: Registrera dig hos Apple och Google meddelandetjänster step-register-with-apple-and-google-messaging-services
Använda Apple Push Notification Service (APNS) using-the-apple-push-notification-service-apns
Gå till Apple-sidan här om du vill bekanta dig med Apple push-meddelandetjänst.
Om du vill använda APN:er måste du ha en Certificate-fil (en .cer-fil), en push Private Key (en .p12-fil) och ett Private Key Password från Apple. Instruktioner om hur du gör det finns här.
Använda tjänsten Google Cloud Messaging (GCM) using-the-google-cloud-messaging-gcm-service
Gå till Google-sidan här och bekanta dig med Google Cloud Messaging för Android™.
Följ de här stegen för att skapa ett Google API-projekt, Aktivera GCM-tjänsten och Hämta en API-nyckel. Du behöver API-nyckeln för att skicka push-meddelanden till Android™-enheter. Registrera även ditt projektnummer, som ibland kallas GCM-avsändar-ID.
I följande steg visas en annan metod för att skapa GCM API-nycklar:
- Logga in på Google och gå till Google Developer-sidan.
- Välj din app i listan (eller skapa en).
- Ange ditt program-ID under Paketnamn för Android™, det vill säga
com.adobe.cq.mobile.weretail.outdoorsapp. (Om det inte fungerar kan du försöka igen med "test.test".) - Klicka på Fortsätt för att välja och konfigurera tjänster
- Välj Cloud Messaging och klicka sedan på Aktivera Google Cloud Messaging.
- Den nya API-nyckeln för servern och (ny eller befintlig) avsändar-ID visas.
Steg 2: Registrera och konfigurera en push-meddelandetjänst step-register-and-configure-a-push-messaging-service
AEM är konfigurerad att använda en av tre tjänster för push-meddelanden:
- AMAZON SNS
- Pushwoosh
- Adobe Mobile Services
Med konfigurationerna Amazon SNS och Pushwoosh kan du skicka push-meddelanden från AEM skärmar.
Med konfigurationen för Adobe Mobile Services kan du konfigurera och skicka push-meddelanden från Adobe Mobile Services med ett Adobe Analytics-konto (men appen måste skapas med den här konfigurationsuppsättningen för att AMS-push-meddelanden ska kunna aktiveras).
Använda meddelandetjänsten Amazon SNS using-the-amazon-sns-messaging-service
Om du inte vill använda Amazon SNS kan du hoppa över dessa steg.
Så här konfigurerar du Amazon SNS för push-meddelanden:
-
Registrera dig hos Amazon SNS
- Registrera ditt konto-ID. Formatet ska vara 12 siffror utan blanksteg eller streck, det vill säga "123456789012".
- Se till att du befinner dig i regionen"us-East" eller"eu", vilket kräver ett av dessa steg (Skapa identitetspool).
- När du har registrerat dig loggar du in på hanteringskonsolen och väljer SNS (Push Notification Service). Klicka på Kom igång om det visas.
-
Skapa åtkomstnyckel och ID
- Klicka på ditt inloggningsnamn i skärmens övre högra hörn och välj Säkerhetsuppgifter på menyn.
- Klicka på Åtkomsttangenter och klicka på Skapa ny åtkomstnyckel i utrymmet nedan.
- Klicka på Visa åtkomstnyckel och kopiera och spara ID:t för åtkomstnyckel och hemlig åtkomstnyckel som visas. Om du väljer att hämta nycklarna får du en CSV-fil som innehåller samma värden.
- Andra säkerhetsrelaterade certifikat och andra kan hanteras på den här sidan.
note note NOTE En åtkomstnyckel kan användas för flera appar. För organisationer som använder ett"AWS Sandbox"-konto är stegen liknande och beskrivs här:
- Klicka på ditt inloggningsnamn längst upp till höger på skärmen och välj Mina inloggningsuppgifter på menyn.
- Klicka på Användare i den vänstra listan med åtgärder och välj ditt användarnamn.
- Klicka på fliken Säkerhetsuppgifter.
- Här ser du dina nycklar och skapar nya nycklar. Spara knapparna för senare bruk.
-
Skapa ett ämne
- Klicka på Skapa ämne och välj ett ämnesnamn. Spela in alla fält, t.ex. Ämnesnamn, Ämnesägare, Region och Visningsnamn.
- Klicka på Andra ämnesåtgärder > Redigera ämnesprofil. Under Tillåt dessa användare att prenumerera på det här ämnet väljer du Alla.
- Klicka på Uppdatera princip.
note note NOTE Du kan skapa flera ämnen för olika scenarier, till exempel dev, test och demo. Resten av SNS-konfigurationen kan vara densamma. Bygg appen med det olika ämnet. Push-meddelanden som skickas till det ämnet tas endast emot av appen som skapats med det ämnet. -
Skapa plattformsprogram
-
Klicka på Program och sedan på Skapa plattformsprogram. Välj ett namn och välj en plattform (APNS för iOS, GCM för Android™). Beroende på plattform. andra fält måste fyllas i:
- För APNS måste en P12-fil, ett lösenord, ett certifikat och en privat nyckel anges. Dessa bör ha hämtats i steget Använda Apple Push Notification Service (APNS) ovan.
- För GCM måste en API-nyckel anges. Detta bör ha hämtats i steget Använda tjänsten Google Cloud Messaging (GCM) ovan.
-
Upprepa ovanstående steg en gång för varje plattform som du stöder. För att kunna använda både iOS och Android™ måste två plattformsprogram skapas.
-
-
Skapa en identitetspool
- Använd Cognito för att skapa en identitetspool som lagrar grundläggande data för oautentiserade användare. Observera att endast områdena"us-east" och"eu" för närvarande stöds av Amazon Cognito.
- Ge den ett namn och markera kryssrutan "Aktivera åtkomst till oautentiserade identiteter".
- På nästa sida ("Dina Cognito-identiteter kräver åtkomst till dina resurser") klickar du på Tillåt.
- Klicka på länken Redigera identitetspool i det övre högra hörnet på sidan. Identitetspoolens ID visas. Spara den här texten till senare.
- På samma sida väljer du listrutan bredvid Oautentiserad roll och ser till att rollen Cognito_<poolnamn>UnauthRole är vald. Spara ändringarna.
-
Konfigurera åtkomst
- Logga in på Identity and Access Management (IAM).
- Välj Roller.
- Klicka på rollen som skapades i föregående steg, med namnet Cognito_<yourIdentityPoolName>Unauth_Role. Spela in"Roll-ARN" som visas.
- Öppna Inline Policies om det inte redan är öppet. Du bör se en princip där med ett namn som oneClick_Cognito_<yourIdentityPoolName>Unauth_Role_1234567890123.
- Klicka på Redigera profil. Ersätt innehållet i policydokumentet med det här JSON-fragmentet:
table 0-row-1 html-authored no-header {
"Version": "2012-10-17",
"Programsats": [
{
"Åtgärd": [
"mobileanalytics:PutEvents",
"cognito-sync:*",
"SNS:CreatePlatformEndpoint",
"SNS:Subscribe"
],
"Effekt": "Tillåt",
"Resurs": [
"*"
]
}
]
}
- Klicka på Använd princip.
Använda meddelandetjänsten Pushwoosh using-the-pushwoosh-messaging-service
Om du inte vill använda Pushwoosh kan du hoppa över det här steget.
Så här använder du Pushwoosh:
-
Registrera dig hos Pushwoosh
- Gå till pushwoosh.com och skapa ett konto.
-
Skapa en API-åtkomsttoken
- På Pushwoosh-webbplatsen går du till menyalternativet API Access för att generera en API Access-token. Spela in denna token på ett säkert sätt.
-
Skapa en app
- För Android™ måste du ange GCM API-nyckeln.
- När du konfigurerar programmet väljer du Cordova som ramverk.
- För iOS-stöd måste du ange certifikatfilen (.cer), push-certifikatet (.p12) och lösenordet för den privata nyckeln. Dessa bör ha hämtats från Apple APNS-webbplats. Välj Cordova under Framework.
- Pushwoosh genererar ett app-ID för den appen, i formatet"XXXXX-XXXXX", där varje X är ett hexadecimalt värde (0 till F).
Steg 3: Lägg till push-stöd i appen step-add-push-support-to-the-app
Lägg till ContentSync-konfiguration add-contentsync-configuration
Skapa två innehållsnoder (en i app-config och en i app-config-dev) som kallas notificationConfig:
- /content/
<your app>/shell/jcr:content/page-app/app-config-dev/notificationsConfig - /content/
<your app>/shell/jcr:content/page-app/app-config/notificationsConfig
Med dessa egenskaper (.content.xml-filer):
<jcr:root xmlns:jcr=" https://developer.adobe.com/experience-manager/reference-materials/spec/jcr/1.0/index.html" xmlns:nt=" https://developer.adobe.com/experience-manager/reference-materials/spec/jcr/1.0/index.html"
jcr:primärType="nt:ostrukturerad"
excludeProperties="[appAPIAccessToken]"
path="…/…/…/…"
targetRootDirectory="www"
type="notificationskonfiguration"/>
Lägg till klientbibliotek add-client-libraries
Klientbiblioteken för push-meddelanden måste läggas till i programmet genom att följa dessa steg:
I CRXDE Lite:
- Navigera till /etc/designs/phonegap//clientlibsall.
- Dubbelklicka på inbäddningsavsnittet i egenskapsrutan.
- Lägg till ett klientlib i dialogrutan som visas genom att klicka på plusknappen (+).
- Lägg till"cq.mobile.push" i det nya textfältet och klicka på OK.
- Lägg till ytterligare en så kallad cq.mobile.push.amazon och klicka på OK.
- Spara ändringarna.
Steg 4: Förbered en telefon för testning step-prepare-a-phone-for-testing
IOS ios
För iOS använder du en macOS-dator och går med i iOS Developer Program. Vissa företag har företagslicenser som kan vara tillgängliga för alla utvecklare.
I XCode 8.1 måste du gå till fliken Funktioner i projektet innan du använder push-meddelanden och växla mellan att aktivera push-meddelanden.
Android™ android
Om du vill installera appen på en Android™-telefon med CLI (se Steg 6 - Bygg och distribuera appen) måste du först placera telefonen i utvecklarläge. Mer information om hur du gör detta finns i Aktivera alternativ för utvecklare på enheter.
Steg 5: Konfigurera push-AEM appar step-configure-push-on-aem-apps
Innan du skapar och distribuerar till din konfigurerade mobila enhet måste du konfigurera meddelandeinställningarna för den meddelandetjänst som du valde att använda.
- Skapa lämpliga auktoriseringsgrupper för push-meddelanden.
- Logga in AEM lämplig användare och klicka på fliken Appar.
- Klicka på appen.
- Hitta rutan Hantera Cloud Service och klicka på pennan för att ändra dina molnkonfigurationer.
- Välj Amazon SNS Connection, Pushwoosh Connection eller Adobe Mobile Services som meddelandekonfiguration.
- Ange leverantörsegenskaperna och klicka på Skicka för att spara dem och Klar. De verifieras inte på fjärrbasis i detta skede, utom om det finns AMS.
- Du bör nu se konfigurationen som du just angav på panelen Hantera Cloud Service.
Steg 6: Skapa och distribuera appen step-build-and-deploy-the-app
Obs! Se instruktionerna här om hur du skapar PhoneGap-program.
Det finns två sätt att skapa och distribuera din app med PhoneGap.
Obs! För testning av push-meddelanden räcker det inte med emulatorer eftersom push-meddelanden använder ett distinkt protokoll mellan push-providern (Apple eller Google) och enheten. Den aktuella maskinvaran och emulatorerna för Mac/PC stöder inte detta.
-
PhoneGap Build är en tjänst som erbjuds av PhoneGap som skapar din app åt dig på deras servrar och låter dig hämta den direkt till din enhet. Mer information om hur du konfigurerar och använder PhoneGap Build finns i PhoneGap Build-dokumentationen på
https://build.phonegap.com/. -
Med PhoneGap Command Line Interface (CLI) kan du använda en mängd PhoneGap-kommandon på kommandoraden för att skapa, felsöka och distribuera din app. Mer information om hur du konfigurerar och använder PhoneGap CLI finns i dokumentationen för PhoneGap-utvecklaren (
https://docs.phonegap.com/en/edge/guide_cli_index.md.html#The%20Command-Line%20Interface).
Steg 7: Skicka ett push-meddelande step-send-a-push-notification
Följ de här stegen för att skapa ett meddelande och skicka det.
-
Skapa ett meddelande
- På AEM Mobile-appens kontrollpanel hittar du panelen Push Notifications (Push-meddelanden).
- Välj "Skapa" på menyn uppe till höger. Den här knappen är inte tillgänglig förrän molnkonfigurationen har ställts in.
- I guiden Skapa meddelande anger du en titel och ett meddelande och klickar sedan på knappen"Skapa". Meddelandet är nu klart att skickas omedelbart eller senare. Den kan redigeras och du kan ändra och spara meddelandet och/eller titeln.
-
Skicka meddelandet
- Leta reda på panelen Push Notifications (Push-meddelanden) på panelen Apps.
- Markera meddelandet eller klicka på informationsknappen längst ned till höger (… .) för att visa listan med meddelanden. Den här listan anger också om ett meddelande är klart att skickas, om det redan har skickats eller om ett fel uppstod när meddelandet skickades.
- Markera kryssrutan för ett meddelande (endast) och klicka på knappen"Skicka meddelande" ovanför listan. Du har en chans att"avbryta" eller"skicka" meddelandet i den dialogruta som visas.
-
Hantera resultaten
-
Om push-meddelandetjänsten (Amazon SNS eller Pushwoosh) tar emot sändningsbegäran, bekräftar att den är giltig och skickar den till ANE-leverantörerna (APNS och GCM) stängs dialogrutan Skicka utan meddelande. Statusen för det meddelandet visas som Skickat i meddelandelistan.
-
Om push-sändningen misslyckas visas ett meddelande i dialogrutan som anger problemet. I meddelandelistan anges meddelandets status som Fel, men om problemet åtgärdas kan meddelandet skickas igen. Om ett fel uppstår bör ytterligare felinformation visas i serverfelloggen.
-
Observera att det finns vissa plattformsskillnader mellan push-meddelanden i iOS och Android™. Bland dem:
- När appen har distribuerats på Android™ kommer den att startas med CLI. I iOS måste du starta programmet manuellt. Eftersom push-registrering sker vid start kan Android™-appar få push-meddelanden direkt (eftersom de redan har startats och registrerats), medan iOS-appar inte kan det.
- I Android™ är texten med OK i versaler (och i alla andra knappar som läggs till i meddelandet i appen), medan den inte finns i iOS.
-
För AMS-push-meddelanden måste meddelanden skapas och skickas från AMS-servern. AMS har ytterligare funktioner för push-meddelanden utöver de som finns i AEM meddelanden med AWS och Pushwoosh.
Konfigurera djup länkning med push-meddelanden configuring-deep-linking-with-push-notifications
Vad är Djuplänkning? I samband med ett push-meddelande är det ett sätt att tillåta att en app öppnas eller dirigeras (om den är öppen) till en viss plats i programmet.
Hur fungerar det? Författaren av ett push-meddelande kan lägga till en knappetikett (d.v.s."Visa mig!") till meddelandet och väljer den sida som de vill länka i meddelandet via en visuell sökvägsläsare. När det skickas utförs push-åtgärden som vanligt förutom att knappen OK ersätts av knappen"Stäng" i meddelandet i appen och den nya knappen anges ("Visa mig!") visas också. När du klickar på den nya knappen kommer programmet till den angivna sidan i programmet. Om du klickar på Stäng stängs meddelandet.
Om appen inte är öppen visas skuggan som vanligt. Om du utför en åtgärd på meddelandet i skuggan öppnas programmet och användaren får sedan tillgång till knapparna för djup länk baserat på vad som konfigurerats i push-meddelandet.
Skapa meddelandet, lägg till en knapptext och länksökväg för den valfria länken:
-
Klicka på redigeringen i det övre högra hörnet av rutan Hantera Cloud Service.
-
Välj Pushwoosh-anslutningen. Klicka på Nästa.
-
Ange information om egenskaperna och klicka på Skicka.
När du har skickat konfigurationen visas rutan Push Notifications på kontrollpanelen.
Guiden Skapa meddelande create-notification-wizard
När panelen Push Notifications visas på kontrollpanelen använder du guiden Create Notification för att lägga till innehållet:
-
Klicka på Lägg till-symbolen i det övre högra hörnet av rutan Push Notifications för att öppna Create Notification Wizard.
-
Om du klickar på bläddringsikonen i länksökvägen visas programmets innehållsstruktur för användaren.
Klicka på bockikonen när du har valt sökvägen.
note note NOTE Länkknappstexten får innehålla högst 20 tecken. Om slutanvändaren inte har den senaste versionen av programmet och den länkade sökvägen inte är tillgänglig kommer användaren att hamna på programmets huvudsida om åtgärden för den djupa länken bekräftas. -
Ange textinformation i guiden Skapa meddelande och klicka på Skapa.
Öppna informationen genom att klicka på det push-meddelande som du skapade i rutan Push Notifications.
Du kan redigera egenskaper, skicka meddelanden eller ta bort meddelandet.
Nästa steg the-next-steps
När du har fått mer information om push-meddelanden för din app kan du läsa AEM Mobile Content Personalization.