Creare e inviare notifiche push

Le consegne tramite app mobile ti consentono di inviare notifiche ai dispositivi iOS e Android.

Per inviare notifiche push in Adobe Campaign, devi:

  1. Integra l’SDK con la tua app. Ulteriori informazioni
  2. Crea un servizio di informazioni di tipo app mobile per la tua app mobile e aggiungi le versioni iOS e Android dell’applicazione a tale servizio. Ulteriori informazioni
  3. Crea una consegna sia per iOS che per Android. Ulteriori informazioni

Integrare l’SDK

Per inviare notifiche push con Adobe Campaign, devi configurare l’estensione Adobe Campaign nell’interfaccia utente di raccolta dati dell’SDK di Adobe Experience Platform Mobile.

L’SDK di Adobe Experience Platform Mobile aiuta ad alimentare soluzioni e servizi di Experience Cloud di Adobe nelle app mobili. La configurazione degli SDK viene gestita tramite l’interfaccia utente di Data Collection per una configurazione flessibile e integrazioni estensibili basate su regole.

Ulteriori informazioni sono disponibili nella documentazione di Adobe Developer.

Configurare le impostazioni app in Campaign

Prima di inviare le notifiche push, devi definire le impostazioni delle app iOS e Android in Adobe Campaign.

Le notifiche push vengono inviate agli utenti dell’app tramite un servizio dedicato. Quando gli utenti installano l’app, si abbonano a questo servizio: Adobe Campaign si basa su questo servizio per eseguire il targeting solo per gli abbonati dell’app. In questo servizio, devi aggiungere le app iOS e Android da inviare su dispositivi iOS e Android.

Per creare un servizio per l’invio di notifiche push, effettua le seguenti operazioni:

  1. Sfoglia per Profiles and Targets > Services and Subscriptions e fai clic su Create.

  2. Immetti un Label e un Internal name, e seleziona un Mobile application tipo.

    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. Ulteriori informazioni sulle mappature di destinazione in questa pagina.

  3. Quindi utilizza Add sulla destra per definire le applicazioni mobili che utilizzano questo servizio.

Per creare un'app per dispositivi iOS, effettua le seguenti operazioni:

  1. Seleziona Create an iOS application e fai clic su Next.

  2. Immetti il nome dell'app in Label campo.

  3. (facoltativo) Puoi arricchire il contenuto di un messaggio push con alcune Application variables. Questi sono completamente personalizzabili e fanno parte del payload del messaggio inviato al dispositivo mobile.

    Nell’esempio seguente, il mediaURl e mediaExt Le variabili vengono aggiunte per creare notifiche push potenziate e quindi forniscono all’applicazione l’immagine da visualizzare all’interno della notifica.

  4. Accedi a Subscription parameters per definire la mappatura con un’estensione del Subscriber applications (nms:appsubscriptionRcp) schema.

  5. Accedi a Sounds per definire un suono da riprodurre. Clic Add e riempimento Internal name che deve contenere il nome del file incorporato nell'applicazione o il nome del suono di sistema.

  6. Clic Next per avviare la configurazione dell'applicazione di sviluppo.

  7. La chiave di integrazione è specifica per ogni applicazione. Collega l’app mobile ad Adobe Campaign.

    Assicurati che lo stesso Integration key è definito in Adobe Campaign e nel codice dell’applicazione tramite l’SDK.

    Ulteriori informazioni in la documentazione per gli sviluppatori

    NOTA

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

    Non è possibile utilizzare lo stesso certificato per la versione di sviluppo (sandbox) e la versione di produzione dell’applicazione.

  8. Seleziona l’icona dal menu Application icon per personalizzare l’app mobile nel servizio.

  9. Seleziona Authentication mode. Sono disponibili due modalità:

    • (Consigliato) Token-based authentication: 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…. Per ulteriori informazioni su Token-based authentication, fare riferimento a Documentazione di Apple.

    • Certificate-based authentication: fai clic Enter the certificate… quindi seleziona la chiave p12 e immetti la password fornita dallo sviluppatore dell’app mobile.

    Puoi modificare la modalità di autenticazione in un secondo momento nel Certificate della tua app mobile.

  10. Utilizza il Test the connection per convalidare la configurazione.

  11. Clic Next per iniziare a configurare l’applicazione di produzione e seguire gli stessi passaggi descritti in precedenza.

  12. Fai clic su Finish.

