Tipos de dados

Esta página reúne os tipos de dados compatíveis com atributos personalizados, propriedades de eventos e catálogos. Cada tipo de dado personalizado tem suporte e restrições ligeiramente diferentes.

Definições

Use esta tabela para ver quais tipos de dados você pode usar para atributos de perfil de usuário, dados de eventos ou itens de catálogo. Consulte as seções a seguir para saber sobre o uso e as restrições de cada tipo.

Considerações importantes

• Array: Atributos personalizados e propriedades de eventos têm limites de tamanho. Datas e horas não são compatíveis dentro de arrays em propriedades de eventos. Catálogos suportam apenas arrays de strings, com no máximo 100 elementos.
• Objeto: Na Braze, isso aparece como “atributos personalizados aninhados” para atributos personalizados, “objetos aninhados” para propriedades de eventos e “objeto JSON” para catálogos.
• Hora: Em propriedades de eventos, esse tipo é chamado de “Datetime”.

Tipos de dados de atributos personalizados

Os atributos personalizados são compatíveis com os tipos de dados listados na tabela de Definições. Veja abaixo o uso e as opções de segmentação de cada tipo.

• booleano
• números
• strings
• arrays
• hora
• objetos
• arrays de objetos

Você pode bloquear atributos personalizados individualmente no menu de ações ou selecionar até 100 atributos e bloqueá-los em massa. Quando você bloqueia um atributo personalizado:

• Nenhum dado é coletado sobre esse atributo.
• Os dados existentes ficam indisponíveis, a menos que o atributo seja reativado.
• Os atributos bloqueados não aparecem em filtros nem em gráficos.

Se o atributo estiver sendo referenciado por filtros ou gatilhos em outras áreas do dashboard da Braze, aparece um modal de alerta. Ele explica que todas as instâncias dos filtros ou gatilhos que fazem referência ao atributo serão removidas e arquivadas.

Marcar como informação de identificação pessoal (IPI)

Administradores também podem criar atributos personalizados e marcá-los como IPI nesta página. Esses atributos ficam visíveis apenas para administradores e usuários do dashboard com a permissão “View Custom Attributes Marked as PII”.

Adicionar descrições

Depois de criar um atributo personalizado, você pode adicionar uma descrição a ele se tiver a permissão de usuário Manage Events, Attributes, Purchases. Edite o atributo personalizado e insira o que quiser, como uma nota para sua equipe.

Adicionar tags

Depois de criar um atributo personalizado, você pode adicionar tags a ele se tiver a permissão de usuário “Manage Events, Attributes, Purchases”. Depois, use as tags para filtrar a lista de atributos.

Remover atributos personalizados

Existem duas formas de remover atributos personalizados dos perfis de usuário:

• Selecione o nome do atributo personalizado a ser removido em uma etapa de Atualização de usuário.
• Defina o valor null na sua solicitação de API para o endpoint /users/track.

Definir o valor null

Importante

Definir um atributo como null não é o mesmo que defini-lo como "" (string vazia).

• null remove o atributo do perfil do usuário por completo. O atributo não aparece no perfil e não corresponde a nenhum filtro IS NOT BLANK.
• "" define o atributo como uma string vazia. O atributo aparece no perfil com valor de string vazia, mas não corresponde a filtros IS NOT BLANK, porque é tratado como vazio.

Além disso, "" só é válido para atributos do tipo string. Se o tipo de dado do atributo estiver definido no dashboard como um tipo que não é string (como booleano, número ou hora), enviar "" não limpa o valor. Nesse caso, use null.

Exportar dados

Para exportar a lista de atributos personalizados como um arquivo CSV, selecione Exportar tudo no topo da página. O sistema gera um arquivo CSV e envia um link de download para o seu e-mail.

Ver relatórios de uso

O relatório de uso lista todos os Canvas, Campaigns e Segments que usam um atributo personalizado específico. Essa lista não inclui usos em Liquid.

Você pode ver até 100 relatórios de uso de uma vez. Para isso, marque as caixas de seleção ao lado dos atributos personalizados e selecione Ver relatório de uso.

Guia Valores

