メインコンテンツへスキップ
この記事では、Portfolio 機能が有効になっている MoEngage ワークスペースにおけるデータの取り込み、管理、表示について説明します。この機能はデータとユーザープロファイルを一元化し、すべてのプロジェクトにわたってユーザープロパティとイベントをシームレスに管理できるようにします。この記事では以下の内容を扱います。
  • データの取り込み: 対象プロジェクトを指定しながら、Data APIs、SDK、Data Warehouse を使用してデータを取り込む方法。
  • データ管理: Portfolio が有効なワークスペース内でデータ、イベント、ユーザープロパティがどのように管理・表示されるか (ユニークイベントおよびユーザープロパティの上限の内訳を含む)。
  • ユーザープロファイルの表示: ポートフォリオレベルと個々のプロジェクトレベルの両方でユーザーデータがどのように表示されるか。
  • 派生ユーザープロパティ: 派生ユーザープロパティ (LTV、First Seen など) がプロジェクトレベルとポートフォリオレベルの両方でどのように計算・表示されるか。
Portfolio 機能は、ユニーク ID フィールドに基づいて複数のプロジェクトのユーザーデータを単一のプロファイルに統合するように設計されています。そのため、カスタム属性に基づく ID 解決 (プロファイルを統合するプロセス) はサポートされていません。

データの取り込み

お客様 (または開発チーム) は、以下を使用して Portfolio が有効なワークスペースにデータを取り込むことができます。

Data APIs

MoEngage では、データの取り込み時にユニーク ID を使用してユーザープロパティまたはイベントを更新します。Portfolio が有効なワークスペースでは、お客様 (または開発チーム) は Data APIs (Track User、Create Event、Bulk Import API など) を使用して、パラメーターに projectID を渡すことができます。この ID により、ユーザーまたはイベントがどのプロジェクトに属するかが識別されます。Project ID は、MoEngage ダッシュボードの Settings > Account > Portfolio で確認できます。 ユースケース あるブランドが「Brand A」(Project 1) と「Brand B」(Project 2) の別々のアプリを持っているとします。ユーザーが両方のアプリをダウンロードすると、Portfolio 機能は Data APIs または SDK を使用してそのユーザーのすべてのデータを取り込みます。projectID 属性によってデータがどのブランドから発生したかが識別されるため、すべてのイベントとユーザープロパティが単一のユーザープロファイルに統合されつつ、正しいプロジェクトに関連付けられます。
Data APIs を使用してデータを取り込む際、projectID なしで渡された属性は、カスタムポートフォリオユーザープロパティと見なされます。
以下は、API エンドポイントで projectID を渡す Data APIs の cURL リクエストのサンプルです。 Track User: JSON
Create Event: JSON

SDK

ポートフォリオの変更が利用可能なサポート対象の SDK:

Data Warehouse

Portfolio 機能はデータウェアハウス連携を強化し、複数プロジェクトのポートフォリオ内でデータを正しく管理する柔軟性を提供します。これにより、既存のバックエンドデータをブランド固有の分析と包括的な顧客理解の両方に活用できます。 MoEngage は、データの種類ごとに次のように処理します。
  • イベントプロパティはプロジェクトレベルで取り込まれるため、特定のアクションを正しいブランドに帰属させることができます。
  • ユーザープロパティはポートフォリオレベルで取り込まれ、更新はすべてのブランドにわたるユーザーのグローバルプロファイルに適用されます。

イベントプロパティ (プロジェクトレベル)

ポートフォリオで正確な分析とセグメンテーションを行うには、すべてのイベントを特定のプロジェクトに関連付けることが重要です。そのためには、データソースの列を専用の MoEngage 属性 moe_project_name にマッピングする必要があります。 eventattr.png シナリオ例: 2 つのブランド、Project A (スポーツアプリ) と Project B (ショッピングアプリ) を管理しているとします。データテーブルには brand という列があり、各イベントに対して「Project A」または「Project B」といった値が含まれています。 データウェアハウスのセットアップ時に、brand 列を MoEngage のイベントプロパティ moe_project_name にマッピングします。これにより、MoEngage はその列の値に基づいて各イベントを正しいプロジェクトに自動的に割り当てます。
ソース列の値 (例:「Project A」) は、MoEngage ポートフォリオで設定されているプロジェクト名と完全に一致する必要があります。一致しない場合、イベントはポートフォリオレベルで取り込まれ、特定のプロジェクトには関連付けられません。このデータは、プロジェクト固有の分析やセグメンテーションでは使用できなくなります。

