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.

• booleano
• números
• cadenas
• matrices
• hora
• objetos
• matrices de objetos

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 panel 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:

• Selecciona el nombre del atributo personalizado a eliminar en un paso de Actualización de usuario.
• Establece el valor null en tu solicitud de API al endpoint /users/track.

Establecer el valor null

Importante

Establecer un atributo como null y establecerlo como "" (cadena vacía) no es lo mismo.

• 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 panel, 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 los usos de Liquid.

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

Pestaña de valores

Al ver un informe de uso, selecciona la pestaña Values para ver los principales valores de los atributos personalizados seleccionados en función de una muestra de aproximadamente 250,000 usuarios. Ten en cuenta que, como 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 la solución de problemas ni para casos de uso que requieran incorporar datos de todos los usuarios.

Configurar atributos personalizados

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

Expande para ver la documentación por plataforma

• Android y FireOS
• iOS
• Web
• React Native
• Unity
• .NET MAUI (anteriormente Xamarin)
• Roku

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
• Números
• Cadenas
• Matrices
• Hora
• Objetos
• Matrices de objetos

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 explícitamente tienen una variable configurada en un valor verdadero o falso, 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.

Opciones de segmentación	Filtro desplegable	Opciones de entrada	Ejemplos
Comprobar si el valor booleano es verdadero, falso, verdadero o no configurado, o falso o no configurado	IS	TRUE, FALSE, TRUE OR NOT SET, o FALSE OR NOT SET	Si este filtro especifica coffee_drinker, un usuario coincidirá con este filtro en las siguientes circunstancias: Si este filtro es true y el usuario tiene el valor coffee_drinker Si este filtro es false y el usuario no tiene el valor coffee_drinker Si este filtro es true or not set y el usuario tiene el valor coffee_drinker o no tiene ningún valor Si este filtro es false or not set y el usuario no tiene coffee_drinker ni ningún valor
Comprobar si el valor booleano existe en el perfil de un usuario y no es null	IS NOT BLANK	N/A	Si este filtro especifica coffee_drinker y un usuario tiene un valor para el atributo coffee_drinker, el usuario coincidirá con este filtro.
Comprobar si el valor booleano no existe en el perfil de un usuario o es null	IS BLANK	N/A	Si este filtro especifica coffee_drinker y un usuario no tiene el atributo coffee_drinker o el valor de coffee_drinker es null, el usuario coincidirá con este filtro.

Consejo

El dinero gastado no debe registrarse con este método. Más bien debe registrarse a través de eventos de compra.

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

Opciones de segmentación	Filtro desplegable	Opciones de entrada	Ejemplos
Comprobar si el atributo numérico es exactamente un número	EXACTLY	NUMBER	Si este filtro especifica 10 y un perfil de usuario tiene el valor 10, el usuario coincidirá con este filtro.
Comprobar si el atributo numérico no es igual a un número	DOES NOT EQUAL	NUMBER	Si este filtro especifica 10 y un perfil de usuario no tiene el valor 10, el usuario coincidirá con este filtro.
Comprobar si el atributo numérico es mayor que un número	MORE THAN	NUMBER	Si este filtro especifica 10 y un perfil de usuario tiene un valor mayor que 10, el usuario coincidirá con este filtro.
Comprobar si el atributo numérico es menor que un número	LESS THAN	NUMBER	Si este filtro especifica 10 y un perfil de usuario tiene un valor menor que 10, el usuario coincidirá con este filtro.
Comprobar si el atributo numérico existe en el perfil de un usuario y no es null	IS NOT BLANK	N/A	Si un perfil de usuario contiene el atributo numérico especificado, independientemente del valor, el usuario coincidirá con este filtro.
Comprobar si el atributo numérico no existe en el perfil de un usuario o es null	IS BLANK	N/A	Si un perfil de usuario no contiene el atributo numérico especificado o el valor del atributo es null, el usuario coincidirá con este filtro.

Detalles de atributos numéricos

• Los filtros “Exactamente 0” y “Menos que” incluyen usuarios con campos NULL.
  • Para excluir usuarios sin un valor para atributos personalizados, debes 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 verificará esos mismos espacios.

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