Ao ver um relatório de uso, selecione a guia Valores para ver os principais valores dos atributos personalizados selecionados. Esses valores se baseiam em uma amostra de aproximadamente 250.000 usuários. Como os resultados vêm de um subconjunto de usuários, a amostra não inclui todos os valores existentes. Portanto, não use a guia Valores para solucionar problemas nem para casos de uso que precisem de dados de todos os usuários.

Definir atributos personalizados

Veja abaixo os métodos usados para definir atributos personalizados em cada plataforma.

Expandir para ver a documentação por plataforma

• Android e FireOS
• iOS
• Web
• React Native
• Unity
• .NET MAUI (antigo Xamarin)
• Roku

Armazenamento de atributos personalizados

Todos os dados armazenados no Perfil do usuário, incluindo os dados de atributos personalizados, são mantidos por tempo indeterminado enquanto cada perfil estiver ativo.

Tipos de dados disponíveis para atributos personalizados

Os atributos personalizados são ferramentas extremamente flexíveis que permitem um ótimo direcionamento.

Os seguintes tipos de dados podem ser armazenados como atributos personalizados:

• Booleanos
• Números
• Strings
• Arrays
• Hora
• Objetos
• Arrays de objetos

Booleanos (verdadeiro/falso)

Atributos booleanos são úteis para armazenar dados binários simples sobre seus usuários, como status de inscrição. Você pode encontrar usuários com uma variável definida explicitamente como verdadeira ou falsa. Também pode encontrar usuários que ainda não têm nenhum registro desse atributo.

Para atributos booleanos, as seguintes opções de segmentação estão disponíveis.

Opções de segmentação	Filtro suspenso	Opções de entrada	Exemplos
Verificar se o valor booleano é verdadeiro, falso, verdadeiro ou não definido, ou falso ou não definido	IS	TRUE, FALSE, TRUE OR NOT SET ou FALSE OR NOT SET	Se esse filtro especificar coffee_drinker, o usuário corresponderá a ele nas seguintes situações: Se o filtro for true e o usuário tiver o valor coffee_drinker Se o filtro for false e o usuário não tiver o valor coffee_drinker Se o filtro for true or not set e o usuário tiver o valor coffee_drinker ou nenhum valor Se o filtro for false or not set e o usuário não tiver coffee_drinker nem nenhum valor
Verificar se o valor booleano existe no perfil do usuário e não é nulo	IS NOT BLANK	N/A	Se esse filtro especificar coffee_drinker e o usuário tiver um valor para o atributo coffee_drinker, o usuário corresponderá ao filtro.
Verificar se o valor booleano não existe no perfil do usuário ou é nulo	IS BLANK	N/A	Se esse filtro especificar coffee_drinker e o usuário não tiver o atributo coffee_drinker ou o valor de coffee_drinker for nulo, o usuário corresponderá ao filtro.

Dica

Não registre valores gastos com este método. Em vez disso, registre-os por meio de eventos de compra.

Para atributos de número, as seguintes opções de segmentação estão disponíveis.

Opções de segmentação	Filtro suspenso	Opções de entrada	Exemplos
Verificar se o atributo numérico é exatamente um número	EXACTLY	NUMBER	Se esse filtro especificar 10 e o perfil do usuário tiver o valor 10, o usuário corresponderá ao filtro.
Verificar se o atributo numérico é diferente de um número	DOES NOT EQUAL	NUMBER	Se esse filtro especificar 10 e o perfil do usuário não tiver o valor 10, o usuário corresponderá ao filtro.
Verificar se o atributo numérico é maior que um número	MORE THAN	NUMBER	Se esse filtro especificar 10 e o perfil do usuário tiver um valor maior que 10, o usuário corresponderá ao filtro.
Verificar se o atributo numérico é menor que um número	LESS THAN	NUMBER	Se esse filtro especificar 10 e o perfil do usuário tiver um valor menor que 10, o usuário corresponderá ao filtro.
Verificar se o atributo numérico existe no perfil do usuário e não é nulo	IS NOT BLANK	N/A	Se o perfil do usuário contiver o atributo numérico especificado, independentemente do valor, o usuário corresponderá ao filtro.
Verificar se o atributo numérico não existe no perfil do usuário ou é nulo	IS BLANK	N/A	Se o perfil do usuário não contiver o atributo numérico especificado ou o valor do atributo for nulo, o usuário corresponderá ao filtro.

