Uma mensagem in-app é um cartão ou uma barra exibida dentro do seu app enquanto uma pessoa o está usando. As telas de In-App do painel permitem escrever a mensagem, escolher quem a vê e quando, e ler como ela performou.

Uma mensagem só é exibida por um SDK que implementa o contrato de In-App: o painel cria e segmenta a mensagem, e o SDK a exibe e reporta o que aconteceu. Veja o Contrato de mensagens in-app para saber o que um SDK faz, e Mensagens in-app (REST) para gerenciar as mesmas mensagens a partir do seu backend com uma chave REST.

Abrir as telas de In-App

Há duas formas de entrar, ambas dentro de um App:

• In-app, em Mensagens na barra lateral, abre a lista de mensagens do App. + Novo In-App inicia uma nova mensagem a partir dali.
• O card In-App no painel Nova notificação ("Mensagens exibidas dentro do seu app") abre diretamente o editor de uma nova mensagem.

Começar de um template

Começar de um modelo, no cabeçalho da lista e na lista vazia, abre uma galeria com cinco pontos de partida: Mensagem de boas-vindas, Anúncio de novidade, Pedido de avaliação do app, Prompt de permissão de push e Oferta promocional. Cada card mostra uma prévia. Ao escolher um, o editor abre pré-preenchido com o nome, o título, o corpo e o botão, no idioma do painel.

• Nada é criado até você salvar. Tudo o que o template preenche pode ser editado.
• Os destinos dos botões vêm vazios. Preencha a URL ou o deep link antes de salvar, por exemplo o link da sua loja em Pedido de avaliação do app. Prompt de permissão de push não precisa de destino: seu botão usa a ação Pedido de permissão de push.
• Os templates não são armazenados por App: fazem parte do painel, então uma nova versão pode adicionar ou melhorar templates sem tocar nas suas mensagens.

Criar uma mensagem in-app

1. Abra o editor com + Novo In-App.

2. Em Detalhes, informe um Nome (até 120 caracteres; só a sua equipe o vê) e escolha o Layout: Topo (uma barra no topo da tela), Centro (um cartão sobre um fundo escurecido, o padrão), Base (uma barra na base) ou Tela cheia (ocupa a tela, os botões ficam na parte de baixo). Topo e Base não escurecem o fundo.

3. Em Conteúdo, informe um Título, um Corpo, ou os dois. Somente texto simples: o título aceita até 100 caracteres e o corpo até 500.

4. Opcionalmente, adicione uma Imagem com Escolher imagem. Ela aparece acima do texto em Centro e Tela cheia, e como um quadrado pequeno em Topo e Base. Ative Abrir um link ao tocar na imagem para tornar a imagem clicável: escolha URL ou Deep link e preencha o destino, com as mesmas regras de um botão. Remover a imagem remove também a ação ao tocar.

