Introduzione

Nel menu Branded Mobile App Publisher in piattaforma, è possibile abilitare le notifiche push, brevi messaggi inviati tramite la propria app mobile branded anche quando l’app non è aperta e che gli utenti visualizzano nell’area di notifica o nella schermata di blocco del proprio dispositivo. Una volta abilitate, si potranno ricevere le notifiche push nella propria app mobile branded. Questo tipo di notifica è utilizzato dal Virtual Coach per tenere aggiornati gli utenti relativamente a contenuti che potrebbero interessare loro o ad attività che devono completare.

Per scoprire come abilitare le notifiche push nella tab Proprietà del menu Branded Mobile App Publisher, fare riferimento alla sezione Abilitare le Notifiche Push in questo articolo.

Per fruire di una guida tecnica dettagliata in cui viene spiegato come configurare il branded mobile app publisher per inviare notifiche push alle applicazioni branded e raccogliere dati analitici, e abilitare il login con Google (Google Sign-In) utilizzando Gmail o Google Apps, leggere le sezioni seguenti di questo articolo.

Quando si configurano le notifiche push per la propria app mobile branded, ci si trova di fronte a tre diversi scenari, a seconda delle funzionalità desiderate:

1. Abilitare le Notifiche Push e Analytics
2. Abilitare Google Sign-In
3. Abilitare Notifiche Push e Analytics E ANCHE Google Sign-In

Si sceglierà di abilitare Google Analytics per Firebase se si vogliono raccogliere dati analitici riguardo all’uso dell’app, mentre si deciderà di abilitare Google Sign-In (il login con Google) se la propria azienda possiede e utilizza una Google G Suite per la gestione degli utenti e quindi si ha la necessità che i propri utenti si connettano alla piattaforma Docebo tramite l’account Google.

Attenzione: la configurazione delle notifiche push nel proprio Branded Mobile App Publisher è una funzionalità molto tecnica. Contattare un membro del reparto IT della propria azienda che ha accesso a tutte le credenziali richieste per svolgere la configurazione.

Si noti inoltre che Docebo non è responsabile del contenuto dei documenti esterni scritti da altre aziende (ad es. Apple, Google, ecc). Ricordare che è propria responsabilità controllare se questi documenti vengono aggiornati o modificati in alcun modo.

Creare un Progetto in Firebase

Per creare un progetto in Google Firebase, è necessario avere un account Google con cui si può accedere alla piattaforma di sviluppo di applicazioni Google Firebase.

Dopo essersi connessi a Firebase, premere il bottone Create a project per iniziare a creare un nuovo progetto in Firebase.  Si aprirà una procedura guidata composta da tre fasi. Nella prima, digitare un nome per il nuovo progetto, accettare i termini, quindi premere Continue. Nella seconda fase, leggere le informazioni su Google Analytics, quindi premere di nuovo Continue.

Ora, nella terza ed ultima fase (Configure Google Analytics), selezionare un’area geografica per i dati di analisi, accettare le condizioni, quindi premere il bottone Create project per creare il progetto. Congratulazioni, è stato creato il proprio progetto in Google Firebase!  

Creare un’App iOS nel Proprio Progetto Firebase

Per creare un’applicazione iOS nel proprio progetto in Firebase, una volta creato il proprio progetto in Firebase, cliccare sull’icona ingranaggio accanto all’opzione Project Overview nella barra laterale, quindi selezionare le impostazioni del progetto (opzione Project settings).

Nella sezione Your Apps nella tab General (la prima tab sulla sinistra), si vedranno alcune icone. Cliccare sull’icona iOS. Si aprirà una procedura guidata. Nella prima fase, digitare all’interno del campo di testo iOS bundle ID l’ID unico che si è utilizzato nel servizio App Store Connect e nella sezione Identifiers manager dell’Apple Developer Console per creare l’app iOS. Quindi, scegliere un nickname per l’app e digitarlo nel campo corrispondente. Infine, compilare il campo App Store ID (anche se è contrassegnato come facoltativo). Al termine, cliccare il bottone Register app per registrare la propria app. Nella seconda fase della procedura, premere il bottone Download GoogleService-Info.plist.