Detalhes dos atributos de número

• Os filtros “Exactly 0” e “Less Than” incluem usuários com campos NULL.
  • Para excluir usuários sem valor para atributos personalizados, inclua o filtro is not blank.

Atributos de string podem ter até 255 caracteres. Se você inserir valores com espaços entre, antes ou depois das palavras, a Braze também vai verificar esses mesmos espaços.

Para atributos de string, as seguintes opções de segmentação estão disponíveis.

Opções de segmentação	Filtro suspenso	Opções de entrada	Exemplos
Verificar se o atributo de string corresponde parcialmente a uma string inserida OU a uma expressão regular	MATCHES REGEX	STRING OR REGULAR EXPRESSION Não diferencia maiúsculas de minúsculas; máximo de 32.764 caracteres
Verificar se o atributo de string não corresponde parcialmente a uma string inserida OU a uma expressão regular	DOES NOT MATCH REGEX *	STRING OR REGULAR EXPRESSION Não diferencia maiúsculas de minúsculas; máximo de 32.764 caracteres
Verificar se o atributo de string existe no perfil do usuário e não é uma string vazia	IS NOT BLANK	N/A	Se esse filtro especificar favorite_genre e o perfil do usuário tiver o atributo favorite_genre, o usuário corresponderá ao filtro, independentemente do valor do atributo. Por exemplo, o usuário pode ter sci-fi, romance ou outro valor.
Verificar se o atributo de string não existe no perfil do usuário	BLANK	N/A	Se esse filtro especificar favorite_genre e o perfil do usuário não tiver o atributo favorite_genre, o usuário corresponderá ao filtro.
Verificar se a string corresponde exatamente a qualquer uma das strings inseridas	IS ANY OF	STRING Diferencia maiúsculas de minúsculas; permite várias strings (máximo de 256)	Se esse filtro especificar book, bookmark e reading light, e o perfil do usuário tiver pelo menos uma dessas strings, o usuário corresponderá ao filtro.
Verificar se o atributo de string não corresponde exatamente a nenhuma das strings inseridas	IS NONE OF	STRING Diferencia maiúsculas de minúsculas; permite várias strings (máximo de 256)	Se esse filtro especificar book, bookmark e reading light, e o perfil do usuário não contiver nenhuma dessas strings, o usuário corresponderá ao filtro.
Verificar se o atributo de string corresponde parcialmente a qualquer uma das strings inseridas	CONTAINS ANY OF	STRING Diferencia maiúsculas de minúsculas; permite várias strings (máximo de 256)	Se esse filtro especificar gold e o perfil do usuário contiver gold em qualquer string, como gold_tier ou former_gold_tier, o usuário corresponderá ao filtro.
Verificar se o atributo de string não corresponde parcialmente a nenhuma das strings inseridas	DOESN’T CONTAIN ANY OF	STRING Diferencia maiúsculas de minúsculas; permite várias strings (máximo de 256)	Se esse filtro especificar gold e o perfil do usuário não contiver gold em nenhuma string, o usuário corresponderá ao filtro.

Nota

Uma string de data como “12/1/2021” é convertida em um objeto datetime e tratada como um atributo de tempo.

Importante

Ao segmentar com o filtro DOES NOT MATCH REGEX, o perfil do usuário já precisa ter um atributo personalizado com um valor atribuído. A Braze recomenda usar a lógica “OR” para verificar se um atributo personalizado está vazio. Assim, você garante que os usuários sejam direcionados corretamente.

Arrays

Arrays têm tamanho máximo de 100 KB. O comprimento padrão de um atributo é de até 500 itens. Por exemplo, imagine um atributo como “Filmes assistidos” definido como 500. Quando o usuário assistir ao 501º filme, o primeiro filme será removido e o mais recente será adicionado. Se você inserir valores com espaços entre, antes ou depois das palavras, a Braze também vai verificar esses mesmos espaços.

Atributos personalizados do tipo array não podem ser importados via importação de CSV. Para fazer upload de valores de array, use o endpoint /users/track ou a ingestão de dados na nuvem.

Nota

A opção de aumentar o comprimento máximo não fica disponível se o atributo estiver configurado para detectar o tipo de dado automaticamente. Nesse caso, o tipo de dado precisa ser definido como array.

