Ir para o conteúdo

Perguntas frequentes

Este artigo fornece respostas para algumas perguntas frequentes sobre mensagens no app.

O que é uma mensagem no navegador e qual é a diferença em relação a uma mensagem no app?

Mensagens no navegador são mensagens no app enviadas para navegadores web. Para criar uma mensagem no navegador, selecione Navegador web no campo Enviar para ao criar sua Campaign de mensagem no app ou seu Canvas.

Uma mensagem no app é exibida se o dispositivo estiver off-line?

Depende. As mensagens no app são entregues no início da sessão. Se o dispositivo conseguir baixar a carga útil antes de ficar off-line, a mensagem no app ainda pode ser exibida sem conexão. Se a carga útil não for baixada, a mensagem no app não é exibida.

Se um usuário já tem a carga útil de uma mensagem no app no dispositivo e a expiração da mensagem é alterada, a expiração é atualizada no dispositivo?

Quando um usuário inicia uma sessão, a Braze verifica se houve alterações em alguma mensagem no app para a qual ele é elegível e faz as atualizações necessárias. Então, se a expiração mudou e o usuário registra uma sessão, a mensagem no app é enviada ao dispositivo com as informações atualizadas.

Como configurar o horário de silêncio para uma Campaign de mensagem no app?

O recurso de horário de silêncio não está disponível para Campaigns de mensagem no app. Esse recurso impede que mensagens sejam enviadas aos seus usuários em horários específicos. Nas Campaigns de mensagem no app, os usuários só recebem mensagens no app se estiverem ativos no app.

Como alternativa para enviar mensagens no app em um horário específico, use o exemplo de código Liquid abaixo. Com ele, a mensagem é interrompida se a mensagem no app for exibida depois das 19h59 ou antes das 8h no fuso horário especificado.

{% assign time = 'now' | time_zone: ${time_zone} %}{% assign hour = time | date: '%H' | plus: 0 %}
{% if hour > 19 or hour < 8 %}
{% abort_message("Outside allowed time window") %}
{% endif %}
MESSAGE HERE

Os usuários podem receber uma mensagem no app novamente depois de dispensá-la?

Campaigns

Nas Campaigns de mensagem no app, você pode permitir que os usuários voltem a ser elegíveis para receber a Campaign. Para isso, ative a reelegibilidade em Controles de entrega (Permitir que os usuários se tornem novamente elegíveis para receber a campanha). O prazo para receber a mensagem de novo depende da janela de reelegibilidade que você definir e de como a Braze registrou o envio anterior. Consulte Reelegibilidade para Campaigns e Canvas para entender o comportamento das Campaigns, incluindo a relação entre a reelegibilidade e o recebimento da mensagem.

Se a reelegibilidade estiver desativada, os usuários geralmente não recebem essa mesma Campaign de novo depois de recebê-la, mesmo que continuem atendendo aos critérios de qualificação.

Canvas

Nas mensagens no app enviadas por um Canvas, a possibilidade de o usuário ver a mensagem novamente depende dos controles de entrada do Canvas (como permitir que os usuários entrem novamente no Canvas) e da configuração das etapas. Os controles de entrega da Campaign não são o único fator.

Quando a elegibilidade para uma mensagem no app é calculada?

Campaigns

Nas Campaigns de mensagens no app, a Braze verifica se o usuário está no seu público-alvo quando o dispositivo dele baixa as mensagens no app. Isso costuma acontecer no início da sessão. O dispositivo armazena as mensagens elegíveis e exibe cada uma quando o gatilho correspondente ocorre, mesmo que seja mais tarde na sessão.

Nas Campaigns com horário de início no futuro, a Braze também envia a mensagem para dispositivos que iniciam uma sessão até uma hora antes do horário de início. Assim, a mensagem fica pronta para ser exibida na hora certa. Por exemplo, um usuário que inicia uma sessão às 6h30 recebe uma Campaign que começa às 7h. A Braze verifica a elegibilidade dele às 6h30, e a mensagem aparece quando o gatilho ocorre depois das 7h.

Elegibilidade durante uma sessão

Usuários que se tornam elegíveis durante uma sessão recebem a mensagem no início da próxima sessão.

