お客様のプロダクト、つまりPendoがすでにインストールされているウェブベースのアプリケーションには、サードパーティのプロダクトが組み込まれている場合があります。この記事では、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 Web SDKから、有効な訪問者IDを渡すことができるか？
アプリケーションと組み込みサードパーティプロダクトの両方で、同じ訪問者ID値を使用することをお勧めします。そうすると、Pendoの同じ訪問者レコードで、お客様のアプリケーションと組み込みサードパーティプロダクトの両方にわたり同一のエンドユーザーの使用状況を追跡できます。
お客様のアプリケーションと組み込みサードパーティプロダクトの両方で同じ訪問者IDを使用できない場合は、別の訪問者IDのセットを使用するか、Pendoがサードパーティプロダクトで匿名の訪問者IDを生成できるようにすることができます。ただし、これは次の理由で推奨されません。
- お客様のアプリケーションと組み込みサードパーティプロダクトでの同じ訪問者の使用状況は、Pendoでは2つの異なる訪問者レコードに分割されます。
- これにより、Pendoサブスクリプションの月間アクティブユーザー（MAU）数が増加します。詳細については、月間アクティブユーザー（MAU）を参照してください。
- 特に自動アクティベーションの場合、ガイドの表示に問題が発生する可能性があります。
訪問者IDの詳細については、記事インストールスクリプトを使用してPendoのウェブでの直接実装を計画するの訪問者IDとアカウントIDを選択するを参照してください。
代替ソリューション
組み込みサードパーティプロダクトにPendoを追加できない場合、代わりにトラックイベントを通じて、組み込みサードパーティアプリのデータをPendoに送信することができます。このソリューションは、サードパーティアプリが埋め込まれたPendoアナリティクスのみに対応し、トラックイベントの設定には開発者の労力が必要です。その際も、有効な訪問者IDとアカウントIDをPendoに渡す必要があります。