Perguntas frequentes

Este artigo fornece respostas para algumas perguntas frequentes sobre o Canvas.

Criação e edição de Canvas

Quantas etapas posso incluir em um Canvas?

Você pode adicionar até 200 etapas em um Canvas.

Existem limites de tamanho para as propriedades de entrada do Canvas?

Sim. O objeto de contexto do Canvas (propriedades de entrada do Canvas) tem um tamanho máximo de 50 KB. Mantenha as cargas úteis o menor possível dentro desse limite. Para entender como as propriedades de entrada e de evento funcionam no Canvas, consulte Propriedades de contexto e evento.

Por que vejo o erro “Too many Canvas branches”?

Esse erro aparece quando a combinação de ramificações de etapas e tamanho do público de entrada pode causar problemas de desempenho no cluster, impedindo o envio de mensagens. Para etapas de resolução — incluindo o uso de jornadas do público, redução de ramificações ou do tamanho do público, e reconstrução no Canvas Flow — consulte Erro “Too many Canvas branches”.

Posso usar a seleção inteligente com reelegibilidade em um Canvas?

Sim. Os Canvas podem usar a seleção inteligente quando a reelegibilidade está ativada, enquanto as Campaigns exigem uma janela de reelegibilidade de 24 horas ou mais quando a seleção inteligente está ativa. A Braze não pode garantir a mesma variante na reentrada, pois a alocação muda ao longo do tempo.

Qual é a diferença entre um componente e uma etapa?

Um componente é uma parte individual do seu Canvas que você pode usar para determinar a eficácia dele. Os componentes podem incluir ações como dividir a jornada do usuário, adicionar uma postergação e até testar múltiplas jornadas do Canvas. Uma etapa no Canvas se refere à jornada personalizada do usuário nas ramificações do seu Canvas. Essencialmente, o Canvas é composto por componentes individuais que criam etapas para a jornada do usuário.

Posso lançar um Canvas com etapas desconectadas?

Sim. Você também pode salvar Canvas após o lançamento com etapas desconectadas.

Para onde os usuários vão quando atingem uma etapa desconectada?

Se um usuário estiver em uma etapa desconectada do fluxo do Canvas, ele avançará para a etapa subsequente, se houver uma, e a configuração da etapa determinará como o usuário deve avançar. Isso é intencional para permitir que os usuários façam alterações nas etapas sem precisar conectá-las diretamente ao restante do Canvas. Isso também oferece espaço para testes antes de publicar imediatamente, permitindo efetivamente salvar um rascunho.

Recomendamos verificar a visualização de análise de dados para identificar usuários pendentes em uma etapa do Canvas antes de desconectar uma etapa.

O que acontece se o público e o horário de envio forem idênticos para um Canvas que tem uma variante, mas múltiplas ramificações?

Enfileiramos um job para cada etapa — eles são executados aproximadamente ao mesmo tempo, e um deles “vence”. Na prática, isso pode ser distribuído de forma relativamente uniforme, mas provavelmente haverá pelo menos uma leve tendência em favor da etapa que foi criada primeiro.

Além disso, não podemos garantir exatamente como será essa distribuição. Se você quiser uma divisão uniforme, adicione um filtro de número de bucket aleatório.

Como os públicos do Canvas são avaliados?

Por padrão, filtros e Segments para etapas completas no Canvas são verificados no momento do envio. A etapa de divisão de decisão realiza uma avaliação logo após receber uma etapa anterior (ou antes de uma postergação).

Quando um evento de exceção é disparado?

Eventos de exceção só são disparados enquanto o usuário está aguardando o recebimento do componente do Canvas ao qual ele está associado. Se um usuário realizar uma ação antecipadamente, o evento de exceção não será disparado. Se você quiser excluir usuários que já realizaram determinado evento, use filtros.

Como a edição de um Canvas afeta os usuários que já estão nele?

Se você editar algumas etapas de um Canvas de múltiplas etapas, os usuários que já estavam no público, mas não receberam as etapas, receberão a versão atualizada da mensagem. Isso só acontecerá se eles ainda não tiverem sido avaliados para a etapa.

Para saber mais sobre o que você pode editar após o lançamento, consulte Alterando seu Canvas após o lançamento.

O que acontece quando você interrompe um Canvas?

Quando você interrompe um Canvas, o seguinte se aplica:

• Os usuários serão impedidos de entrar no Canvas.
• Nenhuma mensagem adicional será enviada, independentemente de onde o usuário esteja no fluxo.
• Exceção: Canvas com e-mails não serão interrompidos imediatamente. Depois que as solicitações de envio são encaminhadas ao SendGrid, não há nada que possamos fazer para impedir que sejam entregues ao usuário.

Devo criar um único Canvas ou Canvas separados por ciclo de vida do usuário?

