Skip to content

ユーザープロファイル属性

このページは、Snowflakeのデフォルトおよびカスタム属性ビューのリファレンスです。デフォルト属性用に3つのビュー、カスタム属性用に3つのビューがあり、それぞれ固有のパフォーマンス上の考慮事項を持つ特定のユースケース向けに設計されています。

ダッシュボードとのデータ整合性

まれに、このページのSnowflakeビューにおけるデフォルトおよびカスタム属性の値が、Brazeダッシュボードのユーザープロファイルに表示される内容と一致しない場合があります。

たとえば、ダッシュボードではそのユーザーに値が表示されているにもかかわらず、Snowflakeでは属性がNULLと表示される場合があります。

広範な不一致が見られる場合は、カスタマーサクセスマネージャーまたはBrazeサポートにお問い合わせください。

利用可能なビュー

利用可能なビュー
タイプ ビュー 説明
デフォルト属性 USER_DEFAULT_ATTRIBUTES_VIEW_SHARED ユーザープロファイルスナップショット
USER_LATEST_STATE_DEFAULT_ATTRIBUTES_VIEW_SHARED リアルタイムユーザープロファイル
USER_DEFAULT_ATTRIBUTES_HISTORY_VIEW_SHARED 変更履歴ログ
カスタム属性 USER_CUSTOM_ATTRIBUTES_VIEW_SHARED ユーザープロファイルスナップショット
USER_LATEST_STATE_CUSTOM_ATTRIBUTE_VIEW_SHARED リアルタイムユーザープロファイル
USER_CUSTOM_ATTRIBUTES_HISTORY_VIEW_SHARED 変更履歴ログ

ユーザープロファイルスナップショット

これらのビューは、ユーザープロファイル属性の定期的なスナップショットを提供します。データは最大12時間遅延するため、リアルタイムの更新を必要としないクエリに適しています。

  • USER_DEFAULT_ATTRIBUTES_VIEW_SHARED
  • USER_CUSTOM_ATTRIBUTES_VIEW_SHARED

使用方法

  • 最大12時間の遅延を伴うユーザー属性のスナップショットを提供します。
  • リアルタイムの正確性を必要としないクエリに適しています。
  • 特にUSER_ID以外の属性でフィルタリングする場合、クエリの実行が高速です。
  • 制限事項: データはリアルタイムで更新されません。

USER_DEFAULT_ATTRIBUTES_VIEW_SHAREDスキーマ

列名 データタイプ
APP_GROUP_ID VARCHAR
APP_ID VARCHAR
USER_ID VARCHAR
TIME NUMBER
TIME_MS NUMBER
UPDATE_SOURCE VARCHAR
SF_UPDATED_AT TIMESTAMP_NTZ
EXTERNAL_USER_ID VARCHAR
FIRST_NAME VARCHAR
LAST_NAME VARCHAR
EMAIL_ADDRESS VARCHAR
GENDER VARCHAR
PHONE_NUMBER VARCHAR
DOB VARCHAR
TIMEZONE VARCHAR
HOME_CITY VARCHAR
COUNTRY VARCHAR
LANGUAGE VARCHAR
ARCHIVED BOOLEAN

USER_CUSTOM_ATTRIBUTES_VIEW_SHAREDスキーマ

列名 データタイプ
APP_GROUP_ID VARCHAR
APP_ID VARCHAR
USER_ID VARCHAR
EXTERNAL_USER_ID VARCHAR
TIME NUMBER
TIME_MS NUMBER
UPDATE_SOURCE VARCHAR
SF_UPDATED_AT TIMESTAMP_NTZ
CUSTOM_ATTRIBUTES VARIANT
ARCHIVED BOOLEAN

リアルタイムユーザープロファイルビュー

これらのビューは、ユーザープロファイル属性のほぼリアルタイムの更新を提供します。データはBrazeで更新が行われてから最大10分遅延します。

  • USER_LATEST_STATE_DEFAULT_ATTRIBUTES_VIEW_SHARED
  • USER_LATEST_STATE_CUSTOM_ATTRIBUTE_VIEW_SHARED

使用方法

  • 最小限の遅延（約10分）で最新のユーザー属性を提供します。
  • リアルタイム分析や最新のデータが必要なシナリオに適しています。
  • パフォーマンスに関する考慮事項:
    • 個々のユーザーに対するクエリは高速です（大規模なウェアハウスを使用して1分以内）。
    • USER_IDフィルターを使用しないクエリは全ユーザーの集計が必要となるため、実行時間が大幅に長くなります。
    • 大規模なデータセット（1億人以上のユーザーなど）に対するクエリは数分かかる場合があります。

USER_LATEST_STATE_DEFAULT_ATTRIBUTES_VIEW_SHAREDスキーマ

