ビジネスオブジェクトの分析（ベータ版）

ビジネスオブジェクトアナリティクス（ベータ版）を使用すると、ページやフィーチャーを分析するのと同じ方法で、注文、タスク、プロジェクトなどのプロダクト内のビジネスオブジェクトを分析できます。この機能を使って、訪問者が見る画面だけでなく、プロダクト内部の要素に関する質問にも答えることができます。

ユースケース

訪問者とアカウントのアナリティクスによって、誰があなたのプロダクト内でどのような行動をとったかが分かります。オブジェクトは、全体像のもう半分、つまりユーザーが取り組んでいた内容を補完します。

オブジェクトを使用して：

• コンバージョンと完了までの時間を測定することで、オブジェクトがファネルをどのように移動し、どこで離脱し、各ステージにどれくらいかかるかを確認できます。
• 単に訪問したページだけでなく、訪問者が実際に利用するエンティティに対するエンゲージメントを理解します。
• 訪問者数、イベント数、滞在時間などに基づいて、それぞれの値を比較します。
• アクティブな値の数が時間とともに変化するにつれて、新しいエンティティの利用率を追跡します。
• 個々の値に対して、Uターン、レイジクリック、エラークリックなどのフラストレーションを診断します。
• オブジェクトの指標をダッシュボード上で他のアナリティクスと並べて共有できます。

仕組み

オブジェクトは、特定のエンティティ（orderIdやtaskIdなど）を識別する値を持つイベントプロパティによって定義された、注文、タスク、プロジェクトなど、プロダクトが対象となるエンティティを表します。1つのオブジェクトは、特定の訪問者やアカウントに属するのではなく、複数の訪問者やアカウントにまたがることがあります。オブジェクトアナリティクスは、多数の注文、ドキュメント、デバイスなど、多くのイベントにまたがる大量のエンティティに最適に機能します。

たとえば、プロジェクト管理アプリは、プロジェクト内で発生するすべてのイベントでprojectIdを送信します。プロジェクトと呼ばれるオブジェクトを設定すると、Pendoユーザーは先月アクティブだったプロジェクトの数、最もエンゲージメントが高かったプロジェクト、特定のプロジェクトの傾向を確認することができます。プロジェクトごとに個別のレポートを作成する必要はありません。

オブジェクトは他のアナリティクスと連携して機能します。

• 使い慣れたツールでオブジェクトを分析します。オブジェクトは、ページ、フィーチャー、トラックイベントで既に使用しているのと同じ指標やアナリティクスを使用します。
• オブジェクトは訪問者やアカウントのアナリティクスを補完します。既存の分析を置き換えるのではなく、補完するものです。
• オブジェクトはイベントデータを基に構築されます。オブジェクトは、Pendoが既に収集しているイベントプロパティ、または今後送信する新しいイベントプロパティに基づいているため、個別の分析パイプラインを設定する必要はありません。オブジェクトを追加した後に収集されたイベントデータを使用するため、過去のイベントは含まれません。
• オブジェクトはファネルで動作します。オブジェクトが一連のステップを経てどのように移動するかを測定し、どこで落下するか、各段階にどれくらいの時間がかかるかを確認します。

始める前に

オブジェクトの設定を開始する前に、以下のものが必要です。

• サブスクリプションに含まれるアナリティクスモジュール。
• イベントプロパティを編集する権限。これにより、オブジェクトの追加、編集、削除が可能になります。サブスクリプション管理者はデフォルトでこの権限を持っています。
• イベント時にオブジェクトIDをPendoに送信する方法（ページURL、トラックイベント、Web SDK経由）。オプションについては、「オブジェクトのIDをPendoに送信する」を参照してください。
• （推奨、必須ではありません）すべてのオブジェクトはイベントプロパティから構築されるため、イベントプロパティの仕組みに関する基本的な理解が必要です。URLから対象物を特定する予定がある場合は、URLのルールを理解しておくことも役立ちます。詳細については、「イベントプロパティ」および「ページのタグ付けを行うURL」をご覧ください。

