Passaggi di configurazione per Android

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

NOTE

Per informazioni su come configurare l'app per iOS e su come creare una consegna per iOS, consulta 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 notificaAndroid avanzata.

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. Select the Android routing external account.

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

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

    NOTE

    È 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. Vai al Profiles and Targets > Services and subscriptions nodo e fai clic su New.

  2. Define a Label and an Internal name.

  3. Vai al Type campo e seleziona Mobile application.

    NOTE

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

  4. Quindi fate clic sul Add pulsante 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 Add pulsante per selezionare il tipo di applicazione.

  2. Selezionate Create an Android application e immettete 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'applicazionemobile.

    NOTE

    L’ Integration key impostazione è completamente personalizzabile con il valore stringa, ma deve corrispondere esattamente a quella specificata nell’SDK.

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

  5. Fill in the Firebase Cloud Messaging the Android connection settings fields.

  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 Subscriber applications (nms:appSubscriptionRcp) tabella. 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.

  • La configurazione HTTP v1 è dettagliata in questa sezione.
  • La configurazione HTTP (precedente) è dettagliata in questa sezione.

Configurare l'API HTTP v1

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

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

  2. Fai clic Load project json file to extract projet details… per caricare direttamente il file della chiave JSON. Per ulteriori informazioni su come estrarre il file JSON, consulta questa pagina.

    Potete anche immettere manualmente i seguenti dettagli:

    • Project Id
    • Private Key
    • Client Email

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

    CAUTION

    Per la distribuzione di origine media, il Test connection pulsante non verifica 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 Mobile application creation wizard finestra, selezionate HTTP (legacy) nel API version menu a discesa.

  2. Immettere Project key quello 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, aggiungiamo titolo, imageURL e iconURL per creare una notifica push potenziata e quindi fornisce all'applicazione l'immagine, il titolo e l'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 Subscriber applications (nms:appsubscriptionRcp) schema e definite i nuovi campi. Ulteriori informazioni sull'estensione dello schema in questa pagina

  2. Definite la mappatura nella Subscription parameters scheda.

    CAUTION

    Accertatevi che i nomi di configurazione nella Subscription parameters scheda siano identici a quelli nel codice dell'applicazione mobile. Fai riferimento all'SDK Integrating Campaign nella sezione dell'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, consulta la documentazione FCM.

Creazione di un messaggio dati

  1. Vai a Campaign management > Deliveries.

  2. Fai clic su New.

  3. Seleziona Deliver on Android (android) nell’ Delivery template elenco a discesa. Aggiungi un Label biglietto alla consegna.

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

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

  6. Nell' Service elenco a discesa, seleziona il servizio creato in precedenza, quindi l'applicazione e fai clic su Finish.
    Le Application variables vengono aggiunte automaticamente in base a 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 configurazione Application variables precedente. Application variables deve essere configurato nel servizio Android e fa parte del payload di messaggi inviato al dispositivo mobile.

  10. Fai clic su Save e invia 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

NOTE

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. Seleziona Deliver on Android (android) nell’ Delivery template elenco a discesa. Aggiungi un Label biglietto alla consegna.

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

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

  6. Nell' Service elenco a discesa, seleziona il servizio creato in precedenza, quindi l'applicazione e fai 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 su come Notification options e come compilare questi campi, consulta la documentazione FCM.

  9. Se l'applicazione è configurata con il protocollo HTTP v1 API, puoi personalizzare ulteriormente la notifica push con i seguenti elementi 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. For more on this, refer to FCM documentation.
    • Visibility: Impostate i livelli di visibilità della notifica su pubblico, privato o segreto. For more on this, refer to FCM documentation.

    Per ulteriori informazioni su come HTTP v1 additional options e come compilare questi campi, consulta la documentazione FCM.

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

  11. Fai clic su Save e invia 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