列名 データタイプ
APP_GROUP_ID VARCHAR
APP_ID VARCHAR
USER_ID VARCHAR
TIME NUMBER
TIME_MS NUMBER
UPDATE_SOURCE VARCHAR
ARCHIVED BOOLEAN
SF_UPDATED_AT TIMESTAMP_LTZ
EXTERNAL_USER_ID VARCHAR
FIRST_NAME VARCHAR
LAST_NAME VARCHAR
EMAIL_ADDRESS VARCHAR
GENDER VARCHAR
PHONE_NUMBER VARCHAR
DOB VARCHAR
HOME_CITY VARCHAR
COUNTRY VARCHAR
LANGUAGE VARCHAR
TIMEZONE VARCHAR

USER_LATEST_STATE_CUSTOM_ATTRIBUTE_VIEW_SHAREDスキーマ

列名 データタイプ
APP_GROUP_ID VARCHAR
USER_ID VARCHAR
EXTERNAL_USER_ID VARCHAR
TIME NUMBER
TIME_MS NUMBER
UPDATE_SOURCE VARCHAR
ARCHIVED BOOLEAN
SF_UPDATED_AT TIMESTAMP_NTZ
APP_ID VARCHAR
CUSTOM_ATTRIBUTES OBJECT

変更履歴ログ

これらのビューは、ユーザー属性の変更履歴ログを保存し、12時間の粒度で変更をキャプチャします。

  • USER_DEFAULT_ATTRIBUTES_HISTORY_VIEW_SHARED
  • USER_CUSTOM_ATTRIBUTES_HISTORY_VIEW_SHARED

使用方法

  • 6か月間のローリング期間にわたるユーザー属性の変更履歴の記録を提供します。
  • データは12時間ごとにスナップショットされます。つまり、この時間枠内の複数の更新は1つのレコードに統合されます。この期間内の個々の変更は個別に保持されません。
  • EFF_DTとEND_DTは、ユーザーの属性状態の開始と終了を示します。

USER_DEFAULT_ATTRIBUTES_HISTORY_VIEW_SHAREDスキーマ

列名 データタイプ
APP_GROUP_ID VARCHAR
USER_ID VARCHAR
APP_ID VARCHAR
TIME NUMBER
TIME_MS NUMBER
UPDATE_SOURCE VARCHAR
SF_UPDATED_AT TIMESTAMP_NTZ
EXTERNAL_USER_ID VARCHAR
FIRST_NAME VARCHAR
LAST_NAME VARCHAR
EMAIL_ADDRESS VARCHAR
GENDER VARCHAR
PHONE_NUMBER VARCHAR
DOB VARCHAR
TIMEZONE VARCHAR
HOME_CITY VARCHAR
COUNTRY VARCHAR
LANGUAGE VARCHAR
EFF_DT TIMESTAMP_NTZ
END_DT TIMESTAMP_NTZ

USER_CUSTOM_ATTRIBUTES_HISTORY_VIEW_SHAREDスキーマ

列名 データタイプ
APP_GROUP_ID VARCHAR
USER_ID VARCHAR
APP_ID VARCHAR
EXTERNAL_USER_ID VARCHAR
TIME NUMBER
TIME_MS NUMBER
UPDATE_SOURCE VARCHAR
SF_UPDATED_AT TIMESTAMP_NTZ
CUSTOM_ATTRIBUTES VARIANT
ARCHIVED BOOLEAN
EFF_DT TIMESTAMP_NTZ
END_DT TIMESTAMP_NTZ

ベストプラクティス

ユースケース 推奨ビュー 備考
最近の更新を必要としない一般的なクエリ USER_DEFAULT_ATTRIBUTES_VIEW_SHAREDとUSER_CUSTOM_ATTRIBUTES_VIEW_SHARED 高速な実行。データは最大12時間前のものです。
最新のユーザー属性を必要とするクエリ USER_LATEST_STATE_DEFAULT_ATTRIBUTES_VIEW_SHAREDとUSER_LATEST_STATE_CUSTOM_ATTRIBUTE_VIEW_SHARED ほぼリアルタイムの更新を提供しますが、大規模なデータセットでは低速になる場合があります。
属性変更の履歴追跡 USER_DEFAULT_ATTRIBUTES_HISTORY_VIEW_SHAREDとUSER_CUSTOM_ATTRIBUTES_HISTORY_VIEW_SHARED 属性の変更を12時間の粒度で保存します。

パフォーマンスに関する考慮事項

  • USER_DEFAULT_ATTRIBUTES_VIEW_SHAREDまたはUSER_CUSTOM_ATTRIBUTES_VIEW_SHAREDに対するクエリは、大規模なウェアハウスの大規模なデータセット（約10億ユーザー）で10秒以内に返されます。
  • 単一ユーザーに対するUSER_LATEST_STATE_DEFAULT_ATTRIBUTES_VIEW_SHAREDまたはUSER_LATEST_STATE_CUSTOM_ATTRIBUTE_VIEW_SHAREDのクエリは1分以内に返されますが、USER_IDフィルタリングなしではスケーリングが不十分です。
  • USER_LATEST_STATE_DEFAULT_ATTRIBUTES_VIEW_SHAREDまたはUSER_LATEST_STATE_CUSTOM_ATTRIBUTE_VIEW_SHAREDで1億人を超えるユーザーに対するクエリは、ユーザーごとの集計のため数分かかる場合があります。
New Stuff!