クロスソースイベントテーブル
このドキュメントでは、「クロスソースイベントテーブル」の構成に特有のフィールドと、アセットリストに特有のロジックについてのみ説明します
クロスソースアセット構成機能の共通の説明は、クロスソースアセット構成機能の説明を参照してください
1. 基本情報
AE仕様のイベントテーブルのデータ構造には、いくつかの重要なデータ列が含まれます。これらの重要なデータ列は、後続の分析モデルの機能の利用に影響します
例：$part_event、#event_time、$part_date など
その他の列はカスタムのイベントプロパティです。例：下表のサンプルのchannel、role_level、amount
| #user_id | $part_event | #event_time | #zone_offset | $part_date | channel | role_level | amount |
|---|---|---|---|---|---|---|---|
| 山田 | login | 2025-10-29 10:25:59 | 8 | 2025-10-29 | Douyin | ||
| 佐藤 | level_up | 2025-10-09 04:00:48 | 8 | 2025-10-09 | 47 | ||
| 鈴木 | payment | 2025-10-20 10:29:16 | 0 | 2025-10-20 | 70 | 166 | |
| 田中 | battle_win | 2025-10-08 15:56:31 | -4 | 2025-10-08 | 83 |
AEのイベントテーブルのサンプル
外部データソースをクロスソースイベントテーブルとして設定する場合は、AE仕様の形式に変換し、クロスソース構成フィールドで設定する必要があります
イベントプロパティとして使用するその他の列は、業務ニーズに応じてアセットリストで設定できます
⚠ クロスソース構成フィールドで設定済みの列は、アセットリストで改めてアセットとして設定する必要はありません
| uid | action | ts | timezone | pt | channel | role_level | amount |
|---|---|---|---|---|---|---|---|
| 山田 | login | 2025-10-26 04:21:54 | 8 | 2025-10-26 | Douyin | ||
| 佐藤 | level_up | 2025-10-09 15:22:26 | 8 | 2025-10-09 | 77 | ||
| 鈴木 | payment | 2025-10-15 06:28:51 | 0 | 2025-10-15 | 54 | 166 | |
| 田中 | battle_win | 2025-10-21 19:23:40 | -4 | 2025-10-21 | 71 |
外部データソースのサンプル
2. クロスソース構成のフィールドの説明
2.1 分析主体情報
データソース内で、AEのイベントテーブルの #user_id に相当するデータ列を設定します。サンプルデータでは uid です
広告アトリビューションイベント、集計データイベントなど、ユーザー行動に関係しないデータの場合は、ここを空欄のままにしてください
⚠ プロジェクトのデータが「レポーティング済みイベントとクロスソースイベントの混在」「クロスソースユーザープロパティとクロスソースイベントのドリルダウン」などの複雑なシーンに関わる場合は、導入の初期段階でThinkingAI側のメンバーとデータの状態および対応方針を確認してください
分析主体列_プレビュー
2.2 イベント名情報
データソース内で、AEのイベントテーブルの $part_event に相当する情報の読み取り方法を設定します
🔵 カラム値を読み取る
データソース内でイベント名を記録しているデータ列を直接選択します
サンプルデータでは
actionです⚠データソースでこの列をパーティションキーにすることをおすすめします。クエリのパフォーマンスが向上します
イベント名_カラム値を読み取るのプレビュー
🔵 固定値
データソースに1つのイベントのデータしかなく、イベント名を記録した列もない場合は、ここで固定値を選択します
あわせて「イベント名」フィールドに対応する名前を入力します。例：user_login
イベント名_固定値のプレビュー
2.3 イベント時間情報
データソース内で、AEのイベントテーブルの #event_time に相当する情報の読み取り方法を設定します
🔵 カラム値を読み取る
データソース内でイベント時間を記録しているデータ列を直接選択します。データタイプは時間である必要があります
サンプルデータでは
tsです
イベント時間_カラム値を読み取るのプレビュー
🔵 カスタムSQL
データソースでイベント時間の情報を文字列や数値のタイムスタンプなどの形式で記録している場合は、SQL関数で時間タイプに変換する必要があります
例：try_cast( "ts" as timestamp )
その他の複雑なシーンは、クロスソース構成の複雑なシーンとSQLサンプルを参照してください
イベント時間_カスタムSQLのプレビュー
2.4 イベントタイムゾーン情報
データソース内で、AEのイベントテーブルの #zone_offset に相当する情報の読み取り方法を設定します
🔵 カラム値を読み取る
データソース内でイベントのタイムゾーンを記録しているデータ列を直接選択します。データタイプは数値である必要があります
サンプルデータでは
timezoneです
イベントタイムゾーン_カラム値を読み取るのプレビュー
🔵 固定値
データソース内のデータがすべて同じタイムゾーンのものである場合（例：サーバーがUTC+8で収集したログ）は、対応するタイムゾーンを設定するだけで済みます
イベントタイムゾーン_固定値のプレビュー
🔵 カスタムSQL
データソースでタイムゾーン情報を別の形式で記録している場合は、SQL関数で数値タイプに変換する必要があります
例：try_cast( substr( 'UTC+8' , 4 , 9 ) as double ) /* 使用時は 'UTC+8' を列名に置き換えます */
その他の複雑なシーンは、クロスソース構成の複雑なシーンとSQLサンプルを参照してください
イベントタイムゾーン_カスタムSQLのプレビュー
2.5 データパーティショニング方式
データソース内で、AEのイベントテーブルの $part_date に相当する情報の読み取り方法を設定します
🔵 日付情報列
データソース内で日付パーティションを記録しているデータ列を直接選択します。データタイプは文字列である必要があります
サンプルデータでは
ptです⚠データソースでこの列をパーティションキーにすることをおすすめします。クエリのパフォーマンスが向上します
🔵 プッシュダウンロジックのカスタム
データソースが別の形式でパーティション分割されている場合は、カスタムのプッシュダウンロジックを使用する必要があります。クエリ時のフロントエンドの日付範囲を変数として、対応するプッシュダウンロジックのSQLを記述します
詳しくは、クロスソース構成の複雑なシーンとSQLサンプルを参照してください
3. クロスソースアセットリストの構成の説明
クロスソースイベントテーブルの構成では、アセットの設定にイベントプロパティ、イベント、イベントとプロパティのマッチング関係の3種類があり、それぞれ設定する必要があります
クロスソースイベントテーブルの各種アセットのプレビュー
3.1 イベントプロパティ
3.1.1 アセットのデータタイプ
クロスソースイベントプロパティのアセットは、次のタイプに対応しています：
文字列、数値、ブール値、時間、リスト、オブジェクト、オブジェクトグループ
値の取得方式に関する複雑なシーンは、クロスソース構成の複雑なシーンとSQLサンプルを参照してください
クロスソースイベントプロパティのデータタイプのプレビュー
3.1.2 共通イベントプロパティ
クロスソースイベントプロパティを設定する際、拡張情報で特定のプロパティを「共通イベントプロパティ」に設定できます
設定すると、そのプロパティは現在の構成のすべてのイベントとマッチング関係が確立されます（他のクロスソース構成には影響しません）
クロスソースイベントプロパティの共通イベントプロパティのプレビュー
3.2 イベント
⚠ イベントアセットで「アセットをスキャン」を使用する前に、構成フィールドの「イベント名情報」の設定を完了しておく必要があります
スキャン後、アセットリストの1列目にスキャンされたイベント名が表示されます。ここで出力イベントの表示名と備考を変更できます
- 出力するイベントが元の値と同じ場合は、「オリジナルイベント一覧」を空欄のままにします（下図のpayment）
- 複数のイベントを1つのイベントにまとめる場合は、まとめるイベントのリストを半角の括弧とシングルクォートで入力します（下図のbattle_end）
- 1つのイベントの出力名を変更する場合は、オリジナルイベント一覧にイベントを1つだけ含むリストを入力します（下図のactivity_attend）
イベントアセットの設定のプレビュー
3.3 イベントとプロパティのマッチング関係
分析モデルでは、あるイベントAを選択すると、そのイベント内のプロパティBでさらにフィルターや計算を行えます。その際、関係のないプロパティCは表示されません
このロジックを「イベントとプロパティのマッチング関係」と呼びます。業務担当者がイベントデータ間の関連を把握しやすくなり、操作効率が向上します
AEシステムにおけるイベントとプロパティの関係のプレビュー
AEシステムでは、データ送信によって取り込まれたデータについて、ETLの段階で各イベントとプロパティの関係を解析できます
しかし、クロスソースマッピングのデータでは、システムが外部データソースの関係を自動で識別できないため、構成で指定する必要があります
イベントとプロパティの関係の設定のプレビュー
設定時は、まず「全マッピング関係表のダウンロード」を行います。システムが設定済みの「イベントプロパティ」と「イベント名」を読み取り、全マッピング関係のデータを生成します。また、「全マッチング関係を一括設定」をクリックすると、イベントプロパティとイベントを全マッピング関係に直接設定できます
次に、データから不要なデータを削除し、UTF-8形式のCSVファイルとしてエクスポートします (UTF-8形式のCSVファイルをエクスポートするには？)
| 出力されたイベント名 | 出力プロパティ名 |
|---|---|
| event_a | prop_a |
| event_a | prop_b |
| event_a | prop_c |
| event_b | prop_a |
| event_b | prop_b |
処理後のマッチング関係のプレビュー
完了したら、「マッチング関係データのアップロード」をクリックして対応するファイルをアップロードし、手順に従って操作します
解析が完了すると、アップロードと解析の結果がポップアップで表示されます
⚠ 構成でマッチング関係を設定していない場合、そのイベントの以降の分析モデルでの利用に影響する可能性があります。その際はページにポップアップで通知されます
マッチング関係の異常ポップアップのプレビュー