お客様のプロダクト、つまりPendoがすでにインストールされているウェブベースのアプリケーションには、サードパーティのプロダクトが組み込まれている場合があります。この記事では、お客様のプロダクトの埋め込み部分にPendoを追加することで、使用行動を把握したり、プロダクト内でのガイド表示ができるかどうかを評価したりするためのガイダンスを提供します。
ユースケース
画像に示す以下の例では、お客様のウェブアプリケーションはオレンジ色のボックスで表され、「BIツールダッシュボードウィジェット（BI Tool Dashboard Widget）」と呼ばれる組み込みサードパーティプロダクトは、オレンジ色のボックスの中にピンク色のボックスで表されています。組み込みサードパーティプロダクトはウェブアプリケーションのiFrameであり、お客様のウェブアプリケーションは最上位のフレームです。Pendoはすでにお客様のウェブアプリケーション（最上位のフレーム）に導入されており、これをサードパーティプロダクト（iFrame）に拡張して、このサードパーティプロダクト内で使用状況の追跡やガイドの配信を行うものとします。
評価チェックリスト
Pendoを組み込みサードパーティプロダクトに追加できるかどうかを確認するために、次の質問に答えてください。
1. 組み込みサードパーティプロダクトにPendoがすでにインストールされているか？
まず、組み込みサードパーティプロダクトが、すでにPendoを使用しているかどうかを判断します。
説明したユースケースでは、内側のiFrame、ピンクで表された「BIツールダッシュボードウィジェット（BI Tool Dashboard Widget）」という埋め込みサードパーティプロダクトは、そのサードパーティのPendoのサブスクリプションですでにPendoを使用しています。上位のフレーム（オレンジ色のボックスで表されているウェブアプリケーション）にも、お客様の別のサブスクリプションによってPendoがインストールされています。
以下の手順で、Pendoが組み込みサードパーティプロダクト（iFrame）にすでにインストールされているかどうかを確認します。さらに、Pendoに関してサードパーティに直接問い合わせることを推奨します。
PendoがiFrameにインストールされていることを確認するために、次の手順を実行します。
- iFrameを右クリックし、ドロップダウンメニューから［検査（Inspect）］を選択します。正しいiFrameが表示されていることを確認します。
- ［ブラウザ開発者コンソール（Browser Developer Console）］に
pendo.validateInstall()を貼り付け、［入力（Enter）］を選択すると、メタデータが返されます。 -
メタデータが返されない場合は、通常、次のエラーメッセージが表示されます。これはPendoがインストールされていないことを意味します。この記事のチェックリスト項目 2に進んでください。
組み込みサードパーティプロダクトがすでにPendoを使用している場合は、残りのチェックリストに進む必要はありません。その代わりに、サードパーティに問い合わせて、どのようなオプションを使用できるかを討議します。
PendoとiFrameのインストールの詳細については、開発者のためのPendoインストールガイドおよびビジュアルデザインスタジオ（Visual Design Studio）によるiframeのサポートを参照してください。
2. 組み込みサードパーティプロダクトにPendoをインストールできるか？
サードパーティのアプリケーションにPendoを展開するには、アプリケーション内のiFrameのコードにPendoをインストールする必要があります。この場合、サードパーティがPendoのJavaScriptコードを追加することを許可しているかどうか、サードパーティと相談する必要があるかもしれません。答えが「いいえ」であれば、続けることはできません。
ただし、この記事の最後に記載されている代替ソリューションを使って、アナリティクスで使用するためにサードパーティアプリからPendoにデータを送ることができるかもしれません。（ガイドは不可）
3. サードパーティプロダクトにインストールされているPendoエージェントから、有効な訪問者IDを渡すことができるか？
アプリケーションと組み込みサードパーティプロダクトの両方で、同じ訪問者ID値を使用することをお勧めします。そうすると、Pendoの同じ訪問者レコードで、お客様のアプリケーションと組み込みサードパーティプロダクトの両方にわたり同一のエンドユーザーの使用状況を追跡できます。
お客様のアプリケーションと組み込みサードパーティプロダクトの両方で同じ訪問者IDを使用できない場合は、別の訪問者IDのセットを使用するか、Pendoがサードパーティプロダクトで匿名の訪問者IDを生成できるようにすることができます。ただし、これは次の理由で推奨されません。
-
お客様のアプリケーションと組み込みサードパーティプロダクトでの同じエンドユーザーの使用状況は、Pendoでは2つの異なる訪問者レコードに分割されます。
-
この場合、Pendoサブスクリプションの月間アクティブユーザー（MAU）数が膨れ上がることになります。詳細については、月間アクティブユーザーの記事を参照してください。
-
特に自動アクティベーションの場合、ガイドの表示に問題が発生する可能性があります。
訪問者IDの詳細については、Pendoインストールの計画の記事の訪問者IDとアカウントIDを選択するを参照してください。
代替ソリューション
組み込みサードパーティプロダクトにPendoを追加できない場合、代わりにトラックイベントを通じて、組み込みサードパーティアプリのデータをPendoに送信することができます。このソリューションは、サードパーティアプリが埋め込まれたPendoアナリティクスのみに対応し、トラックイベントの設定には開発者の労力が必要です。その際も、有効な訪問者IDとアカウントIDをPendoに渡す必要があります。