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 mais compactas possível dentro desse limite. Para saber como as propriedades de entrada e de evento funcionam no Canvas, consulte Propriedades de contexto e de evento.

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

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

Posso usar Optimize with BrazeAI^TM com reelegibilidade em um Canvas?

Sim. Os Canvas podem usar Optimize with BrazeAI^TM quando a reelegibilidade está ativada. A Braze não pode garantir a mesma variante na reentrada, pois a alocação muda ao longo do tempo. As Campaigns exigem uma janela de reelegibilidade de 24 horas ou mais quando Optimize with BrazeAI^TM está ativado.

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 do seu Canvas. 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 do Canvas se refere à jornada personalizada do usuário nas ramificações do seu Canvas. Basicamente, seu Canvas é formado 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 chegam a uma etapa desconectada?

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

Recomendamos verificar a visualização de análise de dados para 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 com uma variante, mas múltiplas ramificações?

Enfileiramos um trabalho 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 equilibrada, mas é provável que haja pelo menos uma leve tendência em favor da etapa que foi criada primeiro.

Além disso, não podemos fazer garantias sobre como exatamente essa distribuição será. 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, os 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?

Os eventos de exceção só são disparados enquanto o usuário está aguardando para receber o componente do Canvas ao qual o evento 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 no Canvas?

Se você editar algumas etapas de um Canvas com múltiplas etapas, os usuários que já estavam no público, mas ainda 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. Após as solicitações de envio serem encaminhadas ao SendGrid, não há como 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 construção da jornada do usuário. A flexibilidade do Canvas permite mapear jornadas de usuário para qualquer estágio do ciclo de vida. Confira nossos modelos de Canvas da Braze para vários exemplos de abordagens otimizadas para criar jornadas de usuário eficazes.

Mensagens e entrega

Quando as mensagens no app no 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 ocorrer se a mensagem no app for disparada por um evento personalizado ou estiver postergada. Nesse caso, é possível que um usuário registre uma impressão de mensagem no app e “receba” a mensagem no app após o Canvas ser interrompido. 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 Mensagens enviadas for sempre zero para um Canvas contendo uma etapa de mensagem no app, isso ocorre porque a entrega de mensagens no app funciona de forma diferente de outros canais de envio de mensagens.

As mensagens no app são “puxadas” pelo SDK, em vez de “empurradas” pela Braze. As mensagens no app para usuários elegíveis são entregues automaticamente no início da sessão e “aguardam” o 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 upstream 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 ficar 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 os atrasos mais longos e realistas da sua jornada. Para saber mais e ver exemplos, consulte Expiração de mensagens no app.

Por que vejo “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 Liquid legado canvas_entry_properties possui restrições diferentes de context. Se você precisar que valores persistam em várias etapas, analise as 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 nos botões para mensagens no app de arrastar e soltar no Canvas?

As métricas no nível do 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, 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 Análise de dados do Canvas.

Posso agendar horários de envio diferentes para cada variante na mesma etapa de Mensagem do Canvas ou 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 uma variante para enviar à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:

• Separe as etapas de Mensagem com etapas de Postergação entre elas para que cada mensagem tenha seu próprio cronograma.
• Use ramificações ou uma etapa de Jornadas experimentais para que os usuários sigam jornadas com tempos diferentes.
• Separe em Campaigns distintas se o caso de uso não precisar permanecer em 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 estiver com limite de frequência global em uma etapa de Mensagem do Canvas?

Ele não recebe o envio do 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 sozinho não remove os usuários 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 que o tamanho estimado do público?

