Copy Pastd

Copy Pastd ofrece Building Blocks, un creador de correo electrónico de arrastrar y soltar que envía Content Blocks con Liquid y plantillas completas directamente a tu espacio de trabajo de Braze. Diseña una vez, sincroniza con Braze y reutiliza los mismos componentes en Campaigns, Canvas y flujos desencadenados sin tener que reconstruir el HTML cada vez.

Esta integración es mantenida por Copy Pastd.

Acerca de la integración

La integración de Braze y Copy Pastd te permite crear correos electrónicos en Building Blocks, un creador de correo electrónico alojado que produce resultados nativos de Braze con Liquid limpio, referencias a Content Blocks y plantillas que se incorporan a cualquier Campaign o Canvas sin necesidad de traducción.

Puedes ensamblar un correo electrónico a partir de bloques reutilizables, enviarlo a Braze con un solo clic y confiar en que los mismos estilos de marca, componentes y contenido dinámico se rendericen de forma consistente en cada envío. El resultado son menos plantillas codificadas a mano, menos tiempo dedicado a crear y enviar correos electrónicos, y una biblioteca centralizada que se actualiza en todas partes cuando cambia.

Requisitos previos

Los siguientes son necesarios para usar esta integración:

Ejemplos

• Creación coherente con la marca a escala. Aplica una hoja de estilos de Building Blocks a cada plantilla, y los colores, fuentes, estilos de botones y el espaciado se renderizan de forma idéntica en cientos de correos electrónicos. Cuando la marca cambie, actualiza la hoja de estilos una vez y resincroniza para implementar la actualización en todos tus correos electrónicos a la vez.
• Plantillas de productos vinculadas a contenido conectado y catálogos. Vincula los campos de bloques de correo electrónico directamente a tus endpoints de contenido conectado y catálogos de Braze desde el propio creador. Reutiliza la misma plantilla para lanzamientos de nuevos productos, colecciones de temporada o actualizaciones de contenido sin tocar Liquid.
• Producción de correo electrónico de autoservicio para especialistas en marketing no técnicos. Compón un correo electrónico completo a partir de bloques aprobados, incluyendo personalización y lógica con Liquid, y envíalo a Braze para revisión sin necesidad de soporte de desarrolladores para escribir HTML o Liquid ni revisar ninguno de los dos.
• Encabezados y pies de página centralizados, actualizados con un solo clic. Crea un encabezado o pie de página una vez en el creador de Building Blocks y envíalo a Braze. Cada plantilla que lo referencia se mantiene sincronizada, de modo que un cambio de logotipo, una modificación del texto legal o un nuevo enlace social solo requiere una actualización dentro de Building Blocks para aplicarse en todos los correos electrónicos que ya están en Braze.
• Contenido centralizado en todos los correos electrónicos. Crea un hero, pie de página o tarjeta promocional una vez como bloque inteligente de Building Blocks. Actualízalo, sincroniza, y cada correo electrónico que ya está en Braze y lo referencia recoge el cambio en el siguiente envío. Los flujos de bienvenida, los boletines semanales y los recorridos desencadenados se mantienen actualizados sin editar cada Campaign.
• Plantillas bloqueadas para que los colaboradores trabajen de forma autónoma. Crea plantillas, bloquea los campos seleccionados y luego invita a otros equipos a crear sus propios correos electrónicos desde una interfaz de colaborador sin otorgarles acceso a las herramientas orientadas al usuario.

Integración

Paso 1: Conectar Building Blocks a Braze

Nota

Conectar Building Blocks a Braze es una configuración única. Una vez que tus credenciales se validen, Building Blocks las guardará para todas las sincronizaciones y envíos de plantillas futuros.

