Notifiche push

La possibilità di avvisare immediatamente gli utenti app AEM Mobile con notifiche importanti è fondamentale per il valore di un'app mobile e delle sue campagne di marketing. Qui descriviamo i passaggi da effettuare per consentire alla tua app di ricevere le notifiche push e come configurare e inviare i messaggi push da AEM Mobile all'app installata sul telefono. Inoltre, questa sezione descrive come configurare la funzione Collegamento profondo alle notifiche push.

L'utilizzo delle notifiche push con AEM richiede diverse tecnologie. Innanzitutto, per gestire le notifiche e i dispositivi deve essere utilizzato un provider di servizi di notifica push (AEM non lo fa ancora). Due provider sono configurati out-of-the-box con AEM: Amazon Simple Notification Service (o SNS) e Pushwoosh. In secondo luogo, la tecnologia push per il sistema operativo mobile specificato deve passare attraverso il servizio appropriato — Apple Push Notification Service (o APNS) per dispositivi iOS; e Google Cloud Messaging (o GCM) per dispositivi Android. Sebbene AEM non comunichi direttamente con questi servizi specifici della piattaforma, alcune informazioni di configurazione correlate devono essere fornite da AEM insieme alle notifiche affinché questi servizi eseguano il push.

Una volta installato e configurato (come spiegato di seguito) funziona come segue:

1. Una notifica push viene creata in AEM e inviata al provider di servizi ( Amazon SNS o Pushwoosh).
2. Il provider di servizi lo riceve e lo invia al provider di base (APNS o GCM).
3. Il provider di base invia la notifica a tutti i dispositivi registrati per tale push. Per ogni dispositivo utilizza la rete dati cellulare o il WiFi, a seconda di quale sia attualmente disponibile sul dispositivo.
4. La notifica viene visualizzata sul dispositivo se l'app per cui è registrata non è in esecuzione. Toccando la notifica l'utente avvia l'app e visualizza la notifica all'interno dell'app. Nel caso in cui l'applicazione sia già in esecuzione, viene visualizzata solo la notifica in-app.

Questa versione di AEM supporta i dispositivi mobili iOS e Android.

Panoramica e procedura

Per utilizzare le notifiche push in un'app AEM Mobile , è necessario effettuare i seguenti passaggi di alto livello.

In genere, uno sviluppatore AEM:

1. Registrati con i servizi di messaggistica Apple e Google
2. Registrati con un servizio di messaggistica push e configuralo
3. Aggiunta del supporto push all'app
4. Preparare un telefono per il test

Mentre un amministratore AEM:

1. Configurare il push su AEM app
2. Creare e distribuire l'app
3. Invia una notifica push
4. Configurare il collegamento profondo (facoltativo)

Passaggio 1: Registrati con i servizi di messaggistica Apple e Google

Utilizzo di Apple Push Notification Service (APNS)

Andate alla pagina Apple qui per acquisire familiarità con Apple Push Notification Service.

Per utilizzare APNS è necessario un file Certificate (un file .cer), una Chiave privata (un file .p12) e una Password chiave privata da Apple. Le istruzioni su come farlo sono reperibili qui.

Utilizzo del servizio Google Cloud Messaging (GCM)

Andate alla pagina Google qui per acquisire familiarità con Google Cloud Messaging per Android.

Sarà necessario seguire i passaggi da qui a Crea un progetto API Google, Abilita il servizio GCM e Ottieni una chiave API. Per inviare le notifiche push ai dispositivi Android sarà necessario Chiave API. Inoltre, registrare il numero Project Number, talvolta denominato anche GCM Sender Id.

La procedura seguente illustra un metodo diverso per la creazione di chiavi API GCM:

1. Accedete a Google e andate alla pagina Sviluppatore di Google.
2. Scegliete l'app dall'elenco (o createne una nuova).
3. In Nome pacchetto Android, immettete il vostro ID app, ossia com.adobe.cq.mobile.weretail.outdoorsapp. Se questo non funziona, riprovate con "test.test".
4. Fare clic su Continua per scegliere e configurare i servizi
5. Selezionate Cloud Messaging, quindi fate clic su Abilita Google Cloud Messaging.
6. Verrà visualizzata la nuova chiave API server e l'ID mittente (nuovo o esistente).