Para verificar a elegibilidade de novo logo antes de a mensagem ser exibida, selecione Reavaliar a elegibilidade da campanha antes de exibir. Se o usuário não se qualificar mais, a mensagem não é exibida. Essa configuração não envia a mensagem para usuários que se tornaram elegíveis depois do início da sessão. Para saber mais, consulte Escolher os usuários para direcionamento.

Canvas

Nas mensagens no app em um Canvas, a Braze verifica o público da etapa quando o usuário chega a ela. Em seguida, a mensagem é baixada no início da próxima sessão do usuário.

Por que minha Campaign arquivada de mensagem no app ainda está gerando impressões de mensagens no app?

Isso pode acontecer com usuários que atendiam aos critérios do Segment enquanto a Campaign de mensagem no app estava ativa.

Para evitar isso, selecione Reavaliar a elegibilidade da campanha antes da exibição ao configurar sua Campaign.

Por que não vejo aberturas nas mensagens no app?

As mensagens no app não usam a métrica Aberturas. A Braze registra Impressões quando a mensagem fica visível na tela e Cliques quando os usuários interagem com o corpo da mensagem ou com os botões. Se uma exportação ou um relatório multicanal incluir linhas de mensagens no app, compare Impressões e Cliques em vez das aberturas típicas de e-mail. Para ver as definições, consulte Relatórios de mensagens no app.

É possível exibir várias mensagens no app na mesma sessão?

Sim, mas apenas uma mensagem no app pode ser exibida a cada ocorrência de um evento-gatilho. Se várias Campaigns de mensagem no app compartilharem o mesmo gatilho (por exemplo, início de sessão), apenas a mensagem de maior prioridade será exibida cada vez que esse gatilho ocorrer. Com gatilhos de início de sessão, isso significa que só uma mensagem pode ser exibida por sessão. A próxima oportunidade de mostrar outra mensagem elegível é a sessão seguinte.

Quando várias mensagens têm o mesmo nível de prioridade, a mensagem criada mais recentemente é exibida primeiro. Com gatilhos de início de sessão, a próxima mensagem mais recente aparece em uma sessão posterior. Já com outros tipos de gatilho, a próxima mensagem mais recente aparece na próxima vez que o evento-gatilho ocorrer, o que pode acontecer na mesma sessão ou em uma sessão posterior.

Para controlar a ordem de exibição dentro de um mesmo nível de prioridade, acesse as configurações de entrega de qualquer uma das Campaigns e selecione Definir prioridade exata. Depois, arraste e solte as Campaigns na ordem desejada. Para saber mais, consulte Escolher uma prioridade.

Como as impressões e os cliques de mensagens no app são registrados?

Consulte Relatórios de mensagens no app para ver como as impressões e os cliques são registrados de acordo com a ação do usuário. Para exemplos específicos de mensagens em tela inteira criadas com o editor tradicional, consulte Métricas de mensagens em tela inteira por ação do usuário.

Como a Braze calcula a expiração de uma mensagem no app definida como “após 1 dia(s)”?

A Braze calcula uma expiração de um dia como 24 horas depois que os usuários se tornam elegíveis para receber uma mensagem.

O que são mensagens no app modeladas?

As mensagens no app são entregues como mensagens no app modeladas quando a opção Reavaliar a elegibilidade da campanha antes da exibição está selecionada. Isso também acontece quando a mensagem contém qualquer uma das seguintes Liquid tags:

  • canvas_entry_properties
  • connected_content
  • Variáveis de SMS, como {sms.${*}}
  • catalog_items
  • catalog_selection_items
  • event_properties

A Braze também usa a entrega modelada para Campaigns de mensagens no app sem atividades. São Campaigns que continuam ativas, mas que já não enviam mensagens ou não são mais necessárias. Essas Campaigns continuam seguindo as regras de público e de gatilho configuradas.

A Braze também pode usar a entrega modelada para proteger a performance do app. Se a preparação do conteúdo Liquid atrasar a resposta de uma sessão em mais de alguns segundos, a Braze adia o restante do processamento. Essas mensagens são renderizadas quando forem disparadas.

Isso significa que, no início da sessão, o dispositivo recebe o gatilho da mensagem no app, e não a mensagem completa. Quando o usuário dispara a mensagem no app, o dispositivo dele faz uma solicitação de rede para buscar a mensagem real.

Para reduzir a quantidade de Liquid que a Braze processa no início da sessão, consulte Otimizar a performance das mensagens no app.