Dependendo do que você deseja alcançar com o seu Canvas, pode ser necessário adotar abordagens diferentes na criação da jornada do usuário. A flexibilidade do Canvas permite mapear jornadas de usuários para qualquer estágio do ciclo de vida. Confira nossos modelos de Canvas da Braze para vários exemplos de abordagens simplificadas para criar jornadas de usuário eficazes.

Mensagens e entrega

Quando as mensagens no app em um Canvas são enviadas?

As mensagens no app são enviadas no próximo início de sessão. Isso significa que, se o usuário entrar na etapa do Canvas antes de o Canvas ser interrompido, ele ainda receberá a mensagem no app no próximo início de sessão, desde que a mensagem no app ainda não tenha expirado.

É possível que um usuário inicie uma sessão antes de o Canvas ser interrompido, mas não veja a mensagem no app imediatamente. Isso pode acontecer se a mensagem no app for disparada por um evento personalizado ou estiver com entrega postergada. Isso significa que é possível que um usuário registre uma impressão de mensagem no app e “receba” a mensagem no app após a interrupção do Canvas. No entanto, o usuário teria que ter iniciado a sessão antes de o Canvas ser interrompido, mas depois de ter recebido a etapa do Canvas.

Por que um Canvas pode mostrar zero envios mesmo com impressões registradas?

Se os Envios de mensagens estiverem sempre em zero para um Canvas que contém uma etapa de mensagem no app, isso ocorre porque a entrega de mensagens no app funciona de forma diferente dos outros canais de envio de mensagens.

As mensagens no app são “puxadas” pelo SDK, em vez de serem “empurradas” pela Braze. As mensagens no app para usuários elegíveis são entregues automaticamente no início da sessão e “esperam” pelo evento-gatilho antes de serem exibidas. Como os usuários elegíveis recebem a mensagem ao iniciar uma sessão, a Braze não registra isso como um evento de envio. Quando os usuários realizam o evento-gatilho, a mensagem é exibida e a Braze registra uma impressão e marca a etapa do Canvas (ou Campaign) como recebida no perfil do usuário. Consequentemente, o total de Envios é zero para mensagens no app.

Por que os usuários não receberam minha mensagem no app após uma longa postergação ou ramificação?

Depois que as etapas de Postergação anteriores e as verificações de público são concluídas, os usuários se tornam elegíveis para uma mensagem no app somente quando chegam à etapa de mensagem. Se a mensagem expirar em uma data do calendário ou em uma janela curta de duração após a etapa estar disponível, os usuários em ramificações mais lentas podem chegar após a expiração e nunca ver a mensagem. Alinhe a expiração com as postergações mais longas e realistas do caminho. Para saber mais e ver exemplos, consulte Expiração de mensagens no app.

Por que vejo a mensagem “Canvas Entry Properties may not be used in In-App Messages.”?

Essa mensagem aparece quando a personalização faz referência a campos que as mensagens no app não conseguem resolver no Canvas. Use o objeto context conforme descrito em Propriedades de contexto e evento e Etapa de mensagem. O namespace legado do Liquid canvas_entry_properties tem restrições diferentes do context. Se precisar que valores persistam em várias etapas, consulte propriedades persistentes no editor original do Canvas com sua equipe da Braze. Os valores armazenados são apagados quando um usuário sai do Canvas antes de o dispositivo baixar a carga útil da mensagem no app.

Onde posso encontrar os cliques em botões para mensagens no app de arrastar e soltar no Canvas?

As métricas de nível de botão para mensagens no app de arrastar e soltar aparecem no cartão de análise de dados da etapa Mensagem em Detalhes do Canvas, e não apenas no resumo de alto nível do Canvas. Abra o Canvas, selecione a etapa de mensagem e analise o engajamento da mensagem no app ali. Para conceitos de relatórios, consulte Medindo e testando com análise de dados do Canvas.

Posso agendar horários de envio diferentes para cada variante na mesma etapa de mensagem do Canvas ou em um envio multivariante?

Não. As variantes na mesma configuração multivariante ou etapa de mensagem compartilham um único cronograma de entrega. Não é possível atribuir o envio de uma variante às 18h e outra às 19h para o mesmo envio agendado.

Para escalonar envios ou usar horários diferentes por jornada, tente os seguintes métodos:

• Separar as etapas de mensagem com etapas de postergação entre elas, de modo que cada mensagem tenha seu próprio cronograma.
• Usar ramificações ou uma etapa de jornada experimental para que os usuários sigam jornadas com horários diferentes.
• Criar Campaigns separadas se o caso de uso não precisar permanecer dentro de um único Canvas.

Para conceitos de testes multivariantes e A/B em Campaigns, consulte Testes multivariantes e A/B.

O que acontece se um usuário atingir o limite de frequência global em uma etapa de mensagem do Canvas?

