Configurar o suporte a mensagens no aplicativo da Web no SDK da Web
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 SDK da Web extension-version
A funcionalidade de mensagens no aplicativo da Web exige a versão mais recente da extensão de tag do SDK da Web.
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 SDK da Web tag-extension
Consulte a página de configuração da extensão de tag do SDK da Web para entender onde você pode encontrar as configurações descritas abaixo.
Depois de instalar a extensão de tag do SDK da Web, siga as etapas abaixo para configurar a extensão para Mensagens no aplicativo da Web.
Na seção Personalization, marque a opção Habilitar armazenamento de personalização. Essa opção permite que o SDK da Web 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 seguintes seções para configurar a extensão de tag do SDK da Web de acordo com os acionadores que deseja usar.
Etapas de configuração para o gatilho Enviar dados para a Plataforma send-data-platform
Selecione a propriedade da marca que contém sua extensão SDK da Web 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 SDK da Web 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, identificador 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 SDK da Web js-library
Como alternativa ao uso da extensão de tag SDK da Web, você também pode configurar mensagens no aplicativo da Web diretamente da biblioteca JavaScript do SDK da Web.
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 SDK da Web busque automaticamente o conteúdo de personalização no carregamento da página, use o comando sendEvent
, como 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 SDK da Web, 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.