Solução de problemas: atributo personalizado de array sem valor no perfil do usuário

Se um atributo personalizado de array aparecer no perfil do usuário sem nenhum valor, verifique se o Comprimento máximo do atributo está definido como 0 no dashboard.

1. Acesse Configurações de dados > Atributos personalizados.
2. Filtre a lista por Array.
3. Encontre o atributo e confira o Comprimento máximo dele.
4. Se o Comprimento máximo for 0, atualize-o para um valor maior que 0.

Quando o Comprimento máximo está definido como 0, os valores não aparecem no perfil do usuário.

Para ver exemplos de comportamento de arrays com foco no SDK, consulte a visão geral de análise de dados.

Para atributos de array, as seguintes opções de segmentação estão disponíveis.

Opções de segmentação	Filtro suspenso	Opções de entrada	Exemplos
Verificar se o atributo de array inclui um valor que corresponde exatamente a um valor inserido	INCLUDES VALUE	STRING	Se esse filtro especificar sci-fi e o perfil do usuário tiver o valor sci-fi, o usuário corresponderá ao filtro.
Verificar se o atributo de array não inclui um valor que corresponde exatamente a um valor inserido	DOESN’T INCLUDE VALUE	STRING	Se esse filtro especificar sci-fi e o perfil do usuário não tiver o valor sci-fi, o usuário corresponderá ao filtro.
Verificar se o atributo de array contém um valor que corresponde parcialmente a um valor inserido OU a uma expressão regular	MATCHES REGEX	STRING OR REGULAR EXPRESSION Máximo de 32.764 caracteres
Verificar se o atributo de array tem algum valor ou não está vazio	HAS A VALUE	N/A	Se esse filtro especificar favorite_genres e o perfil do usuário contiver favorite_genres com qualquer valor, o usuário corresponderá ao filtro.
Verificar se o atributo de array está vazio ou não existe	IS EMPTY	N/A	Se esse filtro especificar favorite_genres e o perfil do usuário não contiver favorite_genres ou contiver favorite_genres sem nenhum valor, o usuário corresponderá ao filtro.
Verificar se o atributo de array inclui um valor que corresponde exatamente a qualquer um dos valores inseridos	INCLUDES ANY OF	STRING Diferencia maiúsculas de minúsculas; permite vários valores (máximo de 256)	Se esse filtro especificar sci-fi, fantasy, romance, o usuário corresponderá ao filtro se o perfil tiver qualquer combinação de sci-fi, fantasy ou romance, mesmo que inclua apenas um deles (como somente sci-fi). O usuário pode ter horror ou outro valor na string, desde que também tenha sci-fi, fantasy ou romance.
Verificar se o atributo de array não inclui um valor que corresponde exatamente a nenhum dos valores inseridos	INCLUDES NONE OF	STRING Diferencia maiúsculas de minúsculas; permite vários valores (máximo de 256)	Se esse filtro especificar sci-fi, fantasy, romance e o perfil do usuário não tiver nenhuma combinação de sci-fi, fantasy ou romance, o usuário corresponderá ao filtro. O usuário pode ter horror ou outro valor, desde que não tenha sci-fi, fantasy nem romance.
Verificar se o atributo de array contém um valor que corresponde parcialmente a qualquer um dos valores inseridos	VALUES CONTAIN ANY OF	STRING Diferencia maiúsculas de minúsculas; permite vários valores (máximo de 256)	Se esse filtro especificar gold e o array do perfil do usuário contiver gold em pelo menos uma string, o usuário corresponderá ao filtro. Isso inclui valores de string como gold_tier, former_gold_tier e outros.
Verificar se o atributo de array não inclui um valor que corresponde parcialmente a nenhum dos valores inseridos	VALUES DON’T CONTAIN ANY OF	STRING Diferencia maiúsculas de minúsculas; permite vários valores (máximo de 256)	Se esse filtro especificar gold e o array do perfil do usuário não contiver gold em nenhuma string, o usuário corresponderá ao filtro. Portanto, usuários com valores de string como gold_tier e former_gold_tier não corresponderão ao filtro.
Verificar se o atributo de array inclui todos os valores inseridos	IS ALL OF	STRING Diferencia maiúsculas de minúsculas; permite vários valores (máximo de 256)	Se esse filtro especificar sci-fi, fantasy, romance e o perfil do usuário tiver todos esses valores, o usuário corresponderá ao filtro. O usuário também pode ter horror ou outros valores e ainda corresponder ao filtro.
Verificar se o atributo de array não inclui todos os valores inseridos	ISN’T ALL OF	STRING Diferencia maiúsculas de minúsculas; permite vários valores (máximo de 256)	Se esse filtro especificar sci-fi, fantasy, romance e o perfil do usuário não tiver todos esses valores, o usuário corresponderá ao filtro.

