Configurare il supporto per la messaggistica Web in-app in Web SDK

I messaggi in-app sono notifiche che puoi inviare agli utenti all’interno dell’applicazione web, guidandoli verso punti di interesse specifici.

Puoi utilizzare queste notifiche per diversi scopi, ad esempio per promuovere nuove funzioni, presentare offerte speciali o facilitare l’onboarding degli utenti.

Utilizzando i messaggi in-app, puoi interagire in modo efficace con il pubblico e indirizzarli verso aspetti importanti dell’applicazione.

IMPORTANT
La messaggistica Web in-app è un Adobe Journey Optimizer che utilizza l’SDK web per distribuire i contenuti personalizzati.
Per istruzioni dettagliate su come configurare la campagna di messaggistica Web in-app, vedi Documentazione di Adobe Journey Optimizer.

Prerequisiti prerequisites

Versione estensione tag Web SDK extension-version

La funzionalità di messaggistica in-app per web richiede la versione più recente dell’estensione tag SDK per web.

Configurare un CSP per la messaggistica in-app web csp

Quando si configura Messaggistica Web in-app, devi includere la seguente direttiva nel CSP:

default-src  blob:;

Per ulteriori informazioni sulla configurazione di un CSP, vedi documentazione dedicata.

Configurare la messaggistica Web in-app utilizzando l’estensione tag Web SDK tag-extension

Consulta la sezione Pagina di configurazione dell’estensione tag Web SDK per capire dove si trovano le impostazioni descritte di seguito.

Dopo aver installato Nell’estensione tag Web SDK, segui i passaggi indicati di seguito per configurare l’estensione per la messaggistica in-app web.

In Personalizzazione sezione, controlla la Abilita archiviazione personalizzazione opzione. Questa opzione consente all’SDK web di tenere traccia delle esperienze viste dall’utente nei vari caricamenti di pagina.

Immagine che mostra l’opzione di archiviazione per la personalizzazione nella pagina di configurazione dell’estensione tag.

La messaggistica in-app Web supporta due tipi di trigger:

Consulta le sezioni seguenti per configurare l’estensione tag Web SDK in base ai trigger che desideri utilizzare.

Passaggi di configurazione per Inviare dati a Platform trigger send-data-platform

Seleziona la proprietà tag che contiene l’estensione Web SDK e crea una nuova regola con le seguenti impostazioni:

  1. Estensione: Core

  2. Tipo di evento: Library Loaded (Page Top)

    Immagine che mostra la schermata di configurazione dell’evento.

  3. Seleziona Mantieni modifiche per salvare la configurazione dell’evento.

Successivamente, devi aggiungere un’azione alla regola creata.

  1. In Actions sezione, seleziona Aggiungi.
    Immagine che mostra la schermata Modifica regola.

  2. Utilizza quanto segue Azione impostazioni:

    • Estensione: Adobe Experience Platform Web SDK

    • Tipo di azione: Invia evento

      Immagine che mostra la schermata di configurazione dell’azione.

  3. Sul lato destro dello schermo, nella Personalizzazione , abilita Eseguire il rendering delle decisioni di personalizzazione visiva opzione.
    Immagine che mostra la schermata di configurazione della personalizzazione.

  4. Sul lato destro dello schermo, nella Contesto decisionale , definire la sezione Chiave/Valore coppie che hai utilizzato nella configurazione di campaign per essere idonee per il messaggio in-app.
    Immagine che mostra la schermata di configurazione della personalizzazione.

  5. Seleziona Mantieni modifiche per salvare la configurazione.

Successivamente, devi aggiungere la regola appena creata alla libreria delle proprietà del tag. Per eseguire questa operazione, vai a Flusso di pubblicazione e seleziona la regola creata in precedenza.

Immagine che mostra la schermata della libreria.

Dopo aver aggiunto la regola alla libreria, seleziona Salva e genera in sviluppo.

Immagine che mostra la schermata di configurazione della personalizzazione.

