DokumentationAEM 6.4Användarhandbok om mobila appar

Push-meddelanden push-notifications

Last update: Thu May 04 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Skapat för:

  • User
CAUTION
AEM 6.4 har nått slutet på den utökade supporten och denna dokumentation är inte längre uppdaterad. Mer information finns i teknisk supportperiod. Hitta de versioner som stöds här.
NOTE
Adobe rekommenderar att du använder SPA Editor för projekt som kräver ramverksbaserad klientåtergivning för en sida (t.ex. Reagera). Läs mer.

Att omedelbart kunna informera användare av AEM Mobile-appar med 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 och hur du konfigurerar och skickar push-meddelanden från AEM Mobile till appen som är installerad på telefonen. I det här avsnittet beskrivs dessutom hur du konfigurerar Djuplänkning till dina push-meddelanden.

NOTE
Push-meddelanden garanteras inte. de är mer som meddelanden. Det bästa görs att se till att alla får dem, men de är inte en garanterad leveransmekanism. Tiden för att skicka en push-funktion kan variera från mindre än en sekund till upp till en halvtimme.

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å leverantörer är färdiga att konfigureras 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 lämplig 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 meddelandena för att dessa tjänster ska kunna utföra push-åtgärden.

Så här fungerar den när den har installerats och konfigurerats (se nedan):

  1. Ett push-meddelande skapas i AEM och skickas till tjänstleverantören (Amazon SNS eller Pushwoosh).
  2. Tjänsteleverantören tar emot den och skickar den till huvudleverantören (APNS eller GCM).
  3. 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å vilket som är tillgängligt på enheten.
  4. Meddelandet visas på enheten om appen som det är registrerat 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 AEM utvecklare brukar:

  1. Registrera dig hos Apple och Google meddelandetjänster
  2. Registrera dig hos en push-meddelandetjänst och konfigurera den
  3. Lägg till push-stöd i appen
  4. Förbered en telefon för testning

Medan en AEM gör det:

  1. Konfigurera push-AEM
  2. Bygg och distribuera appen
  3. Skicka ett push-meddelande
  4. 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 här för att bekanta sig med Apple Push Notification Service.

För att använda APNS behöver du en Certifikat -fil (en .cer-fil), en push-fil Privat nyckel (en P12-fil) och en Lösenord för privat nyckel från Apple. Instruktioner om hur du gör detta finns här.

Använda tjänsten Google Cloud Messaging (GCM) using-the-google-cloud-messaging-gcm-service

NOTE
Google ersätter GCM med en liknande tjänst som kallas Firebase Cloud Messaging (FCM). Mer information om FCM finns i här.

Gå till Google här för att lära känna Google Cloud Messaging för Android.

Du måste följa stegen här till Skapa ett Google API-projekt, Aktivera GCM-tjänsten och Hämta en API-nyckel. Du behöver API-nyckel för att skicka push-meddelanden till Android-enheter. Du kan även spela in Projektnummer, som ibland kallas GCM-avsändar-ID.

I följande steg visas ett annat sätt att skapa GCM API-nycklar:

  1. Logga in på Google och gå till Google Developer page.
  2. Välj din app i listan (eller skapa en ny).
  3. Ange ditt program-ID under Android-paketnamn, dvs. com.adobe.cq.mobile.weretail.outdoorsapp. (Om det inte fungerar kan du försöka igen med "test.test".)
  4. Klicka Fortsätt att välja och konfigurera tjänster
  5. Välj Cloud Messaging och klicka sedan på Aktivera Google Cloud Messaging.
  6. Den nya API-nyckeln för servern och (ny eller befintlig) avsändar-ID visas.
NOTE
Registrera Server-API-nyckeln. Detta värde anges på din push-leverantörs webbplats.

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

Amazon SNS och Pushwoosh konfigurationer gör att du kan skicka push-meddelanden från AEM skärmar.

Adobe Mobile Services Med 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

