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.

Qual é o tamanho máximo do nome de uma etapa do Canvas?

Os nomes das etapas do Canvas podem ter até 256 caracteres.

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 de evento.

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

Esse erro aparece quando a combinação de ramificações das etapas com o tamanho do público de entrada pode causar problemas de desempenho no cluster que impedem o envio das mensagens. Para ver as etapas de resolução, incluindo o uso de Jornadas do público, a redução das ramificações ou do tamanho do público e a recriação no Canvas Flow, consulte Erro “Too many Canvas branches”.

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

Sim. Os Canvas podem usar o Optimize with BrazeAI^TM quando a reelegibilidade está ativada. A Braze não consegue garantir a mesma variante na reentrada, porque a alocação muda ao longo do tempo. As Campaigns exigem uma janela de reelegibilidade de 24 horas ou mais quando o 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 dele. Os componentes podem incluir ações como dividir a jornada do usuário, adicionar uma postergação e até testar várias jornadas do Canvas. Uma etapa no Canvas se refere à jornada personalizada do usuário nas ramificações do seu Canvas. Basicamente, seu Canvas é formado por componentes individuais que criam as etapas da 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 vão os usuários quando chegam a uma etapa desconectada?

Se um usuário estiver em uma etapa desconectada do fluxo de trabalho do seu Canvas, ele avançará para a etapa seguinte, se houver uma, e a configuração da etapa vai definir como esse avanço acontece. Isso permite fazer alterações nas etapas sem precisar conectá-las diretamente ao restante do Canvas. Também dá a você uma margem para testes antes de colocar tudo no ar, funcionando, na prática, como salvar um rascunho.

Recomendamos verificar a visualização de análise de dados para ver os usuários pendentes em uma etapa do Canvas antes de desconectá-la.

O que acontece se o público e o horário de envio forem idênticos em um Canvas com uma variante, mas várias ramificações?

Colocamos uma tarefa na fila para cada etapa. Elas são executadas mais ou menos ao mesmo tempo, e uma delas “vence”. Na prática, a distribuição pode ser relativamente equilibrada, mas é provável que haja pelo menos uma leve tendência em favor da etapa 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, os filtros e segmentos das etapas completas do Canvas são verificados no momento do envio. A etapa de divisão de decisão faz uma avaliação logo após o usuário 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 o usuário realizar uma ação antes disso, 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 com várias etapas, os usuários que já estavam no público, mas ainda não receberam essas etapas, receberão a versão atualizada da mensagem. Isso só acontece 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 Como alterar seu Canvas após o lançamento.

O que acontece quando você interrompe um Canvas?

Quando você interrompe um Canvas, acontece o seguinte:

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

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

Dependendo do que você quer alcançar com seu Canvas, talvez sejam necessárias abordagens diferentes para criar a jornada do usuário. A flexibilidade do Canvas permite mapear jornadas para qualquer estágio do ciclo de vida do usuário. Confira nossos modelos de Canvas da Braze para ver vários exemplos de abordagens simplificadas 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 início da próxima 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 início da próxima sessão, desde que a mensagem no app ainda não tenha expirado.

Um usuário pode iniciar uma sessão antes de o Canvas ser interrompido e não ver a mensagem no app imediatamente. Isso pode acontecer se a mensagem no app for disparada por um evento personalizado ou tiver uma postergação. Portanto, é possível que um usuário registre uma impressão da mensagem no app e “receba” a mensagem depois que o Canvas for interrompido. No entanto, o usuário precisaria 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 estiver sempre zerado em um Canvas com uma etapa de mensagem no app, isso acontece 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 “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 a Campaign) como recebida no perfil de usuário. Por isso, o total de Envios fica zerado para mensagens no app.

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

Depois que as etapas de Postergação e as verificações de público anteriores são concluídas, os usuários só se tornam elegíveis para uma mensagem no app 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 depois da expiração e nunca ver a mensagem. Alinhe a expiração com as postergações mais longas que as jornadas podem ter na prática. Para saber mais e ver exemplos, consulte Expiração da mensagem 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 de evento e em Etapa de Mensagem. O namespace legado do Liquid canvas_entry_properties tem restrições diferentes das do context. Se você precisar que os valores persistam por várias etapas, revise as propriedades persistentes no editor original do Canvas com a sua equipe da Braze. Os valores armazenados são apagados quando o usuário sai do Canvas antes de o dispositivo baixar a carga útil da mensagem no app.

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