オブジェクトデータのみを閲覧するには、ユーザーはアナリティクスへの閲覧アクセス権が必要であり、イベントプロパティを編集する権限は必要ありません。

オブジェクトの値をPendoに送信します

Pendoは、識別用イベントプロパティの値（たとえば、orderIdに含まれる注文ID）によってオブジェクトを追跡します。Pendoがそのオブジェクトのアクティビティを収集できるようになる前に、イベントを通じてそれらの値がPendoに届いている必要があります。ウィザードのトラッキングの設定ステップでは3つの方法が提示され、すべてが同じイベントプロパティを送信する限り、複数の方法を使用できます：

• URLルール。ページURLに値が含まれている場合（例：/orders/A-1024）に使用します。コードを変更せずに、値を取得するルールを追加します。
• Web SDK。値がURLに含まれていない場合は、これを使用します。pendo.trackを使用してトラックイベントでイベントプロパティを送信するか、または、Pendo Web SDKのonEventCapturedを使用して収集したイベントに追加します。トラックイベントの設定手順については、「トラックイベントの設定」を参照してください。onEventCapturedについては、イベントプロパティに関するWeb SDKドキュメントを参照してください。
• モバイルSDK。URLルールが適用されないモバイルアプリで使用します。モバイルSDKからトラックイベントのイベントプロパティを送信してください。

Pendoは、トラッキングの設定後にオブジェクトのアクティビティの収集を開始します。それ以前のアクティビティは含まれません。

ステータスやタイプなどの説明的なメタデータをオブジェクトに追加して、オブジェクトデータを絞り込んで比較することもできます。詳細については、オブジェクトメタデータの送信を参照してください。

オブジェクトを作成する

サブスクリプションごとにオブジェクト数の上限があり、デフォルトで最大5つのオブジェクトが含まれています。実際の上限は、プランによってはさらに高くなる場合があります。オブジェクトの作成は3つのステップで行います：オブジェクトに名前を付け、トラッキングを設定し、詳細を確認します。

1. 左側のメニューで［プロダクト］>［オブジェクトアナリティクス］を選択します。
2. ［オブジェクトを作成］を選択します。ボタンが非アクティブになっている場合は、サブスクリプションのオブジェクト数の上限に達しています。
   • 上限額の引き上げをリクエストするには、Pendoのアカウント担当者またはサポートチームにお問い合わせください。
   • オブジェクトを管理する権限がない場合、ボタンは表示されません。
3. ［オブジェクトに名前を付ける（Name your object）］ステップで、［表示名（Display name）］（Pendo全体でオブジェクトのラベルとして使用）と任意の［説明（Description）］を入力します。
4. オブジェクト識別子で、このオブジェクトのイベントプロパティが既にあるかどうかを回答してください：
   • はい。Pendoがすでに収集しているデータから、オブジェクトを識別するイベントプロパティを選択します。文字列型または整数型のイベントプロパティのみが一覧表示されます。
   • いいえ。イベントで送信するイベントプロパティの［フィールド名（Field name）］（`orderId`など）を入力します。Pendoがすでに収集しているイベントプロパティとほぼ一致する場合は、代わりにこのプロパティを使用を選択して、そのデータからオブジェクトを作成してください。識別子として、accountId、visitorId、またはvisitorPriorityは、大文字と小文字のいずれの表記でも使用できません。
5. ［次へ（Next）］を選択して、［トラッキングの設定（Set up tracking）］ステップに進みます。トラッキング方法として、［URLルール（URL rules）］、［Web SDK］、［モバイルSDK（Mobile SDK）］の1つ以上を選択します。
   • 「URLルール」タブで、ページURLからオブジェクトの値を取得するルールとスキップ値を追加します。構文、例、ルールのテスト方法については、URLルール設定するを参照してください。タグ付け済みのページのルールを再利用するには、「既存のページパラメータルールをコピー」を選択します。
   • Web SDKタブとモバイルSDKタブで、コードからイベントプロパティを送信する手順とコードサンプルに従ってください。折りたたむには［手順を非表示（Hide instructions）］、展開するには［手順を表示（Show instructions）］を選択します。
