Skip to content

Atributos do perfil de usuário

Esta página serve como referência para as visualizações de atributos padrão e personalizados no Snowflake. Há três visualizações para atributos padrão e três visualizações para atributos personalizados, cada uma projetada para um caso de uso específico com suas próprias considerações de desempenho.

Paridade de dados com o dashboard

Em circunstâncias raras, os valores de atributos padrão e personalizados nas visualizações do Snowflake nesta página podem não corresponder ao que você vê no perfil de um usuário no dashboard da Braze.

Durante a versão beta, podem ocorrer discrepâncias. Por exemplo, um atributo pode aparecer como NULL no Snowflake enquanto o dashboard mostra um valor para aquele usuário.

Se você perceber incompatibilidades generalizadas, entre em contato com o seu gerente de sucesso do cliente ou com o suporte da Braze.

Visualizações disponíveis

Instantâneos do perfil de usuário

Essas visualizações fornecem instantâneos periódicos dos atributos do perfil de usuário. Os dados têm um atraso de até 12 horas, o que os torna úteis para consultas que não exigem atualizações em tempo real.

  • USER_DEFAULT_ATTRIBUTES_VIEW_SHARED
  • USER_CUSTOM_ATTRIBUTES_VIEW_SHARED

Uso

  • Fornece um instantâneo dos atributos de usuário com um atraso de até 12 horas.
  • Apresenta bom desempenho para consultas que não exigem precisão em tempo real.
  • Execução de consulta mais rápida, especialmente ao filtrar por atributos diferentes de USER_ID.
  • Limitação: os dados não são atualizados em tempo real.

Esquema de USER_DEFAULT_ATTRIBUTES_VIEW_SHARED

Nome da coluna Tipo de dados
APP_GROUP_ID VARCHAR
APP_ID VARCHAR
USER_ID VARCHAR
TIME NUMBER
UPDATE_SOURCE VARCHAR
SF_UPDATED_AT TIMESTAMP_NTZ
EXTERNAL_ID VARCHAR
FIRST_NAME VARCHAR
LAST_NAME VARCHAR
EMAIL VARCHAR
GENDER VARCHAR
PHONE VARCHAR
DOB VARCHAR
TIME_ZONE VARCHAR
HOME_CITY VARCHAR
COUNTRY VARCHAR
LANGUAGE VARCHAR

Esquema de USER_CUSTOM_ATTRIBUTES_VIEW_SHARED

Nome da coluna Tipo de dados
APP_GROUP_ID VARCHAR
APP_ID VARCHAR
USER_ID VARCHAR
TIME NUMBER
UPDATE_SOURCE VARCHAR
SF_UPDATED_AT TIMESTAMP_NTZ
CUSTOM_ATTRIBUTES VARIANT

Visualizações do perfil de usuário em tempo real

Essas visualizações fornecem atualizações quase em tempo real sobre os atributos do perfil de usuário, com um atraso de dados de até 10 minutos após a ocorrência de uma atualização na Braze.

  • USER_LATEST_STATE_DEFAULT_ATTRIBUTES_VIEW_SHARED
  • USER_LATEST_STATE_CUSTOM_ATTRIBUTE_VIEW_SHARED

Uso

  • Fornece atributos de usuário atualizados com atraso mínimo (~10 minutos).
  • Útil para análises em tempo real e cenários em que dados recentes são necessários.
  • Considerações de desempenho:
    • Consultas sobre usuários individuais são mais rápidas (menos de um minuto usando um warehouse grande).
    • Consultas sem filtros de USER_ID exigem agregação em todos os usuários, o que leva a tempos de execução significativamente mais longos.
    • Consultas em um grande conjunto de dados (como mais de 100 milhões de usuários) podem levar muitos minutos.

Esquema de USER_LATEST_STATE_DEFAULT_ATTRIBUTES_VIEW_SHARED

Nome da coluna Tipo de dados
APP_GROUP_ID VARCHAR
APP_ID VARCHAR
USER_ID VARCHAR
TIME NUMBER
UPDATE_SOURCE VARCHAR
SF_UPDATED_AT TIMESTAMP_LTZ
EXTERNAL_ID VARCHAR
FIRST_NAME VARCHAR
LAST_NAME VARCHAR
EMAIL VARCHAR
GENDER VARCHAR
PHONE VARCHAR
DOB VARCHAR
HOME_CITY VARCHAR
COUNTRY VARCHAR
LANGUAGE VARCHAR
TIME_ZONE VARCHAR