As métricas por botão das mensagens no app de arrastar e soltar aparecem no cartão de análise de dados da etapa de Mensagem em Detalhes do Canvas, e não apenas no resumo geral do Canvas. Abra o Canvas, selecione a etapa de Mensagem e confira o engajamento da mensagem no app ali. Para conceitos de relatório, 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 no mesmo 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 definir que uma variante seja enviada às 18h e outra às 19h nesse mesmo envio agendado.

Para escalonar os envios ou usar horários diferentes por jornada, experimente 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.
• Use Campaigns separadas se o caso de uso não precisar ficar 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?

O usuário não recebe aquele envio no canal limitado, mas as etapas de Mensagem ainda fazem os usuários avançarem quando uma mensagem não é enviada por causa do limite de frequência global. Para ver os casos de avanço etapa por etapa, 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 é independente das Validações de entrega em uma etapa de Mensagem. Para saber mais, consulte Limite de frequência e limite de frequência de envio.

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 muitos dos mesmos motivos das Campaigns, incluindo limites de frequência, filtros rígidos de dispositivo ou navegador, janelas de reelegibilidade, limite de frequência de envio 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).

Também há fatores específicos do Canvas:

• Entrada baseada em ação ou disparada por API: Os usuários só entram (e recebem as etapas) depois de realizarem o comportamento de entrada. Por isso, os envios realizados ficam abaixo da estimativa inicial até que essas ações aconteçam.
• Jornadas de público: Os usuários são direcionados para a ramificação de maior prioridade para a qual se qualificam. Então, as ramificações seguintes podem receber menos usuários do que uma contagem simples do Segment sugere.
• Verificações de público e no momento do envio: As etapas completas reavaliam os filtros no momento do envio, a menos que você configure de outra forma. Usuários que se qualificavam quando o Canvas foi criado podem sair antes de uma mensagem ser enviada.
• Grupos de controle: Os grupos de controle global ou do Canvas retêm uma parte dos usuários que entram, sem enviar mensagens a eles.
• 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 de público: Os limites de entrada ou de envio impedem a entrada de usuários adicionais, mesmo quando o Segment subjacente é maior.
• Janela de relatório: O intervalo da 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 as contagens de usuários do Canvas não coincidem?

O Público estimado mostra quem corresponde aos seus filtros de Segment e de entrada no momento em que a estimativa é calculada. Depois disso, entradas com postergação ou baseadas em ação, reelegibilidade, disparos por API ou o direcionamento por ramificações podem aumentar o número de perfis que passam pela jornada em comparação com esse retrato. Os usuários também podem sair quando os filtros no momento do envio não são atendidos, o que reduz as entradas ou os envios realizados. Compare o tempo, os limites e as configurações de avaliação junto com Por que os envios são menores do que o tamanho estimado do público?.

Por que Destinatários únicos é maior do 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 únicos diários nos relatórios de Canvas e Campaign. Isso garante 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 receber uma etapa do Canvas na segunda-feira e outra vez na sexta-feira, e converter depois de cada envio, a Braze pode contar duas linhas de destinatário e duas conversões dentro do escopo. Com entradas recorrentes ou reelegibilidade, o mesmo pequeno conjunto de perfis pode gerar vários Destinatários únicos ao longo de vários dias.

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

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

• Verifique se a reelegibilidade está ativada: Sem reelegibilidade, a Braze coloca 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 seguinte tem menos usuários elegíveis, e o volume de entrada diminui.
• Verifique se o público tem associação fixa: 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 usuários entrando, o volume de entrada não consegue se recuperar à medida que os usuários entram no Canvas.

Para limites de frequência 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 na associação histórica?

