v7

Passaggi di configurazione per Android

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

NOTA

Per informazioni su come configurare l’app per iOS e creare una consegna per iOS, consulta questa sezione 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. Estendere lo schema dell’app con dati aggiuntivi

Potrai quindi creare una notifica Android potenziata.

Configurare l’account esterno 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:

  1. Vai a Administration > Platform > External accounts.

  2. Seleziona la Android routing account esterno.

  3. In Connector , compila la scheda JavaScript used in the connector campo:

    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, 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

Scopri come configurare un servizio Android in un video

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

  2. Definisci un Label e un Internal name.

  3. Vai a Type e seleziona Mobile application.

    NOTA

    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.

  4. Quindi fai clic su 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 devi creare l’applicazione Android:

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

  2. Seleziona Create an Android application e inserisci un Label.

  3. 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.

    NOTA

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

  4. Seleziona la API version: HTTP v1 o HTTP (legacy). Queste configurazioni sono descritte in dettaglio questa sezione

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

  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 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:

Seleziona la versione API

Dopo aver creato il servizio e una nuova app mobile, è necessario configurare l’app mobile in base alla versione API scelta.

Configurare API HTTP v1

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

  1. Nel tuo Mobile application creation wizard finestra, seleziona HTTPV1 nel API version a discesa.

  2. 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

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

    ATTENZIONE

    Per l'implementazione mid-sourcing, Test connection non verifica se il server MID ha accesso al server FCM.

  4. 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.

  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 del payload FCM per personalizzare ulteriormente la notifica push:

Tipo di messaggio Elemento del messaggio configurabile (nome del 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, fisso, visibilità, notification_priority, notification_count
validate_only


Configurare API HTTP (legacy)

Per configurare la versione API HTTP (legacy), effettua le seguenti operazioni:

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

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

  3. 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.

    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 del payload FCM per personalizzare ulteriormente la notifica push:

Tipo di messaggio Elemento del messaggio configurabile (nome del 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 archiviare i parametri dell’app nel database di Campaign. Questi campi verranno utilizzati per la personalizzazione, ad esempio. Per eseguire questa operazione:

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

  2. Definisci la mappatura in Subscription parameters scheda.

    ATTENZIONE

    Assicurati che i nomi delle configurazioni in Subscription parameters sono le stesse del codice dell’app mobile. Fai riferimento a questa sezione.

In questa pagina