{"id":15985,"date":"2015-02-09T10:10:07","date_gmt":"2015-02-09T09:10:07","guid":{"rendered":"http:\/\/puship.com\/?page_id=15985"},"modified":"2020-07-20T18:12:37","modified_gmt":"2020-07-20T17:12:37","slug":"server","status":"publish","type":"page","link":"http:\/\/www.puship.com\/it\/documentazione\/server\/","title":{"rendered":"Setup lato Server"},"content":{"rendered":"
\n
    \n
  1. Creazione account<\/a><\/li>\n
  2. Creazione applicazione puship<\/a><\/li>\n
  3. Setup degli store<\/a>\n
      \n
    1. Apple Store<\/a>\n
        \n
      1. Creazione dell\u2019identifier<\/a><\/li>\n
      2. Abilitazione del certificato<\/a><\/li>\n
      3. Esportazione del certificato per Puship<\/a><\/li>\n
      4. Configurazione del Server Puship<\/a><\/li>\n
      5. Generare il Provisioning Profile<\/a><\/li>\n
      6. Associare il Profilo al Progetto<\/a>\n
          \n
        1. Su CLI<\/a><\/li>\n
        2. Sul Phonegap Online Builder<\/a><\/li>\n<\/ol>\n<\/li>\n<\/ol>\n<\/li>\n
        3. Google Play<\/a>\n
            \n
          1. Creazione del progetto Firebase<\/a><\/li>\n
          2. Configurazione del Server Puship<\/a><\/li>\n<\/ol>\n<\/li>\n
          3. Windows Store<\/a>\n
              \n
            1. Configurazione del Server Puship<\/a><\/li>\n<\/ol>\n<\/li>\n<\/ol>\n<\/li>\n
            2. Notifiche<\/a>\n
                \n
              1. Invio<\/a><\/li>\n
              2. Gestione storico<\/a><\/li>\n<\/ol>\n<\/li>\n
              3. Dispositivi<\/a>\n
                  \n
                1. Visualizzazione<\/a><\/li>\n
                2. Storico Push per Device<\/a><\/li>\n
                3. Invio singola Push<\/a><\/li>\n<\/ol>\n<\/li>\n
                4. Statistiche<\/a><\/li>\n<\/ol>\n<\/div>\n

                   <\/p>\n

                  <\/a>Creazione account<\/h2>\n

                  Per iniziare ad utilizzare Puship devi prima registrarti, la procedura \u00e8 semplice e gratuita: Vai sulla pagina membri e clicca su register<\/em><\/p>\n

                  \"Login\"<\/p>\n

                  Inserisci i tuoi dati e clicca su create user<\/em><\/p>\n

                  \"Register<\/p>\n

                  Ti verr\u00e0 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.<\/p>\n

                   <\/p>\n

                  <\/a>Creazione applicazione puship<\/h2>\n

                  Cliccando sul pulsante add new app<\/em> comparir\u00e0 un record rappresentante la tua applicazione.<\/p>\n

                  \"AddNewApp\"<\/p>\n

                  Per configurarla clicca sul pulsante Configure<\/em> come mostrato sotto<\/p>\n

                  \"Configure<\/p>\n

                  Si aprir\u00e0 una finestra che permette di configurare i vari store. Viene anche generato l\u2019 App Code<\/strong> (chiamato anche PushipAppId<\/strong>) che poi dovrai utilizzare per configurare Puship nel file www\/js\/index.js<\/em> (Es.: Puship.Register(data.registrationId, “APKCbOd72fXKVUU”);)<\/p>\n

                  \"ConfigureAppPopup\"<\/p>\n

                  A questo punto configura le piattaforme che stai supportando seguendo le seguenti guide.<\/p>\n

                   <\/p>\n

                  <\/a>Setup degli store<\/h2>\n

                  <\/a>Apple Store<\/h3>\n

                  La configurazione delle notifiche push per Apple \u00e8 un procedimento abbastanza complesso e deve essere effettuata da un Mac<\/p>\n

                  <\/a>Creazione dell’AppID<\/h4>\n

                  Accedi al Provisioning portal da questo link<\/a>, poi clicca sul pulsante + in alto per creare una nuova applicazione\"\"<\/p>\n

                  Seleziona AppIDs<\/strong> e nella schermata successiva seleziona App<\/strong> come tipo di applicazione.\"\"<\/p>\n

                  Continua e nella successiva schermata inserisci il nome dell\u2019applicazione e l\u2019Unique Identifier che vorrai utilizzare, a fondo pagina spunta Push Notifications<\/strong>, poi clicca su Continue<\/i>. Nella successiva pagina conferma la creazione dell’applicazione cliccando su Register<\/em>.\"\"\"\"<\/p>\n

                  <\/a>Abilitazione delle notifiche push<\/h4>\n

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

                  Seleziona l’app per cui stai creando il certificato e premi nuovamente continua.\"\"<\/p>\n

                  Apparir\u00e0 una schermata che richiede di avviare il programma Keychan Access<\/i> dal Mac per generare il certificato<\/p>\n

                  Vai quindi su Applications -> Utilities<\/i>
                  \n\"\"
                  \ned esegui il programma Keychan Access
                  \n\"\"
                  \nDal menu in alto a sinistra clicca ora Keychan Access -> Certificate Assistant -> Request a certificate from a Certificate Authority<\/i>
                  \n\"\"
                  \nCompila la seguente form inserendo la tua email e il nome, di nuovo la tua email e seleziona Saved to disk; Clicca poi su Continue<\/i>
                  \n\"\"
                  \nSalva il certificato dove meglio credi per completare la creazione del certificato
                  \n\"\"
                  \nOra torna sulla pagina dove veniva richiesto il certificato, carica il file appena creato e clicca sul pulsante Continue<\/i>;\"\"<\/p>\n

                  Scarica il certificato ed eseguirlo per importarlo fra i certificati della macchina (\u00e8 sufficiente cliccarci due volte).\"\"<\/p>\n

                  E\u2019 possibile controllare se \u00e8 stato importato correttamente accedendo al Keychain Access<\/em> posizionandosi sulla voce My Certificates\"\"<\/em><\/p>\n

                  <\/a>Esportazione del certificato per Puship<\/h4>\n

                  Per generare il certificato necessario a Puship, sempre dall\u2019applicazione Keychain Access<\/i> seleziona il certificato appena importato, clicca con il destro e seleziona la voce Export \u201cApple Push\u2026 \"\"<\/i><\/p>\n

                  Inserisci il nome che vuoi dare al certificato e salvalo dove meglio credi
                  \n\"\"
                  \nInserisci la password da applicare al certificato\"\"<\/p>\n

                  Se richiesta, inserisci anche la password di sistema; a questo punto hai a disposizione il certificato .p12 da utilizzare su Puship.<\/p>\n

                   <\/p>\n

                  <\/a>Configurazione del Server Puship<\/h4>\n

                  Per configurare il server Puship:<\/p>\n

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

                     <\/p>\n

                    <\/a>Generare il Provisioning Profile<\/h4>\n

                    Dal menu di sinistra clicca su Profiles<\/em> e poi sul pulsante + in alto\"\"
                    \nNel wizard che segue seleziona App Store<\/strong> come tipo di distribuzione che stai effettuando\"\"<\/p>\n

                    clicca Continue<\/em> 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.\"\"<\/p>\n

                    ti verr\u00e0 chiesto il nome del profilo e successivamente apparir\u00e0 la seguente schermata per il download del certificato\"\"
                    \nScarica il profilo appena creato ed eseguilo con un doppio click per aggiungerlo alla lista dei provisioning del tuo sistema.<\/p>\n

                    Continua con i prossimi step per poter buildare il progetto<\/p>\n

                     <\/p>\n

                    <\/a>Associare il profilo al Progetto<\/h4>\n
                    <\/a>Su CLI<\/h5>\n

                    Nell root del progetto crea un file chiamato build.json e copia all’interno il seguente testo:<\/p>\n

                    {\n  \"ios\": {\n    \"debug\": {\n      \"codeSignIdentity\": \"iPhone Developer\",\n      \"developmentTeam\": \"YOUR-TEAM-ID\", \/\/Example : 7FSXXXXXXX\n      \"packageType\": \"development\",\n      \"automaticProvisioning\": true\n    },\n    \"release\": {\n      \"codeSignIdentity\": \"iPhone Developer\",\n      \"developmentTeam\": \"YOUR-TEAM-ID\", \/\/Example : 7FSXXXXXXX\n      \"packageType\": \"app-store\",\n      \"automaticProvisioning\": true\n    }\n  }\n}<\/pre>\n
                    Il Team ID \u00e8 quel codice in alto a destra della console di amministrazione\"\"<\/p>\n
                    Il setup \u00e8 stato molto laborioso ma\u2026 ora puoi compilare il progetto e sei pronto per ricevere notifiche push!<\/p>\n
                    <\/a>Sul Phonegap Online Builder<\/h5>\n
                    La configurazione per phonegap online builder \u00e8 spiegata molto dettagliatamente a questo link<\/a>. In alternativa puoi visualizzare il tutorial video in questa<\/a> sezione dove viene spiegato passo passo come creare il progetto con l’online build di adobe<\/p>\n
                     <\/p>\n
                    <\/a>Google Play<\/h3>\n
                    La configurazione dell\u2019account Google play \u00e8 molto semplice, prima di tutto bisogna dire che Google non fa differenze fra sviluppo e produzione<\/p>\n
                    <\/a>Creazione del progetto Firebase<\/h4>\n
                    Per creare il progetto Firebase:<\/p>\n
                      \n
                    1. Apri la console di Firebase<\/a>.<\/li>\n
                    2. Clicca sul pulsante Aggiungi Progetto\"\"<\/li>\n
                    3. Inserisci il nome del progetto\"\"<\/li>\n
                    4. Verrai rediretto alla pagina di panoramica del tuo progetto, clicca sull’icona Android\"\"<\/li>\n
                    5. Inserisci il package che hai utilizzato per la tua applicazione  (il resto dei campi \u00e8 opzionale):\"\"<\/li>\n
                    6. Scarica il google service json e copialo sulla root del tuo progetto cordova\/phonegap\"\"<\/li>\n
                    7. Modifica il file config.xml aggiungendo la seguente riga:\n
                       <\/pre>\n
                      \"\"<\/li>\n
                    8. Completa il wizard (non \u00e8 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<\/strong>\"\"<\/li>\n
                    9. Spostati sul tab Cloud Messaging e prendi nota del Sender ID<\/strong> e della Server Key<\/strong> dovrai inserirli nella configurazione server di Puship.\"\"<\/li>\n<\/ol>\n
                      <\/a>Configurazione del Server Puship<\/h4>\n
                      Per configurare il server Puship:<\/p>\n
                        \n
                      1. Se non hai ancora creato l’app segui le istruzioni presenti al punto 2<\/a>, se l’app \u00e8 gia presente \u00e8 sufficiente cliccare sul bottone Configure<\/i> dell’app esistente.<\/li>\n
                      2. Spostati sul tab Google Play:\"\"<\/li>\n
                      3. Spunta il campo Enabled per abilitare il servizio Push.<\/li>\n
                      4. Inserisci i valori del Sender ID e dell’ API key ottenuti nel paragrafo precedente<\/li>\n
                      5. Il package name<\/strong> non \u00e8 altro che il PakageID  della tua applicazione che trovi nel file Config.xml<\/em> all’interno del tuo progetto<\/li>\n
                      6. Spunta il campo Use Firebase (se disabilitato vengono utilizzate le vecchie API google GCM – deprecate e non pi\u00f9 supportata<\/a>)<\/li>\n
                      7. Clicca su Save<\/i> per completare la configurazione, il server \u00e8 ora configurato per inviare notifiche push ai device registrati.<\/span><\/li>\n<\/ol>\n
                         <\/p>\n
                        <\/a>Windows Store<\/h3>\n
                        Fortunatamente in MS hanno deciso di renderci la vita facile e non \u00e8 necessaria nessuna configurazione per poter cominciare ad inviare notifiche push in Windows Phone.<\/p>\n
                        <\/a>Configurazione del Server Puship<\/p>\n
                        Per configurare il server Puship sar\u00e0 sufficente:<\/p>\n
                          \n
                        1. Se non hai ancora creato l’app segui le istruzioni presenti al punto 2<\/a>, se l’app \u00e8 gia presente clicca sul bottone Configure<\/i> dell’app esistente.<\/li>\n
                        2. Spostati sul tab Microsoft Market:
                          \n\"ConfigureAppPopup\"<\/li>\n
                        3. Spunta il campo Enabled per abilitare il servizio di notifiche push.<\/li>\n
                        4. Clicca su Save<\/i> per completare la configurazione, il server \u00e8 ora configurato per inviare notifiche push ai device registrati.<\/li>\n<\/ol>\n
                           <\/p>\n
                          <\/a>Notifiche<\/h2>\n
                          <\/a>Invio<\/h3>\n
                          Per cominciare ad inviare notifiche push premi sul bottone Send Push Notification<\/em>, come indicato nell\u2019immagine sotto \"PushButton\"<\/p>\n
                          Si aprir\u00e0 una finestra nella quale \u00e8 possibile scegliere quali sono le piattaforme di destinazione, se le piattaforme non sono state abilitate esse non saranno selezionabili.<\/p>\n
                          \"Send<\/p>\n
                          Imposta il messaggio da inviare, il badge da visualizzare e il suono che vuoi eseguire al momento della ricezione. Nel campo Tags<\/em> 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\u00e0 inviata a tutti i dispositivi. Cliccando sul bottone Add geolocation<\/em> si attiver\u00e0 l\u2019invio in base all\u2019ultima posizione registrata dal dispositivo, nello screen successivo viene mostrato come stia per essere inviata una notifica push solo a quei dispositivi registrati a Venezia
                          \n                          <\/a>
                          \n\"Invia<\/p>\n
                          Cliccando invece sulla combo Params<\/em> 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.
                          \n                          <\/a>
                          \n\"Invia<\/p>\n
                          E\u2019 possibile selezionare due modalit\u00e0 di invio della notifica push, la modalit\u00e0 Push<\/strong> tradizionale, che invia la notifica e salva il messaggio nel database Puship per permetterne la successiva lettura attraverso i servizi Puship; oppure la modalit\u00e0 Ship<\/strong>, che non<\/strong> invia la notifica push, ma salva solamente il messaggio nel database. Questa seconda modalit\u00e0 potrebbe essere utile quando si necessita di aggiungere messaggi all\u2019applicazione in modo trasparente, senza segnalarlo all\u2019utente.<\/p>\n
                          \"Push<\/p>\n
                          Una volta inviata la notifica viene visualizzato un veloce resoconto dei telefoni raggiunti dalla notifica push.<\/p>\n
                           <\/p>\n
                          <\/a>Gestione storico<\/h3>\n
                          Premendo il bottone Manage Push Notification<\/em> si pu\u00f2 accedere allo storico delle notifiche push<\/p>\n
                          \"Gestione<\/p>\n
                          Da qui \u00e8 possibile vedere dettagliatamente a che dispositivi erano state inviate, i messaggi e i Tag selezionati.<\/p>\n
                          Per effettuare una veloce modifica del messaggio \u00e8 sufficiente effettuare un doppio click sul testo, editarlo e all\u2019uscita dal campo l\u2019informazione sar\u00e0 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.<\/p>\n
                          \"Modifica<\/p>\n
                          Come puoi vedere nell\u2019ultima 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\u00e0 di inviarla nuovamente.<\/p>\n
                           <\/p>\n
                          <\/a>Dispositivi<\/h2>\n
                          <\/a>Visualizzazione<\/h3>\n
                          Per visualizzare la lista dei dispositivi registrati premi sul bottone Show registered Devices<\/em>, come indicato nell\u2019immagine sotto \"Show<\/p>\n
                          Si aprir\u00e0 una finestra nella quale \u00e8 possibile visulizzare tutti i dispositivi registrati, per ogni dispositivo \u00e8 possibile espandare un dettaglio e visualizzare quali Tag gli solo stati associati.<\/p>\n
                          \"Send<\/p>\n
                          Con il comando Set Expired<\/em> visualizzato sotto \u00e8 possibile disabilitare temporaneamente i device (fino a nuova registrazione).<\/p>\n
                          \"Disabilita<\/p>\n
                           <\/p>\n
                          <\/a>Storico Push per Device<\/h3>\n
                          Premendo sul bottone Show Push<\/em> \u00e8 possibile visualizzare lo storico delle push inviate al dispositivo, le stesse che risulterebbero alla chiamata del metodo GetPushByDevice<\/a><\/p>\n
                          \"Comando<\/p>\n
                          Da questa pagina \u00e8 possibile modificare le push precedentemente inviate, eliminarle e visualizzare quanti dispositivi sono stati raggiunti e che quindi visualizzano la stessa push.<\/p>\n
                          \"Storico<\/p>\n
                          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.<\/p>\n
                           <\/p>\n
                          <\/a>Invio singola Push<\/h3>\n
                          Premendo sul bottone Show Push Notification<\/em> \u00e8 possibile inviare una push ad un singolo dispositivo<\/p>\n
                          \"Comando<\/p>\n
                          L’invio singolo non presenta nessun tipo di filtro, \u00e8 sufficiente inserire il messaggio da inviare e premere Push<\/em><\/p>\n
                          \"Invia<\/p>\n
                           <\/p>\n
                          <\/a>Statistiche<\/h2>\n
                          Per ogni applicazione viene fornito un compatto sistema di reporting, per accederci \u00e8 sufficiente cliccare sul bottone See statistics<\/em> come visualizzato sull\u2019immagine sotto<\/p>\n
                          \"Statistiche\"<\/p>\n
                          Sono disponibili 3 tipi di report:<\/p>\n
                            \n
                          • Push Sent by Platform<\/strong>, dove viene visualizzato il numero di notifiche push inviato<\/li>\n<\/ul>\n
                            \"Report<\/p>\n
                              \n
                            • Unique access<\/strong>, dove viene visualizzato il numero di dispositivi unici che ha utilizzato i metodi di Puship<\/li>\n<\/ul>\n
                              \"Report<\/p>\n
                                \n
                              • Sent\/Access<\/strong>, dove vengono sovrapposti i precedenti due report per dare un\u2019idea della risposta del \u201cpubblico\u201d in base alle notifiche push inviate<\/li>\n<\/ul>\n
                                \"Report<\/p>\n","protected":false},"excerpt":{"rendered":"
                                Creazione account Creazione applicazione puship Setup degli store Apple Store Creazione dell\u2019identifier Abilitazione del certificato Esportazione del certificato per Puship Configurazione del Server Puship Generare il Provisioning Profile Associare il Profilo al Progetto Su CLI Sul Phonegap Online Builder Google Play Creazione del progetto Firebase…<\/p>\n","protected":false},"author":1,"featured_media":0,"parent":56,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":[],"_links":{"self":[{"href":"http:\/\/www.puship.com\/it\/wp-json\/wp\/v2\/pages\/15985\/"}],"collection":[{"href":"http:\/\/www.puship.com\/it\/wp-json\/wp\/v2\/pages\/"}],"about":[{"href":"http:\/\/www.puship.com\/it\/wp-json\/wp\/v2\/types\/page\/"}],"author":[{"embeddable":true,"href":"http:\/\/www.puship.com\/it\/wp-json\/wp\/v2\/users\/1\/"}],"replies":[{"embeddable":true,"href":"http:\/\/www.puship.com\/it\/wp-json\/wp\/v2\/comments\/?post=15985"}],"version-history":[{"count":100,"href":"http:\/\/www.puship.com\/it\/wp-json\/wp\/v2\/pages\/15985\/revisions\/"}],"predecessor-version":[{"id":18092,"href":"http:\/\/www.puship.com\/it\/wp-json\/wp\/v2\/pages\/15985\/revisions\/18092\/"}],"up":[{"embeddable":true,"href":"http:\/\/www.puship.com\/it\/wp-json\/wp\/v2\/pages\/56\/"}],"wp:attachment":[{"href":"http:\/\/www.puship.com\/it\/wp-json\/wp\/v2\/media\/?parent=15985"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}