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 questo articolo 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 potenziata 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 la Android routing conto esterno.

  3. In Connector , compila 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, è 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 a Profiles and Targets > Services and subscriptions nodo e fai clic su New.

  2. Definire un Label e Internal name.

  3. Vai a Type campo 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 inserirla nel Target mapping campo 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 su Add per selezionare il tipo di applicazione.

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

  3. Assicurati che le stesse Integration key è definito in Adobe Campaign e nel codice dell'applicazione tramite l'SDK. Per ulteriori informazioni al riguardo, consulta questa sezione.

    NOTA

    La Integration key è completamente personalizzabile con il valore stringa, ma deve essere esattamente uguale a quello specificato nell'SDK.

  4. Seleziona la API version: HTTP v1 o HTTP (legacy). Queste configurazioni sono descritte in dettaglio in 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 della Subscriber applications (nms:appSubscriptionRcp) tabella. 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. Nel tuo Mobile application creation wizard finestra, seleziona HTTPV1 in API version a discesa.

  2. Fai clic su Load project json file to extract project 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 di mid-Sourcing, il Test connection Il pulsante non controlla se il server MID ha accesso al server FCM.

  4. Puoi 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. Nel tuo Mobile application creation wizard finestra, seleziona HTTP (legacy) in API version a discesa.

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

  3. Puoi 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 il 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 del Subscriber applications (nms:appsubscriptionRcp) definire lo schema e i nuovi campi. Ulteriori informazioni sull’estensione dello schema in questa pagina

  2. Definisci la mappatura nel Subscription parameters scheda .

    ATTENZIONE

    Assicurati che i nomi di configurazione nel Subscription parameters sono uguali a quelle nel codice dell’app mobile. Fai riferimento a questa sezione.

In questa pagina