Passaggi di configurazione per Android

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

I passaggi chiave sono i seguenti:

Potrai quindi creare una notifica avanzata di Android.

IMPORTANT
Alcune importanti modifiche al servizio Android Firebase Cloud Messaging (FCM) verranno rilasciate nel 2024 e potranno influenzare la tua implementazione di Adobe Campaign. Per supportare questa modifica, potrebbe essere necessario aggiornare la configurazione dei servizi di abbonamento per i messaggi push Android. Puoi già verificare ed eseguire azioni. Per ulteriori informazioni, consulta questa nota tecnica su Adobe Campaign v8.

Configurare l’account esterno di Android configuring-external-account-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. Selezionare 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

    note note
    NOTE
    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 a FCM avviate da ogni server secondario (8 per impostazione predefinita).

Configurare un servizio Android configuring-android-service

Scopri come configurare un servizio Android nel video.

  1. Passare al nodo Profiles and Targets > Services and subscriptions e fare clic su New.

  2. Definisci Label e Internal name.

  3. Vai al campo Type e seleziona Mobile application.

    note note
    NOTE
    Il mapping di destinazione predefinito Subscriber applications (nms:appSubscriptionRcp) è collegato alla tabella dei destinatari. Se si desidera utilizzare una mappatura di destinazione diversa, è necessario 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 fare 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 creating-android-app

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

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

  2. Selezionare Create an Android application e immettere Label.

  3. Assicurati che lo stesso Integration key sia definito in Adobe Campaign e nel codice dell'applicazione tramite l'SDK.

    note note
    NOTE
    Integration key è completamente personalizzabile con valore stringa, ma deve essere esattamente lo stesso specificato nell'SDK.
  4. Selezionare 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. Fare clic su Finish e 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 una sottoscrizione a un destinatario. Per raccogliere dati aggiuntivi (ad esempio una chiave di riconciliazione complessa), è necessario applicare la seguente configurazione:

Configurare la versione API select-api-version

IMPORTANT
Alcune importanti modifiche al servizio Android Firebase Cloud Messaging (FCM) verranno rilasciate nel 2024 e potranno influenzare la tua implementazione di Adobe Campaign. Nell'ambito del continuo impegno di Google per migliorare i propri servizi, le API FCM legacy cesseranno il 20 giugno 2024. Per ulteriori informazioni, consulta questa nota tecnica su Adobe Campaign v8.

Dopo aver creato il servizio e una nuova app mobile, è necessario configurare l’app mobile. L'API HTTP (legacy) non deve essere selezionata in quanto è stata dichiarata obsoleta da Google.

Per configurare la versione 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 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. Fare clic su Test the connection per verificare che la configurazione sia corretta e che il server di marketing abbia accesso a FCM.

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

  4. Se necessario, puoi arricchire il contenuto di un messaggio push con alcuni Application variables. Questi sono completamente personalizzabili e fanno parte del payload del messaggio inviato al dispositivo mobile.

  5. Fare clic su Finish e 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

Estendere lo schema appsubscriptionRcp extend-subscription-schema

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

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

  2. Definire il mapping nella scheda Subscription parameters.

    note caution
    CAUTION
    Assicurarsi che i nomi di configurazione nella scheda Subscription parameters siano gli stessi di quelli nel codice dell'app mobile.
recommendation-more-help
601d79c3-e613-4db3-889a-ae959cd9e3e1