Setup lato Server

Creazione account

Per iniziare ad utilizzare Puship devi prima registrarti, la procedura è semplice e gratuita: Vai sulla pagina membri e clicca su register

Inserisci i tuoi dati e clicca su create user

Ti verrà inviata una mail con un link per poter confermare il tuo account. Una volta confermato torna nella pagina di login e inserisci il tuo Username e Password.

Creazione applicazione puship

Cliccando sul pulsante add new app comparirà un record rappresentante la tua applicazione.

Per configurarla clicca sul pulsante Configure come mostrato sotto

Si aprirà una finestra che permette di configurare i vari store. Viene anche generato l’ App Code (chiamato anche PushipAppId) che poi dovrai utilizzare per configurare Puship nel file www/js/index.js (Es.: Puship.Register(data.registrationId, “APKCbOd72fXKVUU”);)

A questo punto configura le piattaforme che stai supportando seguendo le seguenti guide.

Setup degli store

Apple Store

La configurazione delle notifiche push per Apple è un procedimento abbastanza complesso e deve essere effettuata da un Mac

Creazione dell’AppID

Accedi al Provisioning portal da questo link, poi clicca sul pulsante + in alto per creare una nuova applicazione

Seleziona AppIDs e nella schermata successiva seleziona App come tipo di applicazione.

Continua e nella successiva schermata inserisci il nome dell’applicazione e l’Unique Identifier che vorrai utilizzare, a fondo pagina spunta Push Notifications, poi clicca su Continue. Nella successiva pagina conferma la creazione dell’applicazione cliccando su Register.

Abilitazione delle notifiche push

Dal menù di sinistra clicca ora su certificates e poi sul pulsante + in alto per creare un nuovo certificato
Seleziona Apple Push Notification Service SSL (Sandbox e Production) come tipo di servizio, quindi premi continua. Questa tipologia è valida sia per lo sviluppo che per la produzione, non avrai quindi bisogno di creare un’altro certificato quando pubblicherai l’applicazione.

Seleziona l’app per cui stai creando il certificato e premi nuovamente continua.

Apparirà una schermata che richiede di avviare il programma Keychan Access dal Mac per generare il certificato

Vai quindi su Applications -> Utilities

ed esegui il programma Keychan Access

Dal menu in alto a sinistra clicca ora Keychan Access -> Certificate Assistant -> Request a certificate from a Certificate Authority

Compila la seguente form inserendo la tua email e il nome, di nuovo la tua email e seleziona Saved to disk; Clicca poi su Continue

Salva il certificato dove meglio credi per completare la creazione del certificato

Ora torna sulla pagina dove veniva richiesto il certificato, carica il file appena creato e clicca sul pulsante Continue;

Scarica il certificato ed eseguirlo per importarlo fra i certificati della macchina (è sufficiente cliccarci due volte).

E’ possibile controllare se è stato importato correttamente accedendo al Keychain Access posizionandosi sulla voce My Certificates

Esportazione del certificato per Puship

Per generare il certificato necessario a Puship, sempre dall’applicazione Keychain Access seleziona il certificato appena importato, clicca con il destro e seleziona la voce Export “Apple Push…

Inserisci il nome che vuoi dare al certificato e salvalo dove meglio credi

Inserisci la password da applicare al certificato

Se richiesta, inserisci anche la password di sistema; a questo punto hai a disposizione il certificato .p12 da utilizzare su Puship.

Configurazione del Server Puship

Per configurare il server Puship:

1. Se non hai ancora creato l’app segui le istruzioni presenti al punto 2, se l’app è gia presente è sufficente cliccare sul bottone Configure dell’app esistente.
2. Spostati sul tab Apple Store:
   
3. Spunta il campo Enabled per abilitare il servizio Apple Push.
4. Spunta il campo Development per abilitare l’invio a device di sviluppo (dovrai ricordarti di rimuovere questa spunta quando pubblicherai l’app sullo store).
5. Seleziona il certificato con estensione .p12 creato nel capitolo precedente e inserici la password utilizzata per esportarlo.
6. Clicca su Save per completare la configurazione, il server è ora configurato per inviare notifiche push ai device registrati.

Generare il Provisioning Profile

