クロスソースタグテーブル
このドキュメントでは、「クロスソースタグテーブル」の構成に特有のフィールドと、アセットリストに特有のロジックについてのみ説明します
クロスソースアセット構成機能の共通の説明は、クロスソースアセット構成機能の説明を参照してください
1. ワイド／ロングテーブル構造の説明
業務上、プレイヤーのタグ情報を記録する場合、「ワイドテーブル」と「ロングテーブル」の2種類の記録構造があります
🔵 ワイドテーブル構造
通常、先頭列にはプレイヤーの識別情報を記録します。例：プレイヤーID
その他のデータ列にはタグデータを記録し、列名がタグ名になります
| プレイヤー名 | スキル | 戦闘力 | 課金力 | アクティブ度 |
|---|---|---|---|---|
| 毒敵大王 | 蟹爪拳 | 1000 | 中課金 | 中程度アクティブ |
| 寅虎 | 隠身緩急刀 | 800 | 重課金 | 高アクティブ |
ワイドテーブルのサンプル
🔵 ロングテーブル構造
通常、先頭列にはプレイヤーの識別情報を記録します。例：プレイヤーID
タグ名は1つのデータ列に単独で記録します
タグ値はタイプに応じて別のデータ列に記録します
| プレイヤー名 | タグ名 | 文字列タグ値 | 数値タグ値 |
|---|---|---|---|
| 毒敵大王 | スキル | 蟹爪拳 | |
| 毒敵大王 | 戦闘力 | 1000 | |
| 毒敵大王 | 課金力 | 中課金 | |
| 毒敵大王 | アクティブ度 | 中程度アクティブ | |
| 寅虎 | スキル | 隠身緩急刀 | |
| 寅虎 | 戦闘力 | 800 | |
| 寅虎 | 課金力 | 重課金 | |
| 寅虎 | アクティブ度 | 高アクティブ |
ロングテーブルのサンプル
2. クロスソース構成のフィールドの説明
2.1 分析主体情報
タグ機能を使用する際は、タグに対応する主体を指定する必要があります
例：ユーザー主体のタグには、通常、登録時間、課金頻度、ログイン頻度などがあります
例：デバイス主体のタグには、通常、アクティベーション時間、流入チャネル、広告グループなどがあります
クロスソースタグを構成する際は、タグデータに対応する主体と、外部データソースで主体を表す列を指定する必要があります
分析主体情報フィールドのプレビュー
🔵 分析主体
AEシステムで現在のプロジェクトに存在する分析主体は、「プロジェクト管理」>「分析主体」モジュールで確認・管理できます
または、システムマニュアルプロジェクトの分析主体を参照してください
⚠ 分析主体は文字列、数値タイプのみに対応しています
分析主体機能のプレビュー
🔵 分析主体列
データソースで、主体情報を記録しているデータ列を選択します
⚠ データ列のタイプは、選択した分析主体と一致している必要があります。ドロップダウンリストでは、タイプが一致しない選択肢は自動的に除外されて表示されます
2.2 ワイド／ロングテーブル情報
データソースの構造に応じて、「ワイド／ロング」を選択します
🔵 ワイドテーブル
ワイドテーブルモードでは、追加のフィールドはありません
ワイドテーブルのフィールドプレビュー
🔵 ロングテーブル
ロングテーブルモードでは、「タグ名列」と「タグ値列」フィールドが追加されます
ロングテーブルのフィールドプレビュー
以下のサンプルをもとに、フィールドの設定方法を説明します
| user_name | tag_name | str_value | num_value |
|---|---|---|---|
| 毒敵大王 | スキル | 蟹爪拳 | |
| 毒敵大王 | 戦闘力 | 1000 | |
| 毒敵大王 | 課金力 | 中課金 | |
| 毒敵大王 | アクティブ度 | 中程度アクティブ | |
| 寅虎 | スキル | 隠身緩急刀 | |
| 寅虎 | 戦闘力 | 800 | |
| 寅虎 | 課金力 | 重課金 | |
| 寅虎 | アクティブ度 | 高アクティブ |
ロングテーブルモードのサンプルデータソース
🔵 タグ名列
データソースでタグ名を表す列を選択します。上記のサンプルでは「tag_name」を選択します
🔵 タグ値列
データソースでタグ値を表す列を選択します。上記のサンプルでは「str_value」を選択します
⚠ タグ値のタイプが多いため、データソースにタグ値を記録する列が複数ある場合があります。その場合は、大部分のタグ値を記録している列を入力すれば十分です。その他のタグ値は「アセットリスト」で設定できます。例：「戦闘力」タグの場合は、アセットリストの「値の取得方式」に「num_value」と入力します
2.3 日付バージョン情報
日付バージョンは、タグの計算時に過去の各日付に対応するバージョンを記録しているかどうかを表します
a.最新バージョンのみ
各タグに最新の記録値が1つだけあり、過去の日付バージョンの情報がない場合は、下表のように「最新バージョン」とみなします
| user_name | skill | power |
|---|---|---|
| 毒敵大王 | 蟹爪拳 | 1000 |
| 寅虎 | 隠身緩急刀 | 800 |
最新バージョンのみのタグ値のサンプル
この場合、追加のフィールドはありません。「日付バージョン」で「最新バージョンのみ」を選択するだけです
最新バージョンのみの設定サンプル
b.履歴バージョンおよび最新版
各タグについて、日付ごとに対応するタグ値が保存されていて
そのうち最大の日付のタグ値が最新の記録結果である場合
「日付バージョン」で「履歴バージョンおよび最新版」を選択する必要があります
| user_name | skill | power | tag_date |
|---|---|---|---|
| 毒敵大王 | 蟹爪拳 | 1000 | 2025-01-01 |
| 寅虎 | 隠身緩急刀 | 800 | 2025-01-01 |
| 毒敵大王 | 蟹爪拳 | 1000 | 2025-01-02 |
| 寅虎 | 隠身緩急刀 | 800 | 2025-01-02 |
日付バージョン値を含むタグのサンプル
この場合、日付情報に関する設定フィールドが追加されます
履歴バージョンおよび最新版のフィールドプレビュー
🔵 日付情報列
データソースで日付情報を記録しているデータ列を入力します。上記のサンプルでは「tag_date」です
🔵 日付情報のフォーマット
日付情報列の値の形式に合わせて入力します。上記のサンプルでは「yyyy-MM-dd」です
ここで、yyyyは4桁で記録した年、MMは2桁で記録した月、ddは2桁で記録した日を表します
c.履歴バージョンのみ
（複雑なシーン）一連のタグに履歴バージョンがあるものの、「最新バージョン」と「履歴バージョン」をそれぞれ2つのデータソースに保存している場合
上記の説明のとおり、「最新バージョン」のデータソースをもとにクロスソース構成Aを作成します
次に、「履歴バージョン」のデータソースをもとにクロスソース構成Bを作成し、日付バージョンを「履歴バージョンのみ」に設定します
さらに、2つのクロスソース構成のその他のフィールドとアセットリストが一致するようにしてください
3. クロスソースアセットリストの構成の説明
3.1 アセットのデータタイプ
クロスソースタグのアセットは、次のデータタイプに対応しています：
文字列、数値、ブール値、時間、リスト
値の取得方式に関する複雑なシーンは、クロスソース構成の複雑なシーンとSQLサンプルを参照してください
クロスソースタグのデータタイプのプレビュー
3.2 クロスソースタグの拡張情報
クロスソースタグでは「値タイムゾーン」フィールドを設定する必要があります。タグ値に対応するタイムゾーンを示すもので、デフォルト値は「現地時間」(99)です
分析スイートとエンゲージスイートの一部の機能では、同じタイムゾーン設定のタグしか使用できません
[すべてのタグに適用]をクリックすると、タイムゾーン値を現在のアセットリスト内のすべてのタグに適用できます
クロスソースタグの拡張情報のプレビュー