Passaggio 2: Registrazione e configurazione di un servizio di messaggistica push

AEM configurato per utilizzare uno dei tre servizi per le notifiche push:

• Amazon SNS
• Pushwoosh
• Adobe Mobile Services

configurazioni Amazon SNSe ** Pushwooshsaranno in grado di inviare i messaggi push dall'interno AEM schermi.

Adobe Mobile Services la configurazione consente di configurare e inviare le notifiche push dall'interno Adobe Mobile Services utilizzando un account Adobe Analytics (ma l'app deve essere creata con questo set di configurazione per abilitare le notifiche push AMS).

Utilizzo del servizio di messaggistica Amazon SNS

Se non si desidera utilizzare Amazon SNS, è possibile saltare questi passaggi.

Per impostare Amazon SNS per le notifiche push, effettuate le seguenti operazioni:

1. Registrazione con Amazon SNS

   1. Registra il tuo ID account. Il formato deve essere composto da dodici cifre senza spazi o trattini, ovvero "123456789012".
   2. Assicurarsi di essere nell'area "us-east" o "eu", come un passo successivo (Creazione del pool di identità) richiede uno di questi.
   3. Dopo la registrazione, accedete alla console di gestione e selezionate SNS (Push Notification Service). Fare clic su "Get Started" se viene visualizzato.

2. Crea chiave di accesso e ID

   1. Fate clic sul nome di accesso in alto a destra della schermata e scegliete Credenziali di protezione dal menu.
   2. Fare clic su Tasti di accesso e nello spazio sottostante fare clic su Crea nuova chiave di accesso.
   3. Fare clic su Mostra chiave di accesso, quindi copiare e salvare l'ID chiave di accesso e la chiave di accesso segreta mostrati. Se scegliete l'opzione per scaricare le chiavi, otterrete un file CSV che contiene gli stessi valori.
   4. In questa pagina è possibile gestire altri certificati relativi alla sicurezza e altri.
   NOTA

   Una chiave di accesso può essere utilizzata per più app.

   Per le organizzazioni che utilizzano un account "AWS Sandbox", i passaggi sono molto simili e descritti di seguito:

   1. Fate clic sul nome di accesso in alto a destra della schermata e scegliete Credenziali di protezione personale dal menu.
   2. Fate clic su Utenti nell’elenco a sinistra delle azioni e scegliete il nome utente.
   3. Fare clic sulla scheda Credenziali di protezione.
   4. Da qui si vedono le chiavi e si creano nuove chiavi. Salvate le chiavi per un utilizzo successivo.

3. Creare un argomento

   1. Fate clic su Crea argomento e scegliete un nome per l'argomento. Registra tutti i campi come ARN argomento, Proprietario argomento, Regione, Nome visualizzato.
   2. Fare clic su Altre azioni argomento > Modifica criterio argomento. In Consenti a questi utenti di iscriversi a questo argomento, selezionare Tutti.
   3. Fare clic su Aggiorna criterio.
   NOTA

   Potete creare più argomenti per diversi scenari, ad esempio dev, test, demo e così via. Il resto della configurazione SNS può rimanere invariato. Create l'app con il diverso argomento; le notifiche push inviate a tale argomento verranno ricevute solo dall'app creata con tale argomento.

4. Creare applicazioni per la piattaforma

   1. Fate clic su Applicazioni, quindi su Crea applicazione piattaforma. Scegliete un nome e selezionate una piattaforma (APNS for iOS, GCM for Android). A seconda della piattaforma, dovranno essere compilati altri campi:

      1. Per APNS, è necessario immettere un file P12, una password, un certificato e una chiave privata. Questi sono stati ottenuti nel passaggio Utilizzo del servizio APNS (Apple Push Notification Service) precedente.
      2. Per GCM, è necessario inserire una chiave API. Ciò dovrebbe essere ottenuto nel passaggio Utilizzo del servizio Google Cloud Messaging (GCM) precedente.

   2. Ripetete il passaggio riportato sopra una volta per ogni piattaforma da supportare. Per poter effettuare il push sia a iOS che ad Android, è necessario creare due applicazioni piattaforma.

