Pendoは、訪問者がアプリケーション内で行うアクションを記録し、このデータをイベントの生データとして保存します。これらのイベントの例としては、訪問者がフィーチャーをクリックしたとき、ページを表示したとき、トラックイベントを生成したとき、ガイドを操作したときなどがあります。
イベントプロパティは、イベントが発生した時点でイベントに関連付けられている情報です。レポートやセグメントでイベントプロパティを使用することで、訪問者の経時的なアプリ使用状況を絞り込み、分析することができます。
イベントプロパティの種類
イベント属性には、グローバルとカスタムの2種類があります。この2種類のイベント属性の主な違いは、共通イベント属性がすべてのエージェントイベントで取得されるのに対し、カスタムイベント属性は特定のクリックイベントやトラックイベントで取得されることです。それぞれついて、以下で詳しく説明します。
グローバルイベントプロパティ
グローバルイベントプロパティは、アプリケーションで発生するすべてのエージェントイベントに対して収集される詳細情報です。グローバルイベントプロパティには、デバイスデータと履歴メタデータの2つのサブセットがあります。
デフォルトでは、すべてのイベントでデバイスデータが収集されます。
- ウェブアプリ：ブラウザ名、ブラウザのバージョン、デバイスタイプ、オペレーティングシステム
- モバイルアプリ：デバイスモデル、OSのバージョン、デバイスタイプ、オペレーティングシステム、アプリバージョン（顧客のアプリバージョン）、SDKバージョン（Pendo SDKバージョン）
履歴メタデータは、訪問者またはアカウントのメタデータとして発信されるデータですが、この値が［設定（Settings）］>［データマッピング（Data Mappings）］で履歴として有効になっていると、イベントプロパティとして機能します。詳細については、「履歴メタデータ」をご参照ください。
注：イベントプロパティにおけるデバイスとブラウザの使用状況は、デフォルトのメタデータフィールドである「最新のブラウザ名」および「最新のオペレーティングシステム」とは異なります。メタデータは、（履歴メタデータとして有効になっているメタデータでない限り）Pendoによって処理された最後のイベントの値を示します。イベントプロパティは、これまでのすべてのイベントについて、イベントが保存された時点の値を示します。これにより、イベントプロパティを分析して履歴値を表示し、フィーチャー、ページ、トラックイベント、もしくはガイドイベントが記録されたときに訪問者がアプリをどのように使用していたかについてのコンテキストを提供できます。
カスタムイベントプロパティ
カスタムイベント属性は、アプリケーションで特定のイベントが発生したときに収集される詳細情報です。カスタムイベント属性のサブセットには、クリックイベント属性とトラックイベント属性の2つがあります。
Pendoがクリックイベントプロパティを取得する前に、タグ付けされたフィーチャーをビジュアルデザインスタジオ（Visual Design Studio）で編集するときには、これらのカスタム値を設定する必要があります。トラックイベントペイロードで定義されたトラックイベントプロパティには、追加の設定は必要ありません。
カスタムイベントプロパティは特定のアプリやニーズによって異なりますが、一般的な例としては、レポートタイプ、トライアル中の状態、フィルターが適用されている状態、訪問者のソース、またはクリック時にアプリで利用可能なその他のカスタム値などがあります。
注：サブスクリプションでは、一意のカスタムイベントプロパティを最大1,000件持つことができます。1つのプロパティで一意の値が100億を超える（カーディナリティ）場合、自動的にUIから非表示になり、レポート、セグメント、アナリティクスから削除されます。この制限に達した場合でも、イベントプロパティはイベントで引き続き収集され、データ同期を通じてエクスポート可能です。
［設定（Settings）］>［イベントプロパティ（Event Properties）］から、カスタムイベントプロパティにアクセスし、分類することができます。デフォルトでは、すべてのイベントプロパティは最初に文字列として分類されます。構成直後にこれらを適切に分類し、データ形式の種類（数値、文字列、リストなど）を定義することが重要です。これにより、PendoはUIでプロパティを正確に解釈し、フィルタリング、グループ化、レポートを正確に行うことができます。
クリックイベントプロパティとその設定方法の詳細については、クリックイベントプロパティを参照してください。トラックイベントの設定方法の詳細については、トラックイベントの設定を参照してください。
プロダクトデータ内のイベントプロパティ
特定のページ、フィーチャー、またはトラックイベントの詳細を表示すると、そのイベントについて記録されたイベントプロパティの値にアクセスできます。
- これらの詳細を表示するには、Pendoの左側のメニューにある［プロダクト（Product）］タブに移動し、［ページ（Pages）］、［フィーチャー（Features）］または［トラックイベント（Track Events）］を選択します。
- リストから特定のページ、フィーチャー、またはトラックイベントを選択します。
- ページの下部にある［イベントの詳細（Event Breakdown）］表を見つけます。
この表には適用されているすべてのフィルターが反映され、選択したページ、フィーチャー、またはトラックイベントと対応するユーザーに関連するすべてのイベントプロパティの値が表示されます。また、重複する値とnull値は除外されます。対応する詳細ページを表示するには、この表で訪問者またはアカウントIDを選択します。
表には最大5,000エントリが表示されますが、［CSVをダウンロード（Download CSV）］オプションには、さらに深い分析を行うためのイベントプロパティがすべて含まれています。
レポートのイベントプロパティ
データエクスプローラ、ファネル、パスのイベントプロパティを使用して、分析を絞り込むことができます。イベントプロパティフィルターは3つのレポートすべてで利用可能ですが、グルーピングはデータエクスプローラとファネルでのみサポートされています。
注：イベントプロパティタイプが時間またはリストの場合、このデータをフィルタリングしたりグループ化することはできません。他のすべてのデータ形式はサポートされています。
イベントプロパティによるフィルタリング
イベントプロパティフィルターを使用すると、データエクスプローラ、ファネル、パスで特定のプロパティ値に基づいて使用状況データを絞り込むことができます。各レポートでフィルタリングする際、ドロップダウンメニューには最大400の異なる値が表示され、プロパティ値の全範囲を検索できます。
機能は、各レポートタイプによって異なります。
データエクスプローラでは、次の3つの方法でイベントプロパティを適用できます。
- イベントレベルで適用する。フィーチャーのクリックイベント、ページの読み込みイベント、トラックイベントにフィルターを適用して、特定のイベントのデータを分析または比較します。グローバルイベントプロパティ（デバイスデータと履歴メタデータ）はすべてのイベントタイプでサポートされていますが、カスタムイベントプロパティはフィーチャーとトラックイベントでのみサポートされています。
- 1つまたは複数のアプリにわたる「すべてのアクティビティ」で適用する。フィルターを適用して、アプリケーション全体の使用状況の傾向を把握します。［任意のアクティビティ］では、グローバルイベントプロパティのみがサポートされます。
- レポートレベルで適用する。［レポートのフィルター（Report Filters）］セクションを使用して、レポートに含まれるすべてのイベントにフィルターを適用します。
ファネルでは、フィーチャー、ページ、トラックイベントの個々のファネルステップにイベントプロパティフィルターを適用します。
パスでは、次の2つの方法でイベントプロパティフィルターを適用できます。
- 紐付けイベントで適用する。分析の開始点または終了点として機能する特定のフィーチャー、ページ、またはトラックイベントにフィルターを適用します。グローバルイベントプロパティ（デバイスデータと履歴メタデータ）はすべてのイベントタイプでサポートされていますが、カスタムイベントプロパティはフィーチャーとトラックイベントでのみサポートされています。
-
パス全体で適用する。パス内のすべてのステップにフィルターを適用します。これには、フィーチャー、ページ、トラックイベントを含めることができます。このフィルターでは、全体をとおして、グローバルイベントプロパティのみがサポートされています。
注：カスタムイベントプロパティは、構成されているイベントにのみ表示されます。
イベントプロパティによるグループ化
最大10,000個の一意の値を返すイベントプロパティでグループ化できます。データエクスプローラとファネルクエリビルダーの両方の［グループ化（Group By）］フィールドに、ブール値または文字列データ型であるすべてのグローバルイベントプロパティとカスタムイベントプロパティが含まれます。
イベント属性でグループ化すると、ターゲットセグメントと日付範囲のイベントの内訳が、各値の小計と共に表示されます。たとえば、デバイスのタイプ別にページ閲覧をグループ化すると、デスクトップ、タブレット、モバイルデバイス、ボットで生成された閲覧数が表示されます。
下の画像では、データエクスプローラでオペレーティングシステム別にフィーチャーのクリックイベントをグループ化すると、それぞれのシステムで生成されたクリック数が表示されていることがわかります。
セグメントのイベントプロパティ
セグメントを作成するときにイベントプロパティを使用して、分析における対象セグメントの特異性を高めることができます。たとえば、特定のデバイスプロパティを使用して、フィーチャーのクリック数、ページ閲覧数、トラックイベントを使用したユーザー、または使用しなかったユーザーをフィルタリングするなど、より具体的なセグメントを作成できます。
ドロップダウンメニューには最大400の異なる値が表示され、プロパティ値の全範囲を検索できます。
以下の画像の例では、過去30日以内に［コミュニティ検索バー（Community Search Bar）］で［常に有効（always activate）］を検索したすべての訪問者を対象に作成されたセグメントを確認できます。
注：イベントプロパティタイプが時間の場合、このデータでセグメント化することはできません。他のすべてのデータ形式はサポートされています。また、イベントプロパティを使用するセグメントでガイドをターゲットにすることはできません。詳細については、セグメントを参照してください。
イベントプロパティとAPI
シナリオによっては、Pendo UIで提供されるものよりも幅広いレポート機能が必要になる場合もあるでしょう。たとえば、以下のようなレポート機能が求められる場合です。
- 数値または時間ベースのデータを軸に、イベントプロパティにグループ化を適用する。
- 値が10,000を超えるイベントプロパティのレポートを作成する。
- 特定のクリックイベントまたはトラックイベントで、複数のイベントプロパティに関するレポートを同時に作成する。
- 履歴データ全体をエクスポートする。
このような場合、PendoのV1 API、具体的にはソースとなるtrackEventsまたはfeatureEventsを持つアグリゲーションエンドポイントを活用することが有効です。APIコールをご自身で作成したくない場合は、サードパーティのツールを使用してこのAPIからPendoデータを取得することもできます。その他のリソースや情報については、APIドキュメントを参照いただくか、Pendo APIの設定とエンドポイントに関するPendoアカデミーのコースにお申し込みください。