Ele não recebe o envio para o canal limitado, mas as etapas de mensagem ainda avançam os usuários quando uma mensagem não é enviada por causa do limite de frequência global. Para os casos de avanço passo a passo, consulte Como os usuários avançam. O limite de frequência global por si só não faz os usuários saírem de um Canvas; esse comportamento é separado das Validações de entrega em uma etapa de mensagem. Para saber mais, consulte Limite de frequência.

Por que os envios são menores do que o tamanho estimado do público?

Os envios podem ser menores do que o Público estimado por muitas das mesmas razões que ocorrem nas Campaigns, incluindo limites de frequência, filtros rigorosos de dispositivo ou navegador, janelas de reelegibilidade, limite de frequência e exclusões no nível do canal (por exemplo, verificações de alcançabilidade de push ou de inscrição e entregabilidade de e-mail).

Fatores específicos do Canvas também se aplicam:

• Entrada baseada em ação ou disparada por API: os usuários só entram (e recebem etapas) depois de realizar o comportamento de entrada, então os envios realizados ficam atrás da estimativa inicial até que essas ações ocorram.
• Jornadas de público: os usuários são direcionados para a ramificação de maior prioridade para a qual se qualificam, então ramificações posteriores podem receber menos usuários do que uma contagem simples de Segment sugeriria.
• Verificações de público e horário de envio: as etapas completas reavaliam os filtros no momento do envio, a menos que você configure de outra forma. Usuários que se qualificaram quando o Canvas foi criado podem ser excluídos antes do envio de uma mensagem.
• Grupos de controle: grupos de controle global ou do Canvas retêm uma parcela dos participantes do envio de mensagens.
• Horário de silêncio e postergações: as mensagens podem ser retidas ou reagendadas, deslocando os envios para fora da janela de relatório que você está visualizando.
• Limites máximos de entrada ou público: limites de entrada ou envio interrompem usuários adicionais mesmo quando o Segment subjacente é maior.
• Janela de relatório: o intervalo de análise de dados pode não incluir todos os envios que você está comparando com a estimativa.

Por que o público estimado e a contagem de usuários do Canvas não coincidem?

O Público estimado reflete quem corresponde aos filtros de Segment e de entrada no momento em que a estimativa é executada. Depois desse momento, entradas postergadas ou baseadas em ação, reelegibilidade, disparos por API ou roteamento de ramificações podem aumentar a quantidade de perfis que passam pela jornada em comparação com o snapshot. Usuários também podem ser removidos quando os filtros de horário de envio falham, o que reduz as entradas ou envios realizados. Compare o tempo, os limites e as configurações de avaliação juntamente com Por que os envios são menores do que o tamanho estimado do público?.

Por que os destinatários únicos são maiores do que o número de usuários que direcionei?

Os Destinatários únicos podem ser maiores do que o público esperado porque a Braze rastreia destinatários únicos diários para relatórios de Canvas e Campaign. Isso permite uma atribuição de conversão precisa a cada vez que um usuário recebe uma mensagem na jornada.

Por exemplo, se um usuário recebe uma etapa do Canvas na segunda-feira e novamente na sexta-feira e converte após cada envio, a Braze pode contar duas linhas de destinatários e duas conversões dentro do escopo. Com entradas recorrentes ou reelegibilidade, o mesmo pequeno grupo de perfis pode gerar múltiplos Destinatários únicos ao longo de vários dias.

Por que meu Canvas está apresentando taxas de envio mais baixas?

Se você perceber que seu Canvas agendado diariamente envia para menos usuários ao longo do tempo, verifique o seguinte:

• Verifique se a reelegibilidade está ativada: sem a reelegibilidade, a Braze insere cada usuário no Canvas apenas uma vez. Em Canvas com agendamento diário, apenas os usuários que correspondem ao público e que ainda não entraram no Canvas são elegíveis para cada entrada. À medida que mais usuários entram, cada entrada posterior tem menos usuários elegíveis, e o volume de entradas diminui.
• Verifique se o público tem membros fixos: públicos criados a partir de uma lista fixa de usuários (como uma importação de CSV usada como filtro de Segment) não ganham novos membros automaticamente. Sem novos participantes, o volume de entradas não pode se recuperar à medida que os usuários entram no Canvas.

Para limites de velocidade de entrega e outros fatores que reduzem os envios em uma única ocorrência, consulte Por que os envios são menores do que o tamanho estimado do público?.

Por que um Segment de grupo de controle pequeno mostra mudanças no histórico de membros?

Os gráficos de histórico de membros usam amostras estimadas, então Segments pequenos — incluindo Segments de grupo de controle global — podem apresentar variações diárias mesmo quando o público subjacente é estável. Para entender como as estimativas funcionam e por que os gráficos podem flutuar, consulte Visualizando o tamanho histórico de membros do Segment.