5. Creare un pool di identità

   1. Utilizzate Cognito per creare un pool di identità, che archivierà i dati di base degli utenti non autenticati. In questa fase, solo le regioni "us-east" e "eu" sono supportate da Amazon Cognito.
   2. Assegna un nome e seleziona la casella "Abilita accesso alle identità non autenticate".
   3. Nella pagina successiva ("Le identità Cognito richiedono l'accesso alle risorse") fare clic su Consenti.
   4. Nella parte superiore destra della pagina, fare clic sul collegamento "Modifica pool di identità". Viene visualizzato l'ID del pool di identità. Salvate il testo per un secondo tempo.
   5. Nella stessa pagina, scegliere il menu a discesa accanto a "Ruolo non autenticato" e assicurarsi che sia selezionato il ruolo Cognito_<nome pool>UnauthRole. Salvare le modifiche.

6. Configura accesso

   1. Accedi a Gestione identità e accesso (IAM)
   2. Seleziona ruoli
   3. Fate clic sul ruolo creato nel passaggio precedente, denominato Cognito_<yourIdentityPoolName>Unauth_Role. Registrare la voce "Role ARN" visualizzata.
   4. Apri "Criteri in linea" se non è già aperto. Dovresti visualizzare qui un criterio con un nome come oneClick_Cognito_<yourIdentityPoolName>Unauth_Role_1234567890123.
   5. Fare clic su "Edit Policy". Sostituisci il contenuto del documento criteri con questo frammento di JSON:

   { "Versione": "2012-10-17", "Dichiarazione": [ { "Azione": [ "mobileanalytics:PutEvents", "cognito-sync:*", "SNS:CreatePlatformEndpoint", "SNS:Subscribe" ], "Effetto": "Allow", "Risorsa": [ "*" ] } ] }

   1. Fare clic su Applica criterio

Utilizzo del servizio di messaggistica Pushwoosh

Se non si desidera utilizzare Pushwoosh, è possibile saltare questo passaggio.

Per utilizzare Pushwoosh:

1. Registrati con Pushwoosh

   1. Passate a passeggwoosh.com e create un nuovo account.

2. Creare un token di accesso API

   1. Nel sito Pushwoosh, andate alla voce di menu Accesso API per generare un token di accesso API. Sarà necessario registrare in modo sicuro questo.

3. Create una nuova app

   1. Per il supporto di Android, dovete fornire la vostra chiave API GCM.
   2. Quando configurate l'app, scegliete Cordova come framework.
   3. Per il supporto iOS, dovete fornire il file del certificato (.cer), il certificato push (.p12) e la password della chiave privata; questi avrebbero dovuto essere ottenuti dal sito APNS di Apple. Per Framework, scegliete Cordova.
   4. Pushwoosh genererà un App Id per quell'app, nel modulo "XXXXX-XXXXX", dove ogni X è un valore esadecimale (da 0 a F).

Passaggio 3: Aggiunta del supporto push all'app

Aggiungi configurazione ContentSync

Create due nodi di contenuto (uno in app-config e uno in app-config-dev) denominati notificationsConfig:

• /content/<your app>/shell/jcr:content/page-app/app-config-dev/notificationsConfig
• /content/<your app>/shell/jcr:content/page-app/app-config/notificationsConfig

Con queste proprietà (file .content.xml):
<jcr:root xmlns:jcr=" https://www.jcp.org/jcr/1.0" xmlns:nt=" https://www.jcp.org/jcr/nt/1.0">
jcr:PrimaryType="nt:unstructure"
excludeProperties="[appAPIAccessToken]"
path="…/…/…/…"
targetRootDirectory="www"
type="notifications sconfig"/>

Aggiungi librerie client

Le librerie client di notifica push devono essere aggiunte all'app attenendosi alla seguente procedura:

In CRXDE Lite:

1. Andate su /etc/designs/phonegap/<nome app>/clientlibsall.
2. Fare doppio clic sulla sezione Incorpora nel riquadro delle proprietà.
3. Nella finestra di dialogo visualizzata, aggiungere una nuova libreria client facendo clic sul pulsante +.
4. Nel nuovo campo di testo, aggiungete "cq.mobile.push" e fate clic su OK.
5. Aggiungete un’altra voce denominata cq.mobile.push.amazon e fate clic su OK.
6. Salva le modifiche.

Passaggio 4: Preparare un telefono per la verifica di