Como funciona a interrupção nas mensagens no app?

Na Braze, uma interrupção acontece quando um usuário realiza uma ação que o torna elegível para receber uma mensagem, mas ele não a recebe porque a lógica Liquid da mensagem o marca como inelegível. Por exemplo:

  1. Sam realiza uma ação que deveria disparar uma Campaign de e-mail.
  2. O corpo do e-mail contém uma lógica Liquid que diz: se o atributo personalizado de pontuação for menor que 50, não envie este e-mail.
  3. A pontuação de Sam no atributo personalizado é 20.
  4. A Braze reconhece que Sam não deve receber esse e-mail, e o e-mail é interrompido.
  5. Um evento de interrupção é registrado.

No entanto, como as mensagens no app são um canal do tipo pull, as interrupções funcionam de um jeito um pouco diferente para elas.

Comportamento de interrupção padrão das mensagens no app

As mensagens no app são baixadas pelo dispositivo no início da sessão e armazenadas em cache no próprio dispositivo. Assim, independentemente da qualidade da conexão com a internet, a mensagem pode ser entregue instantaneamente ao usuário. Por exemplo, se um usuário recebe cinco mensagens no app durante a sessão, ele recebe as cinco no início da sessão. As mensagens ficam em cache localmente e aparecem quando os eventos-gatilho definidos acontecem (início da sessão, clique do usuário em um botão que registra um evento personalizado, entre outros).

Em outras palavras, a lógica que determina se uma mensagem no app deve ser interrompida é executada antes de o gatilho acontecer. Para demonstrar isso, vamos supor que Sam, do exemplo do e-mail, está inscrito para receber notificações por push.

  1. Sam inicia uma sessão ao abrir um app com tecnologia da Braze no celular.
  2. Com base nos critérios de público das Campaigns ativas no espaço de trabalho, Sam pode ser elegível para cinco Campaigns diferentes. As cinco são baixadas para o celular e armazenadas em cache.
  3. Sam não realizou nenhuma ação que dispararia essas mensagens, mas pode recebê-las durante a sessão.
  4. O Liquid de duas das mensagens no app tem regras que impedem Sam de receber a mensagem (por exemplo, o atributo personalizado de pontuação não é alto o suficiente).
  5. Sam não recebe as duas mensagens no app que o excluem, mas recebe as outras três.
  6. Nenhum evento de interrupção é registrado.

A Braze não registra nenhum evento de interrupção no caso de Sam porque essa situação não se encaixa na definição de interrupção: Sam não realizou nenhuma ação que dispararia as mensagens. Nas mensagens no app, os usuários nunca chegam a realizar o gatilho antes de a Braze determinar que eles não devem ver a mensagem.

Comportamento de interrupção das mensagens no app com modelo

As mensagens no app com modelo obrigam o SDK a reavaliar se uma mensagem deve ser exibida quando o evento-gatilho acontece. Nesse caso, a interrupção funciona de outro jeito. Para demonstrar, veja este exemplo:

  1. Sam inicia uma sessão da Braze ao abrir um app com tecnologia da Braze no celular.
  2. Os critérios de público das Campaigns ativas indicam que Sam pode ser elegível para uma mensagem no app com modelo. Então, as informações do gatilho são enviadas ao dispositivo sem a carga útil da mensagem.
  3. Sam seleciona um botão que registra um evento personalizado, disparando a mensagem no app com modelo.
  4. O dispositivo de Sam faz uma solicitação de rede para buscar a mensagem no app.
  5. A lógica Liquid da mensagem leva a uma interrupção, e a Braze registra isso como uma interrupção, já que Sam realizou a ação-gatilho antes dessa avaliação.

Comparação do comportamento de interrupção das mensagens no app

Esta tabela compara os fluxos de mensagens no app que Sam vivenciou:

Mensagem no app Comportamento de interrupção
Padrão Nenhum evento de interrupção foi registrado porque Sam não realizou nenhuma ação que dispararia uma mensagem.

As mensagens no app padrão não registram interrupções porque a definição de interrupção é “não viu a mensagem apesar de ter realizado a ação-gatilho”. Como as mensagens no app são entregues ao dispositivo antes de as ações-gatilho acontecerem, não faz sentido considerar como interrompidas as mensagens no app omitidas por causa da lógica Liquid.
Com modelo Um evento de interrupção foi registrado porque Sam realizou a ação-gatilho que dispara a mensagem no app com modelo, mas recebeu uma interrupção no modelo Liquid.

