Campos personalizados

Los campos personalizados guardan datos adicionales en cada contacto, como el nombre de la empresa, un plan o un cumpleaños. Defines los campos una vez para el espacio de trabajo y después los rellenas en los contactos y los usas para filtrar contactos, personalizar campañas e iniciar automatizaciones.

Tipos de campo

Cada campo tiene un nombre, que muestra el panel, y una clave, que usan la API, las importaciones, los filtros y las etiquetas de combinación. Los valores se guardan en el contacto como un objeto JSON indexado por la clave del campo:

{
  "company": "Acme",
  "plan": "pro",
  "birthday": "1990-04-12",
  "interests": ["news", "offers"]
}

Crear un campo personalizado

1. Abre Custom fields. Ve a Workspace›Settings›Custom fields y selecciona Add custom field.

2. Ponle nombre al campo. Introduce un Name, por ejemplo Company size. Emailit genera la clave automáticamente a partir del nombre: en minúsculas y con cada secuencia de otros caracteres sustituida por _, así que Company size pasa a ser company_size.

   Para elegir tú la clave, selecciona Show advanced options y edita Key. Las claves siempre se guardan en ese formato de minúsculas y guiones bajos, y cada clave solo puede existir una vez por espacio de trabajo.

3. Elige el tipo. Elige Text, Number, Date, Boolean, Select o Multi select.

4. Añade opciones a los campos de selección. Para Select y Multi select, introduce al menos una opción y usa Add option para añadir más. Estos valores aparecen en el desplegable de los contactos.

5. Guarda. Selecciona Create. El campo aparece en todos los contactos, en los filtros de contactos y como etiqueta de combinación en los editores de campañas.

La página Custom fields enumera todos los campos con su nombre, su tipo y sus opciones. Usa Edit para cambiar el nombre de un campo, su tipo o su clave, o para editar sus opciones.

Establecer los valores

Con la API, pasa custom_fields a Crear un contacto o a Actualizar un contacto:

curl https://api.emailit.com/v2/contacts/ada@example.com \
  -X POST \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "custom_fields": {
      "company": "Acme",
      "plan": "pro",
      "birthday": "1990-04-12",
      "interests": ["news", "offers"]
    }
  }'

Reglas que debes conocer:

• custom_fields sustituye todo el objeto. Al actualizar, incluye todos los valores que quieras conservar, no solo los que cambian.
• Usa las claves de los campos, no sus nombres. Los valores de claves que no están definidas en Custom fields se guardan, pero no aparecen en el panel.
• Las fechas deben tener el formato YYYY-MM-DD. Emailit convierte en fecha las fechas y horas ISO y las celdas de fecha de Excel. Cualquier otra cosa devuelve 400 con «Custom field “Birthday” must be a date in YYYY-MM-DD format». Las fechas no tienen hora ni zona horaria.
• Los valores de selección no se comprueban con las opciones. Un valor que no está en la lista de opciones se guarda igualmente, y el panel lo sigue mostrando.

Filtrar los contactos por un campo personalizado

En el panel, abre Email Marketing›Contacts, selecciona Filter y elige el campo personalizado por su nombre. Los filtros de campos personalizados comparan el valor guardado como texto, así que usa equals, does not equal, contains, does not contain, starts with, ends with, is empty o is not empty.

Con la API, usa custom_fields.<key>.<condition> en Listar contactos y Exportar contactos, con las mismas condiciones de texto (exact, not_exact, contains, not_contains, starts_with, ends_with, empty, not_empty):

curl "https://api.emailit.com/v2/contacts?custom_fields.plan.exact=pro&custom_fields.company.contains=acme" \
  -H "Authorization: Bearer $EMAILIT_API_KEY"

Para un rango, como los cumpleaños de los años noventa, usa los parámetros filter[custom_fields.<key>][gte] y [lte]. Comparan el texto guardado, que se ordena correctamente en las fechas YYYY-MM-DD:

curl -G "https://api.emailit.com/v2/contacts" \
  --data-urlencode "filter[custom_fields.birthday][gte]=1990-01-01" \
  --data-urlencode "filter[custom_fields.birthday][lte]=1999-12-31" \
  -H "Authorization: Bearer $EMAILIT_API_KEY"

Consulta Filtrado y ordenación para ver cómo se combinan los filtros.

Usar los campos personalizados en las campañas

En el contenido y el asunto de una campaña, inserta un campo personalizado con la etiqueta de combinación {{cf.<key>}}, por ejemplo {{cf.company}}. Los editores de texto enriquecido y Dragit muestran tus campos personalizados entre sus variables, así que no tienes que escribir la clave.

<p>Hi {{first_name}}, here's what's new for {{cf.company}}.</p>

Si un contacto no tiene valor, la etiqueta se sustituye por nada. Los valores de selección múltiple se muestran como una lista separada por comas. Consulta Etiquetas de combinación.

Usar los campos personalizados en las automatizaciones

• Disparador Date anniversary. Elige un campo Date para iniciar una ejecución cada año en el mes y el día que guarda, por ejemplo un cumpleaños. Consulta Disparadores de las automatizaciones.
• Disparador Contact updated. Filtra por un campo personalizado, o por su valor anterior, para reaccionar cuando cambie.
• Paso Condition. Crea ramas según el valor de un campo personalizado.
• Paso Edit contact. Establece un campo personalizado introduciendo su clave.

Referencia de la API

Las definiciones de los campos personalizados solo se gestionan en el panel. Los valores de los contactos usan el objeto custom_fields de la API de contactos, y el mismo objeto se acepta al añadir un suscriptor a una lista de contactos.

Ver también