IOS

Per iOS, è necessario utilizzare un computer Mac OS e partecipare al iOS Developer Program. Alcune società dispongono di licenze aziendali che possono essere disponibili a tutti gli sviluppatori.

Con XCode 8.1, prima di utilizzare le notifiche push è necessario passare alla scheda Capacità del progetto e attivare l'opzione Notifiche push.

Android

Per installare l'app su un telefono Android utilizzando CLI (vedi sotto): Passaggio 6 - Creare e distribuire l'app), è innanzitutto necessario inserire il telefono in "modalità sviluppatore". Per ulteriori informazioni, vedere Abilitazione delle opzioni per gli sviluppatori sul dispositivo.

Passaggio 5: Configurare il push AEM app

Prima di creare e distribuire il contenuto al dispositivo mobile configurato, dovete configurare le impostazioni di notifica per il servizio di messaggistica che avete deciso di utilizzare.

1. Create i gruppi di autorizzazione appropriati per le notifiche push.
2. Accedi a AEM come utente appropriato, fai clic sulla scheda App.
3. Fai clic sull'app.
4. Trova la sezione Gestione Cloud Services e fai clic sulla matita per modificare le configurazioni cloud.
5. Selezionate connessione Amazon SNS, connessione Pushwoosh o Adobe Mobile Services come configurazione di notifica.
6. Immettete le proprietà del provider e fate clic su Invia per salvarle, quindi su Fine. In questa fase non sono verificati a distanza, salvo nel caso di AMS.
7. Ora dovresti vedere la configurazione appena inserita nella sezione Gestisci Cloud Services.

Passaggio 6: Creazione e implementazione dell'app

Nota: fare riferimento anche alle nostre istruzioni 🔗 qui sulla creazione di applicazioni PhoneGap.

Esistono due modi per creare e distribuire l'app utilizzando PhoneGap.

Nota: per il test delle notifiche push, gli emulatori non saranno sufficienti perché le notifiche push utilizzano un protocollo distinto tra il provider push (Apple o Google) e il dispositivo. L'hardware e gli emulatori Mac/PC correnti non supportano questa funzionalità.

1. PhoneGap Crea un servizio offerto da PhoneGap che creerà la vostra app per voi sui loro server e vi permetterà di scaricarla direttamente sul vostro dispositivo. Per informazioni su come impostare e utilizzare le PhoneGap Build, fare riferimento alla documentazione sulle PhoneGap Build.

2. L'interfaccia CLI (Command Line Interface) di PhoneGap consente di utilizzare un set completo di comandi PhoneGap sulla riga di comando per creare, eseguire il debug e distribuire l'app. Per informazioni su come impostare e utilizzare l'interfaccia CLI di PhoneGap, fare riferimento alla documentazione per gli sviluppatori di PhoneGap.

Passaggio 7: Invia una notifica push

Per creare una nuova notifica e inviarla, effettuate le seguenti operazioni.

1. Creare una nuova notifica

   • Nel dashboard dell'app AEM Mobile, trova la sezione Notifiche push.
   • Nel menu in alto a destra, scegliete "Crea". Questo pulsante sarà disponibile solo dopo che sarà stata impostata la configurazione cloud.
   • In Creazione guidata notifiche, inserire un titolo e un messaggio, quindi fare clic sul pulsante "Crea". La notifica è ora pronta per l'invio immediato o successivo. Può essere modificato e il messaggio e/o il titolo possono essere modificati e salvati.

2. Inviare la notifica

   • Nel dashboard App, trova la sezione Notifiche push.
   • Selezionate la notifica o fate clic sul pulsante dei dettagli in basso a destra (. . .), per visualizzare l'elenco delle notifiche. Questo elenco indica anche se una notifica è pronta per essere inviata, se è già stata inviata o se si è verificato un errore durante l'invio.
   • Selezionate la casella di controllo per una notifica (solo) e fate clic sul pulsante "Invia notifica" sopra l’elenco. Avrete una possibilità di annullare o inviare la notifica nella finestra di dialogo visualizzata.