Análise de dados e conversões

Como o dashboard de Conversões atribui conversões do Canvas?

O dashboard de Conversões atribui conversões do Canvas com base no método de atribuição que você selecionar (por exemplo, Upon Receipt, Upon Send, Upon Open ou Upon Click). Para que um usuário apareça no relatório, ele precisa entrar no Canvas ou Campaign, registrar o método de atribuição selecionado e realizar o evento de conversão dentro das configurações do seu relatório.

Para regras de conversão no nível de etapas e variantes na análise de dados do Canvas, consulte Como as conversões de usuários são rastreadas em um Canvas?.

Como as conversões de usuários são rastreadas em um Canvas?

Um usuário só pode converter uma vez por entrada no Canvas. As conversões são atribuídas à mensagem mais recente recebida pelo usuário naquela entrada. O bloco de resumo no início de um Canvas reflete todas as conversões realizadas pelos usuários naquela jornada, independentemente de terem recebido uma mensagem. Cada etapa subsequente mostrará apenas as conversões que ocorreram enquanto aquela era a etapa mais recente recebida pelo usuário.

Expandir para ver exemplos

Exemplo 1

Existe uma jornada no Canvas com 10 notificações por push e o evento de conversão é “início de sessão” (“abre o app”):

• O usuário A abre o app após entrar, mas antes de receber a primeira mensagem.
• O usuário B abre o app após cada notificação por push.

Resultado: O resumo mostrará duas conversões, enquanto as etapas individuais mostrarão uma conversão na primeira etapa e zero em todas as etapas subsequentes.

Nota

Se o horário de silêncio estiver ativo quando o evento de conversão ocorrer, as mesmas regras se aplicam.

Exemplo 2

Existe um Canvas de uma única etapa com horário de silêncio ativado:

1. O usuário entra no Canvas.
2. A primeira etapa não tem postergação, mas está dentro do horário de silêncio configurado, então a mensagem é suprimida.
3. O usuário realiza o evento de conversão.

Resultado: O usuário será contado como convertido na variante geral do Canvas, mas não na etapa, já que não recebeu a etapa.

Qual é a diferença entre os diferentes tipos de taxa de conversão?

• O total de conversões do Canvas reflete quantos usuários únicos completaram um evento de conversão, não quantas conversões cada um completou.
• A taxa de conversão da variante ou o bloco de resumo no início de um Canvas reflete todas as conversões realizadas pelos usuários naquela jornada, independentemente de terem recebido uma mensagem, como um total agregado.
• A taxa de conversão da etapa reflete quantas pessoas receberam aquela etapa de mensagem e completaram qualquer um dos eventos de conversão definidos.

Por que a taxa de conversão da etapa do meu Canvas não é igual à taxa total de conversão da variante do Canvas?

É comum que o total de conversões de uma variante do Canvas seja maior que a soma do total de suas etapas. Isso ocorre porque um usuário pode realizar um evento de conversão para uma variante assim que entra nela. No entanto, esse mesmo evento de conversão não conta para uma etapa do Canvas. Portanto, qualquer usuário que entra no Canvas e realiza o evento de conversão antes de receber a primeira etapa do Canvas é contado no total de conversão da variante, mas não no total da etapa. O mesmo vale para um usuário que entra no Canvas, mas sai antes de receber qualquer etapa.

Observe que também é possível que um usuário entre em uma variante, não receba nenhuma mensagem de uma etapa e, mesmo assim, converta. Nesse caso, a conversão não é registrada no nível da etapa. No entanto, como o usuário tecnicamente converteu, a conversão é registrada no nível do Canvas.

Como posso confirmar se meus usuários receberam um Canvas disparado por API?

Você pode criar um Segment usando um filtro de Canvas para confirmar se os usuários entraram no Canvas ou receberam uma etapa específica do Canvas. Por exemplo, use um filtro de entrada no Canvas se quiser confirmar que os usuários entraram no Canvas disparado por API, ou um filtro de etapa recebida se quiser confirmar que eles receberam uma mensagem do Canvas. Em seguida, use o endpoint /users/export/segment para exportar os usuários daquele Segment.

Posso excluir um Canvas?

Não, mas você pode arquivar um Canvas.

Como faço para retomar um Canvas ou Campaign arquivado?

Mensagens arquivadas não são enviadas até que você as retorne a um estado editável. Desarquive o Campaign ou Canvas, defina o cronograma de entrada ou horário de envio para uma janela futura (ou duplique a jornada se precisar de uma cópia limpa) e, em seguida, selecione Resume ou lance conforme necessário. Consulte Arquivar Campaigns e Canvas.

Por que meu Canvas não salva quando nenhum erro aparece?

