Passaggi di configurazione per Android

Una volta installato il pacchetto, potete definire le impostazioni dell'app Android in Adobe Campaign Classic.

NOTA

Per informazioni su come configurare l'app per iOS e su come creare una consegna per iOS, consultate questa sezione.

I passaggi chiave sono:

  1. Configurare l'account esterno Android
  2. Configurare il servizio Android
  3. Creare l'app mobile in Campaign
  4. Estendi lo schema dell'app con dati aggiuntivi

Potrete quindi creare una notifica Android rich.

Configurazione dell'account esterno Android

Per Android sono disponibili due connettori:

  • Connettore V1 che consente una connessione per MTA figlio.
  • Connettore V2 che consente connessioni simultanee al server FCM per migliorare il throughput.

Per scegliere quale connettore utilizzare, procedere come segue:

  1. Vai a Administration > Platform > External accounts.

  2. Selezionare l'account esterno Android routing.

  3. Nella scheda Connector, compilare il campo JavaScript used in the connector:

    Per Android V2: https://localhost:8080/nms/jsp/androidPushConnectorV2.js

    NOTA

    È inoltre possibile configurarlo come segue https://localhost:8080/nms/jsp/androidPushConnector.js, ma si consiglia di utilizzare la versione 2 del connettore.

  4. Per Android V2, un parametro aggiuntivo è disponibile nel file di configurazione del server di Adobe (serverConf.xml):

    • maxGCMConnectPerChild: Limite massimo di richieste HTTP parallele a FCM avviate da ciascun server figlio (per impostazione predefinita, 8).

Configurazione del servizio Android

Scoprite come configurare un servizio Android in un video

  1. Andate al nodo Profiles and Targets > Services and subscriptions e fate clic su New.

  2. Definire Label e Internal name.

  3. Andate al campo Type e selezionate Mobile application.

    NOTA

    Il mapping di destinazione predefinito Subscriber applications (nms:appSubscriptionRcp) è collegato alla tabella dei destinatari. Se desiderate utilizzare un mapping di destinazione diverso, dovete creare un nuovo mapping di destinazione e immetterlo nel campo Target mapping del servizio. Per ulteriori informazioni sulla creazione della mappatura di destinazione, fare riferimento alla Guida alla configurazione.

  4. Quindi fare clic sul pulsante Add per selezionare il tipo di applicazione.

  5. Create la vostra applicazione Android. Per ulteriori informazioni, consulta questa sezione.

Creazione di un'applicazione mobile Android

Dopo aver creato il servizio, è ora necessario creare l'applicazione Android:

  1. Dal servizio appena creato, fate clic sul pulsante Add per selezionare il tipo di applicazione.

  2. Selezionare Create an Android application e inserire un Label.

  3. Assicurati che lo stesso Integration key sia definito in Adobe Campaign e nel codice dell'applicazione tramite l'SDK. Per ulteriori informazioni, consulta: Integrazione di Campaign SDK nell'applicazione mobile.

    NOTA

    Integration key è completamente personalizzabile con valore stringa, ma deve corrispondere esattamente a quello specificato nell'SDK.

  4. Selezionare API version: HTTP v1 o HTTP (precedente). Queste configurazioni sono descritte in questa sezione

  5. Compila i campi Firebase Cloud Messaging the Android connection settings.

  6. Fai clic su Finish, 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 un'iscrizione a un destinatario. Per raccogliere dati aggiuntivi (ad esempio una chiave di riconciliazione complessa), è necessario applicare la seguente configurazione:

Selezionate la versione API

Dopo aver creato un servizio e una nuova applicazione mobile, è necessario configurare l'applicazione mobile in base alla versione API scelta.

Configurare l'API HTTP v1

Per configurare la versione dell'API HTTP v1, attenetevi alla seguente procedura:

  1. Nella finestra Mobile application creation wizard, selezionare HTTPV1 nel menu a discesa API version.

  2. Fare clic su Load project json file to extract projet details… per caricare direttamente il file di chiave JSON. Per ulteriori informazioni su come estrarre il file JSON, fare riferimento a questa pagina.

    Potete anche immettere manualmente i seguenti dettagli:

    • Project Id
    • Private Key
    • Client Email

  3. Fate clic su Test the connection per verificare che la configurazione sia corretta e che il server di marketing abbia accesso al MCM.

    ATTENZIONE

    Per la distribuzione mid-Sourcing, il pulsante Test connection non verificherà se il server MID ha accesso al server FCM.

  4. Come opzione, puoi arricchire il contenuto di un messaggio push con alcuni Application variables, se necessario. Sono completamente personalizzabili e una parte del payload di messaggi inviato al dispositivo mobile.

  5. Fai clic su Finish, quindi su Save. L'applicazione Android ora è pronta per essere utilizzata in Campaign Classic.

