Cree y rastree atributos de datos personalizados (CDAs) sobre sus users y leads, basados en criterios específicos para su negocio. Puede usar estos datos para filtrar y crear segmentos de clientes, y para enviar mensajes y campañas dirigidas. También puede usarlos como datos de calificación para calificar leads y trial users.
¿Qué es un atributo de datos personalizado?
Un atributo de datos personalizado (CDA) rastrea hechos sobre sus clientes — como el plan en el que alguien está, o cuándo se registró — a diferencia de un evento, que rastrea acciones recurrentes del cliente.
Aquí hay un ejemplo: Si su producto es una herramienta de gestión de proyectos, podría rastrear datos sobre la cantidad de archivos que cada user tiene. Luego, si desea enviar mensajes a users que no han comenzado a agregar archivos a la herramienta y podrían necesitar ayuda para incorporarse, podría configurar un mensaje dirigido a users con "files less than 1".
Los CDAs más comunes configurados en Intercom son sobre desarrollo del cliente, tales como:
Plan de precios
Valor de las compras
Número de compañeros añadidos
Número de canciones reproducidas
Fecha de finalización de la suscripción
Importante:
El valor signed_up debe enviarse a Intercom a través de su integración. Este valor indica el momento en que un user se registró en su servicio.
Puede elegir actualizar el valor mediante:
enviándonos el parámetro
created_attimestamp en el fragmento intercomSettings.estableciendo el valor para
signed_up_atsi está usando nuestro REST API.usando una importación CSV, asignando una de las columnas importadas como fecha de registro.
Intercom establecerá automáticamente el valor para la fecha signed_up solo en los siguientes casos:
SDKs (Android/iOS) y users no identificados
users creados a través del fragmento JS sin valor
created_at
En esos casos, los users tendrán la hora de registro establecida en el momento de la solicitud de creación. En todos los demás casos, el valor debe ser establecido por usted.
Crear atributos de datos personalizados
Para crear un nuevo atributo en Intercom, vaya a Configuración > Datos > Personas y haga clic en + Crear atributo. Dé un nombre a su nuevo atributo, una descripción y seleccione el tipo de datos que almacenará.
Prevenir actualizaciones de atributos vía Messenger
Si "Attribute Updates" está habilitado, entonces las actualizaciones a este atributo solo serán aceptadas si provienen de una solicitud autenticada (a través de REST API o JSON web token en Messenger). Las solicitudes no autenticadas serán ignoradas.
Esta configuración puede activarse o desactivarse para cada atributo y no afecta las actualizaciones desde otras fuentes como nuestra Public API, importaciones CSV, etc. Todos los atributos que no tengan esto habilitado estarán abiertos a actualizaciones inseguras.
Nota:
Recomendamos que active "Attribute Updates" para evitar actualizaciones no autorizadas a sus datos. Luego puede configurar Seguridad en Messenger con JWTs para permitir que esos campos se actualicen de forma segura vía Messenger.
Los atributos solo están protegidos contra actualizaciones inseguras vía Messenger si la configuración está activada para cada atributo individual.
Las actualizaciones de atributos vía Messenger solo se procesarán si la solicitud está autenticada con JWT. El uso del método legado de Verificación de Identidad (User hash) no funcionará y no se procesará ninguna actualización para solicitudes que intenten actualizar atributos protegidos que incluyan user_hash en lugar de JWTs.
Haga clic en guardar y el atributo se añadirá a su lista de atributos. Aún no se poblará para ninguno de sus clientes, deberá enviarlo a Intercom a través del fragmento JavaScript, la API o una app de nuestra tienda de aplicaciones. 👌
Si necesita cambiar el formato o la descripción del atributo que acaba de crear, puede editarlo y hacer el cambio:
Importante: El nombre del atributo de datos personalizado no puede cambiarse después de creado. Deberá archivar el atributo existente y crear uno nuevo.
Actualizar atributos personalizados vía Messenger
Los atributos de datos personalizados pueden actualizarse usando el fragmento de código Javascript del Messenger.
Al actualizar atributos personalizados vía Messenger, verifique que sus claves siempre tengan un valor JSON válido que sea una cadena (texto), número o booleano (true o false). Eso significa usar comillas dobles alrededor de cadenas de texto y enviar NULL para casos en que no exista un valor para un user.
También puede enviarnos fechas o URLs. Puede rastrear URLs como una cadena de texto, por ejemplo "http://www.google.com". Intercom reconocerá esto y automáticamente lo convertirá en un hipervínculo. Rastree fechas enviándonos un timestamp unix en segundos. Si crea un nombre de clave que termine con “_at” lo trataremos automáticamente como una fecha en lugar de un número (vea "last_order_at" abajo). Descubra cómo funcionan las fechas en Intercom aquí.
Importante: Asegúrese de que está enviando UNIX en segundos y no en milisegundos.
Aquí hay algunos ejemplos de pares clave y valor de atributos de datos:
window.intercomSettings = {
email: "bob@example.com",
user_id: "123",
app_id: "abc1234",
created_at: 1234567890,
"subdomain": "intercom", // Put quotes around text strings
"teammates": 4, // Send numbers without quotes
"active_accounts": 12,
"last_order_at" : 1350466020, // Send dates in unix timestamp format and end key names with "_at"
"custom_domain": null // Send null when no value exists for a user
}
Importante: No use un objeto anidado custom_attributes: {} al pasar CDAs vía el fragmento JS del Messenger. Este formato (por ejemplo custom_attributes: { lead_source: "Intercom" }) solo es válido para el REST API. Cuando se pasa vía window.intercomSettings o window.Intercom("boot", ...), el Messenger descartará silenciosamente estos valores y no se actualizarán en el backend. Siempre pase los CDAs como claves de nivel superior directamente en el objeto de configuración, como se muestra en el ejemplo anterior. El atributo también debe existir ya en Intercom antes de que se acepte cualquier valor vía Messenger.
Diferentes tipos de CDAs que puede enviar a Intercom
Cadena (es decir, palabras) Ej. URLs, nombre del plan, tipo de user, etc.
Número (entero)
Booleano (true / false)
Marca de tiempo (la fecha y hora en que ocurre algo) por ejemplo "converted_at"
Cosas para recordar:
Los nombres de clave distinguen mayúsculas y minúsculas, y no pueden contener puntos ('.'), signos de dólar ('$'), caracteres como ~`!@#%^&*'{}[]|\'" o el carácter NULL. — Si se usa un carácter no soportado, el atributo se creará con un guion bajo en su lugar.
Los valores de datos deben enviarse como cadenas JSON, números o booleanos (true o false). No podemos aceptar objetos, hashes anidados ni formatos de datos en arrays.
Los valores de cadenas de texto solo pueden contener hasta 255 caracteres. Esto aplica solo a atributos personalizados y no a atributos de datos de conversación.
Puede borrar los valores de datos existentes enviando cadenas vacías.
Intercom rastrea automáticamente una serie de atributos estándar. Revise estos antes de crear atributos personalizados.
El límite suave es de 250 CDAs activos.
Los valores numéricos no pueden comenzar con un "0". Los enteros son números enteros, así que "01234" debe ingresarse como "1234". Si necesita recopilar una cadena de números, como un código postal estatal que incluye un "0" al inicio, entonces debe usar un atributo de cadena.
Atributo de "Nombre del Plan" de la empresa: Intercom incluye un atributo del sistema incorporado llamado "Nombre del Plan" para empresas. No aparece en Configuración pero sí en la barra lateral de la conversación. Si crea un atributo personalizado para la empresa con el mismo nombre, ambos se mostrarán en la barra lateral, causando una aparente duplicación. Use un nombre distinto (por ejemplo, "Plan de Suscripción") para evitar esto.
Una vez que haya actualizado su fragmento de código y comenzado a rastrear los datos, debe:
Activar la verificación de identidad para sus users.
Crear descripciones para cada atributo para ayudar a sus compañeros a entenderlos.
Importante: Recibimos nuestros datos de geolocalización basados en la dirección IP del User desde un servicio externo llamado Maxmind. No tenemos control sobre estos datos y no es posible actualizarlos a través de la API, pero puede elegir presentar una solicitud de corrección de datos a través de esta página si cree que son incorrectos.
Además, es posible que estos users estén usando una VPN o que estén viajando en este momento, lo que explicaría por qué la ubicación aparece incorrecta.
Con respecto al atributo "region": para Estados Unidos, "region" se refiere a Estado. En otros países puede variar; por ejemplo, en Canadá "region" se refiere a Provincia.
Puede ver una lista de todos los valores de región y sus abreviaturas aquí.
Otros métodos
También es posible rastrear y actualizar atributos personalizados sobre sus users, con importaciones CSV, el REST API de Intercom, o muchas aplicaciones de terceros.
Importante: Los atributos de datos personalizados deben crearse en Intercom antes de que cualquier integración o aplicación de terceros pueda actualizar sus valores. Las integraciones y el REST API solo pueden actualizar los valores de atributos existentes; no pueden crear nuevas definiciones de atributos. Para agregar un nuevo atributo, vaya a Configuración > Datos > Personas y créelo manualmente primero.
¿Qué son los datos de calificación personalizados?
Los datos de calificación son un conjunto especial de atributos que puede actualizar manualmente en los perfiles de sus clientes a medida que los califica. Puede configurarlos mediante un formulario simple en Intercom. Si tiene la intención de actualizar estos datos manualmente, no necesita hacer nada más.
Si desea rastrear estos datos mediante un ping, debe agregar los pares clave/valor a su fragmento de código intercomSettings, tal como lo haría con otros datos personalizados.
Para crear nuevos datos de calificación personalizados, vaya a Configuración > Datos > Personas > Calificación de leads.
Desplácese hacia abajo y haga clic en Agregar datos y luego en + Crear nuevos datos en el menú desplegable.
Aquí puede crear un nombre (que es su clave) y elegir un formato para los valores que recopilará (Texto, Número, True o False, o Lista).
Si elige el formato Lista, no es una estructura de array sino una lista de selecciones donde los valores están predeterminados.
Nota: Es posible establecer el valor de un atributo de lista a un valor que no haya configurado manualmente para la lista usando nuestro REST API. Sin embargo, este valor no se agregará como una opción permanente para esa lista al cambiar el valor manualmente y puede perderse si un compañero cambia manualmente este valor.
Finalmente, puede agregar una descripción para ayudar a sus compañeros a entender los datos.
Elija nombres simples para sus datos de calificación personalizados. Si decide calificar estos datos vía Messenger, los clientes verán estos nombres en el Messenger.
Importante: Los atributos desplegables seleccionables manualmente (lista) en Datos de Personas están limitados a 35 opciones por atributo. Este límite no puede levantarse. Si necesita más de 35 valores, use un atributo de texto y establezca valores vía REST API.
Archivar atributos de datos
Los atributos de datos personalizados no pueden eliminarse completamente, pero puede archivarlos. Los datos archivados no aparecerán como filtro en sus listas de users o leads, por lo que es una buena forma de limpiar datos que no necesita.
Vaya a Configuración > Datos > Personas.
Elija un dato que desee archivar. Haga clic en el icono de editar junto a él y luego haga clic en Archivar en la ventana emergente. Puede desarchivarlos si cambia de opinión, pero no puede eliminar completamente los atributos de datos personalizados.
Para encontrar sus atributos personalizados archivados, simplemente desplácese hasta el final de la página.
Si desea desarchivar su atributo personalizado, abra el atributo y haga clic en "Desarchivar".
Comprender los límites y mejores prácticas de los CDAs
Los atributos de datos personalizados (CDAs) tienen límites en el espacio de trabajo para mantener un rendimiento óptimo.
Hay un límite de 250 CDAs de Personas y Empresas por espacio de trabajo, pero puede archivar atributos no usados para liberar espacio.
Al crear nuevos atributos, considere estas mejores prácticas:
Cree atributos que tengan una aplicación amplia entre los users.
Evite crear atributos para situaciones puntuales.
Considere usar Eventos como alternativa para escenarios específicos.
Utilice etiquetas cuando sea apropiado, ya que no tienen las mismas limitaciones.
Revise regularmente el uso de sus CDAs para asegurar una gestión eficiente del espacio de trabajo. Si necesita mayor capacidad después de implementar estrategias de optimización, pueden estar disponibles aumentos adicionales de límite bajo solicitud.
Nota: Si está enviando datos sobre sus users vía Messenger, recomendamos encarecidamente asegurar su Messenger. Vea más:
Preguntas frecuentes
¿Cómo se llena el atributo 'Country' y qué tan rápido se actualiza para usarse en workflows?
¿Cómo se llena el atributo 'Country' y qué tan rápido se actualiza para usarse en workflows?
El atributo 'Country' se llena y actualiza automáticamente basado en la dirección IP del user. Esto sucede instantáneamente cada vez que un user está activo en su app o interactúa con el Messenger. Debido a que los datos están disponibles en tiempo real, puede usarlos para ramificar inmediatamente un workflow tan pronto como un user inicia una conversación.
¿Se puede editar manualmente el atributo 'Country'?
¿Se puede editar manualmente el atributo 'Country'?
No, el atributo 'Country' es un campo generado por el sistema y no puede editarse manualmente. Si necesita un campo de país que pueda ser actualizado manualmente por un user o un administrador, debe crear un atributo personalizado para este propósito.
¿Por qué fallan mis actualizaciones API a un atributo personalizado cuando uso la integración Jira?
¿Por qué fallan mis actualizaciones API a un atributo personalizado cuando uso la integración Jira?
Las actualizaciones API a atributos personalizados pueden fallar silenciosamente si un atributo personalizado comparte el mismo nombre que un atributo Jira. Cuando existen nombres duplicados, las solicitudes de actualización API se dirigen al atributo Jira en lugar de su atributo personalizado, y las actualizaciones a atributos Jira están bloqueadas, causando que la solicitud falle.
Para solucionar esto, cambie el nombre de su atributo personalizado para que no duplique ningún nombre de atributo Jira. Tenga en cuenta que los nombres de atributos personalizados no pueden cambiarse después de la creación, por lo que deberá archivar el atributo existente y crear uno nuevo con un nombre único.