L’applicazione iOS è ora pronta per essere utilizzata in Campaign.

Per creare un'app per dispositivi Android, effettua le seguenti operazioni:

  1. Seleziona Create an Android application e fai clic su Next.

  2. Immetti il nome dell'app in Label campo.

  3. La chiave di integrazione è specifica per ogni applicazione. Collega l’app mobile ad Adobe Campaign.

    Assicurati che lo stesso Integration key è definito in Adobe Campaign e nel codice dell’applicazione tramite l’SDK.

    Ulteriori informazioni in la documentazione per gli sviluppatori

    NOTA

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

  4. Seleziona l’icona dal menu Application icon per personalizzare l’app mobile nel servizio.

  5. Seleziona HTTP v1 in API version elenco a discesa.

  6. Clic Load project json file to extract project details… collegamento per caricare il file di chiave JSON. Per ulteriori informazioni su come estrarre il file JSON, consulta Documentazione di Google Firebase.

    È inoltre possibile immettere manualmente i seguenti dettagli:

    • Project Id
    • Private Key
    • Client Email
  7. Utilizza il Test the connection per convalidare la configurazione.

    ATTENZIONE

    Il Test connection non verifica se il server MID ha accesso al server FCM.

  8. (facoltativo) Puoi arricchire il contenuto di un messaggio push con alcune Application variables se necessario. Questi sono completamente personalizzabili e fanno parte del payload del messaggio inviato al dispositivo mobile.

  9. Fai clic su Finish, quindi su Save. L’applicazione Android è ora pronta per essere utilizzata in Campaign.

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

Creare la prima notifica push

Questa sezione descrive gli elementi specifici per la consegna delle notifiche iOS e Android.

ATTENZIONE

Nell'ambito di una Distribuzione aziendale (FFDA), la registrazione mobile è ora asincrono. Ulteriori informazioni

Per creare una nuova consegna, passa a Campaigns , fare clic su Deliveries e fai clic su Create sopra l’elenco delle consegne esistenti.