6. ［次へ（Next）］を選択して、［詳細の確認（Confirm details）］ステップに進みます。［詳細（Details）］カードを確認し、［保存（Save）］を選択します。保存前は、［アクティビティ（Activity）］行に［いいえ（No）］と表示されます。保存すると、オブジェクトのプロパティを含むイベントが到着するまで、［まだデータを受信していません（No data received yet）］と表示されます。

URLルールを設定する

URLルールは、PendoにURLからオブジェクトのIDを抽出する方法を指示するため、そのIDが実際にページのURLに表示されている場合にのみ機能します。

URLパターンごとに1つのルールを追加すると、Pendoは一致した最初のルールを適用します。最大20個のルールと最大20個のスキップ値を追加できます。URLルールのステップには、ここに示したのと同じパターンと例を使った組み込みの書式設定ヘルプが含まれています。

URLルールを記述する

以下の規則に従ってください。

• 各ルールは//で始めてください。これにより、URLがhttpでもhttpsでも両方に対応します。
• キャプチャしたいURLの部分を*value*でマークしてください。各ルールには、正確に1つの*value*が必要です。
• 以下のトークンを使用して、URLの残りの部分と一致させてください。
  • ***はパス部分にのみ適用されます。* は1つの部分に使い、** は残りのパス部分に使います。
  • ~contains:は特定のテキストを含むパス部分、サーバー名、または#の後のフラグメントと一致します。
  • ~or:は縦棒で区切られた複数の選択肢のうちの 1 つと完全に一致するパス部分に一致します。それぞれの選択肢は、パターンとしてではなく、文字通りに照合されます。

PendoがURLをどのように照合するかについての詳細は、「ページのタグ付けを行うURL」をご覧ください。

スキップ値を追加する

スキップ値とは、Pendoが収集しない値のことです。文字列または数値を入力してください。注文の作成中における/orders/newのnewなど、ルールが収集する対象のうち、実際のオブジェクトではないものに対してスキップ値を追加します。

ルールをテストする

保存する前に、［URLをテスト（Test URLs）］を使用して、ルールが期待どおりにURLと一致しているか確認します。［テストURLを追加（Add a test URL）］を選択し、URLを入力します。［一致したルール（Matched rule）］列にはどの一致ルールが適用されたかが表示され、［ステータス（Status）］列には次の3つの結果のいずれかが表示されます：

• 一致しました。ルールが一致し、値を取得しました。解析済みの値列に表示されます。
• 一致しませんでした。このURLに一致するルールはありません。
• スキップ済み。ルールに一致しましたが、その値はスキップ値に含まれています。

テストURLは保存されません。テストURLに想定どおりの値が表示されたら、［詳細の確認（Confirm details）］ステップに進み、［保存（Save）］を選択してオブジェクトの作成を完了します。

オブジェクトを表示する

オブジェクト一覧には、サブスクリプションに含まれるすべてのオブジェクトと、それぞれのオブジェクトが前期間と比較してどのような推移を示しているかが表示されます。

表の上部にある共通のフィルターを使用して、日付範囲、セグメント、またはアカウントフィルターを変更できます。複数アプリサブスクリプションでは、このページにアプリフィルターは含まれていません。各オブジェクトのURLルールによって、対象のアプリやページがすでに決まっているためです。

表のタイトルには、追加したオブジェクト数と最大数が表示されます（例：［オブジェクト（5個中3個使用）］）。

デフォルトの列には以下が含まれます。