Attenzione: è necessario caricare questo file nel campo Configuration File della tab iOS (sezione Impostazioni, sottosezione Servizi Google) nella pagina Branded Mobile App Publisher nella propria piattaforma Docebo.

Al termine, premere Next. Nella terza e nella quarta fase della procedura, semplicemente premere Next, mentre nella quinta e ultima fase, selezionare il link Skip this step per saltare la fase. Si vedrà ora l’app appena creata nella sezione Your apps della tab General del proprio progetto in Google Firebase.

Caricare le APNs Key iOS

Per poter inviare notifiche push ai dispositivi iOS, è necessario creare una chiave di autenticazione APNs (Apple Push Notifications service, servizio notifiche push di Apple) nell’Apple Developer Console, associarla alla propria app iOS e quindi caricare la private key nelle impostazioni del progetto di Firebase. Attenzione: la stessa private key è utilizzata per tutte le proprie app.

Iniziare connettendosi all’Apple Developer Console e raggiungere la sezione Certificates, Identifiers & Profiles. Quindi, spostarsi nella sezione Keys selezionando l’opzione corrispondente sulla sinistra della pagina. Una volta in questa sezione, premere l’icona più. Inserire un nome per la nuova chiave nel campo Key Name e selezionare l’opzione Apple Push Notifications service (APNs). Quindi, premere Continue. Nella pagina che si apre, selezionare il bottone Register. 

Una volta terminato il processo di caricamento, è possibile scaricare la chiave. 

Attenzione: il bottone Download può essere selezionato soltanto una volta, quindi è importante ricordare di conservare la key in un luogo sicuro, perché se la si perde bisogna crearne una nuova e quindi aggiornare tutti i servizi attivi utilizzando la nuova chiave.

Selezionare ora l’opzione Identifiers nella parte sinistra della pagina per accedere alla sezione Identifiers della pagina Apple Developer Console, dove si selezioneranno gli identificativi della propria app. Una volta in questa sezione, premere l’icona più, quindi scegliere l’opzione App IDs. Quindi, premere Continue per continuare. Nel campo Bundle ID, inserire il bundle ID (si ricordi che è lo stesso che si è inserito durante il processo di creazione dell’app iOS seguito nella sezione Creare un’App iOS nel Proprio Progetto Firebase di questo articolo) ed aggiungere una descrizione dell’app che si sta creando nel campo corrispondente. A questo punto, selezionare l’opzione Push Notifications. Una volta selezionata la casella di spunta Push Notifications, si verrà reindirizzati alla pagina che mostra tutti gli identificativi, dove si troverà l’identificativo appena creato.

Connettersi ora a Firebase Console, cliccare l’icona ingranaggio accanto all’opzione Project Overview nella barra laterale, quindi selezionare le impostazioni del progetto (opzione Project settings) e accedere alla tab Cloud Messaging (seconda tab a partire da sinistra). Qui, raggiungere la sezione relativa alla configurazione delle app iOS (iOS app configuration). Nella sottosezione APNs Authentication Key, caricare la chiave scaricata in precedenza dall’Apple Developer Console, e compilare i campi Key ID e Team ID. Al termine, cliccare Upload per caricare l’APNs authentication key. Il proprio progetto Firebase è ora collegato all’app nell’Apple Developer Console. 

Creare un’App Android nel Proprio Progetto Firebase

Per creare un’applicazione Android nel proprio progetto in Firebase, una volta creato il proprio progetto in Firebase, cliccare sull’icona ingranaggio accanto all’opzione Project Overview nella barra laterale, quindi selezionare le impostazioni del progetto (opzione Project settings).

