VideoSmart
VideoSmart ofrece tecnología de video personalizado e interactivo que te permite entregar contenido basado en datos y no lineal a escala. Cada video se genera dinámicamente utilizando datos a nivel de cliente, lo que permite mensajería personalizada y recorridos de usuario dentro de una única experiencia de video.
La integración de VideoSmart te permite incrustar contenido de video personalizado en campañas de correo electrónico utilizando contenido conectado de Braze y plantillas Liquid para solicitar activos de video de VideoSmart. Esta integración se implementa normalmente a través de una plantilla reutilizable de bloque de contenido de Braze, lo que permite un despliegue consistente entre campañas y al mismo tiempo ofrece flexibilidad en la selección de campañas y la lógica de personalización.
Esta integración es desarrollada y mantenida por VideoSmart.
Acerca de esta integración
VideoSmart se integra con Braze para generar dinámicamente activos de video personalizados en el momento del envío, que luego se incrustan directamente en el contenido de correo electrónico de tu Campaign y Canvas de Braze.
En Braze, seleccionas la Campaign de VideoSmart correspondiente y pasas los atributos del cliente (a través de plantillas Liquid) a VideoSmart cuando realizas el envío. Estos atributos se utilizan para generar una experiencia de video única y personalizada para cada destinatario. Luego puedes usar contenido conectado de Braze para solicitar URLs de video o activos desde la API de VideoSmart en tiempo real, lo que permite la personalización a escala.
Esta integración está diseñada para mensajes de correo electrónico de Braze que admiten plantillas Liquid y contenido conectado, y se puede configurar para funcionar con atributos estándar de perfil de usuario de Braze o campos de datos personalizados.
Ejemplos
Los ejemplos más comunes incluyen los siguientes:
- Incorporación de clientes y recorridos de bienvenida
- Educación financiera (como pensiones y pólizas de seguros)
- Declaraciones anuales y comunicaciones regulatorias
- Campaigns de conocimiento del producto y venta cruzada
- Campaigns de retención y reactivación de clientes
- Recordatorios de carrito abandonado: cuando un cliente añade productos a su carrito pero no compra, envías un correo electrónico con un video personalizado que destaca los artículos que dejó atrás
- Seguimientos posteriores a la compra: después de una compra, envía un video de agradecimiento personalizado y recomienda productos relacionados
Requisitos previos
Antes de empezar, confirma que tienes lo siguiente:
| Requisito | Descripción |
|---|---|
| Credenciales de contenido conectado de Braze | Una credencial de autenticación básica de contenido conectado llamada basic_credentials, configurada con los valores proporcionados por VideoSmart |
| Plantilla de VideoSmart Content Block | La plantilla de VideoSmart Content Block añadida a tu panel de Braze (proporcionada por VideoSmart) |
| Un mensaje de correo electrónico de Braze | Un correo electrónico de Campaign de Braze o un paso de correo electrónico de Canvas donde insertarás el VideoSmart Content Block |
Integración
Sigue estos pasos para habilitar el Content Block de VideoSmart y usarlo en un correo electrónico.
Paso 1: Configurar la plantilla del Content Block de VideoSmart en Braze
Solicita la plantilla del Content Block de VideoSmart a tu representante de VideoSmart y agrégala a tu panel de Braze.
VideoSmart proporcionará las credenciales para la autenticación de contenido conectado que utiliza el Content Block.
Paso 2: Configurar la autenticación de contenido conectado
Crea una credencial de autenticación básica de contenido conectado en Braze con el nombre “basic_credentials”.
- Sigue las instrucciones en Uso de autenticación básica.
- Usa el nombre de usuario y la contraseña proporcionados por VideoSmart.
Paso 3: Agregar el Content Block a tu correo electrónico
Inserta el Content Block de VideoSmart en tu correo electrónico donde quieras que aparezca el contenido de video.
En la mayoría de las configuraciones de Braze, los Content Blocks se referencian usando el siguiente patrón (reemplaza “VideoSmart_Campaign” con el nombre del Content Block en tu cuenta):
{{content_blocks.${VideoSmart_Campaign}}}