Os envios podem ser menores que o Público estimado por muitas das mesmas razões das Campaigns, incluindo limites de frequência, filtros rígidos de dispositivo ou navegador, janelas de reelegibilidade, limitação de taxa e exclusões no nível do canal (por exemplo, alcançabilidade de push ou verificações 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 do público: Os usuários são direcionados para a ramificação de maior prioridade para a qual se qualificam, então ramificações subsequentes podem receber menos usuários do que a contagem simples de um Segment sugere.
• Verificações de público e horário de envio: Etapas completas reavaliam 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 descartados antes de uma mensagem ser enviada.
• 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 ao seu Segment e filtros de entrada no momento em que a estimativa é executada. Após esse momento, entradas postergadas ou baseadas em ação, reelegibilidade, disparos via API ou roteamento de ramificação podem aumentar o número de perfis que passam pela jornada em comparação com o instantâneo. Usuários também podem ser descartados quando os filtros no momento do 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 que o tamanho estimado do público?.

Por que Destinatários únicos é maior que o número de usuários que direcionei?

Destinatários únicos pode ser maior do que o público esperado porque a Braze rastreia destinatários diários únicos para relatórios de Canvas e Campaign. Isso suporta a atribuição de conversão precisa 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ário e duas conversões no escopo. Com entradas recorrentes ou reelegibilidade, o mesmo pequeno conjunto 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 reelegibilidade, a Braze insere cada usuário no Canvas apenas uma vez. Em Canvas agendados diariamente, apenas os usuários que correspondem ao público e 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, então o volume de entradas diminui.
• Verifique se o público possui 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 consegue se recuperar à medida que os usuários entram no Canvas.

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

Por que um Segment de grupo de controle pequeno mostra alterações no histórico de membros?

Os gráficos de histórico de membros usam amostras estimadas, então Segments pequenos — incluindo Segments do grupo de controle global — podem mostrar variações diárias mesmo quando o público subjacente é estável. Para saber 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 selecionado (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 relatório.

Para regras de conversão em nível de etapa e variante 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 de 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 para 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á contabilizado como convertido na variante geral do Canvas, mas não na etapa, pois ele 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 minha etapa do Canvas não é igual à taxa de conversão total da variante do Canvas?

É comum que o total de conversões de uma variante do Canvas seja maior do que a soma dos totais 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 é contabilizado para uma etapa do Canvas. Então, qualquer usuário que entra no Canvas e realiza o evento de conversão antes de receber a primeira etapa é contabilizado no total de conversões 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.

Note 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, uma conversão não é registrada no nível da etapa. No entanto, como o usuário tecnicamente converteu, uma 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 desse Segment.

Posso excluir um Canvas?

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

Como retomo um Canvas ou Campaign arquivado?

Mensagens arquivadas não são enviadas até que você as retorne para 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 nos filtros de público ou de nível de etapa podem bloquear o salvamento sem uma mensagem de validação detalhada. Abra cada cartão de filtro, remova regras de atributo personalizado incompletas ou insira tanto o nome do atributo quanto o valor e, em seguida, 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 faziam referência a ela. Essa limpeza nem sempre gera uma linha própria no registro de alterações do Canvas.

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

Para visualizar 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 visualizar 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 um usuário?

Filtros como Received Message from Canvas Step são atualizados após a Braze registrar 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 quando impressões são registradas?. Esses mesmos eventos aparecem nas métricas de 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 é uma estatística mais precisa para dados de usuários únicos em comparação com as estatísticas de Canvas ou Campaign. Isso acontece porque as estatísticas de Canvas e 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 para 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 devido à forma como os públicos e os disparos são avaliados. Na Braze, um público é avaliado antes do disparo (a menos que seja usado um disparo de alteração de atributo). Isso fará com que os usuários saiam do Canvas se não fizerem parte do público selecionado antes que quaisquer ações de disparo sejam avaliadas.

O que acontece com usuários anônimos durante a jornada do 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, então 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 de um Campaign ou Segment os usuários que estão atualmente em uma jornada do Canvas?

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 etapas. 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 e, em seguida, 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 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, ele não será atribuído a nenhuma variante. 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 eu converto 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 mais atual do Canvas.

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 o benefício de maior visibilidade e personalização na sua 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

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

Avanço do componente de mensagem

Os componentes de mensagem avançam todos os usuários que entram na etapa. Não há necessidade de especificar o comportamento de avanço de mensagem, o que torna a configuração da etapa geral mais simples. Se você quiser implementar a opção Avançar quando a mensagem for enviada, adicione uma jornada do público separada para filtrar os usuários que não receberam a etapa anterior.

Comportamento de postergação “em”

Os componentes de postergação aguardarão 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 em que a postergação está configurada para enviar seu usuário à próxima etapa em um dia às 14h. Um usuário entra no componente às 14h01 de 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 a partir do horário de entrada.
• No editor atual, o usuário prosseguiria para a próxima etapa às 14h de 15 de abril. Note 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 um usuário entra no componente, ele pode receber a mensagem mais tarde do que receberia em um Canvas criado com o fluxo de trabalho original do Canvas.

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

• Fluxo de trabalho atual: Levará 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.

Note 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 que nenhum componente de postergação esteja 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), então encontra o horário de silêncio ao chegar ao componente de mensagem, e o Canvas foi configurado para que a mensagem seja reenviada após o período de horário de silêncio, o evento de exceção não será mais aplicado. Note que esse caso de uso não é comum.

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

Configuração de cronograma “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 agilizar 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 for ó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 ESP ainda serão entregues?

Sim. Depois que a Braze envia uma solicitação ao seu provedor de serviços de e-mail (ESP), a Braze não pode cancelar esse envio. Parar um Canvas ou uma Campaign impede novas solicitações de envio, mas as mensagens já repassadas ao ESP ainda podem ser entregues 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 para o usuário?

A Braze rastreia Sends 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 logs de solicitação do seu endpoint fornecem confirmação adicional quando você precisa de uma prova de recebimento no 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 logs do seu endpoint em vez de solicitações de imagem de um pixel personalizado.

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

As etapas de webhook usam um corpo de solicitação para POST, PUT, PATCH e DELETE. Se você mudar 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 os métodos, consulte Criar um webhook.

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

A Braze hospeda uma imagem placeholder 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. As etapas padrão de webhook devem chamar um endpoint real. Use os relatórios de webhook e os logs 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 para o usuário?.

Por que meu Canvas não carrega com um 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 as etapas que não possuem 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 de um Canvas no Currents difere da minha análise de dados do Canvas?

O Currents registra as conversões do Canvas como eventos users.canvas.Conversion. O time do evento é o momento em que 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 de dados do Canvas também pode agregar 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 da etapa do Canvas é NULL nos meus dados do Currents?.

Por que meu array não está sendo atualizado em uma etapa de User Update?

Verifique o JSON na sua etapa de User Update. 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 um external_id?

Sim, se um perfil de usuário já existir na Braze. Usuários sem um 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 o seu SDK antes da entrada no Canvas, e então use a entrada baseada em ação ou disparada por API. O direcionamento padrão do Canvas ainda exige um perfil de usuário na 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 ele realizou o evento-gatilho?

Para Canvas baseados em ação e disparados por API, a Braze faz a deduplicação de 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 dentro de 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 um comportamento semelhante ao de Campaign que permita múltiplos gatilhos no mesmo segundo, compare seu caso de uso com Campaigns com configurações apropriadas de agendamento e reelegibilidade.

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 já esteja na fila de uma entrada anterior para uma mensagem idêntica, a Braze faz a deduplicação do 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 Test push em um perfil de usuário é entregue a todos os dispositivos habilitados para push daquele perfil. Quando vários apps estão instalados em um dispositivo, o sistema operacional normalmente entrega a notificação de teste ao 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 real ou de teste por meio de uma Campaign ou Canvas com um público restrito (por exemplo, filtre por external_id) em vez de confiar apenas no Test push do perfil.

Para etapas de mensagem do Canvas com vários apps, ative Validate audience at message send na etapa de mensagem para que as verificações de Segment e filtros 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 depuro 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 pelo limite de frequência por 24 horas ou mais. O e-mail é enviado aos usuários do dashboard que fizeram alterações anteriormente no Canvas afetado (com base nos logs de alterações do Canvas). Se a Braze não conseguir determinar esses destinatários, o e-mail será enviado aos 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 timers terminem — isso é mais visível nas 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 de dados, 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 da etapa de jornadas de ação avaliar o clique, ou escolha uma interação que corresponda a uma mensagem que o usuário já tenha recebido nesse 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 os eventos qualificados são ingeridos e o usuário atende às suas regras de público. Se um evento chega ao perfil fora da janela em que seu Canvas ou Campaign estava ativo, ou antes que o usuário correspondesse 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 atividades do perfil de 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.