Os gráficos de associação histórica usam amostras estimadas. Por isso, Segments pequenos, incluindo Segments de grupo de controle global, podem mostrar variações de um dia para o outro mesmo quando o público subjacente está estável. Para entender como as estimativas funcionam e por que os gráficos podem oscilar, consulte Visualizar o tamanho histórico da associação ao Segment.

Análise de dados e conversões

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

O dashboard de conversões atribui as conversões do Canvas de acordo com o método de atribuição que você selecionar. Alguns exemplos são Upon Receipt, Upon Send, Upon Open e Upon Click. Para aparecer no relatório, o usuário precisa entrar no Canvas ou na 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 entender as regras de conversão por etapa e por 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 que o usuário recebeu naquela entrada. O bloco de resumo no início de um Canvas mostra todas as conversões realizadas pelos usuários naquela jornada, tenham eles recebido uma mensagem ou não. Cada etapa seguinte mostra apenas as conversões que aconteceram enquanto ela era a etapa mais recente recebida pelo usuário.

Expandir para ver exemplos

Exemplo 1

Há uma jornada do 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 depois de entrar, mas antes de receber a primeira mensagem.
• O usuário B abre o app depois de cada notificação por push.

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

Nota

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

Exemplo 2

Há um Canvas de uma 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 definido, 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, porque não recebeu a etapa.

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

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

Por que a taxa de conversão da 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 que a soma do total das etapas. Isso acontece 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. Então, qualquer usuário que entre no Canvas e realize o evento de conversão antes de receber a primeira etapa é contabilizado no total de conversões da variante, e não no total da etapa. O mesmo vale para um usuário que entra no Canvas, mas sai dele antes de receber qualquer etapa.

Também é possível que um usuário entre em uma variante, não receba nenhuma mensagem de uma etapa e depois converta. Nesse caso, nenhuma conversão é registrada no nível da etapa. Porém, 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 dele. Por exemplo, use um filtro de entrada no Canvas para confirmar que os usuários entraram no Canvas disparado por API, ou um filtro de etapa recebida para confirmar que eles receberam uma mensagem do Canvas. Depois, 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 uma Campaign arquivada?

Mensagens arquivadas não são enviadas até você voltar a deixá-las editáveis. Desarquive a Campaign ou o Canvas e defina o cronograma de entrada ou o horário de envio para uma janela futura (ou duplique a jornada se precisar de uma cópia limpa). Depois, selecione Retomar ou lance conforme necessário. Consulte Arquivar Campaigns e Canvas.

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

Filtros de Atributo personalizado vazios no público ou nos filtros de etapa podem bloquear o salvamento sem mostrar uma mensagem de validação detalhada. Abra cada cartão de filtro e remova as regras de atributo personalizado incompletas, ou informe tanto o nome quanto o valor do atributo. Depois, selecione Salvar novamente.

Por que uma tag sumiu do meu Canvas ou da minha Campaign?

Quando uma tag é excluída do seu espaço de trabalho, a Braze a remove de todas as Campaigns e de todos os Canvas que a usavam. Essa limpeza nem sempre gera uma linha própria 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 a página Detalhes do Canvas para baixo. Lá, você pode ver a análise de dados de cada componente. Para saber mais, consulte Análise de dados do Canvas.

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 de envio, recebimento ou engajamento correspondente àquela etapa. Mensagens no app 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 de etapa em Detalhes do Canvas.

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

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

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

O número de usuários que entram em um Canvas pode ser diferente do esperado por causa da forma como os públicos e os gatilhos são avaliados. Na Braze, o público é avaliado antes do gatilho (a menos que você use um gatilho de alteração de atributo). Então, os usuários que não fazem parte do público selecionado saem do Canvas antes que qualquer ação-gatilho seja avaliada.

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

Usuários anônimos podem entrar e sair de Canvas, mas as ações deles não ficam associadas a um perfil de usuário específico até que sejam identificados. Por isso, as interações deles 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 uma Campaign ou de um 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, na variante atribuída ou no engajamento com as etapas. Esses filtros avaliam o histórico de entradas e as interações. Eles não indicam se um usuário ainda está avançando em uma jornada ativa.

