VideoSmart
A VideoSmart oferece tecnologia de vídeo personalizado e interativo que permite entregar conteúdo não linear e orientado por dados em escala. Cada vídeo é gerado dinamicamente usando dados no nível do cliente, permitindo mensagens personalizadas e jornadas do usuário dentro de uma única experiência de vídeo.
A integração com a VideoSmart permite incorporar conteúdo de vídeo personalizado em Campaigns de e-mail usando Conteúdo conectado da Braze e modelos Liquid para solicitar ativos de vídeo da VideoSmart. Essa integração é normalmente implementada por meio de um modelo reutilizável de bloco de conteúdo da Braze, permitindo implantação consistente entre Campaigns e flexibilidade na seleção de Campaigns e na lógica de personalização.
Esta integração é desenvolvida e mantida pela VideoSmart.
Sobre esta integração
A VideoSmart se integra com a Braze para gerar dinamicamente ativos de vídeo personalizados no momento do envio, que são então incorporados diretamente no conteúdo de e-mail das suas Campaigns e Canvas na Braze.
Na Braze, você seleciona a campanha VideoSmart relevante e passa atributos do cliente (por meio de modelos Liquid) para a VideoSmart no momento do envio. Esses atributos são usados para renderizar uma experiência de vídeo única e personalizada para cada destinatário. Você pode então usar o Conteúdo conectado da Braze para solicitar URLs de vídeo ou ativos da API da VideoSmart em tempo real, permitindo personalização em escala.
Esta integração foi projetada para mensagens de e-mail da Braze que suportam modelos Liquid e Conteúdo conectado, e pode ser configurada para funcionar com atributos padrão do perfil de usuário da Braze ou campos de dados personalizados.
Casos de uso
Os casos de uso mais comuns incluem:
- Integração e jornadas de boas-vindas de clientes
- Educação financeira (como previdência e apólices de seguro)
- Extratos anuais e comunicações regulatórias
- Campanhas de conscientização de produto e venda cruzada
- Campanhas de retenção e reengajamento de clientes
- Lembretes de carrinho abandonado: quando um cliente adiciona produtos ao carrinho mas não finaliza a compra, você envia um e-mail com um vídeo personalizado que destaca os itens que ele deixou para trás
- Acompanhamento pós-compra: após uma compra, envie um vídeo personalizado de agradecimento e recomende produtos relacionados
Pré-requisitos
Antes de começar, confirme que você tem o seguinte:
| Requisito | Descrição |
|---|---|
| Credenciais de Conteúdo conectado da Braze | Uma credencial de Autenticação Básica de Conteúdo conectado chamada basic_credentials, configurada com os valores fornecidos pela VideoSmart |
| Modelo de VideoSmart Content Block | O modelo de VideoSmart Content Block adicionado ao seu dashboard da Braze (fornecido pela VideoSmart) |
| Uma mensagem de e-mail da Braze | Um e-mail de Campaign da Braze ou uma etapa de e-mail do Canvas onde você inserirá o VideoSmart Content Block |
Integração
Siga estas etapas para ativar o VideoSmart Content Block e usá-lo em um e-mail.
Etapa 1: Configurar o modelo de VideoSmart Content Block na Braze
Solicite o modelo de VideoSmart Content Block ao seu representante da VideoSmart e adicione-o ao seu dashboard da Braze.
A VideoSmart fornecerá as credenciais para a autenticação de Conteúdo conectado usada pelo Content Block.
Etapa 2: Configurar a autenticação de Conteúdo conectado
Crie uma credencial de Autenticação Básica de Conteúdo conectado na Braze chamada “basic_credentials”.
- Siga as instruções em Usando autenticação básica.
- Use o nome de usuário e a senha fornecidos pela VideoSmart.
Etapa 3: Adicionar o Content Block ao seu e-mail
Insira o VideoSmart Content Block no seu e-mail onde você deseja que o conteúdo de vídeo apareça.
Na maioria das configurações da Braze, os Content Blocks são referenciados usando o seguinte padrão (substitua “VideoSmart_Campaign” pelo nome do Content Block na sua conta):
{{content_blocks.${VideoSmart_Campaign}}}