Filtros de Custom attribute vazios no público ou nos filtros no nível da etapa podem bloquear o salvamento sem uma mensagem de validação detalhada. Abra cada cartão de filtro, remova as regras de atributo personalizado incompletas ou insira tanto o nome do atributo quanto o valor. Depois, selecione Save novamente.

Por que uma tag desapareceu do meu Canvas ou Campaign?

Quando uma tag é excluída do seu espaço de trabalho, a Braze a remove de todos os Campaigns e Canvas que a referenciavam. Essa limpeza nem sempre gera sua própria linha no registro de alterações do Canvas.

Como posso ver a análise de dados de cada componente do meu Canvas?

Para ver a análise de dados de um componente do Canvas, acesse seu Canvas e role para baixo na página Canvas Details. Lá, você pode ver a análise de dados de cada componente. Confira Análise de dados do Canvas para mais detalhes.

Quando o engajamento de uma etapa do Canvas fica visível no perfil de usuário?

Filtros como Received Message from Canvas Step são atualizados depois que a Braze registra o evento correspondente de envio, recebimento ou engajamento para aquela etapa. In-App Messages podem registrar impressões separadamente das métricas de envio. Consulte Por que um Canvas pode mostrar zero envios mesmo com impressões registradas?. Esses mesmos eventos aparecem nas métricas da etapa em Canvas Details.

Ao analisar o número de usuários únicos, a análise de dados do Canvas ou o segmentador é mais preciso?

O segmentador oferece uma estatística mais precisa para dados de usuários únicos em comparação com as estatísticas do Canvas ou do Campaign. Isso porque as estatísticas do Canvas e do Campaign são números que a Braze incrementa quando algo acontece — o que significa que existem variáveis que podem fazer com que esse número seja diferente do segmentador. Por exemplo, usuários podem converter mais de uma vez em um Canvas ou Campaign.

Por que o número de usuários entrando em um Canvas não corresponde ao número esperado?

O número de usuários entrando em um Canvas pode diferir do número esperado por conta de como públicos e disparos são avaliados. Na Braze, o público é avaliado antes do disparo (a menos que se use um disparo de mudança de atributo). Isso faz com que usuários saiam do Canvas se não fizerem parte do público selecionado antes que qualquer ação de disparo seja avaliada.

O que acontece com usuários anônimos durante a jornada no Canvas?

Embora usuários anônimos possam entrar e sair de Canvas, suas ações não são associadas a um perfil de usuário específico até que sejam identificados. Portanto, suas interações podem não ser totalmente rastreadas na sua análise de dados. Você pode usar o Query Builder para gerar um relatório dessas métricas.

Posso excluir usuários que estão atualmente em uma jornada do Canvas de um Campaign ou Segment?

Use filtros de segmentação como Entered Canvas Variation, In Canvas Control Group ou Received Message from Canvas Step para direcionar usuários com base na entrada no Canvas, atribuição de variante ou engajamento com a etapa. Esses filtros avaliam o histórico de entrada e as interações — eles não indicam se um usuário ainda está progredindo em uma jornada ativa.

Para incluir ou excluir usuários com base na participação ativa no Canvas, adicione etapas de User Update na entrada e na saída do Canvas para definir e limpar atributos personalizados. Depois, filtre por esses atributos em Campaigns ou Segments.

Segmentação

Qual é a diferença entre “Has not entered Canvas variation” e “Is not in Canvas control group”?

Consulte Filtros de segmentação para ver as definições completas dos filtros.

Has not entered Canvas variation

O usuário nunca entrou em uma jornada de variante de um Canvas específico. Todos os usuários que não estão no grupo de controle são incluídos, independentemente de terem entrado ou não no Canvas. Isso inclui usuários que entraram em outra variante e usuários que não entraram em nenhuma variante.

Is not in Canvas control group

O usuário entrou no Canvas, mas não está no grupo de controle e, consequentemente, recebeu uma variante. Isso inclui apenas os usuários que entraram no Canvas.

A atribuição de variante ocorre na entrada do Canvas. Se um usuário não tiver entrado em um Canvas, nenhuma variante será atribuída a ele. Em outras palavras, ele não estará no grupo de controle nem em uma variante.

Editor original do Canvas

Expandir para ver as perguntas frequentes sobre o editor original do Canvas

Como faço para converter um Canvas existente do editor original para o editor atual?

Você pode clonar seu Canvas. Isso cria uma cópia do seu Canvas original no fluxo de trabalho do Canvas mais recente.

Quais são as principais diferenças entre os editores atual e original do Canvas?

Barra de ferramentas de componentes do Canvas

Anteriormente, com o editor original do Canvas, uma etapa completa era adicionada por padrão sempre que você criava qualquer etapa na jornada do usuário. Essas etapas completas foram substituídas por diferentes componentes do Canvas, o que oferece maior visibilidade e personalização na experiência de edição. Você pode ver imediatamente todos os componentes do Canvas na barra de ferramentas de etapas do Canvas.

