イベントプロパティ

最終更新 2026/10/02

1. 機能の概要

これまでの状況

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

元の画像を見る

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

スーパーレイヤーモデル

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

元の画像を見る

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

注意

スーパーレイヤーモデルにおける「イベント」と、そのソースである「レポーティング済みイベント」や「クロスソースイベント」とを区別して説明するため、本文では「イベント」を「スーパーレイヤーイベント」と明記し、「レポーティング済みイベント」と「クロスソースイベント」をまとめて「ソースイベント」と呼びます

分析での使用

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

ビジネスシナリオの例

• 顧客Aがデータを直接送信し、スーパーレイヤーイベント「ユーザー登録」が生成されました。このイベントにはイベントプロパティ「チャネル」が含まれます

• 顧客Aがクロスソース構成を作成し、スーパーレイヤーイベント「バックエンド注文完了」が生成されました。このイベントにもイベントプロパティ「チャネル」が含まれます

• このときスーパーレイヤーイベントプロパティのリストを確認すると、「チャネル」という名前のイベントプロパティは1つしか表示されません

• このとき、スーパーレイヤーイベントプロパティ「チャネル」は2つのデータソースに関連付けられています：

  • 送信データの「ユーザー登録」イベント
  • クロスソースデータの「バックエンド注文完了」イベント

• レポートで「ユーザー登録」の「チャネル」の「重複除外数」をクエリすると、システムはAE内のイベントテーブルのプロパティを読み込んで計算し、結果を取得します

• レポートで「バックエンド注文完了」の「チャネル」の「重複除外数」をクエリすると、システムは外部のデータテーブルのプロパティを読み込んで計算し、結果を取得します

2. 使用方法

自動監視ロジック

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

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

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

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

リストページ

リスト管理ページの説明

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

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

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

イベントプロパティを新規作成する

スーパーレイヤーイベントプロパティの新規作成の説明

• イベントの関連付けの説明：現在のプロパティAがイベント1と関連付けられ、イベント2とは関連付けられていない場合、分析モデルで使用すると：

  • イベント1を選択すると、そのプロパティリストにプロパティAが表示されます
  • イベント2を選択すると、そのプロパティリストにプロパティAは表示されません

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

イベントプロパティの接続を設定する

スーパーレイヤーイベントプロパティのソース接続の設定

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

  • 1つのスーパーレイヤープロパティが接続関係を持てるのは、1つの送信プロパティのみです

  • 1つのスーパーレイヤープロパティが1つのクロスソースデータソース内で接続関係を持てるのは、1つのクロスソースプロパティのみです

  • プロパティAがイベント1、イベント2と関連付けられているものの、ソースプロパティの接続を設定していない場合：

    • 分析モデルでクエリしても計算結果を取得できません

  • プロパティAがイベント1、イベント2と関連付けられ、さらにそのデータソース内のプロパティとソース接続を設定している場合：

    • イベント1をクエリすると、システムはイベント1のソースデータからプロパティAの接続プロパティを読み込んで計算します
    • イベント2をクエリすると、システムはイベント2のソースデータからプロパティAの接続プロパティを読み込んで計算します

  • オブジェクトグループタイプのプロパティ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：イベントプロパティの非表示 20、イベントプロパティのコピーの作成 5000、参照テーブルプロパティの追加 89、サブプロパティの作成 5000、イベントプロパティの削除 5000、参照テーブルの更新 89、参照テーブルのダウンロード 59、参照テーブルの削除 21。仮想イベントプロパティの行の編集は 21 です。

4. パラメータの制限

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

5. よくある質問

• #user_idイベントプロパティを編集・削除できないのはなぜですか？

  • 分析モデルの可用性を確保するため、一部のプロパティはページ上で編集できません。該当するプロパティとその説明は以下のとおりです：
  • #user_id AEシステムにおけるユーザーの一意識別ID。分析モデルでデフォルトのユーザー重複除外数の計算に使用されます
  • #event_name イベント名。分析モデルでイベントの識別に使用されます
  • #event_time イベント時間。分析モデルでイベント時間の解析とタイムゾーンオフセットの計算に使用されます
  • #zone_offset タイムゾーンオフセット。分析モデルでイベントのタイムゾーンオフセットの計算に使用されます
  • #te_event_id イベントの一意識別ID。エンゲージのリアルタイム計算でイベントの一意性の識別に使用されます