Passaggi di configurazione per Android

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

NOTA

Per scoprire come configurare l’app per iOS e come creare una consegna per iOS, consulta questa sezione .

I passaggi chiave sono i seguenti:

  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

Potrai quindi creare una notifica avanzata Android.

Configurare l’account esterno Android

Per Android sono disponibili due connettori:

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

Per scegliere il connettore da utilizzare, effettua le seguenti operazioni:

  1. Vai a Administration > Platform > External accounts.

  2. Seleziona l’account esterno Android routing.

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

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

    NOTA

    Puoi anche configurarlo come segue https://localhost:8080/nms/jsp/androidPushConnector.js ma ti consigliamo di utilizzare la versione 2 del connettore.

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

    • maxGCMConnectPerChild: Limite massimo di richieste HTTP parallele all'FCM avviato da ogni server figlio (8 per impostazione predefinita).

Configurare un servizio Android

Scopri come configurare un servizio Android nel video

  1. Vai al nodo Profiles and Targets > Services and subscriptions e fai clic su New.

  2. Definisci un Label e un Internal name.

  3. Vai al campo Type e seleziona Mobile application.

    NOTA

    La mappatura di destinazione predefinita Subscriber applications (nms:appSubscriptionRcp) è collegata alla tabella dei destinatari. Se desideri utilizzare una mappatura di destinazione diversa, devi 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.

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

  5. Crea la tua applicazione Android. Per ulteriori informazioni al riguardo, consulta questa sezione.

Creare l’app mobile Android

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

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

  2. Seleziona Create an Android application e immetti 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 al riguardo, consulta questa sezione.

    NOTA

    Il Integration key è completamente personalizzabile con il valore stringa, ma deve essere esattamente lo stesso specificato nell'SDK.

  4. Seleziona il API version: HTTP v1 o HTTP (legacy). 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 abbonamento a un destinatario. Per raccogliere dati aggiuntivi (ad esempio una chiave di riconciliazione complessa), devi applicare la seguente configurazione:

Seleziona la versione API

Dopo aver creato un servizio e una nuova app mobile, devi configurare la tua app mobile in base alla versione API selezionata.

Configurare l’API HTTP v1

Per configurare la versione dell’API HTTP v1, segui i passaggi seguenti:

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

  2. Fai clic su 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.

    Puoi anche immettere manualmente i seguenti dettagli:

    • Project Id
    • Private Key
    • Client Email

  3. Fai clic su Test the connection per verificare che la configurazione sia corretta e che il server di marketing abbia accesso a FCM.

    ATTENZIONE

    Per la distribuzione mid-sourcing, il pulsante Test connection non controlla se il server MID ha accesso al server FCM.

  4. Puoi anche arricchire il contenuto di un messaggio push con alcuni Application variables se necessario. Sono completamente personalizzabili e una parte del payload del messaggio 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 (legacy)

Per configurare la versione dell’API HTTP (legacy), segui la procedura seguente:

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

  2. Immetti il Project key fornito dallo sviluppatore dell’app mobile.

  3. Puoi anche arricchire il contenuto di un messaggio push con alcuni Application variables se necessario. Sono completamente personalizzabili e una parte del payload del messaggio inviato al dispositivo mobile.

    Nell'esempio seguente, aggiungiamo title, 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

Estendere lo schema appsubscriptionRcp

Scopri 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 ad esempio utilizzati per la personalizzazione. Per eseguire questa operazione:

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

  2. Definisci la mappatura nella scheda Subscription parameters .

    ATTENZIONE

    Assicurati che i nomi di configurazione nella scheda Subscription parameters siano gli stessi nel codice dell'applicazione mobile. Fai riferimento a questa sezione.

In questa pagina