Para incluir ou excluir usuários com base na participação ativa em um Canvas, adicione etapas de Atualização de usuário na entrada e na saída do Canvas para definir e limpar atributos personalizados. Depois, filtre por esses atributos nas Campaigns ou nos 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 variação de um Canvas específico. Esse filtro inclui todos os usuários que não estão no grupo de controle, tenham eles entrado no Canvas ou não. Isso abrange usuários que entraram em outra variação e usuários que não entraram em nenhuma variação.

Is not in Canvas control group

O usuário entrou no Canvas, mas não está no grupo de controle e, portanto, recebeu uma variação. Esse filtro inclui apenas usuários que entraram no Canvas.

A atribuição de variação acontece na entrada do Canvas. Se um usuário não entrou em um Canvas, ele não recebe nenhuma variante. Ou seja, ele não estará no grupo de controle nem em uma variante.

Editor original do Canvas

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

Como 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 o editor atual e o editor original do Canvas?

Barra de ferramentas de componentes do Canvas

No 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. Assim, você ganha mais 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 reunia em um único componente informações como configurações de postergação e cronograma, eventos de exceção, filtros de público, configuração da mensagem e opções de avanço da mensagem. No editor atual, essas configurações são separadas para tornar a criação do Canvas mais personalizável, o que traz 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 simplifica a configuração da etapa como um todo. Se quiser implementar a opção Avançar quando a mensagem for enviada, adicione uma etapa separada de jornadas de 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 seguir para a próxima etapa.

Digamos que, em 12 de abril, você tenha 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 de 13 de abril.

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

Comportamento do Intelligent Timing

Como o Intelligent Timing fica armazenado no componente de mensagem, as postergações são aplicadas antes dos cálculos do Intelligent Timing. Então, dependendo de quando o 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.

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

• Fluxo de trabalho atual: A postergação leva 48 horas para terminar, 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 no horário inteligente identificado, dentro de 24 horas após o usuário entrar no componente de mensagem (mesmo sem nenhum componente de postergação envolvido).

Eventos de exceção

Horário de silêncio

O evento de exceção é aplicado com jornadas de ação, que são separadas das etapas de mensagem. Já o horário de silêncio é aplicado no componente de mensagem. Isso significa que o evento de exceção deixa de ser aplicado no seguinte cenário: o usuário já passou pela etapa de jornadas de ação (sem ser excluído pelo evento de exceção), depois encontra o horário de silêncio ao chegar ao componente de mensagem, e o Canvas está configurado para reenviar a mensagem após o período de horário de silêncio. 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, validados no momento do envio. Isso evita o caso extremo de horário de silêncio descrito acima.

Configuração de cronograma “Em” ou “No próximo”

Os eventos de exceção são criados com jornadas de ação. As jornadas de ação só aceitam “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 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 podem receber mensagens do Canvas?

Não. Usuários órfãos não podem receber mensagens. Se um perfil ficar órfão enquanto o usuário está em uma jornada do Canvas, ele sai do fluxo silenciosamente. A análise de dados nem sempre mostra um evento Exited para essa saída. O resumo do fluxo de trabalho também 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 interromper um Canvas ou uma Campaign ativos, as mensagens já enviadas ao ESP ainda sã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 consegue cancelar esse envio. Interromper 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 aumentar a contagem de envios conforme o ESP as processa.

Esse é o mesmo comportamento descrito em interromper 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 os 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 logs de solicitação do seu endpoint oferecem uma 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 nativo para etapas de webhook. Use as métricas de webhook da Braze e os logs 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ê mudar o método para GET, a Braze remove o campo de corpo, porque solicitações GET não aceitam corpo de solicitação. Volte para um método que aceite 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 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 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 e mostra 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. Isso pode acontecer, por exemplo, depois de uma exclusão parcial, de uma clonagem ou de uma importação. Abra o Canvas no editor, reconecte as etapas órfãs ou remova as etapas que não têm mais uma jornada válida a seguir. Se o Canvas ainda não carregar, entre em contato com o suporte da Braze e informe o ID do Canvas e uma captura de tela do erro no console.

