この記事では、Pendo Web SDKをアップグレードして、Pendoプラットフォームの最新の体験を確保する方法について説明します。説明には以下の内容が含まれます。
- Pendo Web SDKの概要およびアプリケーションへの取り込み方法。
- お使いのPendo Web SDKのバージョンを確認する方法。
- 自動または手動でPendo Web SDKをアップグレードする方法。
- Web SDKの互換性設定。
新しいWeb SDKにアップグレードする必要はありませんが、フィーチャーの追加や改善はWeb SDKバージョン2.0以降のみを対象とします。最新バージョンにアップグレードしないことを選択した場合、セキュリティアップデートを自動的に受け取ることができず、古いバージョンのサポートが難しくなります。
Pendo Web SDKのアップグレードに特別な要件はありません。
Web SDKとインストールスクリプト
Pendo Web SDKはJavaScriptファイル（pendo.js）で、ウェブアプリケーションのブラウザ内で動作します。標準のPendoインストールでは、Cloudfront CDNからPendo Web SDKを安全かつ非同期にロードします。
Web SDKは、Pendoエージェントコード（pendo.js）を取得して読み込む数行のコードであるインストールスクリプト（スニペット）によって、アプリケーションに取り込まれます。インストールスクリプトを見つけるには、［設定（Settings）］>［サブスクリプション設定（Subscription Settings）］>［アプリケーション（Applications）］に移動し、［アプリケーション］リストから該当するアプリケーションを選択して、［インストール設定（Install Settings）］タブを開きます。
Pendo Web SDKとインストールスクリプトの詳細については、開発者のためのPendoインストールガイドを参照してください。
Web SDKのバージョンを確認する
現在使用しているインストールスクリプトとPendo Web SDKのバージョンを確認するには、ブラウザのコンソールにコード：pendo.VERSIONを入力します。
コンソールが2.0以降を返した場合、新しいバージョンのインストールスクリプトとWeb SDKを使用しています。コンソールが1.xを返した場合、古いバージョンのインストールスクリプトとWeb SDKを使用しているため、最新バージョンにアップグレードすることをお勧めします。
Web SDKをアップグレードする
これまでは、すべてのお客様が同じWeb SDKを使用していました。新しいバージョンのWeb SDKがリリースされるごとに、すべてのお客様にすべての変更が反映されていました。現在は、各サブスクリプションで個別にパーソナライズされたWeb SDKが提供されるため、いつPendo Web SDKのバージョンをアップグレードするかを社内チームで決められるようになりました。
Pendo Web SDKの最新バージョンを常に取り込むか（推奨）、テストプロセスをサポートするバージョンを手動で選択するかを選択できます。
Web SDKバージョンの自動アップデートを設定する手順は以下のとおりです。
- ［設定（Settings）］>［サブスクリプション設定（Subscription Settings）］の順に進みます。
- ［アプリケーション（Applications）］タブを開きます。
- ［アプリケーション］リストから該当するアプリを見つけて開きます。
- ページの上部にある［Web SDKの設定］タブを開きます。この操作により、ステージング環境と本番環境で現在使用しているWeb SDKのバージョンを確認できます。
- ［本番環境（Production environment）］セクションの右側にある［設定］を選択します。
- ［Web SDKのバージョン設定（Web SDK Version Settings）］で、［安定版（Stable）］ を選択します。本番サーバーの場合は、この設定がデフォルトで推奨されています。
- ［保存（Save）］を選択して続行します。
上記の手順により、Pendo Web SDKの最新の安定版が自動的に展開されるため、最新のアップデートや重大なバグ修正を受信できるようになります。
ここで選択できる他の2つのオプションは以下のとおりです。
- ［ベータ版（Beta）］では、Web SDKの最新のベータ版が自動的に展開されます。ステージングサーバーの場合は、この設定がデフォルトで推奨されています。通常、安定版の展開はベータ版より1～2週間遅れます。
- ［手動（Manual）］では、Pendo Web SDKの特定のバージョンを選択できます。ステージング環境でバージョンをテストしてから、本番環境用のテスト完了済み（安定版）バージョンに切り替える場合は、この設定を選択します。
手動でのアップグレードを選択した場合、ステージング環境と本番環境で実行するバージョンは、お客様の許容範囲によって異なります。ステージング環境用に最新バージョンを選択してから、本番環境用に最新のテスト済みバージョンを手動で選択することもできます。
Web SDK のリリースノートとバージョン変更は、Web SDKドキュメントで確認できます。更新が利用可能になったときに通知を受け取るには、RSSフィードに登録してください。
Web SDKの互換性設定を選択する
Web SDKのアップグレードオプションを選択すると同時に、ブラウザのサポートオプションを変更することができます。
現在、デフォルトは［標準（Standards）］です。プロダクトで古いブラウザを使用している場合は、JSONPを使用されることを推奨します。Pendoのお客様の中には、自社のセキュリティ要件に合わせるため、JSONPを選択しないお客様もいらっしゃいます。このような場合、JSONPの代わりにガイドコンテンツにPendoのXHRトランスポートを使用しています。