イベントとプロパティの一括編集
1. 機能の概要
これまでの状況
- 従来のデータモデルでは、データが送信されるとイベントやイベントプロパティなどのアセットが直接生成され、レポート/ダッシュボードなどのアセットの構築に使用されていました
- マルチソースデータの統合には対応できず、データ送信前に分析シーン向けのアセットを構築することもできませんでした
従来のデータモデル：送信データを分析機能で直接使用
スーパーレイヤーモデル
- スーパーレイヤーモデルの導入により、ソースデータと分析機能の利用との間に分離レイヤーが追加され、両者の強い依存関係が解消されました
- 複数ソースのデータの連携に対応し、スーパーレイヤーオブジェクトでそれらの接続関係を設定できます
- データが実際に発生する前でも、スーパーレイヤーオブジェクトはプレースホルダーとして存在できるため、レポートやダッシュボードの構築を並行して進められます
- プロジェクトの移行が必要な場合、分析レイヤーのアセットはスーパーレイヤーに基づいて移行でき、移行後に異常となる可能性のある接続関係も柔軟に調整できます
スーパーレイヤーモデル：スーパーレイヤーオブジェクトでソースデータに接続してから分析に使用
スーパーレイヤーモデルにおける「イベント」と、そのソースである「レポーティング済みイベント」や「クロスソースイベント」とを区別して説明するため、本文では「イベント」を「スーパーレイヤーイベント」と明記し、「レポーティング済みイベント」と「クロスソースイベント」をまとめて「ソースイベント」と呼びます
一括編集
- データ収集プランのすり合わせが完了し、データの接続を待っている間、ビジネスロールのメンバーはイベント、イベントプロパティ、ユーザープロパティのページで対応するアセットを1つずつ作成し、レポートやダッシュボードの構築に使用できます
- 関連するアセットの作成効率をさらに高めるため、現在は「一括インポート/エクスポート」機能を使用して、すり合わせ済みのデータ収集プランや、データ規約が類似するプロジェクトのアセットプラン全体を、そのまま、またはEXCELで修正したうえで現在のプロジェクトにインポートでき、後続のダッシュボード構築をより迅速に進められます
2. 機能の入口
イベント、イベントプロパティ、ユーザープロパティのページに進み、右上の [管理] ボタンをクリックすると、その他の機能のリストを展開できます
その中に、アセット構成のインポートとエクスポートの機能の入口が含まれています
機能の入口
各機能に必要な権限の詳細は次のとおりです
| 機能の入口 | 権限に対応する機能名 | カテゴリ | 権限に対応する機能の詳細 |
|---|---|---|---|
| エクスポートデータ資産構成 | メタデータ | 確認 | イベント、イベントプロパティ、ユーザープロパティのリストの確認、データテーブルのプレビュー |
| アセット構成インポート | メタデータ | 編集 | イベント/イベントプロパティリストの管理、データ接続関係の設定、送信/クロスソースのアセット情報の確認 |
権限設定ページ
3. 操作手順
3.1 アセット構成のエクスポート
エクスポートをクリックすると、ブラウザのダウンロードウィンドウが自動的に表示されるので、そのままEXCELファイルを保存します
3.2 アセット構成のインポート
⚠ アセット構成をインポートすると、システムはアセット名に基づいて、プロジェクト内の対応するアセットのタイプ、表示名、備考などの情報を作成・変更します
⚠ 構成EXCELで空欄になっている情報がある場合、システムはプロジェクト内のアセット情報も同様にクリアします。例：備考、表示名のクリアなど
⚠ プロジェクトに既に存在するが、EXCELに記入されていないアセット情報については、システムは変更しません。つまり、EXCELに存在しないアセットが一括削除されることはありません
確認のポップアップ
⚠ アセット構成をアップロードする前に、その内容が使用可能かどうかを確認することをお勧めします。誤った構成をアップロードすると、アセットを何度も削除しなければならなくなる場合があります
インポートをクリックすると、ポップアップに重要な情報が表示されます。[続行] をクリックして次のステップに進み、インポートする構成ファイルを選択します
構成ファイルのアップロード
インポート後、システムはまずEXCELの内容を解析し、結果を確認した後にアセット構成のインポートを実行します
解析結果の確認
インポートの実行結果
4. EXCELテンプレートの説明
アセットのインポート機能は、<データ収集管理>のEXCELファイルのアップロードに対応しています。データ収集プランの確定後、プランのEXCELを直接インポートしてイベントやプロパティを生成し、レポートやダッシュボードの構築を開始できます
4.1 サブシートの一覧
アセット構成のEXCELファイルをエクスポートして開くと、3つのサブシートがあります
EXCELサブシートのプレビュー
各サブシートの役割は次のとおりです
| サブシート名 | 説明 |
|---|---|
| #イベントデータ | イベントとその関連イベントプロパティの情報を記録します。規約は<データ収集管理>機能のデータ収集プランの表と同様です |
| #Public Event Properties | あるイベントプロパティがすべてのイベントに関連付けられている場合は、このシートに個別に記入できます。インポート後、システムはそのプロパティの「共通イベントプロパティ」状態を有効にします |
| #ユーザープロパティ | ユーザープロパティの情報を記録します |
4.2 イベントデータシート
単一のイベントの情報とその関連イベントプロパティは、次の表を参考に記入します
| イベント名（必須） | イベント表示名 | イベントの説明 | プロパティ名（必須） | プロパティ表示名 | プロパティタイプ（必須） | プロパティの説明 |
|---|---|---|---|---|---|---|
| activity_attend | アクティビティ参加 | アクティビティ報酬の受け取り | activity_type | アクティビティタイプ1 | テキスト | 初心者向けアクティビティなど |
| channel | 流入チャネル | テキスト | IOS/Android | |||
| level | レベルアップ後のレベル | 数値 | ||||
| platform | システムプラットフォーム識別子 | テキスト | プラットフォーム識別子：android、IOS、harmonyOS、PC | |||
| serverid | サーバーID | 数値 | ||||
| vip_level | vipレベル | 数値 | ||||
| #device_id | テキスト | |||||
| #lib | テキスト | |||||
| #lib_version | テキスト | |||||
| #os | テキスト |
イベントデータシートのプレビュー
各フィールドの説明は次のとおりです：
| フィールド名 | 説明 |
|---|---|
| イベント名（必須） | 小文字で始まり、小文字、数字、アンダースコアで構成され、長さは60文字以内 |
| イベント表示名 | 長さは60文字以内 |
| イベントの説明 | 長さは200文字以内 |
| プロパティ名（必須） | 小文字で始まり、小文字、数字、アンダースコアで構成され（オブジェクトグループのサブプロパティには半角ピリオドが含まれます）、長さは80文字以内 |
| プロパティ表示名 | 長さは80文字以内 |
| プロパティタイプ（必須） | 数値、文字列、時間、ブール値、リスト、オブジェクト、オブジェクトグループ |
| プロパティの説明 | 長さは200文字以内 |
4.3 共通イベントプロパティシート
プロパティがすべてのイベントに関連付けられている場合は、ここにプロパティ情報を記入します
⚠ あるプロパティが<イベントデータシート>と<共通イベントプロパティシート>の両方に記入されている場合は、「共通イベントプロパティ」とみなされます
| プロパティ名（必須） | プロパティ表示名 | プロパティタイプ（必須） | プロパティの説明 |
|---|---|---|---|
| channel | チャネル | テキスト | |
| level | レベル | 数値 | |
| gold_left | 残りのゴールド | 数値 |
共通イベントプロパティシートのプレビュー
各フィールドの説明は次のとおりです：
| フィールド名 | 説明 |
|---|---|
| プロパティ名（必須） | 小文字で始まり、小文字、数字、アンダースコアで構成され（オブジェクトグループのサブプロパティには半角ピリオドが含まれます）、長さは80文字以内 |
| プロパティ表示名 | 長さは80文字以内 |
| プロパティタイプ（必須） | 数値、文字列、時間、ブール値、リスト、オブジェクト、オブジェクトグループ |
| プロパティの説明 | 長さは200文字以内 |
4.4 ユーザープロパティシート
ユーザープロパティの情報は、次の表を参考に記入します
| プロパティ名（必須） | プロパティ表示名 | プロパティタイプ（必須） | プロパティの説明 |
|---|---|---|---|
| ad | 広告ID | テキスト | |
| ad_set | 広告グループID | テキスト | |
| campaign | 広告Campaign | テキスト | |
| channel | 流入チャネル | テキスト | app store,Huawei AppGallery,Xiaomi App Store,vivo,taptap,Wandoujia＝first |
| current_level | 現在のレベル | 数値 | |
| first_login_time | 初回ログイン時間 | 時間 | 初回ログイン時に設定 |
ユーザープロパティシートのプレビュー
各フィールドの説明は次のとおりです：
| フィールド名 | 説明 |
|---|---|
| プロパティ名（必須） | 小文字で始まり、小文字、数字、アンダースコアで構成され（オブジェクトグループのサブプロパティには半角ピリオドが含まれます）、長さは80文字以内 |
| プロパティ表示名 | 長さは80文字以内 |
| プロパティタイプ（必須） | 数値、文字列、時間、ブール値、リスト、オブジェクト、オブジェクトグループ |
| プロパティの説明 | 長さは200文字以内 |