Fuentes de Datos Externas
Incorporar datos dinámicos externos en html
Integrar fuentes de datos externas en plantillas de correo electrónico permite un contenido altamente personalizado y dinámico, mejorando el compromiso y la relevancia. Esta guía te guiará a través de la configuración de fuentes de datos externas y su utilización en tus plantillas de correo electrónico.
Las fuentes de datos externas proporcionan contenido dinámico a tus plantillas de correo electrónico extrayendo información de APIs externas. Esto es útil para:
Personalizar contenido basado en un feed externo
Mostrar datos en tiempo real como el estado de vuelos desde una API
Personalizar enlaces pasando parámetros y obteniendo enlaces finales a través de una herramienta externa
Crear una fuente de datos externa
Usando Fuentes de Datos Externas en Email
Una vez que su fuente de datos externa esté configurada correctamente, puede usar su salida en la plantilla de correo electrónico utilizando el lenguaje de plantillas liquid.
Uso de Fuente de Datos Externa para Alimentación de Contenido
Para mostrar una alimentación de contenido, puede crear una API que proporcione un JSON con muchos elementos de la alimentación de contenido. Como ejemplo, puede verse como a continuación:
El feed JSON anterior se puede usar como una URL de API al crear una fuente de datos externa.
Una vez creado, puede referirse a él en una plantilla de correo electrónico de la siguiente manera:
Primero agregue un elemento HTML y añada el siguiente código para obtener la fuente de datos externa por nombre, es decir, {% datafetch "external-data-source-name" %}
Usa la función for en liquid para obtener todos los elementos en su feed junto con la ruta, es decir, {% for <your-item> in dataFetchResponse.<your-json-path> %}.
Si solo tiene un elemento, esto puede no ser necesario.
Asumiendo que sample-data-feed es el nombre de la fuente de datos externa y feed.items es la ruta en el JSON del feed para obtener los elementos, se verá como a continuación:

Después de que esto se haya agregado, puede agregar cualquier elemento de imagen, texto, botón y referirse a la fuente de datos externa como a continuación, asumiendo la estructura de sample-data-feed:
{{item.title}} - Para mostrar el título en un elemento de texto
{{item.description}} - Para mostrar la descripción en un elemento de texto
{{item.link}} - Para agregar un enlace en un elemento de botón
{{item.thumbnail}} - Para agregar una URL de imagen en un elemento de imagen
Ahora agregue otro bloque HTML para finalizar la obtención de la fuente de datos externa y la función for como se muestra a continuación
Para previsualizar su correo electrónico, puede cambiar a vista previa y ver cómo se ve su feed de contenido.
Nota: Si tiene un feed estático, puede actualizarlo aquí manualmente seleccionando la fuente de datos externa en el menú desplegable Actualizar Fuente de Datos Externa.

Usar fuente de datos externa para personalizar URLs
También puede utilizar fuentes de datos externas junto con variables en la URL de la API. Esto ayuda a pasar cualquier parámetro a una API externa y devolver la respuesta para ser añadida a una plantilla de correo electrónico.
Por ejemplo, puede usar una URL de API como la siguiente pasando variables como se muestra a continuación:
https://api.bird.com/workspaces/?email={{email}}&referenceId={{referenceId}}&locale={{locale}}&name={{name}}

Para usar esta fuente de datos externa en una plantilla de correo electrónico, también debe proporcionar los valores de las variables en la etiqueta liquid:
Agregue el primer elemento html como {% datafetch "name", "variable1", "variable1 value", "variable2, "variable2 value" %}
En el ejemplo a continuación, la primera línea evita causar problemas cuando la dirección de correo electrónico tiene un signo +. La segunda línea realmente inicia el flujo de datos externo con las variables. Puede dar valores estáticos como "value" o puede proporcionar referencias de variables como contact.attributes.userId.
GenerateLink es el nombre de la fuente de datos externa anterior.
Para renderizar un enlace personalizado puede usar un elemento de botón con el enlace definido como {{dataFetchResponse.url}}, donde url contiene la respuesta de su API.

Después de esto, agregue el elemento html de cierre como se muestra a continuación: