DocumentazioneCampaignDocumentazione di Campaign v8

Configurare il canale di notifica push push-notification-configuration

Last update: Mon Mar 18 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Creato per:

  • Intermediate
  • Admin
  • Developer

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. Verifica prerequisiti.
  2. Configurare un 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) abilitare la registrazione e le metriche del ciclo di vita, come descritto di seguito. in questa pagina.
  5. (facoltativo) Aggiungi Adobe Experience Platform Assurance per la tua app to validate your implementation. Learn how to implement Adobe Experience Platform Assurance extension in this page.
  6. Configura i servizi mobili iOS e Android in Adobe Campaign come descritto in questa pagina.
  7. Installare e configurare Estensione Adobe Campaign nella proprietà mobile.
  8. Segui Documentazione di Adobe Experience Platform Mobile SDK per eseguire 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 in 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 l'intero set di autorizzazioni a un singolo profilo di prodotto o condividere le autorizzazioni tra lo sviluppatore di app e Adobe Campaign amministratore.

Da assegnare Proprietà e Azienda diritti, segui i passaggi seguenti:

  1. Accedere a Admin Console.

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

  3. Seleziona un elemento esistente Product Profile o creane una nuova con New profile pulsante. Scopri come creare una nuova New profile nel 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à dell'app in SDK di Adobe Experience Platform Mobile.

  6. Quindi, seleziona Company rights nel menu di 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 di Adobe Experience Platform.

  8. Fai clic su Save.

Per assegnare questo Product profile per gli utenti, effettua le seguenti operazioni:

  1. Accedere a Admin Console.

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

  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, fai clic su Save.

    note note
    NOTE
    Se l’utente non è stato creato in precedenza in Admin Console, consulta Aggiungi documentazione 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 integra la tua 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 in Documentazione di Adobe Experience Platform Mobile SDK.

Ulteriori informazioni su Adobe Experience Platform Data Collection tag in Documentazione di Adobe Experience Platform.

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

  1. Sfoglia per Flusso di pubblicazione nel menu di navigazione a sinistra e seleziona Aggiungi libreria.
  2. Immetti il nome della libreria e seleziona l’ambiente.
  3. Seleziona Aggiungi tutte le risorse modificate, e Salva e genera in sviluppo.
  4. Infine, imposta questa libreria come libreria di lavoro dalla sezione Seleziona una libreria di lavoro pulsante.

Configurare i servizi mobili in Campaign push-service

Una volta impostata l’app mobile in 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. Sfoglia per Profiles and Targets > Services and Subscriptions e fai clic su Create.

    {width="800"}

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

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

  3. Quindi utilizza Add sulla 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. 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.

    {width="600"}

  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

    note note
    NOTE
    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. 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 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.

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

    note note
    NOTE
    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.

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

Il Estensione Adobe Campaign Classic per Adobe Experience Platform Mobile, l'SDK 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 barra di navigazione a sinistra, passa a Estensioni e aprire Catalogo scheda. Utilizza il campo di ricerca per trovare Adobe Campaign Classic estensione.
  3. Dalla scheda Campaign Classic, fai clic su Installa pulsante.
  4. Immetti le impostazioni come descritto in Documentazione di Adobe Experience Platform Mobile SDK.

Ora puoi aggiungere Campaign alla tua app, come descritto in Documentazione di Adobe Experience Platform Mobile SDK.

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