Skip to content

Tipos de datos

Esta página consolida los tipos de datos compatibles con atributos personalizados, propiedades del evento y catálogos. Cada tipo de datos personalizado tiene un soporte y restricciones ligeramente diferentes.

Definiciones

Usa esta tabla para ver qué tipos de datos puedes utilizar para atributos del perfil de usuario, datos de eventos o elementos de catálogo. Consulta las secciones siguientes para conocer el uso y las restricciones de cada tipo.

Consideraciones importantes

  • Matriz: Los atributos personalizados y las propiedades del evento tienen límites de tamaño. Las fechas y horas no son compatibles dentro de matrices en las propiedades del evento. Los catálogos solo admiten matrices de cadenas, con un máximo de 100 elementos.
  • Objeto: En Braze, esto aparece como “atributos personalizados anidados” para atributos personalizados, “objetos anidados” para propiedades del evento y “objeto JSON” para catálogos.
  • Hora: En las propiedades del evento, este tipo se etiqueta como “Datetime”.

Tipos de datos de atributos personalizados

Los atributos personalizados admiten los tipos de datos enumerados en la tabla de Definiciones. A continuación se describe el uso y la segmentación para cada tipo de datos compatible.

Puedes bloquear atributos personalizados individualmente en el menú de acciones, o puedes seleccionar y bloquear hasta 100 atributos de forma masiva. Si bloqueas un atributo personalizado, no se recopilan datos sobre ese atributo, los datos existentes no están disponibles a menos que se reactive, y los atributos bloqueados no aparecen en filtros ni gráficos. Además, si el atributo está actualmente referenciado por filtros o desencadenantes en otras áreas del panel de Braze, aparece un modal de advertencia explicando que todas las instancias de los filtros o desencadenantes que lo referencian se eliminan y archivan.

Marcar como información de identificación personal (PII)

Los administradores también pueden crear atributos personalizados y marcarlos como PII desde esta página. Estos atributos solo son visibles para administradores y usuarios del dashboard con el permiso “View Custom Attributes Marked as PII”.

Añadir descripciones

Puedes añadir una descripción a un atributo personalizado después de crearlo si tienes el permiso de usuario Manage Events, Attributes, Purchases. Edita el atributo personalizado e introduce lo que desees, como una nota para tu equipo.

Añadir etiquetas

Puedes añadir etiquetas a un atributo personalizado después de crearlo si tienes el permiso de usuario “Manage Events, Attributes, Purchases”. Luego puedes usar las etiquetas para filtrar la lista de atributos.

Eliminar atributos personalizados

Hay dos formas de eliminar atributos personalizados de los perfiles de usuario:

Establecer el valor null

  • null elimina el atributo del perfil de usuario por completo. No aparece en el perfil ni coincide con ningún filtro IS NOT BLANK.
  • "" establece el atributo como un valor de cadena vacía. El atributo aparece en el perfil con un valor de cadena vacía, pero no coincide con los filtros IS NOT BLANK (se trata como vacío).

Además, "" solo es válido para atributos de tipo cadena. Si el tipo de datos del atributo está configurado como un tipo que no es cadena (como booleano, número u hora) en el dashboard, enviar "" no borra el valor; usa null en su lugar.

Exportar datos

Para exportar la lista de atributos personalizados como un archivo CSV, selecciona Export all en la parte superior de la página. El sistema genera un archivo CSV y te envía un enlace de descarga por correo electrónico.

Ver informes de uso

El informe de uso enumera todos los Canvas, Campaigns y Segments que utilizan un atributo personalizado específico. Esta lista no incluye usos de Liquid.

Puedes ver hasta 100 informes de uso a la vez seleccionando las casillas de verificación junto a los atributos personalizados correspondientes y luego seleccionando View usage report.

Pestaña de valores

Al ver un informe de uso, selecciona la pestaña Values para ver los valores principales de los atributos personalizados seleccionados basándose en una muestra de aproximadamente 250.000 usuarios. Ten en cuenta que, dado que los resultados se muestrean de un subconjunto de usuarios, la muestra no incluye todos los valores existentes. Esto significa que la pestaña Values no debe usarse para solución de problemas ni para casos de uso que requieran incorporar datos de todos los usuarios.

Informe de uso para atributos personalizados seleccionados con una pestaña "Values" abierta que muestra un gráfico circular de valores del atributo de país, como "US" y "PR".

Configurar atributos personalizados

A continuación se enumeran los métodos en varias plataformas que se utilizan para configurar atributos personalizados.

Expandir para ver la documentación por plataforma

Almacenamiento de atributos personalizados