1. Inicia sesión en Building Blocks en blocks.copypastd.com, o selecciona Login en copypastd.com.
2. Desde el panel, selecciona Set up your Braze connection. (Esta opción aparece para los administradores en el primer inicio de sesión y hasta que se complete. También puedes acceder a la página desde Team Settings > Connect > Braze API Keys.)
3. Selecciona tu clúster de Braze en el menú desplegable. El endpoint REST correspondiente se completa automáticamente.
4. Pega tu clave de API de plantillas, tu clave de API de Content Blocks y (opcionalmente) tu clave de API de catálogos en los campos correspondientes.
5. Selecciona Validate and save. Building Blocks llama a Braze para confirmar que las claves funcionan y que los alcances de permisos son correctos. Si falta algo, un error en línea te muestra qué alcance es incorrecto.

Paso 2: Sincronizar tu biblioteca con Braze

1. Una vez que las claves se validen, selecciona Sync now en el modal de configuración. (También puedes volver a sincronizar en cualquier momento desde Settings > Connect > Braze > Sync library.)
   Building Blocks envía tu hoja de estilos y bloques a tu espacio de trabajo de Braze como Content Blocks de Braze. Aparecen en Braze con nombres que llevan el prefijo CP_ (por ejemplo, CP_Hero_1) o cp_ para hojas de estilos (por ejemplo, cp_default_style).
2. Una vez que la sincronización finalice, puedes enviar plantillas individuales desde el creador usando Push to Braze.

Personalizar Building Blocks

Paso 1: Configura tu hoja de estilos

1. En Building Blocks, ve a Settings > Build > Stylesheets.
2. Edita la hoja de estilos predeterminada o crea una nueva. Configura tu paleta de colores (24 colores con nombre), fuentes (compatible con Google Fonts), estilos de botón, estilos de enlace, radio y escala de relleno.
3. Selecciona Save. Building Blocks regenera el Liquid para cada bloque que utiliza esta hoja de estilos.
4. Selecciona Sync now para enviar los estilos actualizados a tu espacio de trabajo de Braze.

Paso 2: Habilita los endpoints de contenido conectado (opcional)

1. En Building Blocks, ve a Settings > Connect > Connected Content endpoints.
2. Agrega la URL del endpoint, asígnale un nombre y guárdalo. Building Blocks admite un formato de respuesta de Google Sheets, además del formato JSON estándar.
3. En el constructor, vincula cualquier campo de texto, imagen o enlace a una variable de contenido conectado desde el panel Personalize. El Liquid correcto {% connected_content %} se genera en la exportación.

Paso 3: Vincula a los catálogos de Braze (opcional)

1. En Building Blocks, ve a Settings > Connect > Catalogs. Building Blocks lee tu lista de catálogos usando la clave de API de catálogos.
2. Abre un bloque compatible (por ejemplo, una cuadrícula de productos).
3. Selecciona un catálogo y una selección, luego asigna los campos del bloque a los atributos de los elementos del catálogo.
4. Envía la plantilla. Building Blocks genera el Liquid correcto {% catalog_items %} y {% catalog_selection_items %} para que Braze lo resuelva en el momento del envío.

Paso 4: Agrega tus atributos personalizados de Braze (opcional)

Building Blocks incluye los atributos de usuario predeterminados de Braze (first_name, email, country, entre otros). Para vincular bloques a tus propios atributos personalizados, impórtalos a Building Blocks una vez y permanecerán disponibles en cada menú desplegable de Personalize.

1. En Building Blocks, ve a Team Settings > Connect > Custom Attributes.
2. Importa tus atributos personalizados usando uno de los siguientes métodos:
   • Importación masiva (recomendado). En Braze, ve a Data Settings > Custom Attributes y selecciona Export. Sube el CSV en Building Blocks.
   • Agregar atributos de uno en uno. Escribe el nombre del atributo (por ejemplo, loyalty_tier) y selecciona Add. Este método es útil si solo estás agregando algunos atributos o si deseas agregar un nuevo atributo entre exportaciones de Braze.

Después de guardar, tus atributos personalizados aparecen en el menú desplegable de Personalize del constructor junto con los predeterminados. Al insertar uno, se genera el Liquid correcto {{custom_attribute.${name}}} en la exportación, de modo que Braze resuelve el valor por destinatario en el momento del envío.

