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 Android potenziata.
Configurare l’account esterno 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.
-
Seleziona la Android routing account esterno.
-
In Connector , compila la scheda JavaScript used in the connector campo:
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 alla FCM avviate da ciascun server secondario (8 per impostazione predefinita).
Configurare un servizio Android configuring-android-service
Scopri come configurare un servizio Android in un video.
-
Vai a Profiles and Targets > Services and subscriptions e fai clic su New.
-
Definisci un Label e un Internal name.
-
Vai a Type e seleziona Mobile application.
note note NOTE Il valore predefinito Subscriber applications (nms:appSubscriptionRcp) la mappatura di destinazione è collegata alla tabella dei destinatari. Se desideri utilizzare una mappatura di destinazione diversa, devi creare una nuova mappatura di destinazione e immetterla nella Target mapping del servizio. Per ulteriori informazioni sulla creazione della mappatura di destinazione, consulta questa sezione. -
Quindi fai clic su 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 devi creare l’applicazione Android:
-
Dal servizio appena creato, fai clic su Add per selezionare il tipo di applicazione.
-
Seleziona Create an Android application e inserisci un Label.
-
Assicurati che lo stesso Integration key è definito in Adobe Campaign e nel codice dell’applicazione tramite l’SDK. Per ulteriori informazioni al riguardo, consulta questa sezione.
note note NOTE Il Integration key è completamente personalizzabile con un valore stringa, ma deve essere esattamente lo stesso specificato nell’SDK. -
Seleziona la API version: HTTP v1 o HTTP (legacy). Queste configurazioni sono descritte in dettaglio questa sezione
-
Compila il Firebase Cloud Messaging the Android connection settings campi.
-
Clic Finish allora Save. L’applicazione Android è ora pronta per essere utilizzata in Campaign Classic.
Per impostazione predefinita, Adobe Campaign salva una chiave nel User identifier (@userKey) campo di applicazione Subscriber applications (nms:appSubscriptionRcp) tabella. 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. Il HTTP (legacy) L’API non deve essere selezionata perché è stata dichiarata obsoleta da Google.
Per configurare la versione API HTTP v1, segui i passaggi seguenti:
-
Nel tuo Mobile application creation wizard finestra, seleziona HTTPV1 nel API version a discesa.
-
Clic 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
-
Clic Test the connection per verificare che la configurazione sia corretta e che il server di marketing abbia accesso a FCM.
note caution CAUTION Per l'implementazione mid-sourcing, Test connection non verifica se il server MID ha accesso al server FCM. -
Come opzione, puoi arricchire il contenuto di un messaggio push con Application variables se necessario. Questi sono completamente personalizzabili e fanno parte del payload del messaggio inviato al dispositivo mobile.
-
Clic Finish allora 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
Scopri come estendere lo schema appsubscriptionRcp nel video
È 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:
-
Crea un'estensione del Subscriber applications (nms:appsubscriptionRcp) e definiscono i nuovi campi. Ulteriori informazioni sull’estensione dello schema in questa pagina
-
Definisci la mappatura in Subscription parameters scheda.
note caution CAUTION Assicurati che i nomi delle configurazioni in Subscription parameters sono le stesse del codice dell’app mobile. Fai riferimento a questa sezione.