Todos los datos almacenados en el perfil de usuario, incluidos los datos de atributos personalizados, se conservan indefinidamente mientras cada perfil esté activo.

Tipos de datos de atributos personalizados

Los atributos personalizados son herramientas extraordinariamente flexibles que permiten una gran capacidad de segmentación.

Los siguientes tipos de datos pueden almacenarse como atributos personalizados:

Booleanos (verdadero/falso)

Los atributos booleanos son útiles para almacenar datos binarios simples sobre tus usuarios, como estados de suscripción. Puedes encontrar usuarios que tienen explícitamente una variable establecida como verdadera o falsa, además de aquellos que aún no tienen ningún registro de ese atributo.

Para los atributos booleanos, están disponibles las siguientes opciones de segmentación.

Para los atributos numéricos, están disponibles las siguientes opciones de segmentación.

Detalles de atributos numéricos

  • Los filtros “Exactamente 0” y “Menor que” incluyen usuarios con campos NULL
    • Para excluir usuarios sin un valor para atributos personalizados, necesitas incluir el filtro is not blank.

Los atributos de cadena pueden tener hasta 255 caracteres de longitud. Ten en cuenta que si introduces valores con espacios entre, antes o después de las palabras, Braze también comprobará esos mismos espacios.

Para los atributos de cadena, están disponibles las siguientes opciones de segmentación.

Las matrices tienen un tamaño máximo de 100 KB. La longitud predeterminada de un atributo es de hasta 500 elementos (por ejemplo, si envías un atributo como “Películas vistas” configurado en 500, cuando un usuario vea una película número 501, la primera película se elimina y se añade la más reciente). Ten en cuenta que si introduces valores con espacios entre, antes o después de las palabras, Braze también comprobará esos mismos espacios.

Los atributos personalizados de tipo matriz no se pueden importar mediante importación CSV. Para cargar valores de matriz, usa el punto de conexión /users/track o la Ingesta de datos de Cloud.

Para los atributos de matriz, están disponibles las siguientes opciones de segmentación.

Los atributos de hora son útiles para almacenar la última vez que se realizó una acción específica, de modo que puedas ofrecer mensajería de reactivación de la interacción con contenido específico a tus usuarios.

Los filtros de hora que usan fechas relativas (por ejemplo, hace más de 1 día, hace menos de 2 días) miden 1 día como 24 horas. Cualquier Campaign que ejecutes usando estos filtros incluirá a todos los usuarios en incrementos de 24 horas. Por ejemplo, last used app more than 1 day ago capturará a todos los usuarios que “usaron la aplicación por última vez hace más de 24 horas” desde el momento exacto en que se ejecuta la Campaign. Lo mismo se aplica a Campaigns configuradas con rangos de fechas más largos, por lo que cinco días desde la activación significarán las 120 horas anteriores.

Para segmentar usuarios que tienen un atributo de hora dentro de un rango de tiempo, usa dos filtros de audiencia: in more than para el límite inferior e in less than para el límite superior. Un solo filtro no puede expresar ambos lados de ese rango. Por ejemplo, para segmentar usuarios con un atributo de hora en las próximas 24 horas (entre ahora y un día a partir de ahora), aplica in more than 0 days e in less than 1 day.

Para los atributos de hora, están disponibles las siguientes opciones de segmentación.

Detalles de atributos de hora

  • Día de evento recurrente
    • Al usar el filtro “Día de evento recurrente” y luego se te solicita seleccionar el “Día del calendario del evento recurrente”, si seleccionas IS LESS THAN o IS MORE THAN, la fecha actual se contará para ese filtro de segmentación.
    • Por ejemplo, si el 10 de marzo de 2020 seleccionaste la fecha del atributo como LESS THAN ... March 10, 2020, los atributos se considerarán para los días hasta e incluyendo el 10 de marzo de 2020.
  • Hace menos de X días: el filtro “Hace menos de X días” incluye fechas entre hace X días y la fecha/hora actual.
  • En menos de X días en el futuro: incluye fechas entre la fecha/hora actual y X días en el futuro.

Puedes usar atributos personalizados anidados para enviar objetos como tipo de datos para atributos personalizados. Para más información, consulta Atributos personalizados anidados.

Usa una matriz de objetos para agrupar atributos relacionados. Para más detalles, consulta Matriz de objetos.

Puedes cambiar el tipo de datos de tu atributo personalizado, pero debes tener en cuenta los impactos. Consulta Cambiar el tipo de datos de un atributo personalizado o evento para más información.

Operadores consolidados

Hemos consolidado la lista de operadores disponibles para usar en filtros de atributos, filtros de atributos personalizados y filtros de atributos personalizados anidados. Si tienes filtros existentes que usan estos operadores, se actualizarán automáticamente para usar los nuevos operadores.