Usa la integración

Paso 1: Envía una plantilla a Braze

1. Abre cualquier correo electrónico en el creador de Building Blocks.
2. Selecciona Push to Braze en la barra de acciones.
3. Selecciona el espacio de trabajo y confirma. Building Blocks crea una plantilla de correo electrónico en Braze con el Liquid renderizado.

La plantilla aparece en Braze en Plantillas y medios > Plantillas de correo electrónico, con el nombre del correo electrónico y la fecha seleccionada en la configuración del correo electrónico.

Paso 2: Usa la plantilla en una Campaign o Canvas

1. En Braze, crea una nueva Campaign de correo electrónico o un paso en Canvas.
2. Selecciona Templates y elige la plantilla que Building Blocks envió.

La plantilla incluye cada referencia de Building Blocks (hoja de estilos, Content Blocks) como Liquid activo {{content_blocks.${...}}}, de modo que las actualizaciones en Building Blocks se propagan sin necesidad de volver a importar la plantilla.

Paso 3: Actualiza el contenido de forma centralizada

1. En Building Blocks, edita el bloque o la hoja de estilos correspondiente.
2. Selecciona Sync para enviar el Content Block actualizado de vuelta a Braze.

Cada correo electrónico en Braze que lo referencia (flujos permanentes, desencadenados o de bienvenida) recoge la nueva versión en el siguiente envío. No necesitas editar cada Campaign.

Paso 4: Crea grupos de contenido

Los grupos de contenido son tablas de filas de contenido que los correos electrónicos referencian en lugar de contener texto estático. Actualiza el grupo en Building Blocks y cada correo electrónico en Braze que lo utilice servirá el nuevo contenido en el siguiente envío. Usa grupos de contenido en cualquier lugar donde el mismo fragmento de contenido necesite mantenerse actualizado en muchos correos electrónicos, como boletines semanales, flujos de bienvenida, secuencias de recuperación, Campaigns de temporada o recorridos posteriores a la compra.

1. En Building Blocks, selecciona Content en la navegación principal.
2. Selecciona New Pool. Proporciona un nombre que describa lo que contiene (por ejemplo, Ofertas semanales, Catálogo de productos, Artículos de noticias).
3. Elige el tipo de bloque que alimenta el grupo (por ejemplo, Hero, Grid, Card). Esto define qué campos están disponibles en cada fila.
4. Añade filas. Cada fila es un fragmento de contenido. Completa los campos (titular, imagen, texto del CTA, enlace del CTA, etc.).
5. Establece el orden de prioridad arrastrando las filas hacia arriba o hacia abajo. Alterna cada fila entre activa e inactiva, y establece fechas opcionales de inicio y fin. En el momento del envío, gana la fila activa de mayor prioridad cuyas fechas sean válidas.
6. Haz clic en Save. Los bloques inteligentes ahora pueden referenciar este grupo.

Paso 5: Usa bloques inteligentes para renderizar contenido del grupo en tus correos electrónicos

Un bloque inteligente es un bloque en el lienzo del creador que referencia uno o más grupos de contenido en lugar de contener contenido estático. En el momento del envío, Braze renderiza la fila del grupo que tiene la mayor prioridad, está activa y tiene fechas válidas. El Liquid exportado hace el trabajo. No se necesita configuración adicional en Braze.

1. En Building Blocks, arrastra un bloque inteligente al lienzo (cualquier tipo de bloque que tenga un grupo coincidente).
2. En el panel de propiedades, abre el editor de cascada.
3. Añade uno o más grupos de contenido en orden de prioridad. Esta es la cascada: el primer grupo con una fila activa y con fechas válidas se renderiza. Si no tiene nada en vivo, el bloque inteligente pasa al siguiente grupo, y luego al siguiente. Un patrón común es Venta flash > Ofertas semanales > Favoritos permanentes, de modo que siempre haya algo disponible.
4. Envía la plantilla a Braze. El Liquid exportado incluye la cascada completa, por lo que Braze evalúa la prioridad del grupo y las fechas en cada envío.