Comportamento das etapas

Antes, cada etapa completa incluía informações como configurações de postergação e agendamento, eventos de exceção, filtros de público, configuração de mensagem e opções de avanço de mensagem, tudo em um único componente. No editor atual, essas configurações são separadas para tornar a experiência de criação do Canvas mais personalizável, além de introduzir algumas diferenças de funcionalidade.

Avanço do componente de mensagem

Os componentes de mensagem avançam todos os usuários que entram na etapa. Não é necessário especificar o comportamento de avanço da mensagem, o que torna a configuração geral da etapa mais simples. Se quiser implementar a opção Advance when message sent, adicione um componente separado de jornadas do público para filtrar os usuários que não receberam a etapa anterior.

Comportamento de postergação “em”

Os componentes de postergação aguardam todo o tempo de postergação antes de prosseguir para a próxima etapa.

Digamos que, em 12 de abril, temos um componente de postergação configurado para enviar o usuário à próxima etapa em um dia às 14h. Um usuário entra no componente às 14h01 em 13 de abril.

• No fluxo de trabalho original, o usuário prosseguiria para a próxima etapa às 14h de 14 de abril, o que é menos de um dia desde o horário de entrada.
• No editor atual, o usuário prosseguiria para a próxima etapa às 14h de 15 de abril. Observe que o horário é o mesmo, mas passou mais de um dia desde o horário de entrada.

Comportamento do Intelligent Timing

Como o Intelligent Timing é armazenado no componente de mensagem, as postergações serão aplicadas antes dos cálculos do Intelligent Timing. Isso significa que, dependendo de quando o usuário entrar no componente, ele pode receber a mensagem mais tarde do que receberia em um Canvas criado com o fluxo de trabalho original.

Digamos que sua postergação está configurada para 2 dias, o Intelligent Timing está ativado e determinou que o melhor horário para enviar a mensagem é às 14h. Um usuário entra na etapa de postergação às 14h01.

• Fluxo de trabalho atual: Serão necessárias 48 horas para a postergação passar, então o usuário recebe a mensagem no terceiro dia às 14h.
• Fluxo de trabalho original: O usuário recebe a mensagem no segundo dia às 14h.

Observe que, se o Intelligent Timing estiver ativado, a mensagem será enviada dentro de 24 horas após o usuário entrar no componente de mensagem, no horário inteligente identificado (mesmo se nenhum componente de postergação estiver envolvido).

Eventos de exceção

Horário de silêncio

O evento de exceção é aplicado usando jornadas de ação, que são separadas das etapas de mensagem. O horário de silêncio é aplicado no componente de mensagem. Isso significa que, se um usuário já passou pela jornada de ação (e não foi excluído pelo evento de exceção) e depois encontra o horário de silêncio ao chegar ao componente de mensagem, e o Canvas foi configurado para reenviar a mensagem após o período de horário de silêncio, o evento de exceção não será mais aplicado. Observe que esse caso de uso não é comum.

Para Segments e filtros, a etapa de mensagem tem validações de entrega que permitem configurar Segments e filtros adicionais que são validados no momento do envio. Isso evita o caso extremo mencionado do horário de silêncio.

Configuração de agendamento “em” ou “no próximo”

Os eventos de exceção são criados usando jornadas de ação. As jornadas de ação suportam apenas “após uma janela de tempo X” e não “em X tempo” ou “no próximo X tempo”.

O que devo incluir ao enviar um ticket de suporte para um erro “Request Timed Out”?

Se você encontrar um erro “Request Timed Out” ao editar um Canvas e precisar entrar em contato com o suporte da Braze, inclua as seguintes informações para ajudar a acelerar a resolução:

• Gravação de tela: Uma gravação das etapas que você seguiu antes de ver o erro, incluindo quaisquer transições de página.
• Carimbo de data/hora e fuso horário: O horário exato em que o erro ocorreu e seu fuso horário.
• Navegador e versão: O navegador que você está usando (por exemplo, Chrome 120, Safari 17) e se você tentou reproduzir o erro em um navegador diferente.
• Etapas para reproduzir: Uma descrição clara das ações que disparam o erro, incluindo quaisquer etapas do Canvas ou configurações específicas envolvidas.
• Logs de rede (opcional): Abra as ferramentas de desenvolvedor do seu navegador (guia Network), reproduza o erro e exporte o log de rede como um arquivo de log HTTP Archive (HAR). Isso ajuda a equipe de suporte a identificar qual chamada de API está expirando.

Entrega e solução de problemas do Canvas

Usuários órfãos são elegíveis para receber mensagens do Canvas?