Dal menu di sinistra clicca su Profiles e poi sul pulsante + in alto
Nel wizard che segue seleziona App Store come tipo di distribuzione che stai effettuando

clicca Continue e seleziona l’applicazione per la quale stai creando il certificato, Prosegui e come mostrato nello screen successivo, seleziona il certificato al quale associare questo profilo.

ti verrà chiesto il nome del profilo e successivamente apparirà la seguente schermata per il download del certificato
Scarica il profilo appena creato ed eseguilo con un doppio click per aggiungerlo alla lista dei provisioning del tuo sistema.

Continua con i prossimi step per poter buildare il progetto

Associare il profilo al Progetto

Su CLI

Nell root del progetto crea un file chiamato build.json e copia all’interno il seguente testo:

{
  "ios": {
    "debug": {
      "codeSignIdentity": "iPhone Developer",
      "developmentTeam": "YOUR-TEAM-ID", //Example : 7FSXXXXXXX
      "packageType": "development",
      "automaticProvisioning": true
    },
    "release": {
      "codeSignIdentity": "iPhone Developer",
      "developmentTeam": "YOUR-TEAM-ID", //Example : 7FSXXXXXXX
      "packageType": "app-store",
      "automaticProvisioning": true
    }
  }
}

Il Team ID è quel codice in alto a destra della console di amministrazione

Il setup è stato molto laborioso ma… ora puoi compilare il progetto e sei pronto per ricevere notifiche push!

Sul Phonegap Online Builder

La configurazione per phonegap online builder è spiegata molto dettagliatamente a questo link. In alternativa puoi visualizzare il tutorial video in questa sezione dove viene spiegato passo passo come creare il progetto con l’online build di adobe

Google Play

La configurazione dell’account Google play è molto semplice, prima di tutto bisogna dire che Google non fa differenze fra sviluppo e produzione

Creazione del progetto Firebase

Per creare il progetto Firebase:

1. Apri la console di Firebase.
2. Clicca sul pulsante Aggiungi Progetto
3. Inserisci il nome del progetto
4. Verrai rediretto alla pagina di panoramica del tuo progetto, clicca sull’icona Android
5. Inserisci il package che hai utilizzato per la tua applicazione  (il resto dei campi è opzionale):
6. Scarica il google service json e copialo sulla root del tuo progetto cordova/phonegap
7. Modifica il file config.xml aggiungendo la seguente riga:

   

8. Completa il wizard (non è necessario fare altre operazioni) e verrai rediretto alla console di amministrazione dell’applicazione. Clicca sull’ingranaggio in alto a sinistra e quindi su Project Settings
9. Spostati sul tab Cloud Messaging e prendi nota del Sender ID e della Server Key dovrai inserirli nella configurazione server di Puship.

Configurazione del Server Puship

Per configurare il server Puship:

1. Se non hai ancora creato l’app segui le istruzioni presenti al punto 2, se l’app è gia presente è sufficiente cliccare sul bottone Configure dell’app esistente.
2. Spostati sul tab Google Play:
3. Spunta il campo Enabled per abilitare il servizio Push.
4. Inserisci i valori del Sender ID e dell’ API key ottenuti nel paragrafo precedente
5. Il package name non è altro che il PakageID  della tua applicazione che trovi nel file Config.xml all’interno del tuo progetto
6. Spunta il campo Use Firebase (se disabilitato vengono utilizzate le vecchie API google GCM – deprecate e non più supportata)
7. Clicca su Save per completare la configurazione, il server è ora configurato per inviare notifiche push ai device registrati.

Windows Store

Fortunatamente in MS hanno deciso di renderci la vita facile e non è necessaria nessuna configurazione per poter cominciare ad inviare notifiche push in Windows Phone.

Configurazione del Server Puship

Per configurare il server Puship sarà sufficente:

1. Se non hai ancora creato l’app segui le istruzioni presenti al punto 2, se l’app è gia presente clicca sul bottone Configure dell’app esistente.
2. Spostati sul tab Microsoft Market:
   
3. Spunta il campo Enabled per abilitare il servizio di notifiche push.
4. Clicca su Save per completare la configurazione, il server è ora configurato per inviare notifiche push ai device registrati.

Notifiche

Invio