• 名前（Name）。オブジェクトの表示名。オブジェクトを選択して詳細を開きます。
• オブジェクトの合計。選択した日付範囲内でオブジェクトについて追跡された個別の値の数。各行は異なるオブジェクトを表すため、この列では汎用ラベルが維持されます。オブジェクトの詳細ページでは、同じ指標にオブジェクト名が付けられます。たとえば合計注文数です。
• 指標の列。訪問者、訪問者あたりのオブジェクト数、およびオブジェクトあたりの訪問者数。それぞれに、前の期間との比較を示すパーセンテージチップが付いています。サブスクリプションでアカウントアナリティクスが有効になっている場合、アカウントとアカウントあたりのオブジェクト数が含まれます。
• 作成（Created）。オブジェクトが作成された日時。

列を管理を使用して、列の表示または非表示を切り替えます。デフォルトで非表示になっているのは、説明（オブジェクトの作成時に入力した内容、または追加しなかった場合はなし）、およびマルチアプリサブスクリプションにおけるアプリ（オブジェクトのURLルールが適用されるアプリ）です。オブジェクトの総数またはアプリの列ヘッダーにカーソルを合わせると、表示内容の説明が表示されます。

管理者は［URLルールを編集］と［オブジェクトプロパティを削除］の行アクションを表示できます。

オブジェクトのメタデータを表示する

オブジェクトメタデータが利用可能な場合は、［設定（Settings）］>［メタデータ（Metadata）］>［オブジェクトメタデータ（Object metadata）］に移動して、オブジェクトメタデータフィールドの検索可能な読み取り専用テーブルを表示できます。表には、オブジェクト、フィールド名、表示名、タイプが表示されます。リンクされたオブジェクト名を選択すると、その詳細ページが開きます。オブジェクトメタデータフィールドを作成し、Pendo Web SDKまたはAPIを介して値を送信する方法については、「オブジェクトメタデータの送信」を参照してください。

オブジェクトを分析する

オブジェクトを選択すると、その詳細ページが開きます。ヘッダーには、オブジェクトのタイトル、説明、作成日、およびオブジェクトアナリティクスに戻るパンくずリンクが表示されます。組み込みのアカウントオブジェクトには、説明エディターが表示されません。管理者には、ヘッダーにトラッキングを編集とオブジェクトとして削除が表示されます。

オブジェクトのアナリティクスをフィルタリングする

ヘッダーの下にあるフィルター行で、対象のアナリティクスを絞り込めます。

• アプリ、プロダクトエリア、またはイベント。分析を特定のアプリケーション、プロダクトエリア、または個別のイベントに制限します。［アクティビティ（Activity）］タブでは、ロールアップの粒度においてプロダクトエリアのみへのスコープ指定がサポートされています。秒単位とミリ秒単位のアクティビティでは、引き続きアプリの選択が必要です。
• イベントタイプ。ページ、フィーチャー、またはトラックイベントのみを表示するようにフィルタリングします。
• プロパティ。最大5つのイベントプロパティフィルターを追加できます（フィルターを追加）。
• オブジェクトメタデータ。現在のオブジェクトプロパティでメタデータが利用可能な場合は、［フィルターを追加］を選択し、［オブジェクトメタデータ］を選択して、そのオブジェクトに関連付けられているメタデータでフィルター処理を行います。

［概要］タブ

［概要］タブには次の 3 つのセクションがあります。

• 詳細。オブジェクトの設定を表示する折りたたみ式カード：
  • フィールド名。オブジェクトを識別するイベントプロパティ。
  • URLルール。設定されているURLルールとスキップ値の数、またはなし。管理者は鉛筆アイコンを選択して、URLルールをインラインで編集できます。
  • アクティビティ。オブジェクトのプロパティを含むイベントが到着している場合はデータを受信済み、まだ到着していない場合はデータはまだ受信されていません。PendoはSDKベースのトラッキングを直接検出できないため、この行では、どのトラッキング方法が設定されているかではなく、データが到着したかどうかを報告します。
  • メタデータ。設定されているオブジェクトのメタデータフィールド、またはなし。メタデータの送信に必要なコードを確認するには、［手順を表示（Show instructions）］を選択します。詳細については、オブジェクトメタデータの送信を参照してください。

