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.

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.

Nota

Understanding date fields:

• TIME and TIME_MS: Represent the time the user profile update occurred in Braze (in seconds and milliseconds, respectively). For backfilled data, these values are the time of the backfill.
• SF_UPDATED_AT: Represents the time the data was last persisted in Snowflake. This field is most useful for determining data freshness—the time the row was most recently synced to your data warehouse.

Esquema de USER_DEFAULT_ATTRIBUTES_VIEW_SHARED

Esquema de USER_CUSTOM_ATTRIBUTES_VIEW_SHARED

Trabalhando com CUSTOM_ATTRIBUTES

A coluna CUSTOM_ATTRIBUTES armazena todos os seus atributos personalizados como um objeto JSON. Você pode acessar atributos individuais usando as funções JSON do Snowflake.

Exemplo: consultando atributos personalizados específicos

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
-- Get users with a specific loyalty tier
SELECT
  USER_ID,
  EXTERNAL_USER_ID,
  CUSTOM_ATTRIBUTES:loyalty_tier::STRING as loyalty_tier,
  CUSTOM_ATTRIBUTES:points::NUMBER as points
FROM USER_CUSTOM_ATTRIBUTES_VIEW_SHARED
WHERE CUSTOM_ATTRIBUTES:loyalty_tier::STRING = 'gold';

-- Get users who made a purchase above a certain amount
SELECT
  USER_ID,
  CUSTOM_ATTRIBUTES:last_purchase_amount::NUMBER as last_purchase_amount
FROM USER_CUSTOM_ATTRIBUTES_VIEW_SHARED
WHERE CUSTOM_ATTRIBUTES:last_purchase_amount::NUMBER > 100;

Exemplo: analisando dados de atributos personalizados

1
2
3
4
5
6
7
8
9
10
11
12
13
14
-- Count users by subscription status
SELECT
  CUSTOM_ATTRIBUTES:subscription_status::STRING as subscription_status,
  COUNT(*) as user_count
FROM USER_CUSTOM_ATTRIBUTES_VIEW_SHARED
GROUP BY CUSTOM_ATTRIBUTES:subscription_status::STRING;

-- Find average order value by customer segment
SELECT
  CUSTOM_ATTRIBUTES:customer_segment::STRING as segment,
  AVG(CUSTOM_ATTRIBUTES:lifetime_value::NUMBER) as avg_lifetime_value
FROM USER_CUSTOM_ATTRIBUTES_VIEW_SHARED
WHERE CUSTOM_ATTRIBUTES:customer_segment IS NOT NULL
GROUP BY CUSTOM_ATTRIBUTES:customer_segment::STRING;

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 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.

Nota

Understanding date fields:

• TIME and TIME_MS: Represent the time the user profile update occurred in Braze (in seconds and milliseconds, respectively). For backfilled data, these values are the time of the backfill.
• SF_UPDATED_AT: Represents the time the data was last persisted in Snowflake. This field is most useful for determining data freshness—the time the row was most recently synced to your data warehouse.

Esquema de USER_LATEST_STATE_DEFAULT_ATTRIBUTES_VIEW_SHARED

Esquema de USER_LATEST_STATE_CUSTOM_ATTRIBUTE_VIEW_SHARED

Nota

Esta visualização usa o tipo OBJECT para CUSTOM_ATTRIBUTES em vez de VARIANT. Use a mesma sintaxe de acessor JSON (:attribute_name::TYPE) para consultar atributos individuais.

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 por um período contínuo de 6 meses.
• 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.

Nota

Understanding date fields:

• TIME and TIME_MS: Represent the time the user profile update occurred in Braze (in seconds and milliseconds, respectively). For backfilled data, these values are the time of the backfill.
• SF_UPDATED_AT: Represents the time the data was last persisted in Snowflake. This field is most useful for determining data freshness—the time the row was most recently synced to your data warehouse.

Esquema de USER_DEFAULT_ATTRIBUTES_HISTORY_VIEW_SHARED

Esquema de USER_CUSTOM_ATTRIBUTES_HISTORY_VIEW_SHARED

Casos de uso comuns

Criando segmentos de usuários

1
2
3
4
5
6
7
8
9
10
11
12
13
-- Find active users in a specific city who haven't received an email recently
SELECT
  d.EXTERNAL_USER_ID,
  d.EMAIL_ADDRESS,
  d.HOME_CITY,
  c.CUSTOM_ATTRIBUTES:last_email_sent::TIMESTAMP as last_email_sent
FROM USER_DEFAULT_ATTRIBUTES_VIEW_SHARED d
JOIN USER_CUSTOM_ATTRIBUTES_VIEW_SHARED c
  ON d.USER_ID = c.USER_ID
WHERE d.HOME_CITY = 'New York'
  AND d.EMAIL_ADDRESS IS NOT NULL
  AND (c.CUSTOM_ATTRIBUTES:last_email_sent::TIMESTAMP < DATEADD(day, -30, CURRENT_TIMESTAMP())
       OR c.CUSTOM_ATTRIBUTES:last_email_sent IS NULL);

Analisando o comportamento do usuário ao longo do tempo

1
2
3
4
5
6
7
8
9
10
-- Track how a user's loyalty tier changed over the past 6 months
SELECT
  USER_ID,
  CUSTOM_ATTRIBUTES:loyalty_tier::STRING as loyalty_tier,
  EFF_DT,
  END_DT
FROM USER_CUSTOM_ATTRIBUTES_HISTORY_VIEW_SHARED
WHERE USER_ID = 'user_123'
  AND EFF_DT >= DATEADD(month, -6, CURRENT_TIMESTAMP())
ORDER BY EFF_DT DESC;

Combinando atributos padrão e personalizados

1
2
3
4
5
6
7
8
9
10
11
12
13
14
-- Get a complete user profile with both default and custom attributes
SELECT
  d.EXTERNAL_USER_ID,
  d.FIRST_NAME,
  d.LAST_NAME,
  d.EMAIL_ADDRESS,
  d.COUNTRY,
  c.CUSTOM_ATTRIBUTES:subscription_status::STRING as subscription_status,
  c.CUSTOM_ATTRIBUTES:lifetime_value::NUMBER as lifetime_value,
  c.CUSTOM_ATTRIBUTES:last_purchase_date::DATE as last_purchase_date
FROM USER_DEFAULT_ATTRIBUTES_VIEW_SHARED d
LEFT JOIN USER_CUSTOM_ATTRIBUTES_VIEW_SHARED c
  ON d.USER_ID = c.USER_ID
WHERE d.EXTERNAL_USER_ID = 'customer_456';

Encontrando clientes de alto valor

1
2
3
4
5
6
7
8
9
10
11
12
-- Identify users with high lifetime value who are at risk of churning
SELECT
  d.EXTERNAL_USER_ID,
  d.EMAIL_ADDRESS,
  c.CUSTOM_ATTRIBUTES:lifetime_value::NUMBER as lifetime_value,
  c.CUSTOM_ATTRIBUTES:days_since_last_purchase::NUMBER as days_since_last_purchase
FROM USER_DEFAULT_ATTRIBUTES_VIEW_SHARED d
JOIN USER_CUSTOM_ATTRIBUTES_VIEW_SHARED c
  ON d.USER_ID = c.USER_ID
WHERE c.CUSTOM_ATTRIBUTES:lifetime_value::NUMBER > 1000
  AND c.CUSTOM_ATTRIBUTES:days_since_last_purchase::NUMBER > 90
ORDER BY c.CUSTOM_ATTRIBUTES:lifetime_value::NUMBER DESC;

Melhores práticas

Uso recomendado de consultas

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.