Configurare il supporto per la messaggistica in-app web 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.

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

Configurare un CSP per la messaggistica in-app web csp

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

default-src  blob:;

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

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

Fare riferimento alla pagina di configurazione dell'estensione tag Web SDK per individuare le impostazioni descritte di seguito.

Dopo aver installato l'estensione tag Web SDK, eseguire la procedura seguente per configurare l'estensione per la messaggistica in-app Web.

Nella sezione Personalization, seleziona l'opzione Abilita archiviazione personalizzazione. Questa opzione consente al Web SDK di tenere traccia delle esperienze viste dall’utente nei vari caricamenti di pagina.

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 il trigger Invia dati ad Experience Platform send-data-platform

Selezionare la proprietà tag che contiene l'estensione Web SDK e creare una nuova regola con le impostazioni seguenti:

Successivamente, devi aggiungere un’azione alla regola creata.

Successivamente, devi aggiungere la regola appena creata alla libreria delle proprietà del tag. A questo scopo, vai a Flusso di pubblicazione e seleziona la regola creata in precedenza.

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

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

Selezionare la proprietà tag che contiene l'estensione Web SDK e creare una nuova regola con le impostazioni seguenti:

Successivamente, devi aggiungere un’azione alla regola creata.

Successivamente, devi aggiungere la regola appena creata alla libreria delle proprietà del tag. A questo scopo, vai a Flusso di pubblicazione e seleziona la regola creata in precedenza.

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

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

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

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

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 Web SDK recuperi automaticamente il contenuto di personalizzazione al caricamento della pagina, utilizzare il comando 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 visualizzare il contenuto di personalizzazione solo dopo che l'utente ha eseguito un'azione specifica, utilizzare il comando evaluateRulesets come illustrato nell'esempio seguente.

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

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

Configurare l’archiviazione per la personalizzazione personalization-storage

È possibile scegliere di mostrare i messaggi in-app agli utenti per un numero di volte impostato o ogni volta che visitano una pagina, tramite l'opzione di configurazione personalizationStorageEnabled.

Nella configurazione di Web SDK impostare l'opzione personalizationStorageEnabled in base alle proprie esigenze: