Notifiche push

Nota

Adobe consiglia di utilizzare SPA Editor per i progetti che richiedono il rendering lato client basato sul framework di applicazioni a pagina singola (ad es. React). Per saperne di più.

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 diretto alle notifiche push.

Nota

Le notifiche push non sono garantite; sono più come annunci. Si fa il massimo sforzo per assicurarsi che tutti li ricevano ma non sono un meccanismo di consegna garantito. Inoltre, il tempo necessario per distribuire un push può variare da meno di un secondo a fino a mezz'ora.

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 i collegamenti profondi (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 avrete bisogno di un file di certificato (un file .cer), una chiave ​privata push (un file .p12) e una password di chiave privata Apple. Le istruzioni su come farlo si trovano qui.

Utilizzo del servizio Google Cloud Messaging (GCM)

Nota

Google sta sostituendo GCM con un servizio simile denominato Firebase Cloud Messaging (FCM). Per ulteriori informazioni su FCM, fare clic qui.

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

Dovrai seguire i passaggi descritti qui per creare un progetto API Google, abilitare il servizio GCM e ottenere una chiave API. Avrete bisogno della chiave ​API per inviare le notifiche push ai dispositivi Android. Inoltre, registrate il numero di progetto, talvolta denominato anche ID mittente GCM.

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

  1. Accedete a Google e andate alla pagina Sviluppatore diGoogle.
  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. Fai 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).
Nota

Registra la chiave API del server. Questo valore viene immesso nel sito del provider push.

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 SNS e Pushwoosh consentono di inviare i messaggi push dall'interno AEM schermi.

configurazione di Mobile Services Adobe 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

Nota

Informazioni su Amazon SNS e un collegamento per la creazione di un nuovo account AWS sono disponibiliqui. Potete ottenere un account gratuito per un anno.

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. Fate clic su Mostra chiave di accesso, quindi copiate e salvate 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. Fate clic su Altre azioni argomento > Modifica criterio argomento. In Consenti a questi utenti di iscriversi a questo argomento, selezionate Tutti.
    3. Fate 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 Using the Apple Push Notification Service (APNS) qui sopra.
      2. Per GCM, è necessario inserire una chiave API. Ciò dovrebbe essere ottenuto nel passaggio Utilizzo del servizio Google Cloud Messaging (GCM) riportato sopra.
    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 memorizzerà 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 tue identità Cognito richiedono l'accesso alle tue risorse") fai 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. Accesso 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).
Nota

Se una seconda app è configurata in AEM con lo stesso ID app (e altri valori correlati): Token di accesso API e ID GCM), tutte le notifiche push inviate tramite la seconda app in AEM andranno a qualsiasi altra app con tale ID app.

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"/>

Nota

Il gestore di sincronizzazione dei contenuti cerca tali nodi e, se non sono presenti, non scrive il file page-notifications-config.json.

Aggiungi librerie client

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

In CRXDE Lite:

  1. Andate a /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.
Nota

Se le notifiche push vengono rimosse o non vengono utilizzate per considerazioni relative allo spazio nell'app e per evitare messaggi di errore della console, rimuovete questi clientlibs dall'app.

Passaggio 4: Preparare un telefono per il test

Nota

Per le notifiche push, è necessario eseguire il test su un dispositivo effettivo, in quanto gli emulatori non sono in grado di ricevere le notifiche push.

IOS

Per iOS, è necessario utilizzare un computer Mac OS e partecipare all' 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 - Creazione e implementazione dell'app), devi prima mettere il telefono in "modalità sviluppatore". Per informazioni dettagliate, consultate Abilitazione delle opzioni per sviluppatori su dispositivo.

Passaggio 5: Configurare il push su 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: Creare e distribuire l'app

Nota: Consultare anche le 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 Build è 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 relativa alle 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 aver impostato 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 maiuscole (e in tutti gli altri pulsanti aggiunti 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.

Nota

Le notifiche push non sono garantite; sono più come annunci. Si fa il massimo sforzo per far sì che tutti lo sentano, ma non sono un meccanismo di consegna garantito. Inoltre, il tempo necessario per distribuire un push può variare da meno di un secondo a fino a mezz'ora.

Configurazione di 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:

ATTENZIONE

.Per accedere al riquadro delle notifiche push nel dashboard, segui i passaggi descritti di seguito.

  1. Fate clic sulla modifica nell’angolo in alto a destra della sezione Gestisci Cloud Services .

    chlimage_1-108

  2. Selezionate la connessione Pushwoosh. Fai clic su Avanti.

    chlimage_1-109

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

    chlimage_1-110

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

    chlimage_1-111

Creazione guidata notifica

Una volta che la sezione Notifiche ​push viene visualizzata nel dashboard, usate la procedura guidata di creazione delle notifiche per aggiungere il contenuto:

  1. Fate clic sul simbolo di aggiunta nell'angolo superiore destro della sezione Notifiche ​push per aprire la procedura guidata ​Crea notifica.

    chlimage_1-112

  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.

    chlimage_1-113

    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. Immettete i dettagli di testo nella procedura guidata di creazione delle notifiche e fate clic su Crea.

    chlimage_1-114

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

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

    chlimage_1-115

Nota

Informazioni aggiuntive:

Pushwoosh e Amazon SNS non saranno supportati dopo la versione 6.4 e saranno disponibili come componente aggiuntivo dalla condivisione del pacchetto.

Passaggi successivi

Una volta inclusi i dettagli sulle notifiche push per la tua app, consulta AEM Mobile Content Personalization(Personalizzazione dei contenuti).

In questa pagina