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 al capitolo Notifiche Push nell'articolo Branded Mobile App Publisher.

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 i capitoli 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 nel capitolo 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. Fare riferimento a questa 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 al capitolo 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 al capitolo Creare un’App iOS nel Proprio Progetto Firebase in questo articolo per ulteriori informazioni, e seguire le fasi di configurazione incluse nel capitolo.

Inoltre, per poter inviare notifiche push ai dispositivi iOS, è necessario caricare una chiave di autenticazione APNs. Fare riferimento al capitolo 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 al capitolo Creare un’App Android nel Proprio Progetto Firebase in questo articolo per ulteriori informazioni, e seguire le fasi di configurazione incluse nel capitolo.

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). 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. 

Informazioni aggiuntive su come svolgere questi processi (generare la build, effettuare il re-signing dell’app, caricare il pacchetto negli app store).

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. 

Ulteriori informazioni su ognuno degli eventi che si ricevono nella sezione Events di Firebase Analytics

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 al capitolo 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 l’opzione 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, si dovrà incollare la fingerprint SHA-1 del proprio signing certificate. Seguire questi passi per configurare Google Sign-In per un’app Android:

Step 1: Recuperare la fingerprint SHA-1 del proprio certificato. 

Aprire il production certificate store (il file .keystore) e digitare il comando seguente:

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

Ulteriori informazioni sull’utilizzo del keytool.  

Identificare la riga con lo SHA-1 del proprio certificato.

Step 2: In Google Play Console, aprire la tab App integrity (integrità app) e raggiungere la sezione App signing key certificate (certificato chiave per la firma dell’app). Copiare la fingerprint SHA-1 del proprio certificato che si trova nel campo corrispondente.

Step 3: Nella Firebase console, selezionare le impostazioni del progetto (opzione Project settings), quindi identificare l’app Android nella sezione Your apps. Incollare la fingerprint SHA-1 del certificato nel campo Certificate fingerprint (fingerprint del certificato).

Step 4: In Google Play Console, nella tab App integrity (integrità app) raggiungere la sezione Upload key certificate (caricamento chiave del certificato). Copiare la SHA-1 recuperata con il comando del keytool (step 1) e incollarla nel campo SHA-1 certificate fingerprint. Per chi ha già rilasciato una versione della propria app branded, la fingerprint sarà già presente nel campo SHA-1 certificate fingerprint. In ogni caso, assicurarsi che la fingerprint SHA-1 del certificato popoli il campo corrispondente.

Step 5: Nei Project setting della Firebase console, nell’app Android nella sezione Your apps, è ora possibile aggiungere la seconda fingerprint. Cliccare Add fingerprint (aggiungi fingerprint), quindi incollare la fingerprint SHA-1 del certificato nel campo Certificate fingerprint. 

Una volta inserite entrambe le fingerprint per Android, si è pronti per scaricare gli ultimi configuration file.

Nella tab General 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 pulsante corrispondente, quindi selezionare la propria app Android e scaricare il configuration file google-services.json tramite il pulsante 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 Salva le Modifiche, quindi generare di nuovo la build delle proprie app selezionando Genera Build accanto al pulsante 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. 

Informazioni aggiuntive su come svolgere questi processi (generare la build, effettuare il re-signing dell’app, caricare il pacchetto negli app store).

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 nei capitoli 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 nel capitolo Abilitare Google Sign-In di questo documento
3. Completare tutti i passi inclusi nel capitolo Abilitare le Notifiche Push e Analytics e non inclusi nei passi del capitolo 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.

Informazioni aggiuntive su come svolgere questi processi (generare la build, effettuare il re-signing dell’app, caricare il pacchetto negli app store).