Configurar o suporte a mensagens no aplicativo da Web no Web SDK
As mensagens no aplicativo são notificações que podem ser enviadas aos usuários no aplicativo web, guiando-os a pontos de interesse específicos.
É possível usar essas notificações para diferentes propósitos, como promover novos recursos, apresentar ofertas especiais ou facilitar a integração do usuário.
Ao usar mensagens no aplicativo, você pode se envolver efetivamente com seu público-alvo e orientá-los para aspectos importantes de seu aplicativo.
Pré-requisitos prerequisites
Versão da extensão de tag do Web SDK extension-version
A funcionalidade de mensagens no aplicativo da Web exige a versão mais recente da extensão de tag do Web SDK.
Configurar uma CSP para mensagens no aplicativo da Web csp
Ao configurar Mensagens no aplicativo da Web, você deve incluir a seguinte diretiva na CSP:
default-src blob:;
Para obter mais informações sobre como configurar uma CSP, consulte a documentação dedicada.
Configurar mensagens no aplicativo da Web usando a extensão de tag da Web SDK tag-extension
Consulte a página de configuração da extensão de tag do Web SDK para entender onde você pode encontrar as configurações descritas abaixo.
Depois de instalar a extensão de tag do Web SDK, siga as etapas abaixo para configurar a extensão para Mensagens no Aplicativo Web.
Na seção Personalization, marque a opção Habilitar armazenamento de personalização. Essa opção permite que o Web SDK acompanhe quais experiências foram vistas pelo usuário em carregamentos de página.
As mensagens no aplicativo da Web são compatíveis com dois tipos de acionadores:
Consulte as seções a seguir para configurar a extensão de tag do Web SDK de acordo com os acionadores que deseja usar.
Etapas de configuração para o gatilho Enviar dados para a Experience Platform send-data-platform
Selecione a propriedade da marca que contém sua extensão do Web SDK e crie uma nova regra com as seguintes configurações:
-
Extensão: Núcleo
-
Tipo de Evento: Biblioteca Carregada (Início da Página)
-
Selecione Manter alterações para salvar a configuração do evento.
Em seguida, você deve adicionar uma ação à regra criada.
-
Na seção Actions, selecione Adicionar.
-
Usar as seguintes configurações de Ação:
-
Extensão: Adobe Experience Platform Web SDK
-
Tipo de ação: Enviar evento
-
-
No lado direito da tela, na seção Personalization, habilite a opção Renderizar decisões de personalização visual.
-
No lado direito da tela, na seção Contexto de decisão, defina os pares de Chave/Valor que você usou na configuração da campanha para se qualificar para a mensagem no aplicativo.
-
Selecione Manter alterações para salvar sua configuração.
Em seguida, você deve adicionar a regra recém-criada à biblioteca de propriedades da tag. Para fazer isso, vá para Fluxo de publicação e selecione a regra criada anteriormente.
Depois de adicionar a regra à biblioteca, selecione Salvar e criar no desenvolvimento.
O processo de configuração agora está concluído e sua mensagem está pronta para ser exibida aos usuários.
Etapas de configuração para usar acionadores manuais manual-trigger
Selecione a propriedade da marca que contém sua extensão do Web SDK e crie uma nova regra com as seguintes configurações:
-
Extensão: Núcleo
-
Tipo de Evento: Clique
-
Defina o acionador de um elemento específico na página, identificado por um seletor de CSS de sua escolha.
Em seguida, você deve adicionar uma ação à regra criada.
-
Na seção Actions, selecione Adicionar.
-
Usar as seguintes configurações de Ação:
-
Extensão: Adobe Experience Platform Web SDK
-
Tipo de ação: Avaliar conjuntos de regras
-
-
No lado direito da tela, habilite a opção Renderizar decisões de personalização visual.
-
No lado direito da tela, na seção Contexto de decisão, defina os pares de Chave/Valor que você usou na configuração da campanha para se qualificar para a mensagem no aplicativo.
-
Selecione Manter alterações para salvar sua configuração.
Em seguida, você deve adicionar a regra recém-criada à biblioteca de propriedades da tag. Para fazer isso, vá para Fluxo de publicação e selecione a regra criada anteriormente.
Depois de adicionar a regra à biblioteca, selecione Salvar e criar no desenvolvimento.
O processo de configuração agora está concluído e sua mensagem está pronta para ser exibida aos usuários.
Configurar mensagens no aplicativo da Web usando a biblioteca JavaScript do Web SDK js-library
Como alternativa ao uso da extensão de tag do Web SDK, você também pode configurar Mensagens no aplicativo Web diretamente da biblioteca JavaScript do Web SDK.
Você pode exibir mensagens no aplicativo da Web do Adobe Journey Optimizer de duas maneiras.
Método 1: buscar automaticamente o conteúdo de personalização automatic
Para que o Web SDK busque automaticamente o conteúdo de personalização no carregamento da página, use o comando sendEvent
, conforme mostrado no exemplo abaixo.
alloy("sendEvent", {
renderDecisions: true,
personalization: {
surfaces: ['#welcome']
}
});
Método 2: buscar manualmente o conteúdo de personalização com base na ação do usuário manual
Para mostrar o conteúdo de personalização somente depois que o usuário executar uma ação específica, use o comando evaluateRulesets
como mostrado no exemplo abaixo.
Neste exemplo, o conteúdo de personalização é exibido quando um usuário clica no botão Comprar agora no seu site.
alloy("evaluateRulesets", {
renderDecisions: true,
personalization: {
decisionContext: {
"userAction": "buy_now"
}
}
});
Configurar armazenamento de personalização personalization-storage
Você pode optar por mostrar mensagens no aplicativo aos usuários por um número definido de vezes, ou sempre que eles visitarem uma página, por meio da opção de configuração personalizationStorageEnabled
.
Na configuração do Web SDK, defina a opção personalizationStorageEnabled
de acordo com suas necessidades:
personalizationStorageEnabled: true
aciona a mensagem no aplicativo com a frequência que você definiu na campanha do Adobe Journey Optimizer.personalizationStorageEnabled: false
aciona a mensagem no aplicativo em cada carregamento de página.