Di seguito sono riportati i nomi dei payload FCM per personalizzare ulteriormente la notifica push:

Tipo di messaggio Elemento messaggio configurabile (nome payload FCM) Opzioni configurabili (nome payload FCM)
messaggio dati N/D validate_only
messaggio di notifica titolo, corpo, android_channel_id, icona, suono, tag, colore, click_action, immagine, ticker, persistente, visibilità, notification_priority, notification_count
validate_only


Configurare l'API HTTP (precedente)

Per configurare la versione API HTTP (precedente), attenetevi alla procedura seguente:

  1. Nella finestra Mobile application creation wizard, selezionare HTTP (legacy) nel menu a discesa API version.

  2. Immettere il Project key fornito dallo sviluppatore dell'applicazione mobile.

  3. Come opzione, puoi arricchire il contenuto di un messaggio push con alcuni Application variables, se necessario. Sono completamente personalizzabili e una parte del payload di messaggi inviato al dispositivo mobile.

    Nell'esempio seguente, per creare una notifica push potenziata aggiungiamo title, imageURL e iconURL e quindi l'applicazione dispone dell'immagine, del titolo e dell'icona da visualizzare all'interno della notifica.

  4. Fai clic su Finish, quindi su Save. L'applicazione Android ora è pronta per essere utilizzata in Campaign Classic.

Di seguito sono riportati i nomi dei payload FCM per personalizzare ulteriormente la notifica push:

Tipo di messaggio Elemento messaggio configurabile (nome payload FCM) Opzioni configurabili (nome payload FCM)
messaggio dati N/D dryRun
messaggio di notifica titolo, corpo, android_channel_id, icona, suono, tag, colore, click_action
dryRun

Estendi lo schema appsubscriptionRcp

Scoprite come estendere lo schema appsubscriptionRcp nel video

È necessario estendere appsubscriptionRcp per definire nuovi campi aggiuntivi per memorizzare i parametri dall'app nel database di Campaign. Questi campi verranno utilizzati ad esempio per la personalizzazione. Per eseguire questa operazione:

  1. Create un'estensione dello schema Subscriber applications (nms:appsubscriptionRcp) e definite i nuovi campi. Ulteriori informazioni sull'estensione dello schema in questa pagina

  2. Definire la mappatura nella scheda Subscription parameters.

    ATTENZIONE

    Accertatevi che i nomi di configurazione nella scheda Subscription parameters siano identici a quelli nel codice dell'applicazione mobile. Fare riferimento alla sezione Integrazione di Campaign SDK nell'applicazione mobile.

Creazione di una notifica Android rich

Con Firebase Cloud Messaging, puoi scegliere tra due tipi di messaggi:

  • Data message, gestito dall'app client.

    I messaggi vengono inviati direttamente all'applicazione mobile che genererà e visualizzerà la notifica android al dispositivo. I messaggi di dati contengono solo le variabili di applicazione personalizzate.

  • Notification message, gestito automaticamente da FCM SDK.

    FCM visualizza automaticamente il messaggio sui dispositivi degli utenti per conto dell'app client. I messaggi di notifica contengono un set predefinito di parametri e opzioni, ma possono essere ulteriormente personalizzati con variabili di applicazione personalizzate.

Per ulteriori informazioni sui tipi di messaggi di Firebase Cloud Messaging, consultare la documentazione di FCM.

Creazione di un messaggio dati

  1. Vai a Campaign management > Deliveries.

  2. Fai clic su New.

  3. Selezionare Deliver on Android (android) nel menu a discesa Delivery template. Aggiungi un Label alla consegna.

  4. Fare clic su To per definire la popolazione di destinazione. Per impostazione predefinita, viene applicata la mappatura di destinazione Subscriber application. Fare clic su Add per selezionare il servizio.

  5. Nella finestra Target type, selezionare Subscribers of an Android mobile application e fare clic su Next.

  6. Nel menu a discesa Service, selezionate il servizio creato in precedenza e fate clic su Finish.
    Le Application variables vengono aggiunte automaticamente a seconda di quanto è stato aggiunto durante i passaggi di configurazione.

  7. Selezionare data message come Message Type.

  8. Modificate la notifica RTF.

  9. Se necessario, puoi aggiungere informazioni nella Application variables precedentemente configurata. Application variables deve essere configurato nel servizio Android e fa parte del payload di messaggi inviato al dispositivo mobile.

  10. Fare clic su Save e inviare la consegna.

L'immagine e la pagina Web devono essere visualizzate nella notifica push quando vengono ricevute sui dispositivi mobili Android degli abbonati.

Creazione di un messaggio di notifica

NOTA

Ulteriori opzioni per il messaggio di notifica sono disponibili solo con la configurazione dell'API HTTP v1. Per ulteriori informazioni, consulta questa sezione.

Scoprite come creare una notifica push Android in un video

  1. Vai a Campaign management > Deliveries.

  2. Fai clic su New.

  3. Selezionare Deliver on Android (android) nel menu a discesa Delivery template. Aggiungi un Label alla consegna.

  4. Fare clic su To per definire la popolazione di destinazione. Per impostazione predefinita, viene applicata la mappatura di destinazione Subscriber application. Fare clic su Add per selezionare il servizio.

  5. Nella finestra Target type, selezionare Subscribers of an Android mobile application e fare clic su Next.

  6. Nel menu a discesa Service, selezionate il servizio creato in precedenza e fate clic su Finish.

  7. Selezionare notification message come Message Type.

  8. Aggiungi un titolo e modifica il messaggio. Personalizza la notifica push con Notification options:

    • Channel ID: Impostate l'ID canale della notifica. L'app deve creare un canale con questo ID canale prima di ricevere qualsiasi notifica con questo ID canale.
    • Sound: Impostate l'audio in modo che venga riprodotto quando il dispositivo riceve la notifica.
    • Color: Impostate il colore dell'icona della notifica.
    • Icon: Impostate l'icona della notifica per visualizzarla sui dispositivi dei profili.
    • Tag: Impostate l'identificatore utilizzato per sostituire le notifiche esistenti nel cassetto delle notifiche.
    • Click action: Impostate l'azione associata a un clic utente sulla notifica.

    Per ulteriori informazioni sulla Notification options e su come compilare questi campi, fare riferimento alla documentazione FCM.

  9. Se l'applicazione è configurata con il protocollo HTTP v1 API, potete personalizzare ulteriormente la notifica push con la seguente HTTPV1 additional options:

    • Ticker: Impostate il testo della ticker della notifica. Disponibile solo per i dispositivi impostati su Android 5.0 Lollipop.
    • Image: Impostate l’URL dell’immagine da visualizzare nella notifica.
    • Notification Count: Impostate il numero di nuove informazioni non lette da visualizzare direttamente sull'icona dell'applicazione.
    • Sticky: Impostate su true o false. Se è impostata su false, la notifica viene chiusa automaticamente quando l'utente fa clic su di essa. Se è impostata su true, la notifica continua a essere visualizzata anche quando l'utente fa clic su di essa.
    • Notification Priority: Impostate i livelli di priorità della notifica su valori predefiniti, minimi, bassi o alti. Per ulteriori informazioni, consultare la documentazione di FCM.
    • Visibility: Impostate i livelli di visibilità della notifica su pubblico, privato o segreto. Per ulteriori informazioni, consultare la documentazione di FCM.

    Per ulteriori informazioni sulla HTTP v1 additional options e su come compilare questi campi, fare riferimento alla documentazione FCM.

  10. Se necessario, puoi aggiungere informazioni nella Application variables precedentemente configurata. Application variables deve essere configurato nel servizio Android e fa parte del payload di messaggi inviato al dispositivo mobile.

  11. Fare clic su Save e inviare la consegna.

L'immagine e la pagina Web devono essere visualizzate nella notifica push quando vengono ricevute sui dispositivi mobili Android degli abbonati.

In questa pagina