Nella sezione Your Apps nella tab General (la prima tab sulla sinistra), si vedranno alcune icone. Cliccare sull’icona Android. Si aprirà una procedura guidata. Nella prima fase, digitare all’interno del campo di testo Android Package Name il nome del pacchetto che si è utilizzato nella pagina Branded Mobile App Publisher nella propria piattaforma Docebo (tab Android, sezione Impostazioni).

Quindi, scegliere un nickname per l’app e digitarlo nel campo corrispondente. Al termine, cliccare il bottone Register app per registrare la propria app. Nella seconda fase della procedura, premere il bottone Download google-services.json.

Attenzione: è necessario caricare questo file nel campo Configuration File della tab Android (sezione Impostazioni, sottosezione Servizi Google) nella pagina Branded Mobile App Publisher nella propria piattaforma Docebo.

Al termine, premere Next. Nella terza fase della procedura, semplicemente premere Next, mentre nella quarta fase, selezionare il link Skip this step per saltare la fase. Si vedrà ora l’app appena creata nella sezione Your apps della tab General del proprio progetto in Google Firebase.

Abilitare le Notifiche Push e Analytics

Per inviare notifiche push ai dispositivi mobile, Go.Learn e le app mobile branded create da Docebo utilizzano Firebase Cloud Messaging (FCM), un servizio nella piattaforma di sviluppo di applicazioni Google Firebase. Si tratta di un servizio gratuito che chiunque può utilizzare per inviare notifiche push ai dispositivi mobile. Questa è una guida completa sul servizio Firebase Cloud Messaging.

Per abilitare le notifiche push e Analytics, accedere al Menu Amministrazione dall’icona ingranaggio in alto a destra nella propria piattaforma desktop. Quindi, selezionare l’opzione Branded Mobile App Publisher nella sezione Impostazioni Temi. Nella pagina Branded Mobile App Publisher, configurare i campi dettagliati nei prossimi paragrafi (questi campi si trovano nelle tab Proprietà, iOS e Android della pagina).

Tab Proprietà

Nella prima tab, Proprietà, configurare il campo ID Progetto e il campo Configuration File Service Accounts Firebase. Entrambi questi campi si trovano nella sezione Notifiche Push della tab Proprietà nella piattaforma Docebo.

• Campo ID Progetto: innanzitutto, connettersi al proprio account aziendale di Firebase e creare un progetto (fare riferimento alla sezione Creare un Progetto in Firebase qui sopra per ulteriori informazioni). Una volta creato il progetto in Firebase, cliccare sull’icona ingranaggio accanto all’opzione Project Overview nella barra laterale, quindi selezionare le impostazioni del progetto (opzione Project settings). Nella sezione Your Project nella tab General (la prima tab sulla sinistra), si troverà l’ID del progetto (Project ID). Copiare questo testo da Firebase e incollarlo nel campo ID Progetto nella propria piattaforma Docebo.
• Campo Configuration File Service Accounts Firebase: iniziare connettendosi al proprio account aziendale di Firebase e, all’interno del progetto Firebase, cliccare sull’icona ingranaggio accanto all’opzione Project Overview nella barra laterale, quindi selezionare le impostazioni del progetto (opzione Project settings). Accedere alla tab Service Accounts, quindi cliccare Generate New Private Key (genera nuova chiave privata) in fondo alla tab. Si aprirà una finestra pop up, dove si dovrà confermare la propria azione cliccando Generate Key. A questo punto, scaricare il file json da Firebase e caricarlo nel campo Configuration File Service Accounts Firebase nella propria piattaforma Docebo.

Tab iOS

Nella seconda tab, iOS, si configureranno i campi Google iOS Client ID, Google Web Client ID e Configuration File. Questi campi si trovano nella sezione Servizi Google della tab iOS nella piattaforma Docebo.