El nombre del Content Block distingue entre mayúsculas y minúsculas y debe coincidir exactamente con lo que hayas configurado en Braze.
Paso 4: Sobrescribir Campaign y datos de registro (opcional)
Si tu Content Block admite valores predeterminados, puedes usarlo sin establecer ninguna variable.
Si necesitas elegir una Campaign de VideoSmart específica, pasar campos de personalización personalizados, o ambas cosas, establece las siguientes variables de Liquid antes de renderizar el Content Block:
vs_campaign_id: identificador de Campaign de VideoSmartvs_record_data: una cadena JSON que contiene los valores que deseas pasar a la plantilla de VideoSmart
Ejemplo
Este ejemplo usa atributos de usuario de Braze para el nombre y el apellido:
{% assign vs_campaign_id = "CAMPAIGN_ID" %}
{% capture vs_record_data %}
{
"FirstName": "{{ ${first_name} | default: 'Alex' | json_escape }}",
"LastName": "{{ ${last_name} | default: 'Doe' | json_escape }}"
}
{% endcapture %}
{% assign vs_record_data = vs_record_data | strip_newlines %}

- Proporciona siempre valores predeterminados para los valores utilizados en
vs_record_datapara que la vista previa de tu correo electrónico de Braze se muestre correctamente. vs_record_datadebe ser un JSON válido, codificado como una sola cadena (el ejemplo usastrip_newlines).
Paso 5: Usar las variables generadas por la plantilla del Content Block de VideoSmart
Después de que el Content Block se ejecuta, genera variables que puedes referenciar en otras partes de tu correo electrónico.
Las variables comunes incluyen:
| Variable | Descripción |
|---|---|
{{ video_url }} |
URL del video personalizado |
{{ poster_url }} |
URL de la imagen de póster del video |
{{ output_data.VARIABLE_NAME }} |
Campos de salida adicionales expuestos por el Content Block |
Límites de velocidad
La API de VideoSmart tiene un límite de velocidad de 10,000 solicitudes por minuto. Si superas este límite, puedes recibir errores o experimentar retrasos en la generación de videos.
Para reducir este riesgo, configura el límite de velocidad de la Campaign en Braze de modo que la tasa de envío de mensajes se mantenga por debajo de la capacidad de la API de VideoSmart.
Para obtener orientación de Braze sobre la velocidad de entrega y los límites de velocidad, consulta Velocidad de entrega y límites de velocidad.
Consideraciones
- El contenido conectado se ejecuta cuando se renderiza el mensaje, por lo que los valores pueden diferir entre la vista previa y el envío si tus valores predeterminados o atributos son distintos.
- Confirma que tu correo electrónico incluya el bloque de contenido antes de hacer referencia a variables como
video_url. - Si usas campos personalizados en
vs_record_data, confirma los nombres de campo esperados con VideoSmart.
Solución de problemas
La vista previa no funciona
Si la vista previa de Braze falla (por ejemplo, reintentos repetidos o errores de autenticación), comprueba que:
- La credencial de contenido conectado “basic_credentials” existe y está configurada correctamente.
- La plantilla del bloque de contenido de VideoSmart está presente en tu cuenta de Braze.
- Todas las variables requeridas (por ejemplo,
vs_campaign_ido los campos obligatorios envs_record_data) tienen valores predeterminados configurados para la vista previa.
Las variables de la plantilla del bloque de contenido de VideoSmart no generan la salida esperada
Si las variables generadas por la plantilla del bloque de contenido de VideoSmart no generan la salida esperada, comprueba lo siguiente:
- La plantilla del bloque de contenido de VideoSmart está configurada correctamente en Braze.
- La autenticación del contenido conectado está configurada correctamente con las credenciales apropiadas.
- Imprime las variables en tu correo electrónico para confirmar que se están estableciendo. Por ejemplo:
{{ video_url }}
Si estás usando una Campaign personalizada, también verifica lo siguiente:
vs_campaign_idestá establecido con un identificador de Campaign válido.vs_record_dataes un JSON válido y contiene los campos esperados.