• 指標（Metrics）：前の期間と主要な指標を比較する指標グリッドとグラフ。指標名にはオブジェクト名が使用されます。Ordersという名前のオブジェクトの場合、グリッドにはデフォルトで注文の合計、訪問者数、アカウント数、注文ごとの平均時間、注文ごとの平均訪問者数、訪問者ごとの平均注文数が表示されます。

  サブスクリプションでアカウントアナリティクスがオンになっていない場合、［アカウント］指標は省略されます。 ［アカウント］自体がオブジェクトとして選択されている場合、アカウント数やオブジェクトごとの平均アカウント数など、重複するアカウント指標も省略されます。

  表示する指標を変更するには、［指標の管理（Manage metrics）］アイコンを選択します。現在のビューを既存のダッシュボードに追加するには、［ダッシュボードに指標を追加（Add metrics to dashboard）］アイコンを選択します。

• オブジェクトの内訳。 このオブジェクトの個々の値を、各値のイベントアクティビティ量（イベントの合計）が多い順に並べた表です。 値を選択すると、その値が個別に開きます。

オブジェクトの内訳からオブジェクトの値を選択すると、その単一の値に限定されたビューが開きます。ヘッダーには［{value}で絞り込み済み（Filtered to {value}）］と表示され、ページ上のすべての指標とイベントには、その値のみが適用されます。パンくずリストを使用して、オブジェクト全体に戻ります。

イベントタブ

［イベント］タブは、訪問者がこのオブジェクトに紐づいたイベントとどのように関わっているかを示します。

• チャートタイトルは「{field_name}の数別トップイベント」と表示されます。イベントの種類で絞り込むと、タイトルもそれに合わせて更新されます。
• チャートの下には、範囲内のすべてのイベントが一覧の表で示されています。［イベントを検索］を使用して名前でフィルタリングし、［ライフサイクルの役割］フィルターを使用して役割で絞り込みます。スターアイコンを使用して、そのイベントをお気に入りに登録してください。
• 2つ以上の行にあるチェックボックスを選択し、テーブルの右上隅にある3つの点を選択して、［レポートを作成］>［ファネル］を選択すると、それらのイベントにスコープされたファネルが作成され、オブジェクトがどこでドロップされるか、各ステージにどれくらいの時間がかかるかを確認できます。

オブジェクトごとにファネルを構築する

ファネルは、一連のステップを通過する項目数と、どこで離脱が発生するかを測定します。デフォルトではファネルが訪問者を測定しますが、代わりにオブジェクト単位で測定して、ビジネスオブジェクトの進行状況を把握できます。

作成するには、通常の方法でファネルを作成し、次に［ファネル方法］をオブジェクトに設定します。［ファネル方法］はデフォルトで訪問者に設定されているため、代わりにオブジェクトを選択すると、そのオブジェクトでファネルを測定できます。残りのクエリは通常どおり作成してください。

ファネルの作成と設定の手順の詳細については、「ファネル」をご覧ください。

ダッシュボードにオブジェクトを追加する

カタログの［アナリティクス］にある2つのウィジェットを使用すると、任意のダッシュボードにオブジェクトメトリクスを追加できます。

• オブジェクトアナリティクスの主要指標。オブジェクトの主要な指標（一意の値、値ごとの平均訪問者数、値ごとの合計滞在時間など）を表示します。
• オブジェクト分析グラフ。1つ以上のオブジェクトのメトリクスを時系列でグラフ化します。オブジェクト、時間範囲、セグメント、指標、およびグラフ表示の設定を行います。

ウィジェットを追加するには：

1. 編集したいダッシュボードを開き、［ウィジェットを追加］を選択してください。
2. ウィジェットカタログで［オブジェクトアナリティクスの主要指標］または［オブジェクトアナリティクスチャート］を選択してください。
3. オブジェクト、時間範囲、およびセグメントを設定します。ウィジェットはデフォルトで直近30日間と［全員］セグメントが設定されています。
4. ウィジェットをダッシュボードに追加するには、［保存］を選択してください。

