Configurare il canale di notifica push push-notification-configuration

Per inviare notifiche push con Adobe Campaign, devi prima configurare l’ambiente e l’app come descritto in questa pagina. In Adobe Campaign, il canale per l’invio di notifiche push è il canale app mobile.

CAUTION
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.

Prima di iniziare a inviare notifiche push con Adobe Campaign, è necessario assicurarsi che le configurazioni e le integrazioni siano attive nell’app mobile e per i tag in Adobe Experience Platform. L’SDK di Adobe Experience Platform Mobile fornisce API di integrazione lato client per i dispositivi mobili tramite SDK compatibili con Android e iOS.

Per configurare la tua app con gli SDK di Adobe Experience Platform Mobile, segui questi passaggi:

  1. Controlla prerequisiti.
  2. Configura una proprietà tag mobile in Raccolta dati di Adobe Experience Platform.
  3. Ottieni l'SDK di Adobe Experience Platform Mobile come dettagliato in questa pagina.
  4. (facoltativo) Abilita la registrazione e le metriche del ciclo di vita, come descritto in questa pagina.
  5. (facoltativo) Aggiungi Adobe Experience Platform Assurance all'app per convalidare l'implementazione. Scopri come implementare l'estensione Adobe Experience Platform Assurance in questa pagina.
  6. Configura i tuoi iOS e Android Mobile Services in Adobe Campaign come in questa pagina.
  7. Installa e configura l'estensione Adobe Campaign nella tua proprietà mobile.
  8. Segui la documentazione dell'SDK di Adobe Experience Platform Mobile per completare la configurazione con gli SDK di Adobe Experience Platform Mobile nella tua app.

Prerequisiti before-starting

Impostare le autorizzazioni setup-permissions

Prima di creare un’app mobile, è necessario assicurarsi di disporre delle autorizzazioni utente corrette per i tag in Adobe Experience Platform o assegnarle. Le autorizzazioni utente per i tag in Adobe Experience Platform vengono assegnate agli utenti tramite Adobe Admin Console. Ulteriori informazioni nella documentazione sui tag.

CAUTION
La configurazione push deve essere eseguita da un utente esperto. A seconda del modello di implementazione e degli utenti tipo coinvolti nell'implementazione, potrebbe essere necessario assegnare il set completo di autorizzazioni a un singolo profilo di prodotto o condividere le autorizzazioni tra lo sviluppatore di app e l'amministratore Adobe Campaign.

Per assegnare i diritti di Proprietà e Società, effettua le seguenti operazioni:

  1. Accedere a Admin Console.

  2. Dalla scheda Products, seleziona la scheda Adobe Experience Platform Data Collection.

  3. Selezionare un elemento Product Profile esistente o crearne uno nuovo con il pulsante New profile. Scopri come creare un nuovo New profile nella documentazione di Admin Console.

  4. Dalla sezione Permissions, seleziona Property Rights.

  5. Fai clic su Add all. Questo aggiungerà il seguente diritto al tuo profilo di prodotto:

    • Approve
    • Develop
    • Edit Property
    • Manage Environments
    • Manage Extensions
    • Publish

    Queste autorizzazioni sono necessarie per installare e pubblicare l'estensione Adobe Campaign e pubblicare la proprietà app in Adobe Experience Platform Mobile SDK.

  6. Selezionare Company rights nel menu a sinistra.

  7. Aggiungi i seguenti diritti:

    • Manage App Configurations
    • Manage Properties

    Queste autorizzazioni sono necessarie per consentire allo sviluppatore di app mobili di impostare le credenziali push in Raccolta dati Adobe Experience Platform.

  8. Fai clic su Save.

Per assegnare Product profile agli utenti, eseguire la procedura seguente:

  1. Accedere a Admin Console.

  2. Dalla scheda Products, seleziona la scheda Adobe Experience Platform Data Collection.

  3. Seleziona la Product profile configurata in precedenza.

  4. Dalla scheda Users, fai clic su Add user.

  5. Digita il nome o l’indirizzo e-mail dell’utente e selezionalo. Quindi fare clic su Save.

    note note
    NOTE
    Se l'utente non è stato creato in precedenza in Admin Console, consulta la documentazione sull'aggiunta di utenti.

Configurare l’app configure-app

La configurazione tecnica prevede una stretta collaborazione tra lo sviluppatore dell’app e l’amministratore aziendale. Prima di iniziare a inviare notifiche push con Adobe Campaign, è necessario definire le impostazioni in Adobe Experience Platform Data Collection e integrare l'app mobile con gli SDK di Adobe Experience Platform Mobile.

Segui i passaggi di implementazione descritti nei collegamenti seguenti:

Configurare una proprietà di tag mobile in Raccolta dati di Adobe Experience Platform launch-property

