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.

IMPORTANT
As Mensagens no Aplicativo Web são um recurso do Adobe Journey Optimizer, que usa o SDK da Web para fornecer conteúdo personalizado.
Para obter instruções detalhadas sobre como configurar a campanha de Mensagens no Aplicativo da Web, consulte a documentação do Adobe Journey Optimizer.

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.

Imagem mostrando a opção de armazenamento de personalização na página de configuração de extensão de marca.

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:

  1. Extensão: Núcleo

  2. Tipo de Evento: Biblioteca Carregada (Início da Página)

    Imagem mostrando a tela de configuração do evento.

  3. Selecione Manter alterações para salvar a configuração do evento.

Em seguida, você deve adicionar uma ação à regra criada.

  1. Na seção Actions, selecione Adicionar.
    Imagem mostrando a tela editar regra.

  2. Usar as seguintes configurações de Ação:

    • Extensão: Adobe Experience Platform Web SDK

    • Tipo de ação: Enviar evento

      Imagem mostrando a tela de configuração da ação.

  3. No lado direito da tela, na seção Personalization, habilite a opção Renderizar decisões de personalização visual.
    Imagem mostrando a tela de configuração de personalização.

  4. 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.
    Imagem mostrando a tela de configuração de personalização.

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

Imagem mostrando a tela da biblioteca.

Depois de adicionar a regra à biblioteca, selecione Salvar e criar no desenvolvimento.

Imagem mostrando a tela de configuração de personalização.

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:

  1. Extensão: Núcleo

  2. Tipo de Evento: Clique

  3. Defina o acionador de um elemento específico na página, identificador por um seletor de CSS de sua escolha.

    Imagem mostrando a tela de configuração do evento.

Em seguida, você deve adicionar uma ação à regra criada.

  1. Na seção Actions, selecione Adicionar.
    Imagem mostrando a tela editar regra.

  2. Usar as seguintes configurações de Ação:

    • Extensão: Adobe Experience Platform Web SDK

    • Tipo de ação: Avaliar conjuntos de regras

      Imagem mostrando a tela de configuração da ação.

  3. No lado direito da tela, habilite a opção Renderizar decisões de personalização visual.
    Imagem mostrando a tela de configuração de personalização.

  4. 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.
    Imagem mostrando a tela de configuração de personalização.

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

Imagem mostrando a tela da biblioteca.

Depois de adicionar a regra à biblioteca, selecione Salvar e criar no desenvolvimento.

Imagem mostrando a tela de configuração de personalização.

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.
recommendation-more-help
ad108910-6329-42f1-aa1d-5920a2b13636