通常、PendoはJavaScriptコードからなるインストールスクリプトを通してインストールされ、アプリケーションにコピーされます。Pendoのインストールには複数のオプションがあります。この記事では、Pendoをウェブに直接実装するためのさまざまなインストールオプションの概要を簡単に説明します。
シングルページアプリケーションの場合
シングルページのフレームワークでは、Pendoインストールスクリプトの最初の部分はメインのHTMLページに含まれ、Pendoを初期化する呼び出しは通常別のコンポーネントで行われます。手順については、Pendoをシングルページウェブアプリケーションにインストールするを参照してください。
マルチページアプリケーションの場合
マルチページアプリケーションフレームワークでは、アプリケーションのすべてのHTMLページにPendをインストールして初期化する必要があります。手順については、Pendoをマルチページウェブアプリケーションにインストールするを参照してください。
iframesの場合
アナリティクスやガイドが必要な各フレームにPendoをインストールします。ガイドがフレームをまたいだり、フレーム間で調整されることが予想される場合は、すべてのフレームで同じapiKeyと訪問者/アカウントのメタデータを使用してください。
その他のiframe設定オプションは以下のとおりです。
-
frameIdentitySyncでフレーム間で訪問者のIDまたはメタデータの変更を同期します。 -
autoFrameInstallで同じオリジンを持つ子フレームにWeb SDKを自動インストールして初期化します。
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セクションを参照してください。