Adobe consiglia di utilizzare l'editor SPA per i progetti che richiedono il rendering lato client basato sul framework dell'applicazione 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 profondo alle notifiche push.
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 meno di 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:
Questa versione di AEM supporta i dispositivi mobili iOS e Android.
Per utilizzare le notifiche push in un'app AEM Mobile , è necessario effettuare i seguenti passaggi di alto livello.
In genere, uno sviluppatore AEM:
Mentre un amministratore AEM:
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.
Google sta sostituendo GCM con un servizio simile denominato Firebase Cloud Messaging (FCM). Per ulteriori informazioni su FCM, fare clic su qui.
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:
com.adobe.cq.mobile.weretail.outdoorsapp
. Se questo non funziona, riprovate con "test.test".Registra la chiave API del server. Questo valore viene immesso nel sito del provider push.
AEM configurato per utilizzare uno dei tre servizi per le notifiche push:
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).
Informazioni su Amazon SNS e un collegamento per la creazione di un nuovo account AWS sono disponibili qui. È possibile 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:
Registrazione con Amazon SNS
Crea chiave di accesso e ID
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:
Creare un argomento
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.
Creare applicazioni per la piattaforma
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:
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.
Creare un pool di identità
Configura accesso
{ "Versione": "2012-10-17", "Dichiarazione": [ { "Azione": [ "mobileanalytics:PutEvents", "cognito-sync:*", "SNS:CreatePlatformEndpoint", "SNS:Subscribe" ], "Effetto": "Allow", "Risorsa": [ "*" ] } ] }
|
Se non si desidera utilizzare Pushwoosh, è possibile saltare questo passaggio.
Per utilizzare Pushwoosh:
Registrati con Pushwoosh
Creare un token di accesso API
Create una nuova app
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.
Create due nodi di contenuto (uno in app-config e uno in app-config-dev) denominati notificationsConfig:
<your app>
/shell/jcr:content/page-app/app-config-dev/notificationsConfig<your app>
/shell/jcr:content/page-app/app-config/notificationsConfigCon 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"/>
Il gestore di sincronizzazione dei contenuti cerca tali nodi e, se non sono presenti, non scrive il file page-notifications-config.json.
Le librerie client di notifica push devono essere aggiunte all'app attenendosi alla seguente procedura:
In CRXDE Lite:
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.
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.
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.
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.
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.
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à.
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.
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.
Per creare una nuova notifica e inviarla, effettuate le seguenti operazioni.
Creare una nuova notifica
Inviare la notifica
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:
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.
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 meno di mezz'ora.
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:
.Per accedere al riquadro delle notifiche push nel dashboard, segui i passaggi descritti di seguito.
Fate clic sulla modifica nell'angolo superiore destro della sezione Gestisci Cloud Services.
Selezionare la Connessione Pushwoosh. Fai clic su Avanti.
Immettete i dettagli delle proprietà e fate clic su Invia.
Una volta inviata la configurazione, la sezione Notifiche push viene visualizzata nel dashboard.
Quando la sezione Notifiche push viene visualizzata nel dashboard, utilizzate la procedura guidata di creazione delle notifiche per aggiungere il contenuto:
Fare clic sul simbolo di aggiunta nell'angolo superiore destro della sezione Notifiche push per aprire la Creazione guidata notifiche.
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.
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.
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.
Informazioni aggiuntive:
Pushwoosh e Amazon SNS non saranno supportati dopo la versione 6.4 e saranno disponibili come componente aggiuntivo dalla condivisione del pacchetto.
Una volta inclusi i dettagli sulle notifiche push per la tua app, vedi AEM Mobile Content Personalization.