ユーザープロパティ

最終更新 2026/10/02

1. 機能の概要

これまでの状況

• 従来のデータモデルでは、データの送信後にユーザープロパティやイベントプロパティなどのアセットが直接生成され、レポート／ダッシュボードなどのアセットの構築に使用されていました
• マルチソースデータの統合には対応できず、データ送信前に分析シーン向けのアセットを構築することもできませんでした

元の画像を見る

従来のデータモデル：送信データを分析機能で直接使用

スーパーレイヤーモデル

• スーパーレイヤーモデルの導入により、ソースデータと分析機能の利用との間に分離レイヤーが追加され、両者の強い依存関係が解消されました
• 複数ソースのデータの連携に対応し、スーパーレイヤーオブジェクトでそれらの接続関係を設定できます
• データが実際に発生する前でも、スーパーレイヤーオブジェクトはプレースホルダーとして存在できるため、レポートやダッシュボードの構築を並行して進められます
• プロジェクトの移行が必要な場合、分析レイヤーのアセットはスーパーレイヤーに基づいて移行でき、移行後に異常となる可能性のある接続関係も柔軟に調整できます

元の画像を見る

スーパーレイヤーモデル：スーパーレイヤーオブジェクトでソースデータに接続してから分析に使用

注意

ユーザープロパティはイベントプロパティとは異なり、各ユーザープロパティに設定できるデータソースは1つ（送信またはクロスソース）のみです

クロスソースユーザープロパティの設定は、データ管理者が有効にする必要があります。プロジェクトの立ち上げ段階で相談・確認のうえ、関連する操作を実行してください

現在のバージョンでは、クロスソースユーザープロパティの設定は「クロスソース構成（エンティティテーブル）」で行います

注意

スーパーレイヤーモデルにおける「ユーザープロパティ」と、そのソースである「報告ユーザープロパティ」や「クロスソースユーザープロパティ」とを区別して説明するため、本文では「ユーザープロパティ」を「スーパーレイヤーユーザープロパティ」と明記し、「報告ユーザープロパティ」と「クロスソースユーザープロパティ」をまとめて「ソースユーザープロパティ」と呼びます

分析での使用

• リストの選択：従来のシステムではユーザープロパティリストはすべて「報告ユーザープロパティ」でしたが、スーパーレイヤーモデルへのアップグレード後は、ユーザープロパティリストはすべて「スーパーレイヤーユーザープロパティ」になります。対応できるデータソースが広がる一方、使い勝手は従来と変わりません
• モデルクエリ：レポートを作成すると、AEシステムはスーパーレイヤーユーザープロパティのソースに応じて、送信データまたはクロスソースデータを自動で識別・読み込んで計算します。使い勝手は従来と変わりません
• SQL IDE：SQL IDEは高度にカスタマイズされるシナリオであるため、クエリ時にはソースに合わせて実際の from xxx 文を記述し、元のテーブルのデータに基づいてクエリSQL文を作成する必要があります

2. 使用方法

自動監視ロジック

• 新しいユーザープロパティのデータが送信されると、AEシステムは自動で監視し、同名のスーパーレイヤーユーザープロパティを作成して接続します

• ユーザーが「クロスソース構成（エンティティテーブル）」を作成した場合も、AEシステムは構成内のユーザープロパティを読み込み、プロパティの接続設定を自動で追加します

• 自動作成／接続時のロジック

  • 同名のスーパーレイヤーユーザープロパティがない場合、システムはスーパーレイヤーユーザープロパティを自動で作成して関連付けます
  • 同名かつ同タイプで、未接続のスーパーレイヤーユーザープロパティがすでにある場合、システムはそのスーパーレイヤーユーザープロパティに関連付け情報を設定します
  • 同名でタイプが異なるスーパーレイヤーユーザープロパティがすでにある場合、ユーザーがユーザープロパティと接続関係を手動で確認する必要があります

リストページ

リスト管理ページの説明

リストページの各部の機能は次のとおりです。番号は上図の注記に対応しています：

1. 「表示状態」：ユーザープロパティの表示状態をフィルターします。
2. プロパティ名、表示名、備考：ユーザープロパティの名前、表示名、備考。
3. 「ソースユーザープロパティ管理」：ソースユーザープロパティ管理ページに移動し、ソースユーザープロパティを確認・管理します。
4. 「表示名」：ユーザープロパティの表示名を一括設定します。
5. 「+ ユーザープロパティ」：新しいスーパーレイヤーユーザープロパティまたは仮想ユーザープロパティを作成します。
6. 検索ボックス：ユーザープロパティ名、表示名、備考で検索できます。
7. 行操作：現在のスーパーレイヤーユーザープロパティを編集したり、現在のスーパーレイヤーユーザープロパティの接続関係を設定したりします。
8. 「その他」メニュー：「非表示」で表示状態を切り替え、「コピーを作成」でプロパティのコピーを作成、「アップロード」でプロパティに参照テーブルを追加、「削除」で現在のスーパーレイヤーユーザープロパティを削除します。オブジェクト／オブジェクトグループタイプのプロパティには「サブタイププロパティを作成する」もあります。