• Campo Google iOS Client ID: digitare in questo campo la seguente stringa: “PUSH-ONLY”.
• Campo Google Web Client ID: digitare in questo campo la seguente stringa: “PUSH-ONLY”.
• Campo Configuration File: fare riferimento alla sezione Creare un’App iOS nel Proprio Progetto Firebase in questo articolo per ulteriori informazioni, e seguire le fasi di configurazione incluse nella sezione.

Inoltre, per poter inviare notifiche push ai dispositivi iOS, è necessario caricare una chiave di autenticazione APNs. Fare riferimento alla sezione Caricare le APNs Key iOS in questo articolo e seguire le informazioni fornite. 

Tab Android

Nella terza tab, Android, si configureranno i campi Google Web Client ID e Configuration File. Entrambi questi campi si trovano nella sezione Servizi Google della tab Android nella piattaforma Docebo.

• Campo Google Web Client ID: digitare in questo campo la seguente stringa: “PUSH-ONLY”.
• Campo Configuration File: fare riferimento alla sezione Creare un’App Android nel Proprio Progetto Firebase in questo articolo per ulteriori informazioni, e seguire le fasi di configurazione incluse nella sezione.

A questo punto, tutti i campi necessari per attivare le notifiche push nella propria app mobile branded sono stati completati.

Ora, selezionare il bottone Salva le Modifiche in fondo alla pagina Branded Mobile App Publisher per salvare il progetto, quindi generare di nuovo la build delle proprie app selezionando il bottone Genera Build accanto al bottone Salva le Modifiche. 

Dopo aver generato la build, è necessario eseguire il re-signing della propria app mobile branded. Per pubblicare la propria app negli app store (Google Play per Android e App Store per iOS) è necessario sostituire la firma digitale temporaneamente applicata da Docebo con la propria firma generata internamente (per Android) o con il certificato assegnato dall’App Store (per iOS). In questo articolo sono fornite istruzioni dettagliate su come eseguire il re-signing della propria app. Infine, caricare i pacchetti dell’app nelle console degli app store per pubblicare la propria app negli app store mobile per Google ed Apple. 

Per informazioni aggiuntive su come svolgere questi processi (generare la build, effettuare il re-signing dell’app, caricare il pacchetto negli app store), fare riferimento a questo articolo.

Congratulazioni! Ora la propria app è connessa a Firebase! A partire da questo momento, si riceveranno notifiche push e si raccoglieranno dati di analisi sull’uso dell’app. 

Per ulteriori informazioni su ognuno degli eventi che si ricevono nella sezione Events di Firebase Analytics, fare riferimento a questo file.

Abilitare Google Sign-In

Per abilitare Google Sign-In (utilizzando Gmail o Google Apps), è necessario creare un progetto in Firebase (per ulteriori informazioni, fare riferimento alla sezione Creare un Progetto in Firebase in questo articolo). 

Una volta creato il proprio progetto, selezionare l’opzione Authentication nella barra laterale sulla sinistra della pagina di Firebase, quindi accedere alla tab Sign-in method (metodi di login). Nella tab, selezionare e abilitare Google sign-in nella sezione dedicata ai Sign-in providers, attivando il toggle corrispondente. Ora, aprire la sezione a tendina Web SDK configuration, copiare il valore del campo Web client ID e incollarlo nel campo Google Web Client ID in entrambe le tab iOS e Android della pagina Branded Mobile App Publisher nella propria piattaforma Docebo. 

Per raccogliere dati aggiuntivi necessari per la build dell’app iOS, accedere alla sezione Credentials della Google API console. Si può raggiungere la console anche cliccando sul link nelle frasi di suggerimento che appaiono nella sezione Web SDK configuration del provider Google sign-in. Una volta raggiunta la sezione Credentials della Google API console, copiare il Client ID delle credenziali relative ad iOS. Quindi, incollare il Client ID nel campo Google iOS Client ID nella tab iOS della pagina Branded Mobile App Publisher nella propria piattaforma Docebo. Ora, accedere alla tab General del proprio progetto Firebase e identificare l’app Android nella sezione Your apps. Nel campo SHA certificate fingerprints all’interno di questa sezione, incollare le SHA-1 fingerprints del proprio certificato.

