Pendoは、訪問者がアプリケーション内で行うアクションを記録し、このデータをイベントの生データとして保存します。これらのイベントの例としては、訪問者がフィーチャーをクリックしたとき、ページを表示したとき、トラックイベントを生成したとき、ガイドを操作したときなどがあります。
イベントプロパティは、イベントが発生した時点でイベントに関連付けられている情報です。レポートやセグメントでイベントプロパティを使用することで、訪問者の経時的なアプリ使用状況を絞り込み、分析することができます。
イベントプロパティの種類
イベント属性には、グローバルとカスタムの2種類があります。この2種類のイベント属性の主な違いは、共通イベント属性がすべてのWeb SDKイベントで取得されるのに対し、カスタムイベント属性は特定のクリックイベントやトラックイベントで取得されることです。それぞれついて、以下で詳しく説明します。
グローバルイベントプロパティ
グローバルイベントプロパティは、Pendoがアプリケーションで発生するすべてのWeb SDKイベントで収集する詳細です。これらのプロパティは、イベントが発生した時点の訪問者の環境とイベントコンテキストを記述し、デフォルトですべてのイベントで収集されます。グローバルイベントプロパティには5つのサブセットがあります。
- デバイスデータ。訪問者のブラウザ、デバイス、オペレーティングシステムに関する技術的な詳細。
- イベントデータ。イベントが発生した場所に関する情報。これには、イベントを生成したサーバーまたは環境を識別するサーバー名が含まれます。
- 場所データ。訪問者のIPアドレスから得られた国や州/地域などの地理的コンテキスト。これらの値はISO 3166-2国コードの標準に従っています。
重要：イベントと場所のデータの使用には、サブスクリプションのリモートアドレスのログ記録を許可設定をオンにする必要があります。この設定は、PendoがIPアドレスを収集し、イベントデータに関連付けるかどうかを決定します。オフにすると、これらのプロパティは収集されず、後から追加することもできません。この設定を変更するには、サポートチームまでお問い合わせください。
- セッションプロパティ。UTMおよびリファラーデータを含む、訪問者のセッションの開始方法に関連するパラメータ。定義と使用例については、「セッションプロパティについて」を「ウェブアナリティクス」の記事で参照してください。
- 履歴メタデータ。［設定（Settings）］>［メタデータ（Metadata）］で履歴として有効になっている訪問者またはアカウントのメタデータは、イベントプロパティとして表示されます。詳細については、「履歴メタデータ」をご参照ください。
注：イベントプロパティにおけるデバイスとブラウザの使用状況は、デフォルトのメタデータフィールドである「最新のブラウザ名」および「最新のオペレーティングシステム」とは異なります。メタデータは、（履歴メタデータとして有効になっているメタデータでない限り）Pendoによって処理された最後のイベントの値を示します。イベントプロパティは、これまでのすべてのイベントについて、イベントが保存された時点の値を示します。これにより、イベントプロパティを分析して履歴値を表示し、フィーチャー、ページ、トラックイベント、もしくはガイドイベントが記録されたときに訪問者がアプリをどのように使用していたかについてのコンテキストを提供できます。
カスタムイベントプロパティ
カスタムイベントプロパティは、アプリケーションで特定のイベントが発生したときに収集される詳細です。
これらは、イベントが発生した時点でそのイベントに関する追加のコンテキストを提供し、Pendo全体でフィルタリング、グループ化、セグメント化に使用できます。
これらのプロパティは、定義されているイベントタイプに対してのみ収集されます。
［設定（Settings）］>［イベントプロパティ（Event Properties）］から、カスタムイベントプロパティにアクセスし、分類することができます。デフォルトでは、すべてのイベントプロパティは文字列として分類されます。正しいデータ型（数値、文字列、リストなど）を定義するために、設定後すぐにプロパティを分類することが重要です。これにより、PendoはUIでデータを正しく解釈し、正確なフィルタリング、グループ化、レポートをサポートできるようになります。
注：サブスクリプションでは、一意のカスタムイベントプロパティを最大1,000件持つことができます。1つのプロパティで一意の値が100億を超える（カーディナリティ）場合、自動的にUIから非表示になり、レポート、セグメント、アナリティクスから削除されます。このような場合でも、プロパティはイベントで引き続き収集され、データ同期を通じてエクスポート可能です。
ページパラメータ
ページパラメータは、ページのタグ付けルールがURL定義にパラメータ（例：//*/portfolio/*parameter*/ や ?blog_title=*parameter*）を含む場合、ページルールから自動的に収集されます。
これにより、各バリエーションに個別にタグを付けることなく、動的またはパーソナライズされたページ構造全体の行動を分析することができます。データエクスプローラでセグメントを作成したりフィルタリングしたりするときに、ページの詳細でページパラメータを表示し、これらの値を選択できます。
ページパラメータの収集方法の詳細については、ページのタグ付けを行うURLを参照してください。
クリックイベントプロパティ
クリックイベントプロパティは、特定のタグ付きフィーチャーのためにビジュアルデザインスタジオ（Visual Design Studio）で設定するカスタム値です。これらは、クリック時にアプリケーションインターフェースから属性を収集します。
Pendoがクリックイベントを収集できるようにするためには、ビジュアルデザインスタジオ（でフィーチャーを編集する際にクリックイベントのプロパティを設定する必要があります。
クリックイベントプロパティとその設定方法の詳細については、クリックイベントプロパティを参照してください。
トラックイベントのプロパティ
トラックイベントのプロパティは、トラックイベントがプログラムによってPendoに送信される際にトラックイベントペイロードに渡されるカスタム値です。これらは、UIで設定する必要がありません。
カスタムイベントプロパティの一般的な例には以下のものがあります。
- レポートタイプ。
- トライアル中。
- フィルター適用。
- 訪問者のソース。
- イベント時にアプリで利用可能なその他のカスタム値。
トラックイベントの設定方法の詳細については、トラックイベントの設定を参照してください。
ページのイベントプロパティ
ページイベントプロパティを使用すると、innerTextやページタイトルなど、タグ付け時にページに関する追加情報を定義して適用できます。これらの値はページURLに付加され、ビジュアルデザインスタジオ（Visual Design Studio）でのルール作成に使用されます。
注：ページイベントプロパティは［設定（Settings）］>［イベントプロパティ（Event Properties）］に含まれておらず、フィルタリング、セグメント化、レポートには使用できません。これらは、特に不明瞭なURLや静的なURLを持つアプリで、ページをより正確にタグ付けするためにのみ使用されます。
セットアップと使用方法についてはページのイベントプロパティを参照してください。
プロダクトデータ内のイベントプロパティ
特定のページ、フィーチャー、またはトラックイベントの詳細を表示すると、そのイベントについて記録されたイベントプロパティの値にアクセスできます。
- これらの詳細を表示するには、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アカデミーのコースにお申し込みください。