Passaggi di configurazione per Android
Una volta installato il pacchetto, puoi definire le impostazioni dell’app Android in Adobe Campaign Classic.
I passaggi chiave sono i seguenti:
Potrai quindi creare una notifica avanzata di Android.
Configurare l’account esterno di Android configuring-external-account-android
Per Android sono disponibili due connettori:
- Il connettore V1 che consente una connessione per elemento secondario MTA.
- Il connettore V2 che consente connessioni simultanee al server FCM per migliorare il throughput.
Per scegliere il connettore da utilizzare, eseguire la procedura seguente:
-
Vai a Administration > Platform > External accounts.
-
Selezionare l'account esterno Android routing.
-
Nella scheda Connector, compila il campo JavaScript used in the connector:
Per Android V2: https://localhost:8080/nms/jsp/androidPushConnectorV2.js
note note NOTE Puoi anche configurarlo come segue https://localhost:8080/nms/jsp/androidPushConnector.js, ma ti consigliamo di utilizzare la versione 2 del connettore. 
-
Per Android V2, nel file di configurazione del server Adobe (serverConf.xml) è disponibile un parametro aggiuntivo:
- maxGCMConnectPerChild: limite massimo di richieste HTTP parallele a FCM avviate da ogni server secondario (8 per impostazione predefinita).
Configurare un servizio Android configuring-android-service
-
Passare al nodo Profiles and Targets > Services and subscriptions e fare clic su New.
-
Definisci Label e Internal name.
-
Vai al campo Type e seleziona Mobile application.
note note NOTE Il mapping di destinazione predefinito Subscriber applications (nms:appSubscriptionRcp) è collegato alla tabella dei destinatari. Se si desidera utilizzare una mappatura di destinazione diversa, è necessario creare una nuova mappatura di destinazione e immetterla nel campo Target mapping del servizio. Per ulteriori informazioni sulla creazione della mappatura di destinazione, consulta questa sezione. 
-
Quindi fare clic sul pulsante Add per selezionare il tipo di applicazione.
-
Crea la tua applicazione Android. Per ulteriori informazioni al riguardo, consulta questa sezione.
Creare l’app mobile Android creating-android-app
Dopo aver creato il servizio, ora è necessario creare l’applicazione Android:
-
Dal servizio appena creato, fare clic sul pulsante Add per selezionare il tipo di applicazione.
-
Selezionare Create an Android application e immettere Label.
-
Assicurati che lo stesso Integration key sia definito in Adobe Campaign e nel codice dell'applicazione tramite l'SDK.
note note NOTE Integration key è completamente personalizzabile con valore stringa, ma deve essere esattamente lo stesso specificato nell'SDK. -
Selezionare API version: HTTP v1 o HTTP (legacy). Queste configurazioni sono descritte in questa sezione
-
Compila i campi Firebase Cloud Messaging the Android connection settings.
-
Fare clic su Finish e quindi su Save. L’applicazione Android è ora pronta per essere utilizzata in Campaign Classic.
Per impostazione predefinita, Adobe Campaign salva una chiave nel campo User identifier (@userKey) della tabella Subscriber applications (nms:appSubscriptionRcp). Questa chiave consente di collegare una sottoscrizione a un destinatario. Per raccogliere dati aggiuntivi (ad esempio una chiave di riconciliazione complessa), è necessario applicare la seguente configurazione:
Configurare la versione API select-api-version
Dopo aver creato il servizio e una nuova app mobile, è necessario configurare l’app mobile. L'API HTTP (legacy) non deve essere selezionata in quanto è stata dichiarata obsoleta da Google.
Per configurare la versione API HTTP v1, segui i passaggi seguenti:
-
Nella finestra Mobile application creation wizard, seleziona HTTPV1 nel menu a discesa API version.
-
Fai clic su Load project json file to extract project details… per caricare direttamente il file di chiave JSON. Per ulteriori informazioni su come estrarre il file JSON, consulta questa pagina.
È inoltre possibile immettere manualmente i seguenti dettagli:
- Project Id
- Private Key
- Client Email
-
Fare clic su Test the connection per verificare che la configurazione sia corretta e che il server di marketing abbia accesso a FCM.
note caution CAUTION Per la distribuzione mid-sourcing, il pulsante Test connection non verifica se il server MID ha accesso al server FCM. 
-
Se necessario, puoi arricchire il contenuto di un messaggio push con alcuni Application variables. Questi sono completamente personalizzabili e fanno parte del payload del messaggio inviato al dispositivo mobile.
-
Fare clic su Finish e quindi su Save. L’applicazione Android è ora pronta per essere utilizzata in Campaign Classic.
Di seguito sono riportati i nomi del payload FCM per personalizzare ulteriormente la notifica push:
Estendere lo schema appsubscriptionRcp extend-subscription-schema
È necessario estendere appsubscriptionRcp per definire nuovi campi aggiuntivi per archiviare i parametri dell'app nel database di Campaign. Questi campi vengono utilizzati per la personalizzazione, ad esempio. Per eseguire questa operazione:
-
Creare un'estensione dello schema Subscriber applications (nms:appsubscriptionRcp) e definire i nuovi campi. Ulteriori informazioni sull'estensione dello schema in questa pagina
-
Definire il mapping nella scheda Subscription parameters.
note caution CAUTION Assicurarsi che i nomi di configurazione nella scheda Subscription parameters siano gli stessi di quelli nel codice dell'app mobile.