NOTE
Information om Amazon SNS, och en länk för att skapa ett nytt AWS-konto, finns här. Du kan få ett kostnadsfritt konto i ett år.

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:

  1. Registrera dig hos Amazon SNS

    1. Registrera ditt konto-ID. Formatet ska vara tolv siffror utan blanksteg eller streck, dvs. "123456789012".
    2. Se till att du befinner dig i regionen"us-East" eller"eu", vilket kräver ett av dessa steg i ett senare steg (Skapa identitetspool).
    3. 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.

  2. Skapa åtkomstnyckel och ID

    1. Klicka på ditt inloggningsnamn i skärmens övre högra hörn och välj Säkerhetsuppgifter på menyn.
    2. Klicka på Åtkomsttangenter och klicka i utrymmet nedan Skapa ny åtkomstnyckel.
    3. Klicka Visa åtkomstnyckel och kopiera och spara ID:t för åtkomstnyckeln och den hemliga åtkomstnyckeln som visas. Om du väljer att hämta nycklarna får du en CSV-fil som innehåller samma värden.
    4. 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 mycket lika och beskrivs här:

    1. Klicka på ditt inloggningsnamn längst upp till höger på skärmen och välj Mina inloggningsuppgifter på menyn.
    2. Klicka på Användare i den vänstra listan med åtgärder och välj ditt användarnamn.
    3. Klicka på fliken Säkerhetsuppgifter.
    4. Här ser du dina nycklar och skapar nya nycklar. Spara knapparna för senare bruk.

  3. Skapa ett ämne

    1. Klicka Skapa ämne och välj ett ämnesnamn. Spela in alla fält, t.ex. Ämnesnamn, Ämnesägare, Region och Visningsnamn.
    2. Klicka Övriga ämnesåtgärder > Redigera ämnesprofil. Under Tillåt dessa användare att prenumerera på det här avsnittet, markera Alla.
    3. Klicka Uppdatera princip.
    note note
    NOTE
    Du kan skapa flera ämnen för olika scenarier, t.ex. dev, test, demo och så vidare. Resten av SNS-konfigurationen kan vara densamma. Bygg appen med olika ämnen; push-meddelanden som skickas till det ämnet tas endast emot av appen som skapats med det ämnet.

  4. Skapa plattformsprogram

    1. 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å vilken plattform som används måste andra fält fyllas i:

      1. För APNS måste en P12-fil, ett lösenord, ett certifikat och en privat nyckel anges. Dessa skulle ha erhållits i steget Använda Apple Push Notification Service (APNS) ovan.
      2. För GCM måste en API-nyckel anges. Detta borde ha erhållits i steget Använda tjänsten Google Cloud Messaging (GCM) ovan.

    2. Upprepa ovanstående steg en gång för varje plattform som du kommer att stödja. Om du vill kunna skicka till både iOS och Android måste du skapa två plattformsprogram.

  5. Skapa en identitetspool

    1. Använd Cognito om du vill 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.
    2. Ge den ett namn och markera kryssrutan "Aktivera åtkomst till oautentiserade identiteter".
    3. På nästa sida ("Dina Cognito-identiteter kräver åtkomst till dina resurser") klicka på Tillåt.
    4. Klicka på länken längst upp till höger på sidan Redigera identitetspool". Identitetspoolens ID visas. Spara den här texten till senare.
    5. På samma sida väljer du listrutan bredvid Oautentiserad roll och ser till att den har rollen Cognito_<pool name="">UnauthRole har valts. Spara ändringarna.

  6. Konfigurera åtkomst

    1. Logga in på Hantering av identitet och åtkomst (IAM)
    2. Välj roller
    3. Klicka på rollen som skapades i föregående steg, som kallas Cognito_<youridentitypoolname>Unauth_Role. Spela in"Roll-ARN" som visas.
    4. Ö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.
    5. 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": [

    "*"

    ]

    }

    ]

    }
    1. 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:

  1. Registrera dig hos Pushwoosh

    1. Gå till pushwoosh.com och skapa ett nytt konto.

  2. Skapa en API-åtkomsttoken

    1. På Pushwoosh-webbplatsen går du till menyalternativet API Access för att generera en API Access-token. Du måste registrera detta säkert.

  3. Skapa en ny app

    1. För Android-stöd måste du ange GCM API-nyckeln.
    2. När du konfigurerar programmet väljer du Cordova som ramverk.
    3. För iOS support 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.
    4. 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).
NOTE
Om en andra app har konfigurerats i AEM med samma app-ID (och andra relaterade värden): API Access Token och GCM-ID), alla push-meddelanden som skickas via den andra appen på AEM, kommer att skickas till andra appar med det app-ID:t.

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=" <span id=" translate="no" />https://www.jcp.org/jcr/1.0🔗" xmlns:nt=" https://www.jcp.org/jcr/nt/1.0"
jcr:primärType="nt:ostrukturerad"
excludeProperties="[appAPIAccessToken]"
path="…/…/…/…"
targetRootDirectory="www"
type="notificationskonfiguration"/>

NOTE
Hanteraren för innehållssynkronisering söker efter dessa noder, och om de inte finns där skrivs inte filen page-notifications-config.json ut.

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:

  1. Navigera till /etc/designs/phonegap/<app name="">/clientlibsall.
  2. Dubbelklicka på inbäddningsavsnittet i egenskapsrutan.
  3. I dialogrutan som visas lägger du till ett nytt klientlib genom att klicka på plusknappen (+).
  4. Lägg till"cq.mobile.push" i det nya textfältet och klicka på OK.
  5. Lägg till ytterligare en så kallad cq.mobile.push.amazon och klicka på OK.
  6. Spara ändringarna.
NOTE
Om push-meddelanden tas bort, eller inte används, av utrymmesskäl i appen och för att undvika konsolfelmeddelanden, tar du bort dessa klientlibs från appen.

Steg 4: Förbered en telefon för testning step-prepare-a-phone-for-testing