• フィールドの説明は以下のとおりです

フィールド名	説明
ユーザープロパティ名	アルファベットで始まり、アルファベット、数字、アンダースコアを使用可能。最大80文字
ユーザープロパティ表示名	中国語・英語に対応。最大80文字
備考	中国語・英語に対応。最大200文字
プロパティタイプ	ユーザープロパティは分析モデルで使用する基本プロパティです。他の機能と組み合わせて、仮想プロパティ、ディメンションプロパティ、為替レートプロパティを生成できます
データタイプ	例：文字列／数値／ブール値／時間／リスト／オブジェクト／オブジェクトグループなど
リアルタイム利用可能ステータス	トリガー型エンゲージのトリガールールおよびリアルタイムアラートに使用できるかどうか
接続ステータス	現在のユーザープロパティがソースデータと接続済みかどうか
データステータス	データ接続の利用可能状態が正常かどうか
操作	編集 = ユーザープロパティの基本情報を編集 コピーを作成 = 現在のユーザープロパティに基づいてコピーを作成 非表示/表示 = ユーザープロパティの表示状態を非表示/表示に設定 アップロード = 現在のプロパティに参照テーブルを追加（オブジェクト/オブジェクトグループタイプは非対応） ダウンロード/参照テーブルを更新/参照テーブルを削除 = 参照テーブルを追加済みのプロパティに対応する操作を追加 サブタイププロパティを作成する = オブジェクト/オブジェクトグループタイプのプロパティにサブプロパティを作成 削除 = 現在のユーザープロパティを削除

ユーザープロパティの新規作成

スーパーレイヤーユーザープロパティの新規作成の説明

プロジェクトの初期段階で作成するアセットが多い場合は、イベントとプロパティの一括編集機能を使用できます

ユーザープロパティの接続を設定する

スーパーレイヤーユーザープロパティのソース接続の設定

• プロパティのソース接続の説明：

  • 1つのスーパーレイヤープロパティが接続関係を持てるのは、1つの送信プロパティのみです
  • オブジェクトグループタイプのプロパティPがあり、その中にサブプロパティP1が含まれる場合：
    • サブプロパティP1の接続プロパティも同様にサブプロパティである必要があり、かつその親プロパティがプロパティPとすでに接続関係を持っている必要があります

3. 主な機能の権限の説明

ユーザープロパティ関連の機能に関わる権限は次のとおりです：

権限ID	機能	操作権限	機能の詳細
19	メタデータ	確認	イベント、イベントプロパティ、ユーザープロパティのリストの確認、データテーブルのプレビュー
20	メタデータ	編集	元イベント、イベントプロパティ、ユーザープロパティの表示名を編集
21	メタデータ	編集	仮想イベント、参照テーブル、仮想プロパティを編集
59	メタデータ	確認	プロパティの参照テーブルのエクスポート、データテーブルの内容のダウンロード、データテーブルの履歴内容のダウンロード
89	メタデータ	編集	ファイルアップロード型データテーブルの追加・編集、ファイルアップロード型データテーブルの履歴バージョンの復元
5000	メタデータ	編集	イベント/イベントプロパティリストの管理、データ接続関係の設定、送信/クロスソースのアセット情報の確認

図中の番号に対応する入口と必要な権限は次のとおりです：

1. ユーザープロパティページへのアクセス（確認）：権限ID 19
2. 「ソースユーザープロパティ管理」（ソースユーザープロパティの管理）：権限ID 5000
3. 「表示名」（表示名の編集）：権限ID 20
4. 「+ ユーザープロパティ」：スーパーレイヤーユーザープロパティの作成には権限ID 5000、仮想ユーザープロパティの作成には権限ID 21が必要です
5. 行内での表示名・備考の編集：権限ID 20
6. 行操作：スーパーレイヤーユーザープロパティの編集と接続の設定には権限ID 5000、仮想ユーザープロパティの編集には権限ID 21が必要です

「その他」メニュー（「リストページ」の画像を参照）の各操作に必要な権限は次のとおりです：

• ユーザープロパティの非表示：権限ID 20
• ユーザープロパティのコピーの作成：権限ID 5000
• 参照テーブルの追加：権限ID 89
• サブプロパティの作成：権限ID 5000
• ユーザープロパティの削除：権限ID 5000
• 参照テーブルを追加済みのプロパティ：参照テーブルの更新には権限ID 89、参照テーブルのダウンロードには権限ID 59、参照テーブルの削除には権限ID 21が必要です

4. パラメータの制限

• 1つのプロジェクトで作成できるスーパーレイヤーユーザープロパティは1,000個です

5. よくある質問

• #user_idユーザープロパティを編集・削除できないのはなぜですか？

  • 分析モデルの可用性を確保するため、一部のプロパティはページ上で編集できません。該当するプロパティとその説明は以下のとおりです：
  • #user_id AEシステムにおけるユーザーの一意識別ID。分析モデルでデフォルトのユーザー重複除外数の計算に使用されます