Fare riferimento a questa pagina per ulteriori informazioni sull’utilizzo del keytool.  Aprire il production certificate store (il file .keystore) e digitare il comando seguente:

keytool -list -v -keystore ./yourcompany.keystore

A questo punto, identificare la riga con lo SHA1 del proprio certificato e incollare il suo valore nel campo SHA certificate fingerprints. Quindi, accedere alla tab General (la prima tab a partire da sinistra) del progetto Firebase, raggiungere la sezione Your Apps e scaricare i configuration file per le app iOS e Android. Selezionare la propria app iOS e scaricare il configuration file GoogleService-Info.plist tramite il bottone corrispondente, e selezionare la propria app Android e scaricare il configuration file google-services.json tramite il bottone corrispondente.

Una volta scaricati i configuration file, caricarli nel campo Configuration File (questo campo si trova in entrambe le tab, iOS e Android) nella pagina Branded Mobile App Publisher nella propria piattaforma Docebo. Caricare il file .plist nella tab iOS e il file .json nella tab Android.

Ora, selezionare il bottone Salva le Modifiche, quindi generare di nuovo la build delle proprie app selezionando il bottone Genera Build accanto al bottone Salva le Modifiche in fondo a ciascuna delle tab iOS e Android nella pagina Branded Mobile App Publisher della piattaforma Docebo. Dopo aver generato la build, è necessario eseguire il re-signing della propria app mobile branded. Per pubblicare la propria app negli app store (Google Play per Android e App Store per iOS) è necessario sostituire la firma digitale temporaneamente applicata da Docebo con la propria firma generata internamente (per Android) o con il certificato assegnato dall’App Store (per iOS). Infine, caricare i pacchetti dell’app nelle console degli app store per pubblicare la propria app negli app store mobile per Google ed Apple. 

Per informazioni aggiuntive su come svolgere questi processi (generare la build, effettuare il re-signing dell’app, caricare il pacchetto negli app store), fare riferimento a questo articolo.

Abilitare Notifiche Push e Analytics E Google Sign-In

Per abilitare sia le notifiche push e Analytics sia Google Sign-In, seguire i passi seguenti:

1. Creare le app iOS e Android, come spiegato nelle sezioni Creare un’App iOS nel Proprio Progetto Firebase e Creare un’App Android nel Proprio Progetto Firebase di questo documento
2. Seguire tutti i passi spiegati nella sezione Abilitare Google Sign-In di questo documento
3. Completare tutti i passi inclusi nella sezione Abilitare le Notifiche Push e Analytics e che non si sono trovati quando si sono seguiti tutti i passi della sezione Abilitare Google Sign-In di questo documento. Attenzione: non sovrascrivere i client ID esistenti (il campo Google iOS Client ID e il campo Google Web Client ID) con la stringa “PUSH-ONLY”.
4. Salvare le modifiche, quindi generare di nuovo la build delle proprie app selezionando il bottone Genera Build accanto al bottone Salva le Modifiche in fondo a ciascuna delle tab iOS e Android nella pagina Branded Mobile App Publisher della piattaforma Docebo. 

Dopo aver generato la build, è necessario eseguire il re-signing della propria app mobile branded. Per pubblicare la propria app negli app store (Google Play per Android e App Store per iOS) è necessario sostituire la firma digitale temporaneamente applicata da Docebo con la propria firma generata internamente (per Android) o con il certificato assegnato dall’App Store (per iOS). 

Infine, caricare i pacchetti dell’app nelle console degli app store per pubblicare la propria app negli app store mobile per Google ed Apple.

Per informazioni aggiuntive su come svolgere questi processi (generare la build, effettuare il re-signing dell’app, caricare il pacchetto negli app store), fare riferimento a questo articolo.