Opciones de segmentación	Filtro desplegable	Opciones de entrada	Ejemplos
Comprobar si el atributo de cadena coincide parcialmente con una cadena introducida O una expresión regular	MATCHES REGEX	STRING O REGULAR EXPRESSION No distingue entre mayúsculas y minúsculas; máximo de 32,764 caracteres
Comprobar si el atributo de cadena no coincide parcialmente con una cadena introducida O una expresión regular	DOES NOT MATCH REGEX *	STRING O REGULAR EXPRESSION No distingue entre mayúsculas y minúsculas; máximo de 32,764 caracteres
Comprobar si el atributo de cadena existe en el perfil de un usuario y no es una cadena vacía	IS NOT BLANK	N/A	Si este filtro especifica favorite_genre y un perfil de usuario tiene el atributo favorite_genre, el usuario coincidirá con este filtro independientemente del valor de su atributo. Por ejemplo, el usuario puede tener sci-fi, romance u otro valor.
Comprobar si el atributo de cadena no existe en el perfil de un usuario	BLANK	N/A	Si este filtro especifica favorite_genre y un perfil de usuario no tiene el atributo favorite_genre, el usuario coincidirá con este filtro.
Comprobar si la cadena coincide exactamente con cualquiera de las cadenas introducidas	IS ANY OF	STRING Distingue entre mayúsculas y minúsculas; se permiten múltiples cadenas (máximo de 256)	Si este filtro especifica book, bookmark y reading light, y un perfil de usuario tiene al menos una de esas cadenas, el usuario coincidirá con este filtro.
Comprobar si el atributo de cadena no coincide exactamente con ninguna de las cadenas introducidas	IS NONE OF	STRING Distingue entre mayúsculas y minúsculas; se permiten múltiples cadenas (máximo de 256)	Si este filtro especifica book, bookmark y reading light, y un perfil de usuario no contiene ninguna de esas cadenas, el usuario coincidirá con el filtro.
Comprobar si el atributo de cadena coincide parcialmente con cualquiera de las cadenas introducidas	CONTAINS ANY OF	STRING Distingue entre mayúsculas y minúsculas; se permiten múltiples cadenas (máximo de 256)	Si este filtro especifica gold y un perfil de usuario contiene gold en cualquier cadena, como gold_tier o former_gold_tier, el usuario coincidirá con el filtro.
Comprobar si el atributo de cadena no coincide parcialmente con ninguna de las cadenas introducidas	DOESN’T CONTAIN ANY OF	STRING Distingue entre mayúsculas y minúsculas; se permiten múltiples cadenas (máximo de 256)	Si este filtro especifica gold y un perfil de usuario no contiene gold en ninguna cadena, el usuario coincidirá con este filtro.

Nota

Una cadena de fecha como “12-1-2021” o “12/1/2021” se convertirá en un objeto datetime y se tratará como un atributo de hora.

Importante

Al segmentar con el filtro DOES NOT MATCH REGEX, ya debes tener un atributo personalizado con un valor asignado en ese perfil de usuario. Braze sugiere usar la lógica “OR” para verificar si un atributo personalizado está en blanco a fin de asegurar que los usuarios sean segmentados correctamente.

Matrices