Per cominciare ad inviare notifiche push premi sul bottone Send Push Notification, come indicato nell’immagine sotto

Si aprirà una finestra nella quale è possibile scegliere quali sono le piattaforme di destinazione, se le piattaforme non sono state abilitate esse non saranno selezionabili.

Imposta il messaggio da inviare, il badge da visualizzare e il suono che vuoi eseguire al momento della ricezione. Nel campo Tags seleziona i tag da usare come filtro per l’invio delle notifiche push, se la combo risulta vuota significa che ancora nessun dispositivo ha associato tags a questa applicazione. Se non selezioni nessun tag la notifica sarà inviata a tutti i dispositivi. Cliccando sul bottone Add geolocation si attiverà l’invio in base all’ultima posizione registrata dal dispositivo, nello screen successivo viene mostrato come stia per essere inviata una notifica push solo a quei dispositivi registrati a Venezia

Cliccando invece sulla combo Params si possono allegare dei parametri alla push che si sta per inviare. E’ possibile inserire link, numeri, date e testo semplice fino ad un massimo di 255 caratteri.

E’ possibile selezionare due modalità di invio della notifica push, la modalità Push tradizionale, che invia la notifica e salva il messaggio nel database Puship per permetterne la successiva lettura attraverso i servizi Puship; oppure la modalità Ship, che non invia la notifica push, ma salva solamente il messaggio nel database. Questa seconda modalità potrebbe essere utile quando si necessita di aggiungere messaggi all’applicazione in modo trasparente, senza segnalarlo all’utente.

Una volta inviata la notifica viene visualizzato un veloce resoconto dei telefoni raggiunti dalla notifica push.

Gestione storico

Premendo il bottone Manage Push Notification si può accedere allo storico delle notifiche push

Da qui è possibile vedere dettagliatamente a che dispositivi erano state inviate, i messaggi e i Tag selezionati.

Per effettuare una veloce modifica del messaggio è sufficiente effettuare un doppio click sul testo, editarlo e all’uscita dal campo l’informazione sarà aggiornata. Questa operazione non invia nuovamente la notifica push, ma modifica solamente il valore nel database Puship, correggendo di conseguenza le sezioni che ne fanno uso nei device.

Come puoi vedere nell’ultima colonna dello screenshot sopra per ogni notifica ci sono a disposizione due bottoni, il primo permette di eliminare la notifica dal database Puship, il secondo permette di visualizzare e modificare tutte le informazioni relative alla notifica e da la possibilità di inviarla nuovamente.

Dispositivi

Visualizzazione

Per visualizzare la lista dei dispositivi registrati premi sul bottone Show registered Devices, come indicato nell’immagine sotto

Si aprirà una finestra nella quale è possibile visulizzare tutti i dispositivi registrati, per ogni dispositivo è possibile espandare un dettaglio e visualizzare quali Tag gli solo stati associati.

Con il comando Set Expired visualizzato sotto è possibile disabilitare temporaneamente i device (fino a nuova registrazione).

Storico Push per Device

Premendo sul bottone Show Push è possibile visualizzare lo storico delle push inviate al dispositivo, le stesse che risulterebbero alla chiamata del metodo GetPushByDevice

Da questa pagina è possibile modificare le push precedentemente inviate, eliminarle e visualizzare quanti dispositivi sono stati raggiunti e che quindi visualizzano la stessa push.

Attenzione che la modifica o l’eliminazione di una push condivisa con altri device comporta la visualizzazione della modifica per tutti i device che la condividono.

Invio singola Push

Premendo sul bottone Show Push Notification è possibile inviare una push ad un singolo dispositivo

L’invio singolo non presenta nessun tipo di filtro, è sufficiente inserire il messaggio da inviare e premere Push

Statistiche

Per ogni applicazione viene fornito un compatto sistema di reporting, per accederci è sufficiente cliccare sul bottone See statistics come visualizzato sull’immagine sotto

Sono disponibili 3 tipi di report:

• Push Sent by Platform, dove viene visualizzato il numero di notifiche push inviato

• Unique access, dove viene visualizzato il numero di dispositivi unici che ha utilizzato i metodi di Puship

• Sent/Access, dove vengono sovrapposti i precedenti due report per dare un’idea della risposta del “pubblico” in base alle notifiche push inviate