Reach

Grow

Manage

Automate

Reach

Grow

Manage

Automate

G

G

M

M

Fuentes de Datos Externas

Incorporar datos dinámicos externos en html

Descripción general

Descripción general

Descripción general

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

  • Navega a la aplicación de Marketing y haz clic en Contenido

  • En Contenido, haz clic en Fuentes de datos externas > Crear fuente de datos externa


  • Puedes darle un nombre. Este debe ser una cadena continua sin espacios

  • Proporciona el enlace para tu API

  • Define si deseas que el contenido se actualice dinámicamente o deseas actualizar manualmente una vez añadido al correo electrónico y luego no deseas que se actualice.

  • Puedes elegir no tener autenticación o definir el tipo de autenticación y también añadir cualquier encabezado


  • Una vez que hagas clic en Guardar configuración, se crea la fuente de datos externa

  • Una vez creada, puedes probar tu configuración para ver qué salida obtienes haciendo clic en Probar configuración como se muestra a continuación.

  • Navega a la aplicación de Marketing y haz clic en Contenido

  • En Contenido, haz clic en Fuentes de datos externas > Crear fuente de datos externa


  • Puedes darle un nombre. Este debe ser una cadena continua sin espacios

  • Proporciona el enlace para tu API

  • Define si deseas que el contenido se actualice dinámicamente o deseas actualizar manualmente una vez añadido al correo electrónico y luego no deseas que se actualice.

  • Puedes elegir no tener autenticación o definir el tipo de autenticación y también añadir cualquier encabezado


  • Una vez que hagas clic en Guardar configuración, se crea la fuente de datos externa

  • Una vez creada, puedes probar tu configuración para ver qué salida obtienes haciendo clic en Probar configuración como se muestra a continuación.

  • Navega a la aplicación de Marketing y haz clic en Contenido

  • En Contenido, haz clic en Fuentes de datos externas > Crear fuente de datos externa


  • Puedes darle un nombre. Este debe ser una cadena continua sin espacios

  • Proporciona el enlace para tu API

  • Define si deseas que el contenido se actualice dinámicamente o deseas actualizar manualmente una vez añadido al correo electrónico y luego no deseas que se actualice.

  • Puedes elegir no tener autenticación o definir el tipo de autenticación y también añadir cualquier encabezado


  • Una vez que hagas clic en Guardar configuración, se crea la fuente de datos externa

  • Una vez creada, puedes probar tu configuración para ver qué salida obtienes haciendo clic en Probar configuración como se muestra a continuación.

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:

{
  "feed": {
    "version": "1.0",
    "title": "sample-data-feed",
    "items": [
      {
        "title": "Meet the Full Cast",
        "link": "https://bird.com/article",
        "description": "See who's joining previously announced stars Katie Brayben and Christian Borle in the Elton John-Jake Shears-James Graham musical.",
        "thumbnail": "https://assets.bird.com.jpg",
        "date": "2024-08-28T11:21:00",
        "creator": "Joe Black"
      },
      {
        "title": "Stars in ASL American",
        "link": "https://bird.com/article",
        "description": "Center Theatre Group is teaming up with Deaf West Theatre to reopen the Mark Taper Forum with a new production of the Green Day musical after bringing revivals of Big River and Spring Awakening to Broadway.",
        "thumbnail": "https://assets.bird.com.jpg",
        "date": "2024-08-28T11:59:00",
        "creator": "Joe Black"
      }
    ]
  }
}

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:

  1. 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" %}

  2. 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:

{% datafetch "sample-data-feed" %}
{% for item in dataFetchResponse.feed.items %}



  • 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

{% endfor %}
{% enddatafetch %}

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.

{%- assign email_for_datafetch = contact.attributes.email_address | url_encode -%}
{% datafetch "GenerateLink","email", email_for_datafetch,"referenceId", contact.attributes.userId, "locale", contact.attributes.locales[0],"name", contact.attributes.name %}

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:

{% enddatafetch %}

Conectémosle con un experto de Bird.
Vea el poder completo del Bird en 30 minutos.

Al enviar, aceptas que Bird pueda contactarte sobre nuestros productos y servicios.

Puedes darte de baja en cualquier momento. Consulta el Aviso de Privacidad de Bird para obtener detalles sobre el procesamiento de datos.

Company

Newsletter

Mantente al día con Bird a través de actualizaciones semanales en tu buzón.

Conectémosle con un experto de Bird.
Vea el poder completo del Bird en 30 minutos.

Al enviar, aceptas que Bird pueda contactarte sobre nuestros productos y servicios.

Puedes darte de baja en cualquier momento. Consulta el Aviso de Privacidad de Bird para obtener detalles sobre el procesamiento de datos.

Company

Newsletter

Mantente al día con Bird a través de actualizaciones semanales en tu buzón.

Conectémosle con un experto de Bird.
Vea el poder completo del Bird en 30 minutos.

Al enviar, aceptas que Bird pueda contactarte sobre nuestros productos y servicios.

Puedes darte de baja en cualquier momento. Consulta el Aviso de Privacidad de Bird para obtener detalles sobre el procesamiento de datos.

R

Reach

G

Grow

M

Manage

A

Automate

Company

Newsletter

Mantente al día con Bird a través de actualizaciones semanales en tu buzón.