ユーザープロパティの取り込み (ポートフォリオレベル)

一方、インポートするユーザープロパティは常にポートフォリオレベルで適用されます。これによりユーザーの単一のグローバルプロファイルが更新され、特定のプロジェクトには紐付けられません。プロセスはポートフォリオ以外のアカウントと同じで、User ID や Updated at などの標準列をマッピングする必要があります。
この方法を使用して、_プロジェクト固有の_ユーザープロパティをインポートまたは更新することはできません。データウェアハウスからのインポートでサポートされるのは、グローバルユーザープロパティのみです。
インポート設定の詳しい手順については、Data Warehouse インポートガイドを参照してください。

データ管理

Portfolio が有効なワークスペースでは、Settings >Data > Data Management に以下の詳細が表示されます。
  • Overview タブには、ポートフォリオ全体のユニークイベントとユーザープロパティの総数が表示されます。プロジェクト間でイベントやユーザープロパティを受け渡すことはできますが、ポートフォリオレベルの上限はデフォルトで固定されています (ユニークイベント 1024 件、ユニークユーザープロパティ 1024 件)。すべてのプロジェクトにわたるユニークイベントとユーザープロパティの合計がこれらの上限を超えないようにしてください。これにより、ビジネス全体のユニークイベントと属性の総数の追跡が簡素化され、固定の上限内に収めることができます。
  • Events タブと User attributes タブでは、すべてのプロジェクトにわたるイベントとユーザープロパティを包括的に確認できます。Select project リストを使用してリストをフィルタリングし、特定のプロジェクトのデータを表示できます。 filterbasedonproject.gif
  • 標準イベントとカスタムイベントの場合: MoEngage は、取り込まれたすべてのイベントに moe_project_name イベントプロパティを自動的に追加し、イベントの発生元プロジェクトを示します。たとえば、Project1 からの Purchase イベントには、値が Project1 の moe_project_name 属性が含まれます。 standard and custom events.png
  • 標準ユーザープロパティの場合: MoEngage は、ユーザープロパティの Display name と Key name の両方にプロジェクト名をサフィックスとして追加します。たとえば、newproject の custom_attr_2 ユーザープロパティの表示名とキー名は custom_attr_2_newproject になります。 custom_attr_2.png
  • カスタムユーザープロパティの場合: MoEngage は Key name にプロジェクト名をサフィックスとして追加し、Display name はユーザーが渡したものがサフィックスなしでそのまま使用されます。たとえば、newproject の custom_attr_2 ユーザープロパティのキー名は custom_attr_2_newproject となり、表示名は custom_attr_2 となります。

ユーザープロファイル

Portfolio が有効な場合、ユーザープロファイルの User Info タブには、ポートフォリオレベルとプロジェクトレベルの両方の情報が表示されます。たとえば、「Brand A」と「Brand B」の両方を利用するユーザーは単一のプロファイルを持ち、そこで合計の LTV Portfolio (両プロジェクトの LTV の合計) を確認できます。 ユーザープロファイルでは、ポートフォリオレベルで以下の詳細を確認できます。
  • First Name
  • Last Name
  • Email (Standard)
  • Mobile Number (Standard)
  • MoEngage ID
  • ID
  • Lifecycle
  • Conversion
  • Acquisition
  • Reachability
PORTFOLIO LEVEL-USER PROFILE.png ドロップダウンメニューからプロジェクトを選択すると、特定のプロジェクトの User Properties を表示できます。 USERPROPERTIES.png

派生ユーザープロパティの動作

異なるプロジェクト間で同じ名前のカスタム属性がある場合は、Data Management で名前を変更してください。これにより混乱を避け、パーソナライゼーションとコンバージョンの正確性を確保できます。
次の表は、プロジェクトレベルおよびポートフォリオレベルで追跡される派生ユーザープロパティの一覧です。

FAQ

この上限を超えたすべてのユニークユーザープロパティとイベントは自動的にブロックされます。
いいえ、できません。