Configurare una proprietà mobile consente allo sviluppatore di app mobili o all’addetto al marketing di configurare gli SDK per dispositivi mobili. In genere si crea una proprietà mobile per ogni applicazione mobile che si desidera gestire. Scopri come creare e configurare una proprietà mobile nella documentazione dell'SDK di Adobe Experience Platform Mobile.

Ulteriori informazioni su Adobe Experience Platform Data Collection tag nella documentazione di Adobe Experience Platform.

Una volta creata, apri la nuova proprietà tag e crea una libreria. Per eseguire questa operazione:

  1. Passa a Flusso di pubblicazione nell'area di navigazione a sinistra e seleziona Aggiungi libreria.
  2. Immetti il nome della libreria e seleziona l’ambiente.
  3. Selezionare Aggiungi tutte le risorse modificate e Salva e genera nello sviluppo.
  4. Infine, impostare questa libreria come libreria di lavoro dal pulsante Seleziona una libreria di lavoro.

Configurare i servizi mobili in Campaign push-service

Dopo aver configurato l'app mobile in Adobe Experience Platform Data Collection, è necessario creare due servizi (uno per i dispositivi iOS e uno per i dispositivi Android) per poter inviare notifiche push da 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. Passare alla scheda Profiles and Targets > Services and Subscriptions e fare clic su Create.

    {width="800"}

  2. Immettere Label e Internal name e selezionare un tipo 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. Ulteriori informazioni sulle mappature di destinazione in questa pagina.
  3. Quindi utilizza l'icona Add a destra per definire le applicazioni mobili che utilizzano questo servizio.

iOS

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

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

    {width="600"}

  2. Immettere il nome dell'app nel campo Label.

  3. (facoltativo) È possibile 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.

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

    {width="600"}

  4. Passare alla scheda Subscription parameters per definire il mapping con un'estensione dello schema Subscriber applications (nms:appsubscriptionRcp).

  5. Passare alla scheda Sounds per definire un suono da riprodurre. Fare clic su Add e compilare il campo Internal name che deve contenere il nome del file incorporato nell'applicazione o il nome del suono di sistema.

  6. Fare clic su 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 sia definito in Adobe Campaign e nel codice dell'applicazione tramite l'SDK.

    Ulteriori informazioni sono disponibili nella documentazione per sviluppatori

    note note
    NOTE
    Integration key è completamente personalizzabile con 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 campo 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, consulta la documentazione di Apple.

    • Certificate-based authentication: fare clic su Enter the certificate…, quindi selezionare la chiave p12 e immettere la password fornita dallo sviluppatore dell'app mobile. Tieni presente che questo certificato ha una data di scadenza e deve essere rinnovato su base annuale. Per evitare interruzioni del servizio per gli utenti, aggiorna i certificati prima della scadenza. I certificati sono validi per un anno e devi aggiornarli per continuare a comunicare con i numeri APN.

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

  11. Fare clic su Next per avviare la configurazione dell'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.

Android

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

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

    {width="600"}

  2. Immettere il nome dell'app nel campo Label.

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

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

    Ulteriori informazioni sono disponibili nella documentazione per sviluppatori

    note note
    NOTE
    Integration key è completamente personalizzabile con valore stringa, ma deve essere esattamente lo stesso specificato nell'SDK.
  4. Seleziona l'icona dal campo Application icon per personalizzare l'app mobile nel servizio.

  5. Selezionare HTTP v1 nell'elenco a discesa API version.

  6. Fai clic sul collegamento Load project json file to extract project details… per caricare il file di chiave JSON. Per ulteriori informazioni su come estrarre il file JSON, consulta la documentazione di Google Firebase.

    È inoltre possibile immettere manualmente i seguenti dettagli:

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

    note caution
    CAUTION
    Il pulsante Test connection non verifica se il server MID ha accesso al server FCM.
  8. (facoltativo) 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.

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

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

Configurare l’estensione Adobe Campaign nella proprietà mobile configure-extension

L'estensione Adobe Campaign Classic per gli SDK Adobe Experience Platform Mobile potenzia le notifiche push per le app mobili e ti aiuta a raccogliere i token push degli utenti e a gestire la misurazione delle interazioni con i servizi Adobe Experience Platform.

Questa estensione, che si applica sia a Campaign Classic v7 che a Campaign v8, è preinstallata nell’ambiente e deve essere configurata. Per configurare l'estensione per la proprietà tag per dispositivi mobili, effettua le seguenti operazioni:

  1. Apri la proprietà tag creata in precedenza.
  2. Dalla navigazione a sinistra, passa a Estensioni e apri la scheda Catalogo. Utilizza il campo di ricerca per trovare l'estensione Adobe Campaign Classic.
  3. Dalla scheda Campaign Classic, fai clic sul pulsante Installa.
  4. Immetti le impostazioni come descritto nella documentazione Adobe Experience Platform Mobile SDK.

Ora puoi aggiungere Campaign all'app, come descritto nella documentazione dell'SDK di Adobe Experience Platform Mobile.

recommendation-more-help
35662671-8e3d-4f04-a092-029a056c566b