Dica

Para saber mais sobre como usar expressões regulares (regex), confira estes recursos:

• Expressões regulares compatíveis com Perl (PCRE)
• Regex com a Braze
• Depurador e testador de regex
• Tutorial de regex

Atributos de hora são úteis para armazenar a última vez que uma ação específica foi realizada. Assim, você pode enviar mensagens de reengajamento com conteúdo específico para seus usuários.

Filtros de hora com datas relativas (por exemplo, mais de 1 dia atrás ou menos de 2 dias atrás) medem 1 dia como 24 horas. Qualquer Campaign que você executar com esses filtros incluirá todos os usuários em incrementos de 24 horas. Por exemplo, last used app more than 1 day ago captura todos os usuários que “usaram o app pela última vez há mais de 24 horas”, contadas a partir do momento exato em que a Campaign é executada. O mesmo vale para Campaigns com intervalos de datas mais longos. Então, cinco dias a partir da ativação equivalem às 120 horas anteriores.

Para direcionar usuários cujo atributo de hora esteja dentro de um intervalo de tempo, use dois filtros de público: in more than para o limite inferior e in less than para o limite superior. Um único filtro não consegue expressar os dois lados do intervalo. Por exemplo, para direcionar usuários com um atributo de hora nas próximas 24 horas (entre agora e daqui a um dia), aplique in more than 0 days e in less than 1 day.

Aviso

A data da última ocorrência de um evento personalizado ou de um evento de compra é registrada automaticamente. Não é preciso registrá-la novamente em um atributo personalizado de hora.

Para atributos de hora, as seguintes opções de segmentação estão disponíveis.

Opções de segmentação	Filtro suspenso	Opções de entrada	Exemplos
Verificar se o atributo de hora é anterior a uma data selecionada	BEFORE	CALENDAR DATE SELECTOR	Se esse filtro especificar 2024-01-31 e o perfil do usuário tiver uma data anterior a 2024-1-31, o usuário corresponderá ao filtro.
Verificar se o atributo de hora é posterior a uma data selecionada	AFTER	CALENDAR DATE SELECTOR	Se esse filtro especificar 2024-01-31 e o perfil do usuário tiver uma data posterior a 2024-1-31, o usuário corresponderá ao filtro.
Verificar se o atributo de hora é de mais de X dias atrás	MORE THAN	NUMBER OF DAYS AGO	Se esse filtro especificar 7 e o perfil do usuário tiver uma data de mais de sete dias atrás, o usuário corresponderá ao filtro.
Verificar se o atributo de hora é de menos de X dias atrás	LESS THAN	NUMBER OF DAYS AGO	Se esse filtro especificar 7 e o perfil do usuário tiver uma data de menos de sete dias atrás, o usuário corresponderá ao filtro.
Verificar se o atributo de hora está a mais de X dias no futuro	IN MORE THAN	NUMBER OF DAYS IN FUTURE	Se esse filtro especificar 7 e o perfil do usuário tiver uma data a mais de sete dias no futuro, o usuário corresponderá ao filtro.
Verificar se o atributo de hora está a menos de X dias no futuro	IN LESS THAN	NUMBER OF DAYS IN FUTURE	Se esse filtro especificar 7 e o perfil do usuário tiver uma data a menos de sete dias no futuro, o usuário corresponderá ao filtro.
Verificar se o atributo de hora existe no perfil do usuário e não é nulo	IS NOT BLANK	N/A	Se esse filtro especificar um atributo de hora presente no perfil do usuário, o usuário corresponderá ao filtro.
Verificar se o atributo de hora não existe no perfil do usuário ou é nulo	IS BLANK	N/A	Se esse filtro especificar um atributo de hora ausente do perfil do usuário, o usuário corresponderá ao filtro.