Per inviare notifiche sui dispositivi iOS, effettua le seguenti operazioni:

  1. Seleziona la Deliver on iOS modello di consegna.

  2. Per definire il target della notifica, fai clic sul pulsante To , quindi fai clic su Add.

  3. Seleziona Subscribers of an iOS mobile application (iPhone, iPad), seleziona il servizio relativo all’app mobile, quindi seleziona la versione iOS dell’applicazione.

  4. Scegli il tuo Notification type tra General notification (Alert, Sound, Badge) o Silent notification.

    NOTA

    Il Push silenzioso La modalità consente di inviare una notifica "invisibile all’utente" a un’app mobile. L’utente non viene informato dell’arrivo della notifica. Viene trasferito direttamente all’applicazione.

  5. In Title immettere l'etichetta del titolo che si desidera visualizzare nell'elenco delle notifiche disponibili dal centro notifiche.

    Questo campo ti consente di definire il valore del titolo parametro del payload di notifica di iOS.

  6. Puoi aggiungere una Subtitle, valore del sottotitolo parametro del payload di notifica di iOS.

  7. Inserisci il contenuto del messaggio in Message content sezione della procedura guidata.

  8. Dalla sezione Sound and Badge , è possibile modificare le seguenti opzioni:

    • Clean Badge: abilita queste opzioni per aggiornare il valore del badge.

    • Value: imposta un numero che verrà utilizzato per visualizzare direttamente sull’icona dell’applicazione il numero di nuove informazioni non lette.

    • Critical alert mode: abilita questa opzione per aggiungere un suono alla notifica anche se il telefono dell’utente è impostato sulla modalità di attivazione o se l’iPhone è disattivato.

    • Name: seleziona il suono che deve essere riprodotto dal terminale mobile quando viene ricevuta la notifica.

    • Volume: volume del suono da 0 a 100.

      NOTA

      I suoni devono essere inclusi nell'applicazione e definiti al momento della creazione del servizio.

  9. Dalla sezione Application variables , il tuo Application variables vengono aggiunti automaticamente. Consentono di definire il comportamento di notifica; ad esempio, puoi configurare una schermata di un’applicazione specifica da visualizzare quando l’utente attiva la notifica.

  10. Dalla sezione Advanced , è possibile modificare le seguenti opzioni generali:

    • Mutable content: abilita questa opzione per consentire all’app mobile di scaricare contenuti multimediali.

    • Thread-id: identificatore utilizzato per raggruppare le notifiche correlate.

    • Category: nome dell’ID categoria che visualizzerà i pulsanti di azione. Queste notifiche forniscono all’utente un modo più rapido per eseguire diverse attività in risposta a una notifica senza aprire o esplorare l’applicazione.

  11. Per le notifiche sensibili all’ora, puoi specificare le seguenti opzioni:

    • Target content ID: identificatore utilizzato per individuare la finestra dell’applicazione da inoltrare quando viene aperta la notifica.

    • Launch image: nome del file dell'immagine di avvio da visualizzare. Se l’utente sceglie di avviare l’applicazione, viene visualizzata l’immagine selezionata invece della schermata di avvio dell’applicazione.

    • Interruption level:

      • Active: per impostazione predefinita, il sistema visualizza immediatamente la notifica, illumina lo schermo e può riprodurre un suono. Le notifiche non interrompono le modalità di attivazione.

      • Passive: il sistema aggiunge la notifica all’elenco delle notifiche senza accendere lo schermo o riprodurre un suono. Le notifiche non interrompono le modalità di attivazione.

      • Time sensitive Il sistema presenta immediatamente la notifica, accende lo schermo, può riprodurre un suono e interrompere le modalità di messa a fuoco. Questo livello non richiede un’autorizzazione speciale da Apple.

      • Critical Il sistema visualizza immediatamente la notifica, illumina lo schermo e ignora le modalità di disattivazione audio o di messa a fuoco. Tieni presente che questo livello richiede un’autorizzazione speciale da parte di Apple.

    • Relevance score: imposta un punteggio di rilevanza da 0 a 100. Il sistema utilizza questa funzione per ordinare le notifiche nel riepilogo delle notifiche.

  12. Una volta configurata la notifica, fai clic su Preview per visualizzare l’anteprima della notifica.

Per inviare notifiche su dispositivi Android, effettua le seguenti operazioni:

  1. Seleziona la Deliver on Android (android) modello di consegna.

  2. Per definire il target della notifica, fai clic sul pulsante To , quindi fai clic su Add.

  3. Seleziona Subscribers of an Android mobile application, scegli il servizio relativo alla tua app mobile (Neotrips, in questo caso), quindi seleziona la versione Android dell’applicazione.

  4. Quindi inserisci il contenuto per la notifica.

  5. Fai clic su Insert emoticon per inserire emoticon nella notifica push.

  6. In Application variables , immettere il valore di ciascuna variabile. Ad esempio, puoi configurare una schermata dell’applicazione specifica da visualizzare quando l’utente attiva la notifica.

  7. Una volta configurata la notifica, fai clic su Preview per visualizzare l’anteprima della notifica.

Testare, inviare e monitorare le notifiche push

Per inviare una bozza e la consegna finale, utilizza lo stesso processo utilizzato per le altre consegne.

Scopri come convalidare una consegna in questa pagina.

Scopri come confermare e inviare la consegna in questa pagina

Dopo aver inviato i messaggi, puoi monitorare e tenere traccia delle consegne. Ulteriori informazioni sui motivi degli errori di consegna delle notifiche push in questa pagina.

In questa pagina