Guia rápido de início de mensagens no local

Prev Next

Tudo o que você precisa saber antes de começar a enviar mensagens no local

Mensagens no local são entregues aos usuários que navegam pelo seu site em resposta a um gatilho de evento. Opt-in não é obrigatório para esse tipo de mensagem. Tanto eventos do SDK quanto do servidor podem ser usados para acionar campanhas no local.

Pré-requisitos: integração do SDK

Mensagens no local exigem que você configure sua aplicação web no seu projeto Xtremepush e que complete a integração do Xtremepush SDK no seu site.

Adicionar eventos para disparar mensagens

Mensagens no local são acionadas por eventos do SDK ou do servidor.

Eventos SDK

Você precisa de pelo menos um evento em tempo real (por exemplo, uma visualização de página específica) para mostrar uma mensagem no site aos seus usuários. Uma vez que o SDK seja implantado no seu site, você pode adicionar esses eventos chamando o método de evento JavaScript do SDK.

xtremepush('event', 'EVENT_NAME');

Para mais informações sobre eventos SDK e como eles podem ser facilmente implantados diretamente ou usando um produto gerenciador de tags como o Google Tag Manager, veja eventos de demissão do seu site , respectivamente. Confira nosso guia dedicado para mais informações sobre eventos especiais, como mouse out e eventos de pager.

Tempo real vs enfileira

Você só pode configurar mensagens em tempo real no local especificando gatilhos de eventos do SDK em campanhas independentes no aplicativo / no local , que são criadas a partir de Campanhas > Criar uma campanha > Dentro do app/no local. Eventos SDK também podem ser usados em campanhas multicanal no local, mas a mensagem será recuperada usando um mecanismo de pesquisa.

Eventos do servidor

Eventos do servidor podem incluir qualquer evento backend ou externo que possa ser acionado por integrações ou por meio de API externa usando o método de evento hit. Ao usar esses eventos, as mensagens enviadas aos seus usuários serão enfileiradas e entregues apenas após abrirem seu aplicativo. Para mais informações sobre a implantação de eventos do servidor, veja Configurar mensagens acionadas pelo servidor.

Eventos do servidor só podem ser usados quando você cria uma campanha autônoma no local. Para criar uma campanha autônoma no local, navegue até Campanhas > Crie uma campanha > In-app/On-site.

Ativear o canal no local

Para poder usar o canal on-site, ele deve ser ativado primeiro por um usuário do Projeto ou Administrador da Empresa, a partir de Configurações > Apps & sites > clique no site correspondente alternando o controle deslizante On-site e clicando em Enable. Não é necessária nenhuma configuração adicional.

Testando...

É recomendado realizar testes antes de começar a enviar campanhas no local para seus clientes.

Mensagens de teste no local

Mensagens no local podem ser usadas como campanhas independentes ou como parte de campanhas de estágio único multicanal.

Para criar campanhas independentes, acesse Campanhas > Criar Campanha > In-App / On-Site. Criar campanhas independentes permite que você use eventos de backend como gatilhos de campanha. Para mais informações, veja Definir Gatilhos para Campanhas In-App / On-Site.

Para adicionar mensagens no local a campanhas de estágio único, acesse Campanhas > Criar campanha > Evento de > de estágio único acionado e, em seguida, selecione o canal On-site na aba Configuração da sua campanha.

Você pode consultar mais detalhes sobre como configurar uma campanha no local neste guia. Confira nosso guia de diretrizes criativas para melhores resultados.

Para lançar facilmente uma campanha de teste, você pode disparar manualmente um evento do seu site, usando as ferramentas de desenvolvimento do navegador, usando o método de evento SDK. Navegue até seu site no navegador de sua preferência e abra as ferramentas para desenvolvedores. Depois, navegue até a aba Console e use o seguinte comando (no exemplo, estamos executando um evento chamado cart.view:

xtremepush('event', 'cart.view');

Um evento é criado no seu projeto quando você o executa pela primeira vez a partir do seu site, ou você também pode criá-lo manualmente navegando até o Gerenciador de Dados > Eventos > Criar evento.

Depois de disparar ou criar esse evento, poderá selecioná-lo para uso na sua campanha digitando o nome em Evento Personalizado) na aba Gatilhos . Configure o restante das opções seguindo nosso guia.

Navegue até a aba Segmento para especificar os destinatários da campanha. Se você ativou as Aplicações de Alvo e integrou mais de um site no seu projeto, pode especificar qual deseja direcionar, caso contrário o conteúdo aparecerá em todos eles. Se você tem vários usuários e quer direcionar um específico, pode fazer isso selecionando Criar Segmento Personalizado > identificador > ID de usuário igual e fornecendo o ID de usuário. Isso só funcionará se você já tiver definido seu ID de usuário.

Conte os destinatários antes de iniciar a campanha

Ao lançar uma campanha, é uma boa prática usar o recurso Calcular destinatários para contar os destinatários e garantir que o público-alvo dessa campanha seja o que você espera.

Depois de iniciar a campanha, e para testá-la, você precisará voltar ao seu site e disparar o evento novamente. A mensagem no local deve aparecer imediatamente após você disparar o evento.

Solução de problemas: Logs de depuração

Os logs de depuração permitem que você revise solicitações feitas do seu site para o projeto Xtremepush e detecte problemas. Veja nosso guia dedicado para instruções sobre como habilitar logs de depuração.

Como obter o ID do seu dispositivo?

Confira nosso guia dedicado para saber como obter o ID do seu dispositivo.