Por que o registro de data e hora de uma conversão do Canvas no Currents é diferente da análise de dados do meu Canvas?

O Currents registra 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 da conversão (tipo e janela). A análise de dados do Canvas também pode agrupar conversões em relação à entrada no Canvas dentro da janela de conversão. Ao conciliar exportações, compare o time do Currents com o registro de data e hora do evento de conversão e com as configurações da janela de conversão do seu Canvas.

Por que canvas_step_name aparece como nulo no Currents?

Campos de nome de Campaign e Canvas, como canvas_step_name, podem ser null quando um evento do Currents é enviado antes de a Braze terminar de propagar os metadados da etapa. Isso pode acontecer, por exemplo, depois que você cria ou renomeia uma etapa. Para mais detalhes, consulte Por que o nome da campanha ou o nome da etapa do Canvas aparece como NULL nos meus dados do Currents?.

Por que minha matriz não é atualizada em uma etapa de Atualização de Usuário?

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

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

Sim, desde que já exista um perfil de usuário na Braze. Usuários sem um external_id são usuários anônimos e podem ser referenciados por um braze_id ou por um alias de usuário. Crie ou atualize o perfil com o endpoint /users/track ou com o seu SDK antes da entrada no Canvas. Depois, 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 em um Canvas menos vezes do que realizou o evento-gatilho?

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

Para permitir várias entradas no mesmo segundo, espace os eventos-gatilho em pelo menos 1,1 segundo (por exemplo, quando você controla o momento dos eventos pelo seu servidor). Se você precisa de um comportamento que permita vários gatilhos no mesmo segundo, compare seu caso de uso com as Campaigns com as configurações adequadas de agendamento e de reelegibilidade.

Quando os usuários são desduplicados 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 em que já está na fila por uma entrada anterior para uma mensagem idêntica, a Braze desduplica o usuário para evitar envios duplicados. A segunda instância do Canvas é encerrada. Por isso, o número de entradas pode ser maior que o número de envios.

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

O Teste de push no perfil de usuário é entregue a todos os dispositivos com push ativado desse perfil. Quando há vários apps 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ê quer validar.

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

Em etapas de Mensagem do Canvas com vários apps, ative Validar público no envio da mensagem na etapa de Mensagem para que as verificações de segmento e de filtro sejam executadas no momento do envio. Para saber mais, consulte Etapa de Mensagem.

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

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

Comece por Push Stories para conhecer os requisitos de configuração e de criativos. Para a implementação e o 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 ficam atrasadas por limite de frequência durante 24 horas ou mais. O e-mail vai para os usuários do dashboard que já fizeram alterações no Canvas afetado (com base nos registros de alterações do Canvas). Se a Braze não conseguir identificar esses destinatários, o e-mail vai para os administradores da empresa do espaço de trabalho.

Quando um usuário deixa de receber mensagens depois de um evento de exceção?

A Braze registra a saída assim que o evento de exceção ocorre. Mas os usuários podem continuar em uma etapa até que os temporizadores terminem, o que é mais visível nas etapas de postergação. O comportamento também é diferente entre etapas agendadas e etapas disparadas por eventos. Para ver cronogramas, exemplos e detalhes da 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, Clicar no alias no e-mail ou Clicou no alias em qualquer Campaign ou etapa do Canvas) precisam de uma etapa de Mensagem que já tenha enviado a mensagem com esse link. Adicione ou reorganize 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 ver a lista completa de gatilhos de interação, consulte Entrega baseada em ação.

Como os registros de data e hora 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 regras do seu público. Eventos personalizados com data retroativa podem disparar a entrada no Canvas se o registro de data e hora do evento estiver dentro da janela de entrada do Canvas. A entrada ou os envios seguintes podem não acontecer como esperado se o registro de data e hora estiver fora dessa janela, se o Canvas ou a Campaign não estiverem ativos ou se o usuário ainda não correspondia ao seu público.

Compare os registros de data e hora dos eventos com os horários de lançamento, as configurações da janela de entrada e a participação em segmentos. Para isso, use 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 ao esperado, entre em contato com o suporte da Braze.