3. Gestione dei risultati

   • Se il servizio di notifica push ( Amazon SNS o Pushwoosh) riceve la richiesta Invia, la conferma come valida e la invia correttamente ai provider nativi (APNS e GCM), la finestra di dialogo Invia si chiuderà senza messaggio. Nell'elenco delle notifiche, lo stato di tale notifica è indicato come Inviato.

   • Se l'invio push non riesce, nella finestra di dialogo viene visualizzato un messaggio che indica il problema. Nell'elenco delle notifiche, lo stato di tale notifica viene elencato come Errore, ma se il problema viene risolto, la notifica può essere inviata di nuovo. In caso di errore, nel registro errori del server dovrebbero essere visualizzate informazioni aggiuntive sull'errore.

   • Notate che ci sono alcune differenze di piattaforma tra le notifiche push di iOS e Android. Tra questi:

     • La creazione con CLI avvierà l'app dopo che sarà stata distribuita su Android. Su iOS, è necessario avviarlo manualmente. Dal momento che il passaggio di registrazione push viene eseguito all'avvio, le app Android possono ricevere notifiche push subito (perché saranno state avviate e registrate) mentre le app iOS no.
     • Su Android, il testo del pulsante OK si trova in tutte le didascalie (e in qualsiasi altro pulsante aggiunto alla notifica in-app), mentre in iOS non lo è.

Per le notifiche push AMS, le notifiche devono essere composte e inviate dal server AMS. AMS fornisce funzionalità aggiuntive di notifica push oltre a quelle fornite dalle notifiche AEM con AWS e Pushwoosh.

Configurazione dei collegamenti profondi con le notifiche push

Cos'è il collegamento profondo? Nel contesto di una notifica push, si tratta di un mezzo per consentire l'apertura o il reindirizzamento di un'app (se aperta) a una posizione specifica all'interno dell'app.

Come funziona? L'autore di una notifica push aggiunge facoltativamente un'etichetta di pulsante (ad es. "Mostrami!") alla notifica e sceglie la pagina che desiderano collegare nella notifica, tramite un browser del percorso visivo. Quando viene inviata, la notifica push viene eseguita come normale, tranne per il fatto che nel messaggio in-app, il pulsante OK viene sostituito da un pulsante "Dismiss" e il nuovo pulsante specificato ("Show me!") appare anche. Facendo clic sul nuovo pulsante l'app passerà alla pagina specificata all'interno dell'app. Fai clic su Ignora per chiudere il messaggio.

Se l'app non è aperta, l'ombreggiatura verrà visualizzata come normale. Intervenendo sulla notifica all’ombra, l’app viene aperta e gli vengono quindi presentati i pulsanti di collegamento profondo in base alla configurazione della notifica push.

Crea la notifica, aggiungi il testo di un pulsante e il percorso di collegamento per il collegamento profondo facoltativo:

1. Fate clic sulla modifica nell'angolo superiore destro della sezione Gestisci Cloud Services.

   

2. Selezionare la Connessione Pushwoosh. Fai clic su Avanti.

   

3. Immettete i dettagli delle proprietà e fate clic su Invia.

   

   Una volta inviata la configurazione, la sezione Notifiche push viene visualizzata nel dashboard.

   

Creazione guidata notifica

Quando la sezione Notifiche push viene visualizzata nel dashboard, utilizzate la procedura guidata di creazione delle notifiche per aggiungere il contenuto:

1. Fare clic sul simbolo di aggiunta nell'angolo superiore destro della sezione Notifiche push per aprire la Creazione guidata notifiche.

   

2. Facendo clic sull'icona Sfoglia nel percorso del collegamento, l'utente viene presentato con la struttura del contenuto dell'app.

   Dopo aver selezionato il percorso, fate clic sull’icona di controllo.

   

   NOTA

   Il testo del pulsante di collegamento è limitato a 20 caratteri.

   Se l'utente finale non dispone della versione più recente dell'applicazione e il percorso collegato non è disponibile, la conferma dell'azione del collegamento profondo porterà l'utente nella pagina principale dell'app.

3. Immettere i Dettagli testo nella Creazione guidata notifica e fare clic su Crea.

   

   Aprite i dettagli facendo clic sulla notifica push creata dalla sezione Notifiche push.

   Potete modificare le proprietà, inviare notifiche o eliminare la notifica.

   

Passaggi successivi

Una volta inclusi i dettagli sulle notifiche push per la tua app, vedi AEM Mobile Content Personalization.