Tipos de datos de propiedades del evento

Cuando registras un evento, puedes adjuntar información adicional (por ejemplo, nombre del producto o precio) como propiedades del evento. Cada propiedad tiene un nombre y un valor. Los valores de las propiedades del evento admiten los tipos de datos de la tabla de Definiciones (Hora se etiqueta como “Datetime” en las propiedades del evento).

Formato esperado

Los valores de las propiedades se envían como un objeto: las claves son los nombres de las propiedades y los valores son los valores de las propiedades. Los nombres de las propiedades deben ser cadenas no vacías, de 255 caracteres o menos, sin signos de dólar iniciales ($).

Reglas específicas de las propiedades del evento:

  • Hora (Datetime): Usa el formato ISO 8601 o yyyy-MM-dd'T'HH:mm:ss:SSSZ. No es compatible dentro de matrices.
  • Matriz: Las fechas y horas no son compatibles dentro de matrices.
  • Objeto anidado: Consulta Objetos anidados.
  • Carga útil: Los objetos de propiedades del evento que contienen valores de matriz u objeto pueden tener hasta 102.400 bytes (100 KiB).

Puedes cambiar el tipo de datos de tu propiedad de evento personalizado, pero ten en cuenta los impactos de cambiar los tipos de datos después de que se hayan recopilado datos.

Para conocer el comportamiento completo de las propiedades del evento, las claves reservadas y el uso en desencadenantes y personalización, consulta Propiedades de eventos personalizados.

Eventos de compra e ingresos

Los datos de compras e ingresos se registran a través de eventos de compra o eventos recomendados de comercio electrónico.

Registrar eventos de compra establece el valor de duración del ciclo de vida (LTV) para cada perfil de usuario, y estos datos se pueden ver en la página de ingresos en series temporales. Puedes segmentar por dinero gastado, fecha de última compra, número de compras en un período de tiempo y más.

Tipos de datos de propiedades de eventos de compra

Los valores de las propiedades de eventos de compra (el objeto properties en una compra) admiten los tipos de datos de la tabla de Definiciones, con la misma estructura y reglas de nomenclatura que las propiedades del evento.

The properties values must be an object up to 50 KB where the keys are the property names and the values are the property values. Property names must be strings, 255 characters or fewer, with no leading dollar signs ($).

Property values can be any of the following data types:

The following keys are reserved and cannot be used as property names: time, product_id, quantity, event_name, price, and currency. Using a reserved key in the properties object returns the error “Invalid ‘properties’ field”.

Para el esquema completo del objeto de compra y ejemplos, consulta Objeto de compra. Para registrar eventos de compra, filtros de segmentación y detalles completos, consulta Eventos de compra.

Cambiar el tipo de datos de un atributo personalizado o evento

Para cambiar el tipo de datos de un atributo personalizado o evento:

  1. Ve a Configuración de datos y selecciona Atributos personalizados o Eventos personalizados.
  2. Busca tu atributo o evento en la lista y selecciona Más acciones.
  3. Selecciona un nuevo Tipo de datos en el desplegable.
  4. Selecciona Guardar.

Si cambias el tipo de datos de un atributo personalizado o evento (por ejemplo, cambiar time a string), ten en cuenta lo siguiente:

  • Los filtros no se actualizan automáticamente. Los Segments, Campaigns, Canvas u otras ubicaciones que usen el atributo o evento modificado no se actualizan. Antes de cambiar el tipo de datos, detén cualquier Campaign o Canvas que use el atributo en Segments o filtros, y elimina el atributo de los filtros que lo referencian.
  • Los datos de usuario existentes no se actualizan retroactivamente. Si el atributo modificado estaba en un perfil de usuario antes del cambio, ese valor permanece con el tipo de datos anterior. Los usuarios pueden salir de Segments que contienen el atributo modificado porque el filtro busca el nuevo tipo de datos. Actualiza esos perfiles de usuario (por ejemplo, con el punto de conexión /users/track) para que coincidan con el nuevo tipo y vuelvan a entrar en el Segment si es necesario.
  • Los nuevos datos deben coincidir con el nuevo tipo. Las llamadas a la API que envíen el tipo de datos anterior para el atributo modificado no se aceptan. Envía el nuevo tipo de datos.

Tipos de datos de catálogos

Los catálogos admiten los tipos enumerados en la tabla de Definiciones. La siguiente tabla enumera cada tipo, cómo se puede crear o actualizar, y el formato y ejemplos.

Formato y ejemplos

Para crear y actualizar catálogos, consulta Crear un catálogo.
New Stuff!