O nome do Content Block diferencia maiúsculas de minúsculas e deve corresponder exatamente ao que você configurou na Braze.
Etapa 4: Substituir campanha e dados de registro (opcional)
Se o seu Content Block suporta valores padrão, você pode usá-lo sem definir nenhuma variável.
Se você precisar escolher uma campanha VideoSmart específica, passar campos de personalização personalizados, ou ambos, defina as seguintes variáveis Liquid antes de renderizar o Content Block:
vs_campaign_id: identificador da campanha VideoSmartvs_record_data: uma string JSON contendo os valores que você deseja passar para o modelo da VideoSmart
Exemplo
Este exemplo usa atributos de usuário da Braze para o nome e o sobrenome:
1
2
3
4
5
6
7
8
9
{% assign vs_campaign_id = "CAMPAIGN_ID" %}
{% capture vs_record_data %}
{
"FirstName": "{{ ${first_name} | default: 'John' | json_escape }}",
"LastName": "{{ ${last_name} | default: 'Doe' | json_escape }}"
}
{% endcapture %}
{% assign vs_record_data = vs_record_data | strip_newlines %}

- Sempre forneça valores padrão para os valores usados em
vs_record_datapara que a pré-visualização do e-mail da Braze seja exibida corretamente. vs_record_datadeve ser um JSON válido, codificado como uma única string (o exemplo usastrip_newlines).
Etapa 5: Usar as variáveis geradas pelo modelo de VideoSmart Content Block
Após a execução do Content Block, ele gera variáveis que você pode referenciar em outras partes do seu e-mail.
As variáveis comuns incluem:
| Variável | Descrição |
|---|---|
{{ video_url }} |
URL do vídeo personalizado |
{{ poster_url }} |
URL da imagem de pôster do vídeo |
{{ output_data.VARIABLE_NAME }} |
Campos de saída adicionais expostos pelo Content Block |
Limites de taxa
A API da VideoSmart tem um limite de taxa de 10.000 solicitações por minuto. Se você exceder esse limite, poderá receber erros ou enfrentar atrasos na geração de vídeos.
Para reduzir esse risco, configure o limite de taxa da Campaign da Braze para que a taxa de envio de mensagens fique abaixo da capacidade da API da VideoSmart.
Para orientações da Braze sobre velocidade de entrega e limite de taxa, consulte Velocidade de entrega e limite de taxa.
Considerações
- O Conteúdo conectado é executado quando a mensagem é renderizada, então os valores podem diferir entre a pré-visualização e o envio se seus valores padrão ou atributos forem diferentes.
- Confirme que seu e-mail inclui o Content Block antes de referenciar variáveis como
video_url. - Se você usar campos personalizados em
vs_record_data, confirme os nomes de campo esperados com a VideoSmart.
Solução de problemas
A pré-visualização não está funcionando
Se a pré-visualização da Braze falhar (por exemplo, tentativas repetidas ou erros de autenticação), verifique se:
- A credencial de Conteúdo conectado “basic_credentials” existe e está configurada corretamente.
- O modelo de VideoSmart Content Block está presente na sua conta da Braze.
- Quaisquer variáveis obrigatórias (por exemplo,
vs_campaign_idou campos obrigatórios emvs_record_data) têm valores padrão definidos para a pré-visualização.
As variáveis do modelo de VideoSmart Content Block não estão gerando a saída esperada
Se as variáveis geradas pelo modelo de VideoSmart Content Block não estão gerando a saída esperada, verifique o seguinte:
- O modelo de VideoSmart Content Block está configurado corretamente na Braze.
- A autenticação de Conteúdo conectado está configurada corretamente com as credenciais apropriadas.
- Imprima as variáveis no seu e-mail para confirmar que estão sendo definidas. Por exemplo:
{{ video_url }}
Se você estiver usando uma campanha personalizada, verifique também:
vs_campaign_idestá definido com um identificador de campanha válido.vs_record_dataé um JSON válido e contém os campos esperados.