ダッシュボードに［プロダクトエリア（Product Area）］フィルターを適用すると、両方のウィジェットの対象範囲が、選択したプロダクトエリアに変更されます。詳しくは、「ダッシュボード」の「ダッシュボードをフィルタリングする」を参照してください。

オブジェクトを管理または削除する

サブスクリプション管理者やイベントプロパティマネージャーは、オブジェクトリストまたは詳細ページのいずれかからオブジェクトのURLルールを編集できます。

1. オブジェクトの横にある鉛筆アイコン（［URLルールを編集］）を選択します。
2. URLルールを更新するか、値をスキップしてください。
3. ［保存］を選択します。

オブジェクトを削除するには：

1. リストのゴミ箱アイコン（オブジェクトプロパティの削除）を選択するか、詳細ページで［オブジェクトプロパティとして削除］を選択してください。
2. 「オブジェクトプロパティを削除しますか？」 の確認画面で［削除］を選択します。

オブジェクトを削除しても、Pendoによるデータ収集は停止しません。Pendoは基となるイベントデータの収集を継続しますが、プロパティをオブジェクトとして扱わなくなります。つまり、次のようになります。

• そのオブジェクトはビジネスオブジェクト分析ページに表示されなくなります。
• これはファネルでは使用できません。
• プロパティに多数の固有値（高いカーディナリティ）が含まれている場合、他のレポートでは使用できません。

Pendoはこのデータを遡及的に処理しないため、後でオブジェクトを再作成しても、オフになっている間に収集されたデータは利用できません。

Pendo MCPサーバー経由でオブジェクトを分析する

Pendo MCPサーバーがサブスクリプションで有効になっている場合、Pendoで行うのと同じように、独自のAIツールから追跡しているオブジェクトのアナリティクスをクエリできます。これには、アクティブ値のカウント、指標の内訳、時系列、オブジェクト別のイベント内訳、オブジェクトのメタデータが含まれます。

詳細については、AIエージェント向けPendo MCPツールを参照してください。

トラブルシューティング

• ［オブジェクトを作成］ボタンが非アクティブになっているか、表示されていない。ボタンが非アクティブであれば、サブスクリプションのオブジェクト制限に達しています。不要になったオブジェクトを削除するか、Pendoの担当者に連絡して上限を引き上げてください。ボタンが全く表示されない場合は、オブジェクトを管理する権限がありません。サブスクリプション管理者にお問い合わせください。
• 新規作成したオブジェクトにデータが表示されません。オブジェクトは、そのオブジェクトが作成された時点から収集され、オブジェクトのプロパティを保持するイベントを測定します。オブジェクトの［詳細（Details）］カードにある［アクティビティ（Activity）］行を確認します。［まだデータを受信していません（No data received yet）］と表示されている場合は、対象となるイベントでプロパティが送信されていること、およびそれらのイベントが発生するページに少なくとも1つのURLルールが一致していることを確認してください。
• フラストレーション指標は、数値自体は減少したものの、依然として悪化傾向を示している。フラストレーション指標（Uターン、レイジクリック数、デッドクリック数、エラークリック数）はトレンドの色を逆にして、増加を悪化として表示します。減少はプラスの変化です。
• 管理権限を持たないユーザーに「管理者に設定を依頼してください」と表示される。オブジェクト管理にはサブスクリプション管理者かイベントプロパティの編集権限が必要です。そのアクセス権を持つユーザーは、他のユーザーが分析する前に最初のオブジェクトを追加する必要があります。

関連リソース

• イベントプロパティ：イベントプロパティがどのようにキャプチャされ、利用されるか。
• フィーチャーやページにタグを付けるか、トラックイベントを設定して、イベントに変換したいプロパティを含めてください。
• オブジェクト指標と訪問者データ、アカウントデータを組み合わせたセグメントを作成します。
• ダッシュボードを作成し、オブジェクトウィジェットを追加して同僚とオブジェクトのトレンドを共有しましょう。