As mensagens no app com modelo registram interrupções porque a avaliação do Liquid acontece depois que a ação-gatilho é realizada.

Quando o Connected Content é executado nas mensagens no app?

Nas mensagens no app com modelo, o Connected Content e outras Liquid tags são resolvidos quando o evento-gatilho acontece e o dispositivo solicita a carga útil da mensagem, e não quando o usuário clica em um botão dentro da mensagem. Cada busca com modelo pode incluir chamadas de Connected Content para aquela exibição.

Se o seu HTML faz referência a dados REST retornados pelo Connected Content, esses dados ficam disponíveis durante a sessão em que a mensagem foi gerada pelo modelo. Vários botões podem fazer referência à mesma resposta do Connected Content sem disparar chamadas adicionais ao clicar.

Qual é a postergação máxima após um gatilho em Campaigns de mensagens no app?

As Campaigns de mensagens no app podem postergar a entrega em até duas horas (7.200 segundos) após o evento-gatilho. As opções de postergação são Imediatamente e Após uma postergação. Para uma espera maior, adicione uma etapa de Postergação antes de uma etapa de mensagem no app em um Canvas. Para configurar a postergação, consulte Entrega baseada em ação.

Por que há uma postergação antes de a minha mensagem no app ser exibida?

As mensagens no app padrão são exibidas assim que a carga útil em cache fica pronta após o evento-gatilho. No Android e no iOS, imagens grandes ou outros ativos hospedados na CDN referenciados na mensagem podem causar uma pequena postergação enquanto esses recursos terminam de ser baixados, antes de a mensagem no app aparecer.

As mensagens no app com modelo e as Campaigns com a opção Reavaliar a elegibilidade da campanha antes da exibição selecionada exigem uma solicitação de rede adicional após o gatilho, antes de a mensagem aparecer. Isso pode causar uma pequena postergação (normalmente menos de 100 ms em uma conexão estável). Para saber mais, consulte Escolher os usuários a serem direcionados.

Por que minha mensagem no app parece diferente da prévia no dashboard?

As mensagens no app entregues podem ser diferentes da prévia no dashboard quando:

  • Sua integração aplica estilos personalizados ou substitui a interface padrão das mensagens no app em determinadas plataformas
  • A prévia usa um perfil de usuário teste com atributos diferentes dos do destinatário
  • O conteúdo com modelo é resolvido de forma diferente no momento do envio e no modo de prévia

Ao validar a aparência, use Enviar mensagens de teste com um usuário teste cujo perfil corresponda ao seu público-alvo.

Por que uma mensagem no app de várias páginas usa o mesmo fundo em todas as páginas?

Quando a opção Imagem de fundo está ativada em uma página de uma mensagem no app de várias páginas, esse fundo é aplicado a todas as páginas da mensagem. Para usar fundos diferentes em cada página, use um bloco de HTML personalizado com JavaScript para trocar as imagens entre as páginas.

Como faço para testar mensagens no app para web?

Os envios de teste de mensagens no app para web exigem que o push esteja ativado no dispositivo de teste, porque o fluxo de teste entrega uma notificação por push que abre o app ou o site onde a mensagem no app é exibida. Esse mesmo caminho de teste baseado em push vale para qualquer plataforma em que o push não esteja configurado com a Braze. Mesmo assim, a falta de push é mais comum na web, porque muitas integrações mobile já têm o push ativado. Nesse caso, use uma campanha ativa para um Segment de teste interno. Para ver as etapas, consulte Enviar mensagens de teste.

As mensagens no app exigem integração de push?

As mensagens no app não precisam de notificações por push para funcionar em produção. Elas são entregues pelo SDK da Braze e aparecem durante uma sessão ativa no app, sem necessidade de integração de push.

No entanto, os envios de teste de mensagens no app exigem que o push esteja ativado nos seus dispositivos de teste. Isso acontece porque as mensagens no app de teste são entregues por meio de uma notificação por push que dispara a exibição da mensagem no app. O usuário teste precisa ter o push ativado e tocar na notificação por push de teste para ver a mensagem no app.

Nas Campaigns em produção, os usuários veem as mensagens no app com base nos gatilhos da sua Campaign (como início de sessão ou eventos personalizados), sem envolvimento do push.

