このドキュメントでは、デスクトップアプリ、スマートTVアプリ、POSソフトウェアなど、非Webビュー環境でPendoをインストールする際にトラックイベントを使用する方法について説明します。
標準的な形式でPendoをインストールする方法については、以下を参照してください。
- インストールスクリプトを使用したPendoの実装に関する開発者ガイドでは、Webアプリケーションへの Pendo のインストール方法について説明しています。
- モバイルインストールの製品ドキュメント内の記事では、モバイルアプリケーションへの Pendo のインストール方法について説明しています。
サポートされる機能
トラックイベントを使用してPendoをインストールすると、次がサポートされます。
- トラックイベントに関するアナリティクスとレポート(ダッシュボード、データエクスプローラ、パス、ファネル、リテンション、PES、メタデータ、行動に基づくセグメントのデータを含む)。
- 非Webビューアプリケーションでのユーザーの行動に基づいて、他のアプリケーションでガイドをターゲティングすること。
サポートされない機能
トラックイベントを使用してPendoをインストールする場合、次はサポートされません。
- ガイド、投票とアンケート調査、NPS、リソースセンターなどのアプリ内メッセージ機能。
- 自動イベント収集。代わりに、開発者がすべてのイベントに対してトラックイベントを送信するコードを追加する必要があります。
- 遡及的な分析。新しいフィーチャーをリリースした際に、クリックされたことを示すトラックイベントの送信を忘れると、そのデータを後から取得する方法はありません。
- Pendo Feedback。
インストールの仕組み
Pendo Web SDKは非Webビュー環境にインストールできないため、自動的に収集されるデータはありません。代わりに、Pendoで追跡したいすべてのアクティビティについて、サーバーサイドのトラックイベントを送信するコードを開発者が作成する必要があります。これには、ページの閲覧数やフィーチャーのクリック数が含まれます。プロダクトがTwilio Segmentと連携している場合は、Twilio Segment経由でPendoにトラックイベントを送信する方法を使用できる場合があります。
注: トラックイベントの設定に関する詳細については、トラックイベントの設定およびサーバーサイドトラックイベントのAPIドキュメントを参照してください。開発チームがトラックイベントを設定したら、アプリからPendoにそれらを送信する最適な方法を一緒に検討してください。
また、APIを使用してPendoにメタデータを渡し、それをレポートのセグメントの定義に使用することもできます。詳細については、メタデータのAPIドキュメントを参照してください。
インストールのベストプラクティス
このセクションでは、非Webビュー環境でトラックイベントを使用してPendoをインストールする際のベストプラクティスについて説明します。
トラックイベントをアプリ内時間としてカウントする設定を有効にする
デフォルトでは、この設定は無効になっています。トラックイベントはさまざまなユースケースをサポートできるため、すべての実装でトラックイベントを訪問者のアクティビティとして扱うべきとは限りません。ただし、トラックイベントを使用してPendoをインストールする場合は、各トラックイベントがアプリ内で訪問者のアクティビティとして扱われるように、この設定を有効にする必要があります。アプリ内時間としてトラックイベントをカウントする(Count Track Events as time in app)設定の詳細については、トラックイベント セクション(ページとアプリの滞在時間の計算の記事内)を参照してください。
既存のログを使用する
プロダクトですでに別のツール(SplunkやLogstashなど)でページの読み込みやフィーチャーのクリックをログに記録している場合は、開発者が既存のログ記録機能を変更して、これらをトラックイベントとしてPendoに送信できます。
命名規則を決める
トラックイベント名は、PendoのUIでトラックイベントがどのように表示されるかを示すものです。命名規則を定義し、データディクショナリに保存しておくことを強くおすすめします。特定のトラックイベントが何を表しているかをPendoユーザーが理解しやすいように、命名規則を定義したドキュメントをPendoの外部で管理してください。
例:
- ページビューは「Page | 」で始まります。
- フィーチャークリックは「Feature | 」で始まります。
- フィーチャー名は、そのフィーチャーがあるページ名とページ内のセクション名で始まります。「Feature | {page name} | {section} {feature name}」
要素が多く複雑なアプリケーションでは、各エリアにラベルを付けたページのスクリーンショットが役立ちます。例:
データディクショナリで管理する
データは、それが何を表すかについて全員が合意していて初めて有用になります。データディクショナリを保持しておくことをおすすめします。データディクショナリは、Pendoを実装するエンジニアと、アナリティクスを閲覧するPendoユーザーの両方がアクセスできるようにしてください。
イベントプロパティを使用する
レポートとセグメントの機能を強化するには、イベントプロパティを使用します。イベントプロパティを使用すると、JSONオブジェクトのpropertiesキーで設定することで、各イベントに関する追加のコンテキストを含めることができます。イベントプロパティを指定することで、Pendoでのセグメントとレポートの機能をさらに拡張できます。詳細については、イベントプロパティの記事内のカスタムイベントプロパティセクションを参照してください。