通常、PendoはJavaScriptコードからなるインストールスクリプトを通してインストールされ、アプリケーションにコピーされます。Pendoのインストールには複数のオプションがあります。この記事では、Pendoをウェブに直接実装するためのさまざまなインストールオプションの概要を簡単に説明します。
シングルページアプリケーションの場合
シングルページのフレームワークでは、Pendoインストールスクリプトの最初の部分はメインのHTMLページに含まれ、Pendoを初期化する呼び出しは通常別のコンポーネントで行われます。手順については、Pendoをシングルページウェブアプリケーションにインストールするを参照してください。
マルチページアプリケーションの場合
マルチページアプリケーションフレームワークでは、アプリケーションのすべてのHTMLページにPendをインストールして初期化する必要があります。手順については、Pendoをマルチページウェブアプリケーションにインストールするを参照してください。
iframesの場合
Pendoは、最上位フレームと、アナリティクスの追跡またはガイドの配信を行う各フレームで実行されている必要があります。ガイドがフレームをまたいで表示される、またはフレーム間で連携することが想定される場合は、すべてのフレームで同じapiKeyと訪問者およびアカウントのメタデータを使用してください。
Pendo Web SDKバージョン2.141.1では、同一オリジンのフレーム設定におけるセットアップの負担を軽減する2つの設定オプションが導入されました。
-
frameIdentitySync。すべてのフレームで訪問者IDとメタデータの変更を同期します。1つのフレーム内でpendo.identifyまたはpendo.updateOptionsを呼び出すと、Web SDKを実行している他のすべてのフレームに伝播します。 -
autoFrameInstall。親フレームと同じオリジンを共有するすべての子フレームで、Web SDKを自動的にインストールして初期化します。インストールコードスニペットを最上位フレームに追加するだけで済みます。
注：autoFrameInstallには同一オリジンのフレームが必要です。frameIdentitySyncは、各フレームが個別に初期化されている限り、異なるオリジンのフレーム間で機能します。
設定の詳細については、Pendo Web SDKドキュメントの「フレームの自動インストールと同期」を参照してください。
アプリケーションのログインページの場合
ログインページでアナリティクスを取得する場合は、Pendoで匿名の訪問者IDを使用してインストールする必要があります。ユーザーがサインインした後、次のいずれかを行う必要があります。
- マルチページフレームワークを使用している場合、Pendoを再初期化します。
- シングルページのフレームワークを使用している場合は、訪問者を再識別します。
詳しい手順は、ログインページにPendoをインストールするをご覧ください。
Twilio Segmentとのインテグレーション
PendoはTwilio Segment（旧Segment.ioおよびSegment.com）とのインテグレーションを提供しており、SegmentからPendoにデータを送信することができます。Pendoは、Twilio Segmentインテグレーションを通じてインストールできます。多くの場合、アプリケーションのコードを変更することなくこのインストールを完了できるため、Pendoをより迅速にインストールできます。手順については、Twilio SegmentによるPendoのインストールを参照してください。
Googleタグマネージャー経由
PendoはGoogleタグマネージャー経由でインストールできます。多くの場合、アプリケーションのコードを変更することなくこのインストールを完了できるため、Pendoをより迅速にインストールできます。手順については、GoogleタグマネージャーによるPendoのインストールを参照してください。
その他のタグマネージャー経由
ほとんどのタグマネージャーは、アプリケーションのコードに小さなインストールスクリプトを埋め込むことで動作します。インストールスクリプトがインストールされた後、通常はコードベースのアプローチではなく、タグマネージャーを通じてアプリケーションに追加コードを追加するオプションが提供されます。PendoはプレーンなJavaScriptを使用してインストールされるため、ほとんどのタグマネージャーからPendoインストールスクリプトを挿入できます。
npmパッケージ経由
Pendo Web SDK は、インストールスクリプトを直接アプリケーションに追加する代わりに、npm パッケージ@pendo/web-sdkを使用してインストールできます。これによりSDKがアプリにバンドルされるため、新しいバージョンにアップデートするには新しいビルドをデプロイする必要があります。
インストールおよび初期化の手順については、「Pendo Web SDK」のドキュメントをご覧ください。
Microsoftアプリの場合
Microsoft Power Appsはローコードでアプリケーションを開発できるフレームワークで、Microsoftユーザーは、社内のビジネスアプリケーションを構築し、カスタマイズできます。Microsoft Power Appsには、モデル駆動型アプリとキャンバスアプリという2つの大きなカテゴリーがあります。
Salesforceデジタルエクスペリエンスの場合
SalesforceデジタルエクスペリエンスにPendoをインストールするには、JavaScriptを使用します。この方法なら、Salesforce側で新たにエンジニアリング作業を行うことなく、訪問者IDをPendoに送信できます。ただし、アカウントIDや、訪問者とアカウントのメタデータについては、Salesforceのカスタムコンポーネントを開発しない限り送信できません。詳細については、SalesforceデジタルエクスペリエンスにPendoをインストールするを参照してください。
他のサードパーティ製アプリの場合
コードスニペットを追加できるサードパーティアプリには、Zendesk GuideなどのアプリにPendoインストールスクリプトを挿入できます。
ブラウザ拡張機能の場合
Pendo Web SDKは、インストールスクリプトが追加された任意のウィンドウまたはフレームでイベントを収集できます。ブラウザ拡張機能はサードパーティアプリケーション上で実行できるため、Pendoが基盤となるアプリケーションではなく拡張機能からのイベントのみをキャプチャするようにすることが重要です。
次のいずれかの条件を満たす場合は、ブラウザ拡張機能にPendoをインストールできます。
- 拡張機能は、拡張機能によってホストされ、独自のドキュメントオブジェクトを持つ別のiframeを開きます。この場合は、その frame内にPendoインストールスクリプトをインストールします。
- 拡張機能は新しいウィンドウを開き、独自のウェブアプリケーションにアクセスするか、拡張機能ベースのURL（たとえば、Chrome拡張機能の場合は
chrome-extension://）を使用します。この場合、新しいウィンドウにPendoインストールスクリプトをインストールします。
拡張機能でManifest V3を使用している場合は、追加の手順が必要です。リモートコードが取得されないようにするために、npmを使用してPendo Web SDKをインストールする必要があります。セットアップ手順については、READMEの Manifest V3 Extensionセクションを参照してください。