属性
属性は、ユーザーの行動に関する詳細な記述データであり、イベント属性、ユーザー属性、デバイス属性の3種類に分類されます。属性を通じてイベント/ユーザー/デバイスをさらに記述することで、ユーザージャーニーにおけるフィルタ条件として選択できます。
属性の種類
属性は、イベント属性、ユーザー属性、デバイス属性の3つのカテゴリに分けられます。各カテゴリはさらに、標準属性、推奨属性、カスタム属性に分けられます。
| カテゴリ | 属性タイプ | 説明 |
|---|---|---|
| イベント属性 | 標準 | SDKによって自動収集および報告される、またはバックエンド計算によって生成される事前定義されたイベント属性 |
| 推奨 | 開発者がAPI呼び出しを通じて報告する事前定義されたイベント属性 | |
| カスタム | ビジネスニーズに基づいて開発者が自由に作成および報告するイベント属性 | |
| デバイス属性 | 標準 | SDKによって自動収集および報告される、またはバックエンド計算によって生成される事前定義されたデバイス情報 |
| ユーザー属性 | 標準 | SDKによって自動収集および報告される、またはバックエンド計算によって生成される事前定義されたユーザー情報 |
| 推奨 | 開発者がAPI呼び出しを通じて報告する事前定義されたイベント属性 | |
| カスタム | ビジネスニーズに基づいて開発者が自由に作成および報告するユーザー属性 |
属性データタイプ
| データタイプ | 説明 |
|---|---|
| STRING | 文字列タイプ。「ユーザー名」などは一般的にSTRINGタイプとして設定されます。 |
| NUMBER | 数値タイプ。整数や小数をサポートし、「購入回数」などは一般的にNUMBERタイプとして設定されます。 |
| BOOL | ブールタイプ。true/falseをサポートし、「VIP会員かどうか」などは一般的にBOOLタイプとして設定されます。 |
| DATETIME | 日付と時刻タイプ。ISO8601形式で報告されたデータをサポートします。例えば、「アカウント登録時間」は一般的にDATETIMEタイプとして設定されます。 |
| LIST | リストタイプ。文字列要素の配列（例: ["Tesla", "Volkswagen", "Audi"]）で、「興味のタグ」などは一般的にLISTタイプとして設定されます。 |
カスタム属性
事前定義された標準および推奨属性に加えて、開発者はビジネスニーズに基づいてカスタム「イベント属性/ユーザー属性」を作成できます。カスタム属性は、ページ作成とAPI作成の2つの方法をサポートします。
ページ作成
属性はページ上で事前に作成でき、個別またはExcelインポートを通じて一括作成が可能です。必要な情報には以下が含まれます：
| 情報 | 必須 | 説明 |
|---|---|---|
| 属性名 | 必須 | 報告される属性の名前。小文字の英字、数字、アンダースコアをサポートし、英字で始める必要があります（例: open_app）。一度設定すると変更できません。 |
| 属性説明 | 必須 | 属性をより理解しやすくするための注釈を追加します。最大50文字まで設定可能で、設定後の変更が可能です。 |
| データタイプ | 必須 | データタイプは、MAシステムが属性データを処理する方法を決定します。報告されたデータがタイプと一致しない場合、強制的に変換されます。変換に失敗した場合、データは破棄されます。サポートされるタイプにはSTRING、NUMBER、BOOL、DATETIME、LISTがあります。 |
API作成
属性はAPI呼び出しを通じて自由に報告できます。属性が存在しない場合、自動的に作成されます：
- イベント属性が存在しない場合、自動的に作成され、イベントに関連付けられます。
- ユーザー属性が存在しない場合、自動的に作成されます。
イベント報告APIインターフェース：Android API, iOS API, Web API, Rest API
ユーザー属性報告APIインターフェース：Android API, iOS API, Web API, Rest API
属性ステータス
カスタムイベント/ユーザー属性が作成されると、その初期ステータスは「表示可能」です。ビジネスニーズに基づいてステータスを調整できます。
| ステータス | 説明 |
|---|---|
| 表示可能 | 属性フィルタに表示され、属性報告を受け取ることができます。 |
| 非表示 | 属性フィルタに表示されませんが、属性報告を受け取ることができます。 |
| 無効 | 属性フィルタに表示されず、属性報告を受け取ることができません。 |
標準属性
EngageLabは「イベント属性、ユーザー属性、デバイス属性」の名前と説明を事前定義しています。このデータはSDKによって自動収集および報告されるか、バックエンド計算によって生成されます。
標準属性は編集または削除できません。標準属性リストはページ上で表示するか、Excelファイルとしてダウンロードして参照できます。
推奨属性
EngageLabは「イベント属性およびユーザー属性」を事前定義しており、データは開発者がAPI呼び出しを通じて報告します。
推奨属性を可能な限り報告することをお勧めします。これにより、後続の分析が容易になります。
推奨属性は編集または削除できません。推奨属性リストはページ上で表示するか、Excelファイルとしてダウンロードして参照できます。