Não. Usuários órfãos não são elegíveis para receber mensagens. Se um perfil se tornar órfão enquanto o usuário estiver em uma jornada do Canvas, ele sairá silenciosamente do fluxo. A análise de dados nem sempre mostra um evento Exited para essa saída, e o resumo do fluxo de trabalho pode incluir um partial_update_token sem exited_date ou exit_reason.

Para saber mais sobre mesclagens e perfis órfãos, consulte Mesclar usuários duplicados.

Se eu parar um Canvas ou uma Campaign ativa, as mensagens já enviadas ao provedor de serviços de e-mail ainda são entregues?

Sim. Depois que a Braze envia uma solicitação ao seu provedor de serviços de e-mail (ESP), ela não pode cancelar esse envio. Parar um Canvas ou uma Campaign impede novas solicitações de envio, mas as mensagens já entregues ao ESP ainda podem ser enviadas e ainda podem incrementar as contagens de envio conforme o ESP as processa.

Esse é o mesmo comportamento descrito para parar um Canvas: envios de e-mail em andamento não são interrompidos imediatamente.

Como posso confirmar que uma etapa de webhook do Canvas foi disparada sem conteúdo visível ao usuário?

A Braze rastreia Envios de webhook e os resultados de entrega relacionados para etapas de Webhook em Campaigns e Canvas. Use a análise de dados da etapa, os relatórios de webhook ou os eventos de webhook do Currents para confirmar que a etapa foi executada. Os registros de solicitação do seu endpoint fornecem confirmação adicional quando você precisa de comprovação do lado do servidor.

A Braze não inclui um pixel de rastreamento invisível integrado para etapas de webhook. Use as métricas de webhook da Braze e os registros do seu endpoint em vez de solicitações personalizadas de imagem de um pixel.

Por que minha etapa de webhook não tem um campo de corpo?

As etapas de webhook usam um corpo de solicitação para POST, PUT, PATCH e DELETE. Se você alterar o método para GET, a Braze remove o campo de corpo porque solicitações GET não suportam corpo de solicitação. Volte para um método que suporte corpo se precisar enviar JSON ou dados de formulário. Para detalhes sobre métodos, consulte Criar um webhook.

Como uso o spacer.gif em uma etapa de webhook?

A Braze hospeda uma imagem de espaço reservado spacer.gif em cdn.braze.com e braze-images.com. Algumas equipes apontam a URL de um webhook para essa imagem quando uma etapa precisa ser disparada sem chamar um endpoint externo. Etapas de webhook padrão devem chamar um endpoint real. Use os relatórios de webhook e os registros do seu endpoint para confirmar a entrega, conforme descrito em Como posso confirmar que uma etapa de webhook do Canvas foi disparada sem conteúdo visível ao usuário?.

Por que meu Canvas não carrega com o erro “invalid next-step-id”?

Esse erro no console significa que pelo menos uma etapa aponta para uma próxima etapa ausente ou inválida — por exemplo, após uma exclusão parcial, clonagem ou importação. Abra o Canvas no editor, reconecte as etapas órfãs ou remova etapas que não tenham mais um caminho downstream válido. Se o Canvas ainda não carregar, entre em contato com o suporte da Braze informando o ID do Canvas e uma captura de tela do erro no console.

Por que o timestamp de conversão do Canvas no Currents difere da minha análise do Canvas?

O Currents registra conversões do Canvas como eventos users.canvas.Conversion. O time do evento é quando o evento de conversão ocorreu. O campo conversion_behavior nesse evento descreve a definição de conversão (tipo e janela). A análise do Canvas também pode consolidar conversões em relação à entrada no Canvas dentro da janela de conversão. Ao reconciliar exportações, compare o time do Currents com o timestamp do evento de conversão e as configurações da janela de conversão do seu Canvas.

Por que canvas_step_name está nulo no Currents?

Campos de nome de Campaign e Canvas, como canvas_step_name, podem ser null quando um evento do Currents é enviado antes que a Braze termine de propagar os metadados da etapa — por exemplo, após você criar ou renomear uma etapa. Para mais detalhes, consulte Por que o nome da Campaign ou o nome da etapa do Canvas é NULL nos meus dados do Currents?.

Por que meu array não está sendo atualizado em uma etapa de atualização do usuário?

Verifique o JSON na sua etapa de atualização do usuário. Atualizações de arrays e atributos aninhados precisam de caminhos e valores válidos para o atributo que você está alterando. Não inclua campos que a etapa fornece automaticamente, como o ID de usuário externo. Use a guia Preview and test da etapa para confirmar a carga útil antes do lançamento.

Posso enviar mensagens do Canvas para usuários sem external_id?