Nota

Ao usar os operadores in less than ou in more than com 90 dias ou mais, a Braze converte automaticamente o valor em semanas quando você salva o Segment. Por exemplo, 90 dias são convertidos em 13 semanas.

Detalhes dos atributos de hora

Data de evento recorrente e deslocamentos de timestamp

Para atributos personalizados de hora, a Braze armazena o timestamp absoluto e também deriva uma data de evento recorrente (mês e dia). Essa data é usada pelo filtro “Day of Recurring Event” e pelas comparações de “dia do ano” em atributos personalizados aninhados. A data de evento recorrente é calculada a partir da data do calendário no deslocamento UTC do timestamp no momento em que o atributo é definido.

Como o deslocamento afeta as comparações de data recorrente:

Quando você define um atributo de hora, o deslocamento UTC do timestamp determina a data de evento recorrente armazenada. Instantes equivalentes com deslocamentos diferentes produzem datas recorrentes diferentes:

• 2026-10-13T00:09:49+09:00 → 13 de outubro
• 2026-10-12T15:09:49Z → 12 de outubro

Esses timestamps representam o mesmo instante. O primeiro usa o deslocamento +09:00 (JST) e armazena 13 de outubro. O segundo usa UTC (Z) e armazena 12 de outubro. As configurações de fuso horário da empresa e do usuário não recalculam essa data de evento recorrente armazenada.

Serialização no SDK:

Alguns SDKs serializam objetos Date em UTC antes de enviá-los para a Braze. Por exemplo, quando você define um atributo de hora usando um objeto Date no SDK para Swift, Web ou Android, o SDK o converte em um timestamp UTC antes da transmissão. Se o horário local estiver entre 00:00 e 08:59 JST, a data em UTC será um dia antes. Nesse caso, a data de evento recorrente armazenada corresponderá ao dia anterior no fuso horário local do usuário. Da mesma forma, se o fuso horário local estiver atrás do UTC (como os fusos dos EUA), a data em UTC pode ser um dia depois da data do calendário local. Então, a data de evento recorrente armazenada será um dia depois da data local do usuário.

Como preservar a data do calendário local pretendida:

Para garantir que a data de evento recorrente corresponda à data do calendário local do usuário, envie os atributos de hora como strings com o deslocamento local, e não como objetos Date:

1
2
3

{
  "anniversary_date": "2026-10-13T00:00:00+09:00"
}

Isso mantém 13 de outubro como data de evento recorrente para o filtro “Day of Recurring Event” e para a filtragem aninhada por dia do ano.

• Dia de evento recorrente
  • Ao usar o filtro “Dia de evento recorrente” e ser solicitado a selecionar o “Dia do calendário de evento recorrente”, se você selecionar IS LESS THAN ou IS MORE THAN, a data atual será contada para esse filtro de segmentação.
  • Por exemplo, se em 10 de março de 2020 você selecionou a data do atributo como LESS THAN ... March 10, 2020, os atributos serão considerados para os dias até, e incluindo, 10 de março de 2020.
• Menos de X dias atrás: O filtro “Menos de X dias atrás” inclui datas entre X dias atrás e a data/hora atual.
• Menos de X dias no futuro: Inclui datas entre a data/hora atual e X dias no futuro.

Você pode usar atributos personalizados aninhados para enviar objetos como tipo de dado de atributos personalizados. Para saber mais, consulte Atributos personalizados aninhados.

Use um array de objetos para agrupar atributos relacionados. Para saber mais, consulte Array de objetos.

Você pode alterar o tipo de dado do seu atributo personalizado, mas precisa conhecer os impactos dessa mudança. Para saber mais, consulte Alterar o tipo de dado de atributos ou eventos personalizados.

Operadores consolidados

Consolidamos a lista de operadores disponíveis para filtros de atributos, filtros de atributos personalizados e filtros de atributos personalizados aninhados. Se você tiver filtros que usam esses operadores, eles serão atualizados automaticamente para usar os novos operadores.

Tipos de dados de propriedades de eventos

