Criação de cartões
Você pode escolher quando a Braze avalia a elegibilidade do público e a personalização para novas Campaigns de Content Cards e etapas do Canvas, especificando quando o cartão é criado.
Pré-requisitos
Para aproveitar esse recurso, você precisa fazer upgrade para as seguintes versões mínimas do SDK:
No iOS, o Swift SDK oferece suporte a esse recurso a partir da versão 5.2.0, e o SDK legado Objective-C oferece suporte a partir da versão 4.5.0. As versões 5.0.0 a 5.1.x do Swift SDK não oferecem suporte.
Após fazer upgrade do SDK, seus usuários de dispositivos móveis precisam atualizar o app. Você pode filtrar o público da sua Campaign ou Canvas para direcionar apenas usuários nas versões mínimas do app.
Visão geral
Você pode escolher quando a Braze cria um cartão na etapa Delivery ao criar uma nova campanha de Content Card com entrega agendada.
As seguintes opções estão disponíveis:
- No lançamento da campanha: O comportamento padrão anterior para Content Cards. A Braze calcula a elegibilidade do público e a personalização quando a campanha é lançada, depois cria o cartão e o armazena até que o usuário abra o app.
- Na primeira impressão (recomendado): Quando o usuário abre o app novamente (inicia uma nova sessão), a Braze determina quais Content Cards o usuário é elegível para receber, processa qualquer personalização como Liquid ou Connected Content, e então cria o cartão. Essa opção geralmente oferece melhor desempenho.
Independentemente da opção selecionada, a contagem regressiva da data de expiração do Content Card começa quando a campanha é lançada.
Você pode escolher quando a Braze cria um cartão na guia Messaging Channels de uma etapa de Mensagem de Content Card.
As seguintes opções estão disponíveis:
- Na entrada da etapa: O comportamento padrão anterior para Content Cards. A Braze calcula a elegibilidade do público quando o usuário entra na etapa do Canvas, depois cria o cartão e o armazena até que o usuário abra o app.
- Na primeira impressão (recomendado): A Braze calcula a elegibilidade do público quando o usuário entra na etapa do Canvas. Quando o usuário abre o app novamente (inicia uma nova sessão), a Braze processa qualquer personalização como Liquid ou Connected Content, e então cria o cartão. Essa opção oferece melhor desempenho na entrega de cartões e uma personalização mais atualizada.
Independentemente da opção selecionada, a contagem regressiva da data de expiração do Content Card começa quando o usuário entra na etapa do Canvas.
Se você quiser que usuários anônimos vejam um Content Card na primeira sessão, use uma Campaign em vez de um Canvas. Isso acontece porque, quando um usuário anônimo entra em um Canvas, a sessão já foi iniciada, então ele não receberá o Content Card até iniciar uma nova sessão.
Evento de remoção
Selecione a opção para remover Content Cards quando os usuários concluírem uma compra ou realizarem um evento personalizado. Para usar Perform Custom Event como o evento de remoção, selecione variáveis de contexto ou atributos personalizados para comparações ao usar filtros de propriedade.
Expiração
Nas configurações de Expiration (Time in Feed), você pode selecionar Personalize duration para definir a expiração do Content Card usando variáveis de contexto.
Content Cards têm uma expiração máxima de 30 dias, mesmo quando se usa duração personalizada com variáveis de contexto. Qualquer valor definido acima de 30 dias será limitado a 30 dias. Para mais detalhes, consulte Expiração do cartão.
Para ambas as opções, após um cartão ser criado, a Braze não recalcula a elegibilidade do público nem a personalização.
Diferenças entre criar cartões no lançamento ou na entrada versus na primeira impressão
Esta seção descreve as principais diferenças entre criar cartões no lançamento da campanha ou na entrada da etapa versus na primeira impressão.
| No lançamento da campanha / Na entrada da etapa do Canvas | Na primeira impressão | |
|---|---|---|
| Quando usar | Se você precisar que o conteúdo seja capturado em um momento específico (o momento do lançamento). |
|
| Público | A Braze avalia a participação no público quando a campanha é enviada. Usuários novos ou anônimos não serão avaliados para elegibilidade se tentarem visualizar o cartão após o envio da campanha. Para Campaigns recorrentes, isso acontecerá no próximo intervalo de recorrência. |
A Braze avalia a participação quando o usuário abre o app novamente (inicia uma sessão, somente Campaigns*). Essa configuração terá um alcance de público mais amplo, pois qualquer usuário novo ou anônimo sempre será avaliado para elegibilidade quando tentar visualizar o cartão. Além disso, o limite de frequência (limitando o número de pessoas que receberão o cartão) não se aplica quando configurado para a primeira impressão. |
| Personalização | A Braze avalia Liquid, Connected Content e Content Blocks no momento em que a campanha é lançada ou quando o usuário entra na etapa do Canvas. Para Campaigns recorrentes, isso acontecerá no próximo intervalo de recorrência. | A Braze avalia Liquid, Connected Content e Content Blocks no momento da primeira impressão ou após o próximo intervalo de recorrência. |
| Análise de dados | Mensagens Enviadas refere-se ao número de cartões que a Braze criou e disponibilizou. Isso não conta se os usuários visualizaram o cartão. | Mensagens Enviadas refere-se ao número de cartões que a Braze envia a um usuário após o início de uma sessão. No Canvas, se um usuário entra na etapa sem iniciar uma sessão, a Braze não envia um cartão, então essa métrica pode não corresponder ao número de usuários que entram em uma etapa. Embora os usuários contatáveis e as impressões não mudem, espere um volume de envio menor (Mensagens Enviadas) ao criar um cartão na primeira impressão em comparação com o lançamento da campanha ou a entrada na etapa do Canvas. |
| Tempo de processamento | A Braze cria cartões para cada usuário elegível no Segment no momento do lançamento. Para públicos grandes, selecione At First Impression para que os cartões fiquem disponíveis mais rapidamente após o lançamento. | A Braze cria um cartão na primeira vez que um usuário tenta visualizá-lo, então pode levar de 1 a 2 segundos para ser exibido na primeira impressão. |
* Este cenário se aplica apenas a Campaigns, pois o público do Canvas é avaliado na entrada do Canvas, não no nível da etapa.
Considerações
Campaigns multicanais
Campaigns multicanais não suportam cartões na primeira impressão, então todos os Content Cards são enviados no lançamento da campanha.
Usar propriedades de contexto do Canvas
Ao personalizar Content Cards com propriedades de contexto do Canvas, use a sintaxe ${...} (por exemplo, {{context.${property_name}}}). A notação de ponto sem essa sintaxe (por exemplo, {{context.property_name}}) pode não resolver corretamente em Content Cards, mesmo que funcione em outros canais como push e e-mail.
Alterar a criação de cartões após o lançamento
A Braze recomenda não alterar a forma como os cartões são criados após o lançamento de uma campanha. Devido às diferenças na forma como Mensagens Enviadas é calculada entre os dois tipos de criação de cartões, alterar a criação dos cartões após o lançamento da campanha pode afetar a precisão do seu volume de envio.
Tempo de processamento potencial
Para públicos grandes, selecione a opção de criar cartões na primeira impressão para que os cartões estejam disponíveis rapidamente após o lançamento. Campaigns disparadas no início da sessão também podem se beneficiar da mudança para criação na primeira impressão (disponível por meio de entrega agendada) para melhorar o desempenho.
Quando os cartões são criados na primeira impressão, pode levar alguns segundos para serem processados. A duração desse tempo de processamento depende de vários fatores, como o tamanho do cartão e a complexidade das opções de template da mensagem. Por exemplo, o tempo de processamento para cartões que usam Connected Content é pelo menos tão longo quanto o tempo de resposta do Connected Content.
Versões anteriores do SDK
Se o app de um usuário estiver rodando uma versão anterior do SDK, ele ainda receberá os Content Cards que você enviar. No entanto, os cartões demoram mais para aparecer e podem não ser exibidos até a próxima sincronização de Content Cards.