Sim, se um perfil de usuário Braze já existir. Usuários sem external_id são usuários anônimos e podem ser referenciados com um braze_id ou alias de usuário. Crie ou atualize o perfil com o endpoint /users/track ou seu SDK antes da entrada no Canvas, e então use entrada baseada em ação ou disparada por API. O direcionamento padrão do Canvas ainda requer um perfil de usuário Braze — não é possível enviar mensagens do Canvas apenas para um endereço de e-mail sem perfil.

Por que um usuário entrou no Canvas menos vezes do que realizou o evento-gatilho?

Para Canvas baseados em ação e disparados por API, a Braze desduplicam eventos-gatilho para que um usuário possa entrar no máximo uma vez por segundo para o mesmo Canvas. Se um usuário realizar o mesmo gatilho várias vezes em um segundo, apenas uma entrada será processada.

Para permitir múltiplas entradas no mesmo segundo, espaçe os eventos-gatilho em pelo menos 1,1 segundo (por exemplo, quando você controla o timing dos eventos a partir do seu servidor). Para comportamento semelhante ao de Campaigns que permite múltiplos gatilhos no mesmo segundo, compare seu caso de uso com Campaigns com agendamento e configurações de reelegibilidade apropriados.

Quando os usuários são deduplicados em Canvas disparados por API?

Se um usuário entrar novamente em um Canvas disparado por API e chegar a uma etapa de postergação onde ele já está na fila de uma entrada anterior para uma mensagem idêntica, a Braze deduplica o usuário para evitar envios duplicados. A segunda instância do Canvas é encerrada, então o número de entradas pode exceder o número de envios.

Por que um push de teste vai para o app errado, mas os envios reais parecem corretos?

O push de teste em um perfil de usuário é entregue a todos os dispositivos habilitados para push daquele perfil. Quando múltiplos apps estão instalados em um dispositivo, o sistema operacional normalmente entrega a notificação de teste para o primeiro app disponível, que pode não ser o app que você deseja validar.

Para confirmar o direcionamento específico por app, envie uma mensagem ao vivo ou de teste por meio de uma Campaign ou Canvas com um público restrito (por exemplo, filtre por external_id) em vez de depender apenas do push de teste do perfil.

Para etapas de mensagem do Canvas com múltiplos apps, ative Validate audience at message send na etapa de mensagem para que as verificações de Segment e filtro sejam executadas no momento do envio. Para saber mais, consulte Etapa de mensagem.

Para o comportamento geral de push de teste, consulte Envio de mensagens de teste e FAQ de push.

Como faço para depurar Push Stories no iOS e Android?

Comece com Push Stories para requisitos de configuração e criação. Para implementação e tratamento de notificações Rich, consulte Notificações Rich e Push Stories no guia do desenvolvedor.

Quem recebe o e-mail “Canvas Messages Delayed 24+ Hours”?

A Braze envia essa notificação quando mensagens do Canvas são atrasadas por limite de frequência por 24 horas ou mais. O e-mail é enviado para os usuários do dashboard que fizeram alterações anteriormente no Canvas afetado (com base nos registros de alteração do Canvas). Se a Braze não conseguir determinar esses destinatários, o e-mail é enviado para os administradores da empresa do espaço de trabalho.

Quando um usuário para de receber mensagens após um evento de exceção?

A Braze registra a saída assim que o evento de exceção ocorre, mas os usuários podem permanecer dentro de uma etapa até que os temporizadores terminem — mais visivelmente em etapas de postergação. O comportamento também difere entre etapas agendadas e etapas disparadas por evento. Para cronogramas, exemplos e nuances de análise, consulte Critérios de saída.

Por que minha etapa de jornadas de ação mostra um erro quando seleciono uma interação de alias de link?

Grupos de ação que usam gatilhos de interatividade de e-mail (por exemplo, Click alias in email ou Clicked alias in any campaign or Canvas step) precisam de uma etapa de mensagem que já tenha enviado a mensagem contendo aquele link. Adicione ou reordene as etapas para que o e-mail seja enviado antes de a etapa de jornadas de ação avaliar o clique, ou escolha uma interação que corresponda a uma mensagem que o usuário já recebeu neste Canvas. Para a lista completa de gatilhos de interação, consulte Entrega baseada em ação.

Como os timestamps históricos de eventos personalizados afetam Canvas e Campaigns baseados em ação?

A Braze avalia jornadas baseadas em ação quando eventos qualificados são ingeridos e o usuário atende às suas regras de público. Se um evento chegar ao perfil fora da janela em que seu Canvas ou Campaign estava ativo, ou antes de o usuário corresponder ao seu público, a entrada ou os envios subsequentes podem não ocorrer conforme esperado. Compare os timestamps dos eventos com os horários de ativação e a associação ao Segment usando o registro de atividade do perfil do usuário e as etapas de solução de problemas em Solução de problemas de eventos personalizados. Se o comportamento ainda não corresponder às expectativas, entre em contato com o suporte da Braze.