Las matrices tienen un tamaño máximo de 100 KB. La longitud predeterminada para un atributo es de hasta 500 elementos (por ejemplo, si envías un atributo como “Películas vistas” configurado a 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 verificará esos mismos espacios.

Los atributos personalizados de tipo matriz no pueden importarse mediante importación CSV. Para cargar valores de matriz, usa el endpoint /users/track o la ingesta de datos en la nube.

Nota

La opción de aumentar la longitud máxima no estará disponible si el atributo está configurado para detectar automáticamente el tipo de datos; el tipo de datos debe estar configurado como matriz.

Solución de problemas: el atributo personalizado de matriz no muestra ningún valor en el perfil de usuario

Si un atributo personalizado de matriz aparece en un perfil de usuario pero no muestra valores, verifica si la longitud máxima del atributo está configurada en 0 en el panel.

1. Ve a Data Settings > Custom Attributes.
2. Filtra la lista por Array.
3. Encuentra el atributo y revisa su Max Length.
4. Si Max Length es 0, actualízalo a un valor mayor que 0.

Configurar Max Length en 0 impide que los valores se muestren en el perfil de usuario.

Para ver ejemplos de comportamiento de matrices orientados al SDK, consulta Resumen de análisis.

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

Opciones de segmentación	Filtro desplegable	Opciones de entrada	Ejemplos
Comprobar si el atributo de matriz incluye un valor que coincide exactamente con un valor introducido	INCLUDES VALUE	STRING	Si este filtro especifica sci-fi y un perfil de usuario tiene el valor sci-fi, el usuario coincidirá con este filtro.
Comprobar si el atributo de matriz no incluye un valor que coincide exactamente con un valor introducido	DOESN’T INCLUDE VALUE	STRING	Si este filtro especifica sci-fi y un perfil de usuario no tiene el valor sci-fi, el usuario coincidirá con este filtro.
Comprobar si el atributo de matriz contiene un valor que coincide parcialmente con un valor introducido O una expresión regular	MATCHES REGEX	STRING O REGULAR EXPRESSION Máximo de 32,764 caracteres
Comprobar si el atributo de matriz tiene algún valor o no está vacío	HAS A VALUE	N/A	Si este filtro especifica favorite_genres y un perfil de usuario contiene favorite_genres con cualquier valor, el usuario coincidirá con este filtro.
Comprobar si el atributo de matriz está vacío o no existe	IS EMPTY	N/A	Si este filtro especifica favorite_genres y un perfil de usuario no contiene favorite_genres o contiene favorite_genres pero no tiene valores, el usuario coincidirá con este filtro.
Comprobar si el atributo de matriz incluye un valor que coincide exactamente con cualquiera de los valores introducidos	INCLUDES ANY OF	STRING Distingue entre mayúsculas y minúsculas; se permiten múltiples valores (máximo de 256)	Si este filtro especifica sci-fi, fantasy, romance y un perfil de usuario tiene cualquier combinación de sci-fi, fantasy o romance, incluyendo solo uno de ellos (como solo sci-fi). Un usuario puede tener horror u otro valor en su cadena si también tiene alguno de sci-fi, fantasy y romance.
Comprobar si el atributo de matriz no incluye un valor que coincide exactamente con ninguno de los valores introducidos	INCLUDES NONE OF	STRING Distingue entre mayúsculas y minúsculas; se permiten múltiples valores (máximo de 256)	Si este filtro especifica sci-fi, fantasy, romance y un perfil de usuario no tiene ninguna combinación de sci-fi, fantasy o romance, el usuario coincidirá con este filtro. El usuario puede tener horror u otro valor si no tiene ninguno de sci-fi, fantasy o romance.
Comprobar si el atributo de matriz contiene un valor que coincide parcialmente con cualquiera de los valores introducidos	VALUES CONTAIN ANY OF	STRING Distingue entre mayúsculas y minúsculas; se permiten múltiples valores (máximo de 256)	Si este filtro especifica gold y una matriz del perfil de usuario contiene gold en al menos una cadena, el usuario coincidirá con este filtro. Esto incluye valores de cadena como gold_tier, former_gold_tier y otros.
Comprobar si el atributo de matriz no incluye un valor que coincide parcialmente con ninguno de los valores introducidos	VALUES DON’T CONTAIN ANY OF	STRING Distingue entre mayúsculas y minúsculas; se permiten múltiples valores (máximo de 256)	Si este filtro especifica gold y una matriz del perfil de usuario no contiene gold en ninguna cadena, el usuario coincidirá con este filtro. Esto significa que los usuarios con valores de cadena como gold_tier y former_gold_tier no coincidirán con este filtro.
Comprobar si el atributo de matriz incluye todos los valores introducidos	IS ALL OF	STRING Distingue entre mayúsculas y minúsculas; se permiten múltiples valores (máximo de 256)	Si este filtro especifica sci-fi, fantasy, romance y un perfil de usuario tiene todos esos valores, el usuario coincidirá con este filtro. El usuario también puede tener horror u otros valores y aún coincidir con este filtro.
Comprobar si el atributo de matriz no incluye todos los valores introducidos	ISN’T ALL OF	STRING Distingue entre mayúsculas y minúsculas; se permiten múltiples valores (máximo de 256)	Si este filtro especifica sci-fi, fantasy, romance y un perfil de usuario no tiene todos esos valores, el usuario coincidirá con este filtro.

Consejo

Para obtener más información sobre cómo usar expresiones regulares (regex), consulta estos recursos:

• Expresiones regulares compatibles con Perl (PCRE)
• Regex con Braze
• Depurador y probador de regex
• Tutorial de regex

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 con contenido específico a tus usuarios.

Los filtros de hora que utilizan 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 con 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 sucederá con las Campaigns configuradas con rangos de fechas más amplios, de modo que cinco días desde la activación significarán las 120 horas previas.

Para segmentar usuarios que tienen un atributo de hora que cae 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.

Advertencia

La última fecha en que ocurrió un evento personalizado o un evento de compra se registra automáticamente y no debe registrarse nuevamente a través de un atributo de hora personalizado.

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

Opciones de segmentación	Filtro desplegable	Opciones de entrada	Ejemplos
Comprobar si el atributo de hora es anterior a una fecha seleccionada	BEFORE	CALENDAR DATE SELECTOR	Si este filtro especifica 2024-01-31 y un perfil de usuario tiene una fecha anterior a 2024-1-31, el usuario coincidirá con este filtro.
Comprobar si el atributo de hora es posterior a una fecha seleccionada	AFTER	CALENDAR DATE SELECTOR	Si este filtro especifica 2024-01-31 y un perfil de usuario tiene una fecha posterior a 2024-1-31, el usuario coincidirá con este filtro.
Comprobar si el atributo de hora es de hace más de X número de días	MORE THAN	NUMBER OF DAYS AGO	Si este filtro especifica 7 y un perfil de usuario tiene una fecha de hace más de siete días, el usuario coincidirá con este filtro.
Comprobar si el atributo de hora es de hace menos de X número de días	LESS THAN	NUMBER OF DAYS AGO	Si este filtro especifica 7 y un perfil de usuario tiene una fecha de hace menos de siete días, el usuario coincidirá con este filtro.
Comprobar si el atributo de hora es en más de X número de días en el futuro	IN MORE THAN	NUMBER OF DAYS IN FUTURE	Si este filtro especifica 7 y un perfil de usuario tiene una fecha de más de siete días en el futuro, el usuario coincidirá con este filtro.
Comprobar si el atributo de hora es en menos de X número de días en el futuro	IN LESS THAN	NUMBER OF DAYS IN FUTURE	Si este filtro especifica 7 y un perfil de usuario tiene una fecha de menos de siete días en el futuro, el usuario coincidirá con este filtro.
Comprobar si el atributo de hora existe en el perfil de un usuario y no es null	IS NOT BLANK	N/A	Si este filtro especifica un atributo de hora que está en un perfil de usuario, el usuario coincidirá con este filtro.
Comprobar si el atributo de hora no existe en el perfil de un usuario o es null	IS BLANK	N/A	Si este filtro especifica un atributo de hora que no está en un perfil de usuario, el usuario coincidirá con este filtro.

Nota

Al usar los operadores in less than o in more than con 90 días o más, Braze convierte automáticamente el valor a semanas cuando guardas el Segment. Por ejemplo, 90 días se convierten en 13 semanas.

Detalles de atributos de hora

• Día de evento recurrente
  • Al usar el filtro “Día de evento recurrente” y cuando se te solicite seleccionar el “Día del calendario de 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 el 10 de marzo de 2020, inclusive.
• 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.
• 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 un tipo de datos para atributos personalizados. Para obtener más información, consulta Atributos personalizados anidados.

Usa una matriz de objetos para agrupar atributos relacionados. Para obtener más información, 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 obtener 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.

Nota

Los eventos recomendados tienen esquemas predefinidos con tipos de datos establecidos. Para más detalles, consulta Eventos recomendados de comercio electrónico.

Registrar eventos de compra establece el LTV (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 Data Settings y selecciona Custom Attributes o Custom Events.
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 segmentos, las campañas, los Canvas u otras ubicaciones que usen el atributo o evento modificado no se actualizan. Antes de cambiar el tipo de datos, detén cualquier campaña o Canvas que use el atributo en segmentos 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 segmentos que contienen el atributo modificado porque el filtro busca el nuevo tipo de datos. Actualiza esos perfiles de usuario (por ejemplo, con el endpoint /users/track) para que coincidan con el nuevo tipo y vuelvan a entrar en el segmento 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.

Importante

La capacidad de evitar que la detección automática actualice el tipo de datos del atributo personalizado está actualmente en acceso anticipado. Ponte en contacto con tu CSM si te interesa participar.

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.