[v7]{class="badge informative" title="Applicabile anche a Campaign Classic v7"} [v8]{class="badge positive" title="Applicabile a Campaign v8"}
Modifiche del canale di notifica push push-upgrade
Puoi utilizzare Campaign per inviare notifiche push su dispositivi iOS e Android. Per eseguire questa operazione, Campaign si basa sui servizi di abbonamento alle app mobili.
Alcune modifiche importanti al servizio Android Firebase Cloud Messaging (FCM) sono state rilasciate nel 2024 e potrebbero influire sull’implementazione di Adobe Campaign. Per supportare questa modifica, potrebbe essere necessario aggiornare la configurazione dei servizi di abbonamento per i messaggi push di Android.
Inoltre, Adobe consiglia vivamente di passare alla connessione basata su token ai numeri APN anziché a una connessione basata su certificati, che è più sicura e scalabile.
Servizio Google Android Firebase Cloud Messaging (FCM) fcm-push-upgrade
Cosa è cambiato? fcm-changes
Come parte del continuo sforzo di Google per migliorare i suoi servizi, le API FCM legacy saranno interrotte il 22 luglio 2024. Ulteriori informazioni sul protocollo HTTP Firebase Cloud Messaging in Documentazione di Google Firebase.
Adobe Campaign Classic v7 e Adobe Campaign v8 supportano già le API più recenti per l’invio di messaggi di notifica push. Tuttavia, alcune implementazioni precedenti si basano ancora sulle API legacy. Queste implementazioni devono essere aggiornate.
Sei interessato? fcm-impact
Se l’implementazione corrente supporta i servizi di abbonamento che si connettono a FCM utilizzando le API legacy, sei interessato. Per evitare distrazioni di servizio, è necessario passare alle API più recenti. In tal caso, i team di Adobi ti contatteranno.
Per verificare se sei interessato, puoi filtrare il Servizi e abbonamenti secondo il filtro seguente:
-
Se uno dei servizi di notifica push attivi utilizza HTTP (legacy) API, la configurazione sarà direttamente interessata da questa modifica. È necessario rivedere le configurazioni correnti e passare alle API più recenti come descritto di seguito.
-
Se la configurazione utilizza esclusivamente HTTP v1 API per le notifiche push in Android, hai già ottenuto la conformità e non saranno necessarie ulteriori azioni da parte tua.
Come si esegue l’aggiornamento? fcm-transition-procedure
Prerequisiti fcm-transition-prerequisites
-
Per Campaign Classic v7, il supporto di HTTP v1 è stato aggiunto nella versione 20.3.1. Se l’ambiente è in esecuzione su una versione precedente, un prerequisito per la transizione a HTTP v1 è aggiornare l’ambiente a build Campaign Classic più recente. Per Campaign v8, HTTP v1 è supportato da tutte le versioni e non è necessario alcun aggiornamento.
-
Il file JSON dell'account del servizio Android Firebase Admin SDK è necessario per spostare l'app mobile su HTTP v1. Scopri come ottenere questo file in Documentazione di Google Firebase.
-
Per le distribuzioni ibride, in hosting e Managed Services, oltre alla procedura di transizione riportata di seguito, contatta l’Adobe per aggiornare il server di esecuzione in tempo reale (RT). Il server Mid-Sourcing non è interessato.
-
In qualità di utente on-premise di Campaign Classic v7, devi aggiornare sia il server di esecuzione Marketing che il server di esecuzione in tempo reale. Il server Mid-Sourcing non è interessato.
Procedura di transizione fcm-transition-steps
Per spostare l’ambiente in HTTP v1, effettua le seguenti operazioni:
-
Sfoglia l’elenco di Servizi e abbonamenti.
-
Elencare tutte le applicazioni mobili utilizzando HTTP (legacy) Versione API.
-
Per ciascuna di queste applicazioni mobili, imposta il Versione API a HTTP v1.
-
Fai clic su Load project json file to extract project details… collegamento per caricare direttamente il file di chiave JSON.
È inoltre possibile immettere manualmente i seguenti dettagli:
- Project Id
- Private Key
- Client Email
-
Clic Test the connection per verificare che la configurazione sia corretta e che il server di marketing abbia accesso a FCM. Tieni presente che per le distribuzioni Mid-Sourcing, il Test connection Impossibile verificare se il server ha accesso al servizio Android Firebase Cloud Messaging (FCM).
-
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.
-
Fai clic su Finish, quindi su Save.
Di seguito sono riportati i nomi del payload FCM per personalizzare ulteriormente la notifica push. Queste opzioni sono dettagliate qui.
table 0-row-3 1-row-3 2-row-3 1-align-center 2-align-center 3-align-center 5-align-center 6-align-center 7-align-center 9-align-center 10-align-center 11-align-center 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 -
Al termine della transizione HTTP v1, è necessario aggiornare modelli di consegna per le notifiche push di Android per aumentare il numero di messaggi batch. A questo scopo, individua le proprietà del modello di consegna Android e, nella Consegna , impostare Quantità batch messaggi a 256. Applica questa modifica a tutti i modelli di consegna utilizzati per le consegne Android e a tutte le consegne Android esistenti.
Qual è l’impatto sulle app Android? fcm-apps
Non sono richieste modifiche specifiche al codice delle applicazioni Android Mobile e il comportamento di notifica non deve cambiare.
Tuttavia, con HTTP v1, puoi personalizzare ulteriormente la notifica push con HTTPV1 additional options.
Puoi eseguire le seguenti azioni:
- Utilizza il Ticker per impostare il testo del ticker della notifica.
- Utilizza il Image per impostare l’URL dell’immagine da visualizzare nella notifica.
- Utilizza il Notification Count per impostare il numero di nuove informazioni da visualizzare direttamente sull'icona dell'applicazione.
- Imposta il Sticky su false in modo che la notifica venga automaticamente ignorata quando l’utente fa clic su di essa. Se impostato su true, la notifica viene comunque visualizzata anche quando l’utente fa clic su di essa.
- Imposta il Notification Priority livello di notifica predefinito, minimo, minimo o massimo.
- Imposta il Visibility livello della notifica a pubblico, privato o segreto.
Per ulteriori informazioni su HTTP v1 additional options e come compilare questi campi, consulta Documentazione FCM.
Servizio Apple iOS Push Notification (APNs) apns-push-upgrade
Cosa è cambiato? ios-changes
Come consigliato da Apple, è necessario proteggere le comunicazioni con il servizio APN (Apple Push Notification Service) utilizzando token di autenticazione senza stato.
L’autenticazione basata su token offre un modo senza stato di comunicare con i numeri APN. La comunicazione senza stato è più veloce della comunicazione basata su certificato perché non richiede che APN ricerchi il certificato o altre informazioni correlate al server provider. L’utilizzo dell’autenticazione basata su token presenta altri vantaggi:
-
È possibile utilizzare lo stesso token da più server provider.
-
Puoi utilizzare un token per distribuire le notifiche per tutte le app della tua azienda.
Ulteriori informazioni sulle connessioni basate su token ai numeri APN in Documentazione per gli sviluppatori di Apple.
Adobe Campaign Classic v7 e Adobe Campaign v8 supportano connessioni sia basate su token che basate su certificati. Se l’implementazione si basa su una connessione basata su certificato, Adobe consiglia vivamente di aggiornarla a una connessione basata su token.
Sei interessato? ios-impact
L’implementazione corrente è interessata se si basa su richieste basate su certificati per la connessione ad APN. Si consiglia di passare a una connessione basata su token.
Per verificare se sei interessato, puoi filtrare il Servizi e abbonamenti secondo il filtro seguente:
-
Se uno dei servizi di notifica push attivi utilizza Autenticazione basata su certificato (.p12), le implementazioni correnti devono essere riviste e spostate in una Autenticazione basata su token (.p8) come descritto di seguito.
-
Se la configurazione utilizza esclusivamente Autenticazione basata su token per le notifiche push di iOS, l’implementazione è già aggiornata e non sarà necessaria alcuna ulteriore azione da parte tua.
Come si esegue l’aggiornamento? ios-transition-procedure
Prerequisiti ios-transition-prerequisites
-
Per Campaign Classic v7, il supporto di Autenticazione basata su token è stata aggiunta nella versione 20.2. Se l’ambiente è in esecuzione su una versione precedente, un prerequisito per questa modifica è aggiornare l’ambiente a build Campaign Classic più recente. Per Campaign v8, Autenticazione basata su token La modalità è supportata da tutte le versioni e non è necessario alcun aggiornamento.
-
Per generare i token utilizzati dal server è necessaria una chiave di firma del token di autenticazione APNs. Richiedi questa chiave al tuo account sviluppatore Apple, come spiegato in Documentazione per gli sviluppatori di Apple.
-
Per le distribuzioni ibride, in hosting e Managed Services, oltre alla procedura di transizione riportata di seguito, contatta l’Adobe per aggiornare il server di esecuzione in tempo reale (RT). Il server Mid-Sourcing non è interessato.
-
In qualità di utente on-premise di Campaign Classic v7, devi aggiornare sia il server di esecuzione Marketing che il server di esecuzione in tempo reale. Il server Mid-Sourcing non è interessato.
Procedura di transizione ios-transition-steps
Per spostare le app mobili iOS nella modalità di autenticazione basata su token, effettua le seguenti operazioni:
-
Sfoglia l’elenco di Servizi e abbonamenti.
-
Elencare tutte le applicazioni mobili utilizzando Autenticazione basata su certificato (.p12).
-
Modifica ciascuna di queste applicazioni mobili e passa alla Certificato/chiave privata scheda.
-
Dalla sezione Modalità di autenticazione a discesa, seleziona Autenticazione basata su token (.p8).
-
Inserisci le impostazioni di connessione APNs Key Id, Team Id e Bundle Id quindi seleziona il certificato p8 facendo clic su Enter the private key….
-
Clic Test the connection per verificare che la configurazione sia corretta e che il server abbia accesso ai numeri APN. Tieni presente che per le distribuzioni Mid-Sourcing, il Test connection non può verificare se il server ha accesso ai numeri APN.
-
Clic Next per iniziare a configurare l’applicazione di produzione e seguire gli stessi passaggi descritti in precedenza.
-
Fai clic su Finish, quindi su Save.
L’applicazione iOS viene ora spostata nella modalità di autenticazione basata su token.