Il processo di configurazione è ora completato e il messaggio è pronto per essere mostrato agli utenti.

Passaggi di configurazione per l'utilizzo di trigger manuali manual-trigger

Seleziona la proprietà tag che contiene l’estensione Web SDK e crea una nuova regola con le seguenti impostazioni:

  1. Estensione: Core

  2. Tipo di evento: Clic

  3. Imposta il trigger per un elemento specifico sulla pagina, identificabile da un selettore CSS a tua scelta.

    Immagine che mostra la schermata di configurazione dell’evento.

Successivamente, devi aggiungere un’azione alla regola creata.

  1. In Actions sezione, seleziona Aggiungi.
    Immagine che mostra la schermata Modifica regola.

  2. Utilizza quanto segue Azione impostazioni:

    • Estensione: Adobe Experience Platform Web SDK

    • Tipo di azione: Valuta set di regole

      Immagine che mostra la schermata di configurazione dell’azione.

  3. Sul lato destro dello schermo, abilita Eseguire il rendering delle decisioni di personalizzazione visiva opzione.
    Immagine che mostra la schermata di configurazione della personalizzazione.

  4. Sul lato destro dello schermo, nella Contesto decisionale , definire la sezione Chiave/Valore coppie che hai utilizzato nella configurazione di campaign per essere idonee per il messaggio in-app.
    Immagine che mostra la schermata di configurazione della personalizzazione.

  5. Seleziona Mantieni modifiche per salvare la configurazione.

Successivamente, devi aggiungere la regola appena creata alla libreria delle proprietà del tag. Per eseguire questa operazione, vai a Flusso di pubblicazione e seleziona la regola creata in precedenza.

Immagine che mostra la schermata della libreria.

Dopo aver aggiunto la regola alla libreria, seleziona Salva e genera in sviluppo.

Immagine che mostra la schermata di configurazione della personalizzazione.

Il processo di configurazione è ora completato e il messaggio è pronto per essere mostrato agli utenti.

Configurare la messaggistica Web in-app utilizzando la libreria JavaScript di Web SDK js-library

In alternativa all’utilizzo dell’estensione tag Web SDK, puoi anche configurare la messaggistica Web in-app direttamente dalla libreria JavaScript dell’SDK per web.

I messaggi web in-app provenienti da Adobe Journey Optimizer possono essere visualizzati in due modi.

Metodo 1: recuperare automaticamente il contenuto di personalizzazione automatic

Per fare in modo che l’SDK web recuperi automaticamente il contenuto di personalizzazione al caricamento della pagina, utilizza sendEvent come illustrato nell'esempio seguente.

  alloy("sendEvent", {
      renderDecisions: true,
      personalization: {
          surfaces: ['#welcome']
      }
  });

Metodo 2: recuperare manualmente il contenuto di personalizzazione in base all’azione dell’utente manual

Per mostrare il contenuto di personalizzazione solo dopo che l’utente ha eseguito un’azione specifica, utilizza evaluateRulesets come illustrato nell'esempio seguente.

In questo esempio, il contenuto di personalizzazione viene visualizzato quando un utente fa clic su Acquista ora sul sito web.

 alloy("evaluateRulesets", {
     renderDecisions: true,
     personalization: {
         decisionContext: {
             "userAction": "buy_now"
         }
     }
 });

Configurare l’archiviazione per la personalizzazione personalization-storage

Puoi scegliere di mostrare i messaggi in-app agli utenti per un determinato numero di volte oppure ogni volta che visitano una pagina, tramite personalizationStorageEnabled opzione di configurazione.

In Configurazione dell’SDK web imposta personalizationStorageEnabled opzione in base alle tue esigenze:

  • personalizationStorageEnabled: true attiva il messaggio in-app con la frequenza definita nell' Campagna Adobe Journey Optimizer.
  • personalizationStorageEnabled: false attiva il messaggio in-app a ogni caricamento di pagina.
recommendation-more-help
ad108910-6329-42f1-aa1d-5920a2b13636