DocumentazioneCampaignDocumentazione di Campaign Classic v7

Passaggi di configurazione per Android

Last update: Thu Jun 20 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Creato per:

  • Utente
  • Sviluppatore

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

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.

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. Ulteriori informazioni Nota tecnica su Adobe Campaign v8.

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

    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 alla FCM avviate da ciascun server secondario (8 per impostazione predefinita).

Configurare un servizio Android configuring-android-service

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.

    note note
    NOTE
    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 creating-android-app

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.

    note note
    NOTE
    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. Clic Finish allora 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:

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. Come parte del continuo sforzo di Google per migliorare i suoi servizi, le API FCM legacy saranno interrotte il 20 giugno 2024. Ulteriori informazioni Nota tecnica su Adobe Campaign v8.

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

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.

    note caution
    CAUTION
    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. Clic Finish allora 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. 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.

    note caution
    CAUTION
    Assicurati che i nomi delle configurazioni in Subscription parameters sono le stesse del codice dell’app mobile.
recommendation-more-help
601d79c3-e613-4db3-889a-ae959cd9e3e1