Ao registrar um evento, você pode anexar informações adicionais (por exemplo, nome do produto ou preço) como propriedades de eventos. Cada propriedade tem um nome e um valor. Os valores de propriedades de eventos são compatíveis com os tipos de dados na tabela de Definições (Hora é chamado de “Datetime” em propriedades de eventos).

Formato esperado

Os valores de propriedades são enviados como um objeto: as chaves são os nomes das propriedades e os valores são os valores das propriedades. Os nomes das propriedades devem ser strings não vazias, com 255 caracteres ou menos, sem cifrões ($) no início.

Regras específicas de propriedades de eventos:

• Hora (Datetime): Use o formato ISO 8601 ou yyyy-MM-dd'T'HH:mm:ss:SSSZ. Não é compatível dentro de arrays.
• Array: Datas e horas não são compatíveis dentro de arrays.
• Objeto aninhado: Consulte Objetos aninhados.
• Carga útil: Objetos de propriedades de eventos que contêm valores de array ou objeto podem ter até 102.400 bytes (100 KiB).

Você pode alterar o tipo de dado da propriedade do seu evento personalizado, mas esteja ciente dos impactos de alterar tipos de dados após os dados terem sido coletados.

Para o comportamento completo de propriedades de eventos, chaves reservadas e uso em gatilhos e personalização, consulte Propriedades de eventos personalizados.

Eventos de compra e receita

Dados de compra e receita são registrados por meio de eventos de compra ou eventos recomendados de eCommerce.

Nota

Eventos recomendados têm esquemas pré-definidos com tipos de dados definidos. Para mais detalhes, consulte Eventos recomendados de eCommerce.

O registro de eventos de compra estabelece o Lifetime Value (LTV) para cada perfil de usuário, e esses dados podem ser visualizados na página de receita em séries temporais. Você pode segmentar por valor gasto, data da última compra, número de compras em um período e muito mais.

Tipos de dados de propriedades de eventos de compra

Os valores de propriedades de eventos de compra (o objeto properties em uma compra) são compatíveis com os tipos de dados na tabela de Definições, com a mesma estrutura e regras de nomenclatura das propriedades de eventos.

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 o esquema completo do objeto de compra e exemplos, consulte Objeto de compra. Para registro de eventos de compra, filtros de segmentação e detalhes completos, consulte Eventos de compra.

Alterando o tipo de dado de atributo personalizado ou evento

Para alterar o tipo de dado de um atributo personalizado ou evento:

1. Acesse Data Settings e selecione Custom Attributes ou Custom Events.
2. Encontre seu atributo ou evento na lista e selecione Mais ações.
3. Selecione um novo Data type no dropdown.
4. Selecione Save.

Se você alterar o tipo de dado de um atributo personalizado ou evento (por exemplo, alterando time para string), considere o seguinte:

• Os filtros não são atualizados automaticamente. Segments, Campaigns, Canvas ou outros locais que usam o atributo ou evento alterado não são atualizados. Antes de alterar o tipo de dado, pare quaisquer Campaigns ou Canvas que usem o atributo em Segments ou filtros, e remova o atributo dos filtros que o referenciam.
• Os dados existentes dos usuários não são atualizados retroativamente. Se o atributo alterado estava no perfil de um usuário antes da alteração, esse valor permanece com o tipo de dado antigo. Os usuários podem sair de segmentos que contêm o atributo alterado porque o filtro procura o novo tipo de dado. Atualize esses perfis de usuário (por exemplo, com o endpoint /users/track) para que correspondam ao novo tipo e reentrem no Segment, se necessário.
• Os novos dados devem corresponder ao novo tipo. Chamadas de API que enviam o tipo de dado anterior para o atributo alterado não são aceitas. Envie o novo tipo de dado.

Importante

A capacidade de impedir que a detecção automática atualize o tipo de dado do atributo personalizado está atualmente em acesso antecipado. Entre em contato com seu CSM se tiver interesse em participar.

Tipos de dados de catálogos

Os catálogos são compatíveis com os tipos listados na tabela de Definições. A tabela a seguir lista cada tipo, como ele pode ser criado ou atualizado, e o formato com exemplos.

Formato e exemplos

Para criar e atualizar catálogos, consulte Criar um catálogo.