Por que aparecem caracteres extras ou não renderizados na minha mensagem no app?

Copiar texto de outro app (como um processador de texto ou uma página da web) pode inserir caracteres invisíveis ou não imprimíveis no corpo da mensagem. Esses caracteres podem aparecer como símbolos soltos ou quebrar o Liquid e o HTML em mensagens personalizadas.

Para corrigir caracteres soltos ou não renderizados, digite novamente o texto afetado no editor da Braze ou exclua diretamente os caracteres indesejados, em vez de selecionar e substituir apenas o texto visível. Em mensagens HTML personalizadas com caracteres especiais, adicione <meta charset="UTF-8"> dentro da tag <head> do seu HTML. Para saber mais, consulte Codificação de caracteres.

Por que o botão de fechar fica oculto em mensagens no app HTML de tela inteira no Android?

Em dispositivos com telas de ponta a ponta (incluindo Android 15+), as mensagens no app HTML de tela inteira podem ser desenhadas atrás da barra de status do sistema. Com isso, um controle de fechar no topo do layout pode ficar escondido.

A partir da versão 37.0.0, o SDK da Braze para Android aplica os window insets às mensagens no app HTML por padrão, para que os controles fiquem na área segura. Se os usuários ainda virem sobreposição, faça upgrade para a versão mais recente do SDK da Braze para Android.

Em versões mais antigas do SDK, os desenvolvedores podiam ativar BrazeConfig.setIsHtmlInAppMessageApplyWindowInsetsEnabled(true) antes de esse comportamento se tornar o padrão.

O que devo saber ao personalizar mensagens no app de arrastar e soltar?

O editor de arrastar e soltar é compatível com os tipos de exibição modal e tela inteira. Você monta o conteúdo dentro desses contêineres usando os blocos do editor.

Lembre-se do seguinte:

  • Pares de chave-valor: Adicione pares de chave-valor na guia Configurações para enviar dados personalizados aos dispositivos dos usuários junto com a mensagem. Para saber mais, consulte Adicionar pares de chave-valor (arrastar e soltar) ou Pares de chave-valor (tradicional).
  • Links e deep links: Cada ação ao clicar tem um único campo de URL por padrão. Use Liquid na URL para variar os links por dispositivo, tipo de app ou atributos do usuário. No Contêiner de mensagens, você também pode ativar o comportamento ao clicar específico por plataforma para definir links diferentes para cada plataforma.
  • Opacidade e fundos: A opacidade do contêiner de mensagens afeta o fundo da mensagem inteira. Cada bloco pode ter a própria cor de fundo. Para ter um controle mais preciso, adicione CSS personalizado em um bloco de código personalizado.
  • Largura da mensagem: No editor, a largura máxima do Contêiner de mensagens não pode ser menor que 325 px. Isso mantém o conteúdo legível em telas menores. Se precisar de um layout mais estreito, use CSS personalizado.
  • Fundos específicos por plataforma: Uma mesma mensagem usa a mesma imagem e as mesmas cores de fundo na web e no celular. Não é possível definir fundos diferentes para cada plataforma no editor.
  • Mensagens com várias páginas: As imagens de fundo e as ações ao clicar no nível da mensagem se aplicam a todas as páginas de uma mensagem com várias páginas. Para usar imagens inteiras diferentes em cada página, adicione botões que levem à próxima página.
  • Estilos no nível da mensagem: Os estilos no nível da mensagem se aplicam à mensagem inteira.
  • Imagens de fundo: As imagens de fundo são esticadas para preencher o modal.

Para ver mais considerações sobre o editor, consulte o Guia de preparação de mensagens no app.

O que significa “Event was published, but no subscribers were found” nos logs do Android SDK?

Essa linha de log normalmente não indica um erro. Ela costuma aparecer quando a Braze publica um evento interno (como NoMatchingTriggerEvent) e nenhum listener de mensagem no app ou de Content Card está inscrito naquele momento.

Você esperava que um evento personalizado disparasse uma mensagem no app e viu esse log? Então, confirme três pontos. Primeiro, verifique se o evento foi registrado. Depois, confira se o usuário faz parte do público da Campaign ou do Canvas. Por fim, se a mensagem depender de Content Cards, confirme se eles estão sincronizados.

New Stuff!