A partir de ahora, actualizas el grupo, no el correo electrónico. Los flujos desencadenados, los boletines permanentes y las Campaigns de temporada se mantienen al día siempre que el grupo esté actualizado.

Encuentra tus plantillas de Building Blocks cargadas en Braze en Plantillas y medios > Plantillas de correo electrónico. Las hojas de estilos y los bloques sincronizados aparecen en Plantillas y medios > Content Blocks.

Consideraciones

• Una instancia de Braze por espacio de equipo de Building Blocks. Cada equipo de Building Blocks se conecta a una única instancia de Braze. Los clientes que gestionan múltiples espacios de trabajo (marcas, regiones o entornos separados) pueden añadirlos al mismo equipo, lo que permite compartir bloques.
• Los permisos de clave de API tienen alcances separados. Las claves de plantillas y las claves de Content Blocks se mantienen separadas. La validación falla rápidamente si a una clave le falta un alcance requerido, para que sepas exactamente qué permiso añadir en Braze.
• Los nombres de Content Blocks tienen espacio de nombres. Building Blocks envía Content Blocks con los prefijos CP_ (bloques) y cp_ (hojas de estilo) para evitar colisiones con Content Blocks creados directamente en Braze.
• Las ediciones de hojas de estilo actualizan todos los correos electrónicos. Las hojas de estilo se renderizan como un único Content Block de Braze referenciado por cada plantilla. Un cambio en Building Blocks actualiza todos los correos electrónicos en Braze que lo utilizan, incluidos los que ya están programados. Prueba los cambios de hojas de estilo en una plantilla borrador antes de sincronizar.
• La vinculación de catálogos es de solo lectura. Building Blocks lee los catálogos para rellenar la interfaz de vinculación. No escribe en los catálogos de Braze. Toda la gestión de catálogos sigue realizándose en el panel de Braze.
• Límites de velocidad y reintentos. Todas las solicitudes salientes respetan los límites de velocidad de Braze, con retirada exponencial, jitter y manejo de Retry-After. Se envía un encabezado User-Agent: partner-CopyPastd en cada llamada para la atribución del partner.
• No se transmiten datos de usuario. Building Blocks es una herramienta de creación de contenido. No envía atributos de usuario, eventos, compras ni datos de Segment a Braze, y no consume puntos de datos de Braze.

Solución de problemas

• La validación de la clave de API falla. Comprueba que cada clave tenga los permisos exactos indicados en los requisitos previos. Los alcances de plantillas y Content Blocks se verifican por separado. Si regeneras una clave en Braze, pega el nuevo valor en Building Blocks y vuelve a validar.
• El endpoint REST no coincide. Las claves de plantillas y Content Blocks deben provenir del mismo espacio de trabajo de Braze, y el endpoint REST debe coincidir con el clúster. El menú desplegable de Building Blocks lo configura automáticamente, así que verifica la selección de clúster si la validación falla.
• Push to Braze devuelve un error. Abre Settings > Build > Activity log para ver el último intento de sincronización y la respuesta que devolvió Braze. La mayoría de los fallos están relacionados con permisos (alcance faltante) o con cuotas (límite de velocidad, reintentado automáticamente).
• El bloque de contenido no se actualiza en Braze. Activa una resincronización manual desde Settings > Connect > Braze > Sync library. Building Blocks realiza una comparación e intercambio, por lo que los bloques sin cambios se omiten.
• La plantilla hace referencia a un bloque de contenido que aún no existe en Braze. Envía primero las dependencias (hoja de estilos, bloques inteligentes) usando Sync library y luego envía la plantilla.
• Para cualquier otra cosa. Contacta a Copy Pastd en [email protected]. Incluye el nombre de tu equipo y la hora de la acción fallida para que Copy Pastd pueda consultar el registro de actividad correspondiente.