Esquema de USER_LATEST_STATE_CUSTOM_ATTRIBUTE_VIEW_SHARED

Nome da coluna Tipo de dados
APP_GROUP_ID VARCHAR
USER_ID VARCHAR
TIME NUMBER
UPDATE_SOURCE VARCHAR
SF_UPDATED_AT TIMESTAMP_NTZ
APP_ID VARCHAR
CUSTOM_ATTRIBUTES OBJECT

Registros históricos de alterações

Essas visualizações armazenam registros históricos de alterações de atributos de usuário, capturando mudanças com granularidade de 12 horas.

  • USER_DEFAULT_ATTRIBUTES_HISTORY_VIEW_SHARED
  • USER_CUSTOM_ATTRIBUTES_HISTORY_VIEW_SHARED

Uso

  • Fornece um registro de alterações históricas nos atributos de usuário.
  • Os dados são capturados a cada 12 horas, o que significa que várias atualizações nesse período são combinadas em um único registro. Alterações individuais dentro desse intervalo não são mantidas separadamente.
  • EFF_DT e END_DT marcam o início e o fim do estado de um atributo do usuário.

Esquema de USER_DEFAULT_ATTRIBUTES_HISTORY_VIEW_SHARED

Nome da coluna Tipo de dados
APP_GROUP_ID VARCHAR
USER_ID VARCHAR
APP_ID VARCHAR
TIME NUMBER
UPDATE_SOURCE VARCHAR
SF_UPDATED_AT TIMESTAMP_NTZ
EXTERNAL_ID VARCHAR
FIRST_NAME VARCHAR
LAST_NAME VARCHAR
EMAIL VARCHAR
GENDER VARCHAR
PHONE VARCHAR
DOB VARCHAR
TIME_ZONE VARCHAR
HOME_CITY VARCHAR
COUNTRY VARCHAR
LANGUAGE VARCHAR
EFF_DT TIMESTAMP_NTZ
END_DT TIMESTAMP_NTZ

Esquema de USER_CUSTOM_ATTRIBUTES_HISTORY_VIEW_SHARED

Nome da coluna Tipo de dados
APP_GROUP_ID VARCHAR
USER_ID VARCHAR
APP_ID VARCHAR
TIME NUMBER
UPDATE_SOURCE VARCHAR
SF_UPDATED_AT TIMESTAMP_NTZ
CUSTOM_ATTRIBUTES VARIANT
EFF_DT TIMESTAMP_NTZ
END_DT TIMESTAMP_NTZ

Melhores práticas

Caso de uso Visualizações recomendadas Notas
Consultas gerais que não requerem atualizações recentes USER_DEFAULT_ATTRIBUTES_VIEW_SHARED e USER_CUSTOM_ATTRIBUTES_VIEW_SHARED Execução rápida, com dados de até 12 horas.
Consultas que exigem os atributos de usuário mais recentes USER_LATEST_STATE_DEFAULT_ATTRIBUTES_VIEW_SHARED e USER_LATEST_STATE_CUSTOM_ATTRIBUTE_VIEW_SHARED Fornece atualizações quase em tempo real, mas pode ser mais lento para grandes conjuntos de dados.
Rastreamento histórico de alterações de atributos USER_DEFAULT_ATTRIBUTES_HISTORY_VIEW_SHARED e USER_CUSTOM_ATTRIBUTES_HISTORY_VIEW_SHARED Armazena alterações de atributos com granularidade de 12 horas.

Considerações de desempenho

  • Consultas em USER_DEFAULT_ATTRIBUTES_VIEW_SHARED ou USER_CUSTOM_ATTRIBUTES_VIEW_SHARED devem retornar em menos de 10 segundos para grandes conjuntos de dados (~1 bilhão de usuários) em um warehouse grande.
  • Consultas em USER_LATEST_STATE_DEFAULT_ATTRIBUTES_VIEW_SHARED ou USER_LATEST_STATE_CUSTOM_ATTRIBUTE_VIEW_SHARED para um único usuário retornam em menos de um minuto, mas escalam mal sem a filtragem por USER_ID.
  • Consultas sobre mais de 100 milhões de usuários em USER_LATEST_STATE_DEFAULT_ATTRIBUTES_VIEW_SHARED ou USER_LATEST_STATE_CUSTOM_ATTRIBUTE_VIEW_SHARED podem levar vários minutos devido à agregação por usuário.
New Stuff!