5. Opcionalmente, adicione até 2 Botões. Cada um tem um Rótulo (até 30 caracteres) e uma ação: URL (um endereço https://), Deep link (um link do app como myapp://screen; http:// puro não é permitido) ou Pedido de permissão de push. O primeiro botão é a ação principal.

   Pedido de permissão de push pede ao usuário que permita notificações e não precisa de destino. Um usuário que ainda não decidiu vê o prompt do sistema; um usuário que negou é enviado às configurações de notificação do app. A mensagem não é exibida em dispositivos que já recebem push, nem em dispositivos com uma versão do SDK que ainda não suporta a ação, então ela pode alcançar menos dispositivos do que o público que você escolher. O editor mostra a versão mínima do SDK quando o primeiro release com suporte for lançado. A ação ao tocar na imagem não oferece essa opção.

6. Opcionalmente, ajuste o Estilo e o Comportamento (abaixo).

7. Escolha o público, o agendamento e a frequência conforme descrito abaixo.

8. Clique em Salvar rascunho. A mensagem é criada como Rascunho e o editor continua aberto nela.

A prévia à direita acompanha suas edições, com uma visão para iOS e outra para Android. Um rascunho pode estar incompleto, mas uma mensagem precisa de um título ou de um corpo para poder ser ativada.

Estilizar a mensagem

O Estilo é opcional. Um campo deixado vazio mantém o visual padrão do SDK.

• Cor de fundo, Cor do texto, Cor do botão e Cor do texto do botão: digite um valor hex como #102030 ou escolha pelo seletor de cor. Apenas valores hex de seis dígitos são aceitos, sem transparência.
• Alinhamento do texto: Esquerda, Centro ou Direita.
• Margem ao redor da mensagem: vale para Topo, Base e Tela cheia. O Centro sempre mantém espaço ao redor do cartão.
• Restaurar estilo limpa todos os campos.

Quando o contraste entre a cor do texto e o fundo, ou entre o texto do botão e o botão, é menor que 4,5:1, o editor mostra um aviso com a razão. Ele nunca bloqueia o salvamento: a decisão é sua. A prévia aplica as suas cores, mas a renderização real é feita pelo SDK de cada plataforma.

Escolher quando aparece e por quanto tempo fica

O Comportamento tem duas escolhas:

• Exibir quando: No início da sessão (o padrão) exibe a mensagem quando o app abre uma sessão. Quando o app informar um evento retém a mensagem até que o seu app reporte esse evento com o trackEvent do SDK. Informe o Nome do evento (letras minúsculas, números, pontos, hífens e sublinhados, até 64 caracteres); o campo sugere os nomes já usados pelas mensagens deste App. Os nomes de evento são comparados dentro do app e nunca são enviados ao servidor. Público, agendamento e frequência ainda são decididos pelo servidor.
• Dispensar: Exibir até ser dispensada (o padrão) ou Dispensar após N segundos (1 a 300). Um controle de fechar sempre aparece, então a pessoa ainda pode fechar a mensagem antes do fim do temporizador.

Um SDK exibe uma mensagem por vez, e cada mensagem no máximo uma vez por sessão.

Escolher quem vê

O Público decide quais dispositivos podem ver a mensagem.

• Exibir para: os segmentos que podem ver a mensagem. Um dispositivo a vê se estiver em pelo menos um deles; sem nenhum selecionado, a mensagem é para Todos. Adicione segmentos com Adicionar segmento.
• Não exibir para: segmentos cujos dispositivos nunca veem a mensagem, mesmo que também estejam em Exibir para. Um segmento não pode estar nas duas listas, e cada lista comporta até 10.
• São os mesmos segmentos que você usa nas notificações push. Crie e edite-os em Segmentos (Gerenciar segmentos abre a tela). Um segmento que foi excluído aparece como "Segmento indisponível"; remova-o da lista.
• Plataformas: iOS e Android. Com as duas selecionadas, a mensagem é exibida em todas as plataformas. Ao menos uma fica selecionada.

Abaixo das opções, o editor mostra "Cerca de N dispositivos": uma estimativa dos dispositivos que o público alcança. Ela conta todos os dispositivos correspondentes, tenham ou não permitido notificações push, porque as mensagens in-app não dependem da permissão de push. Se nenhum dispositivo corresponder ainda, o editor avisa, mas você ainda pode salvar e ativar. Ninguém vê a mensagem até que um dispositivo corresponda.

Agendar

O Agendamento é opcional. Os dois campos usam o fuso do App, que aparece abaixo do título da seção e é definido nas configurações de análises do App.

• Início: quando a mensagem começa a ser exibida. Vazio significa "Começa assim que for ativada".
• Fim: quando ela para. Vazio significa "Fica no ar até ser pausada".

Limpar esvazia um campo. O fim deve ser depois do início.

Controlar a frequência com que aparece

A Frequência é com que frequência um mesmo dispositivo pode ver a mensagem. Ela conta as impressões que o dispositivo reportou para esta mensagem.

Modo	O que faz
Uma vez	Exibida uma vez por dispositivo.
N vezes	Exibida até o número definido em Exibições por dispositivo.
Intervalo	Exibida de novo somente após pelo menos o tempo definido em Esperar pelo menos, em minutos, horas ou dias.

Ativar, pausar e encerrar

Salvar um rascunho não o exibe a ninguém. Uma mensagem só chega aos dispositivos enquanto está ativa.

Status	Significado
Rascunho	Salva, mas nunca ativada. Não é exibida.
Ativa	Ativada e dentro da janela de agendamento. Exibida aos dispositivos correspondentes.
Agendada	Ativada, mas a data de Início ainda não chegou. Exibida quando chegar.
Pausada	Parada por você. Não é exibida.
Concluída	Ativada, mas a data de Fim já passou. Não é exibida.

As mensagens ativadas passam entre Agendada, Ativa e Concluída sozinhas conforme as datas de Início e Fim (no fuso do App) passam. Pausar é a única parada manual.

O que fazem os botões do cabeçalho:

• Salvar rascunho (mensagem nova) cria o rascunho. Salvar (mensagem existente) grava as suas edições e fica desativado até algo mudar. Editar uma mensagem ativa afeta o que os dispositivos buscam a partir daquele momento; os eventos já registrados permanecem com a mensagem.
• Ativar (em um Rascunho) e Retomar (em uma mensagem Pausada) colocam a mensagem no ar. Ficam desativados com um motivo quando há alterações não salvas ("Salve suas alterações primeiro") ou quando o App está no limite do plano ("Limite do plano atingido").
• Pausar (em uma mensagem Ativa ou Agendada) a interrompe. As métricas são mantidas.
• Uma mensagem Concluída não tem Ativar, Retomar nem Pausar. Para exibi-la de novo, altere o Fim para uma data posterior (ou limpe-o) e salve.
• Mais ações > Excluir abre uma confirmação. Excluir mensagem a remove da lista e deixa de exibi-la. Não é possível desfazer.

As alterações chegam aos dispositivos na próxima busca, o que pode levar até cerca de um minuto após a mudança. A página do contrato tem as regras exatas.

Limites do plano

O plano limita quantas mensagens podem estar ativas ao mesmo tempo em cada App: 2 no Free, 5 no Start, 8 no Pro e 20 no Business (veja Uso e cobrança).

• Mensagens Rascunho, Pausada e Concluída não contam.
• Mensagens Agendada contam, mesmo antes da data de início.
• Reativar uma mensagem Concluída alterando a data de fim também conta, então esse salvamento é bloqueado enquanto o App estiver no limite.

Quando o App está no limite, a lista mostra um aviso, por exemplo "Seu plano permite 2 mensagens in-app ativas e todas estão em uso.". O proprietário da conta recebe um botão Fazer upgrade que abre a tela Uso; os demais perfis são orientados a pedir ao proprietário da conta. O mesmo aviso aparece no editor quando uma ativação é bloqueada. Para liberar uma vaga, pause ou exclua uma mensagem ativa.

Um downgrade de plano não é bloqueado por mensagens ativas. Quando o novo plano entra em vigor, um App com mais mensagens ativas do que o plano permite tem as excedentes pausadas automaticamente. As mensagens mais antigas (por data de criação) continuam ativas. A pausa pode levar alguns minutos para ser aplicada. Para escolher quais continuam ativas, pause ou exclua mensagens você mesmo antes de a mudança entrar em vigor. As mensagens pausadas mantêm seu conteúdo e suas métricas e podem ser reativadas enquanto o App estiver abaixo do limite. Veja Uso e cobrança para saber como funcionam as mudanças de plano.

A lista de mensagens

A lista mostra as mensagens do App da mais recente para a mais antiga, com estas colunas: Nome, Status, Criada em, Impressões e CTR. O CTR mostra N/A até a mensagem ser vista.

• Filtre por Todas, Ativas, Pausadas, Agendadas, Concluídas ou Rascunhos, e busque por nome.
• Um tile mostra "N de M ativas": as mensagens ativas do App em relação ao limite do plano.
• Clique em uma linha para abrir a mensagem.

Ler as métricas

Abra uma mensagem salva e escolha a aba Métricas (Editar volta ao formulário). O seletor de período define o intervalo (últimos 7, 14, 30 ou 90 dias, ou um intervalo personalizado), e os dias seguem o fuso do App, que aparece ao lado das datas. O i ao lado de uma métrica mostra a definição dela.

As métricas vêm de eventos que os dispositivos reportam. Uma mensagem precisa ser exibida por um SDK que implemente o contrato de In-App, e os números podem ficar atrás do que as pessoas fizeram quando um dispositivo está offline, porque os eventos dele chegam quando ele reconecta. Para saber como cada métrica é calculada a partir dos eventos, veja O que as métricas significam.

Métrica	Definição
Impressões	Número de vezes que a mensagem foi exibida. Um dispositivo que a vê duas vezes conta duas vezes.
Alcance	Dispositivos distintos que viram a mensagem pelo menos uma vez.
Taxa de alcance	Alcance dividido pelos dispositivos elegíveis agora. Os dispositivos elegíveis são uma estimativa de um momento.
CTR	Dispositivos distintos que clicaram em um botão, divididos pelo alcance.
Taxa de dispensa	Dispositivos distintos que fecharam a mensagem por conta própria (botão de fechar, deslize ou toque fora) sem clicar, divididos pelo alcance. Uma mensagem fechada pelo temporizador não entra aqui.
Dispensadas automaticamente	Dispositivos distintos que só viram a mensagem fechar pelo temporizador, sem fechamento manual e sem clique. Uma contagem, não uma taxa.
Média de impressões por dispositivo	Impressões divididas pelo alcance.
Elegíveis agora	Dispositivos que correspondem ao público hoje. Uma estimativa de um momento, não uma contagem do período.

Uma taxa mostra um traço quando o denominador é zero, por exemplo o CTR antes de alguém ter visto a mensagem.

Abaixo dos tiles:

• Impressões e cliques por dia: um gráfico diário do período. Cliques é o número de cliques em botões, e um dispositivo que clica duas vezes conta duas vezes.
• Cliques por botão: para cada botão, Cliques e Clicantes únicos (dispositivos distintos que clicaram pelo menos uma vez). Quando a mensagem tem uma ação ao tocar na imagem, uma linha Imagem vem primeiro, com os toques na imagem. Uma mensagem sem botões nem ação na imagem não tem cliques em botões para reportar.
• Plataforma, Versão do app e País: os dispositivos distintos que viram a mensagem, agrupados. Grupos menores são reunidos em Outros, e dispositivos sem valor aparecem como Desconhecido.

Como o alcance cobre todo o período enquanto Elegíveis agora é um instantâneo, o alcance pode ser maior que a contagem de elegíveis, e a taxa de alcance reflete o público de hoje, não o público da época.

Quando um período ainda não tem impressões, a aba informa isso; tente um período maior quando os dispositivos já tiverem visto a mensagem.