NOTE
För push-meddelanden måste du testa på en faktisk enhet eftersom emulatorer inte kan ta emot push-meddelanden.

iOS ios

För iOS måste du använda en Mac OS-dator och du måste gå 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

Så här installerar du appen på en Android-telefon med CLI (se nedan: Steg 6 - Bygg och distribuera appen) måste du först ställa telefonen i"utvecklarläge". Se Aktivera alternativ för utvecklare på enheter om du vill ha mer information om hur du gör detta.

Steg 5: Konfigurera push-AEM 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.

  1. Skapa lämpliga auktoriseringsgrupper för push-meddelanden.
  2. Logga in AEM lämplig användare och klicka på fliken Appar.
  3. Klicka på appen.
  4. Hitta rutan Hantera Cloud Services och klicka på pennan för att ändra dina molnkonfigurationer.
  5. Välj Amazon SNS Connection, Pushwoosh Connection eller Adobe Mobile Services som meddelandekonfiguration.
  6. Ange leverantörsegenskaperna och klicka på Skicka för att spara dem och Klar. De kontrolleras inte på fjärrbasis i detta skede, utom när det gäller AMS.
  7. Du bör nu se konfigurationen som du just angav på panelen Hantera Cloud Services.

Steg 6: Bygg och distribuera appen step-build-and-deploy-the-app

Obs! Se även våra instruktioner här om att bygga 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.

  1. PhoneGap Build är en tjänst som erbjuds av PhoneGap som skapar din app åt dig på deras servrar och gör att du kan hämta den direkt till din enhet. Se PhoneGap Build för att lära dig hur du konfigurerar och använder PhoneGap Build.

  2. Kommandoradsgränssnitt för PhoneGap (CLI) kan du använda en mängd PhoneGap-kommandon på kommandoraden för att skapa, felsöka och distribuera din app. Se Dokumentation för PhoneGap-utvecklare för att lära dig hur du konfigurerar och använder PhoneGap CLI.

Steg 7: Skicka ett push-meddelande step-send-a-push-notification

Följ de här stegen för att skapa ett nytt meddelande och skicka det.

  1. Skapa ett nytt meddelande

    • På AEM Mobile-appens kontrollpanel hittar du panelen Push Notifications (Push-meddelanden).
    • Välj "Skapa" på menyn uppe till höger. Observera att den här knappen inte är 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.

  2. 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 kan välja att"avbryta" eller"skicka" meddelandet i den dialogruta som visas.

  3. Hantera resultaten

    • Om tjänsten för push-meddelanden (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 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 finnas i serverfelloggen.

    • Observera att det finns vissa plattformsskillnader mellan push-meddelanden för 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-registreringssteget inträffar vid start kan Android-appar få push-meddelanden direkt (eftersom de har startats och registrerats), medan iOS-appar inte gör det.
      • I Android är texten för knappen OK i versaler (och i alla andra knappar som läggs till i meddelandet i appen), men inte 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 AEM meddelanden med AWS och Pushwoosh ger.

NOTE
Push-meddelanden garanteras inte. de är mer som meddelanden. Det bästa görs att se till att alla hör det, men de är inte en garanterad leveransmekanism. Tiden för att skicka en push-funktion kan variera från mindre än en sekund till upp till en halvtimme.

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å. Om du klickar på den nya knappen kommer programmet att gå 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 skuggningen öppnas appen 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 knapptext och länksökväg för den valfria länken:

CAUTION
.Följ stegen nedan om du vill öppna panelen Push Notification (Push-meddelanden) på instrumentpanelen.

  1. Klicka på redigeringen i det övre högra hörnet av Hantera Cloud Services platta.

    chlimage_1-108

  2. Välj Pushwoosh Connection. Klicka på Nästa.

    chlimage_1-109

  3. Ange information om egenskaperna och klicka på Skicka.

    chlimage_1-110

    När du skickar in konfigurationen, Push-meddelanden visas på kontrollpanelen.

    chlimage_1-111

Guiden Skapa meddelande create-notification-wizard

När Push-meddelanden visas på kontrollpanelen. Använd guiden för att skapa meddelanden för att lägga till innehållet:

  1. Klicka på Lägg till-symbolen i det övre högra hörnet av Push-meddelanden för att öppna Guiden Skapa meddelande.

    chlimage_1-112

  2. 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.

    chlimage_1-113

    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.

  3. Ange Textinformation i Guiden Skapa meddelande och klicka Skapa.

    chlimage_1-114

    Öppna informationen genom att klicka på det push-meddelande som du skapade från Push-meddelanden platta.

    Du kan redigera egenskaper, skicka meddelanden eller ta bort meddelandet.

    chlimage_1-115

NOTE
Ytterligare information:
Pushwoosh och Amazon SNS stöds inte efter version 6.4 och kommer att vara tillgängliga som tillägg från paketresursen.

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.

recommendation-more-help
547b817b-14b5-4d82-aa0f-a64750e0e592