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

Tudo o que você precisa saber antes de começar a enviar mensagens dentro do app

Mensagens dentro do app são entregues aos usuários que navegam no seu app 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 mensagens dentro do app.

Pré-requisitos: integração do SDK

Mensagens dentro do app exigem que você configure seu app no seu projeto Xtremepush e que complete a integração do SDK Xtremepush. Veja detalhes de como fazer isso para Android e iOS.

Se seu app não for totalmente nativo, mas construído com um framework móvel, você precisará dos pré-requisitos para iOS e Android mencionados acima, mas suas alterações no código estarão relacionadas ao framework móvel específico que você está usando. Damos suporte a uma variedade de frameworks móveis populares, incluindo:

• PhoneGap

• Titânio

• Xamarin

• Unidade

• Aplicativos híbridos

Depois de integrar o SDK no seu app, será necessário ativar a mensagem dentro do app usando o seguinte método:

.setEnableInApp(true)

[XPush setInAppMessageEnabled: YES];

XPush.setInAppMessageEnabled(true)

Adicionar eventos para disparar mensagens

Mensagens dentro do app são acionadas por eventos do SDK, eventos do servidor ou no início da sessão (um evento do sistema que precisa ser implantado no seu app).

Eventos SDK

Depois que o SDK for implantado, você pode adicionar esses eventos facilmente chamando um método simples no seu app iOS ou Android. Eventos de gatilho são adicionados ao seu app usando o eventHit método do Xtremepush SDK.

mPushConnector.hitEvent("EVENT_NAME");

[XPush hitEvent: @"EVENT_NAME"];

XPush.hitEvent("EVENT_NAME")

Esses eventos podem ser acionados quando seções do app são abertas, botões são pressionados ou eventos mais complexos ocorrem, como compras ou o cumprimento de objetivos. Você deve selecionar um evento que acione a mensagem para ser enviada enquanto o aplicativo estiver aberto.

Para mais detalhes sobre eventos, incluindo envio de valores únicos ou pares chave/valor junto com eventos, confira a documentação do iOS e Android .

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, leia nosso guia dedicado.

Ativar o canal dentro do aplicativo

Para poder usar o canal dentro do app, ele deve ser ativado primeiro por um usuário do Projeto ou Administrador da Empresa, a partir de Configurações > Apps e Sites > clicar no aplicativo correspondente alternando o controle deslizante Dentro do app e clicando em Ativar. Não é necessária nenhuma configuração adicional.

Depois de ativar o canal dentro do app, você poderá ver Mensagens In-app / On-site como um canal disponível na página do construtor de campanhas.

Mensagens de teste dentro do aplicativo

Mensagens dentro do aplicativo podem ser usadas como campanhas independentes ou como parte de campanhas de estágio único.

Para criar campanhas independentes, acesse Campanhas > Criar Campanha > Dentro do Aplicativo / On-Site. Criar campanhas independentes permite usar SDK e eventos de backend como gatilhos de campanha. Para mais informações, veja Definir Gatilhos para Campanhas In-App / On-Site.

Para adicionar mensagens In-App a campanhas multicanal de estágio único, vá em Campanhas > Criar campanha > Evento de > de etapa única acionado e, em seguida, selecione o canal In-App na aba Configuração da sua campanha.

Você pode consultar mais detalhes sobre como configurar uma campanha dentro do aplicativo neste guia e também conferir nosso guia de diretrizes criativas para obter os melhores resultados.

Para iniciar uma campanha de teste, você pode disparar manualmente um evento do seu app, usando o método de eventos do SDK.

mPushConnector.hitEvent("EVENT_NAME");

[XPush hitEvent: @"EVENT_NAME"];

XPush.hitEvent("EVENT_NAME")

Depois de iniciar ou criar esse evento, você poderá selecioná-lo digitando o nome do evento na aba Eventos . Configure todas as outras opções seguindo nosso guia.

Navegue até a aba Segmento para especificar os destinatários da campanha. Se você tiver mais de um app integrado, precisa 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 que deseja direcionar. Isso só funcionará se você já tiver definido seu ID de usuário no Segmentation Engine.

Alternativamente, você pode direcionar por ID de dispositivo selecionando identificador > ID de dispositivo é igual.

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