エージェント2.0に関するよくある質問

最終更新日:

Pendoエージェントとは何ですか?また、「スニペット」とは何ですか?

Pendoエージェントは、ウェブアプリケーションの訪問者のブラウザ内部で実行されるJavascriptコードです。標準的な方法でPendoをインストールした場合、安全かつ非同期的にPendoエージェントがCloudfront CDNから読み込まれます。

「スニペット」は、[Pendoインストール設定(Pendo Install Setup)]のインストール(Install)ページから確認できる数行のコードで、これにより完全なエージェントがアプリケーションに組み込まれます。

古いバージョンと新しいバージョンはどうすれば見分けられますか?

ブラウザのコンソールで、
pendo.VERSION
と入力することで、現在使用しているPendoスニペットとPendoエージェントのバージョンを確認できます。2.0以降と表示される場合は、新しいバージョンのスニペットとエージェントが使用されています。1.xと表示される場合は、古いバージョンが使用されているため、アップグレードする必要があります。

エージェント2.0に移行するメリットは何ですか?

これまでは、すべてのお客様が同じエージェントを使用していました。新しいバージョンのエージェントがリリースされるごとに、すべてのお客様に同じ変更が即座に反映されていました。

エージェント2.0では、各サブスクリプションで個別にパーソナライズされたエージェントが提供されるため、いつPendoエージェントバージョンをアップグレードするかをチームで決められるようになります。これまでと同じように動作させたい場合には、常に最新のバージョンを取得するように設定できますし、手動でバージョンを選択してテストプロセスをサポートすることもできます。

今後は、エージェント2.0のみに機能が追加されていくため、アップグレードを推奨します。どうしても必要な場合を除き、古いバージョンのPendoエージェントの使用は推奨されません。古いバージョンのPendoエージェントには新しい機能が追加されず、バグ修正も行われません。また、古いバージョンの場合サポートを受けにくくなります。

新しいバージョンに移行する必要がありますか?移行しない場合どうなりますか?

通常は移行する必要があります。古いエージェントを使用するユーザーが何か影響を受けることはありませんが、新しい機能はエージェント2.0以降のみに追加される予定です。

新しいバージョンに移行するにはどうすればよいですか?

管理者として、[設定(Settings)] -> [サブスクリプション設定(Subscription Settings)] -> [アプリの選択(Choose your App)] -> [インストール設定(Install Settings)]に移動して、Pendoアプリケーションの指示に従いウェブサイトのスニペットを更新します。

ステージング環境および本番環境での推奨設定は何ですか?具体的には、どのバージョンを実行すべきですか?

これは許容範囲によります。ステージング環境で「最新版」を使用して、最も新しいテスト済みバージョンを手動で選択し、それを本番環境で使用することもできます。

JSONP、XHRとは何ですか?どれを使用すればよいですか?
JsonVsXhr

Pendoの現在のデフォルトはJSONPであるため、これが使用されている可能性が高いです。特に問題がなければ、そのままJSONPを使用してください。一般的に、JSONPはブラウザの対応範囲が最も広いオプションです。プロダクトで古いブラウザを使用する場合は特に、JSONPの使用を強く推奨します。

お客様のセキュリティチームの中には、セキュリティ要件上の理由からJSONPを利用できない方もいます。このようなお客様は、ガイドコンテンツにPendoのXHRトランスポートを使用しています。

ベータ版(Beta)、安定版(Stable)、手動(Manual)の違いは何ですか?

BetaVsStableVsManual

ベータ版の場合、最新版のPendoエージェントが適用されるようにサイトが自動で更新されます。これは、ステージングサーバーのデフォルトであり、推奨設定です。

安定版の場合、ベータ版から1~2週間遅れたエージェントのバージョンが適用されるようにサイトが自動で更新されます。これは、本番サーバーのデフォルトであり、推奨設定です。

手動では、特定のバージョンのエージェントを手動で選択できます。この場合、たとえばステージングでバージョンをテストしてから、必要に応じてそのテスト済みのバージョンを本番環境に切り替えることなどができます。

エージェント2.0に移行するための要件は何ですか?

エージェント2.0に特別な要件はありません。すでにエージェントがインストールされているのであれば、エージェント2.0も機能するはずです。