Pendo Web SDKは、ウェブアプリケーションで動作し、生のイベントデータを収集し、ガイドを表示するJavaScriptです。標準のPendoインストールでは、CDNからpendo.jsが安全かつ非同期に読み込まれます。最新のバージョンを使用するために、CDNからPendo Web SDKを読み込むことを強くお勧めします。ただし、セキュリティ上の制約により必要な場合は、Pendo Web SDKをセルフホストすることができます。
Pendoのインストールと設定の詳細については、以下を参照してください。
セルフホスティングのデメリット
Pendoは、通常毎週、Pendo Web SDKのアップデートを継続的にリリースしています。これらのアップデートの多くには機能強化が含まれており、その機能強化が正しく動作するためには、更新されたPendo Web SDKがアプリケーションに存在する必要があります。Pendo Web SDKをセルフホスティングすると、アプリの読み込み時に最新バージョンのWeb SDKを受け取ることができず、アップデートへのアクセスがブロックされる可能性があります。さらに重要なのは、Pendo Web SDKをセルフホスティングすると、重要なセキュリティアップデートを自動的に受け取ることができないということです。また、セルフホスティングでは、Web SDKをインストールして管理するための追加の開発の時間も必要になります。
Web SDKには、現在のPendoの設定が反映されます。変更があった場合は、その変更を有効にするために、お客様がWeb SDKを更新する必要があります。つまり、更新されたWeb SDKがダウンロードされ、ローカルにホストされたWeb SDKでホストされるまで、Pendoでの設定の変更は発生しません。
Pendoでステージング環境を追加または削除するには、その変更を認識するために更新済みのWeb SDKが必要です。ステージング環境は、本番環境の外でガイドを展開し、テストするために使用されます。Pendo Web SDKのステージング版は、常にPendo CDNから提供されており、これを変更するためにインストールスクリプトを変更することはサポートされていません。
Web SDKをダウンロードする
アプリケーションレベルの設定である[Web SDKの設定]からPendo Web SDKをダウンロードします。
- [設定(Settings)]>[サブスクリプション設定(Subscription Settings)]の順に進みます。
- [アプリケーション(Applications)]タブを開きます。
- [アプリケーション]リストから該当するアプリケーションを見つけて開きます。
- [Web SDKの設定]タブを開きます。
- [本番設定を管理(Manage Production Settings)]を選択します。
-
[ダウンロード(Download)] リンクを選択し、
pendo.jsをダウンロードします。
Pendo Web SDKをホストする
pendo.jsのダウンロード後、アプリケーションがアクセスできる場所にファイルをホストします。たとえば、Web SDKを https://myapp.com/assets/pendo.jsでホストすることができます。
インストールスクリプトを更新する
pendo.jsをディレクトリにアップロードしたら、インストールスクリプトを更新して、現在の場所からpendo.jsを読み込みます。インストールスクリプトのsrc='https://cdn.pendo.io/agent/static/'+apiKey+'/pendo.js'を、ローカルでホストされているWeb SDKの場所で更新する必要があります。この変更は、Pendoがアプリケーションにインストールされているすべての場所で行う必要があります。お客様のインストールの詳細に応じて、アプリケーションの単一ページまたは複数ページでの更新が必要です。
Web SDKを更新する必要がある場合は、場所やファイル名の変更がない限り、ディレクトリ内のpendo.jsを置き換えるだけで済みます。