この記事では、コードを制御するアプリケーション、またはJavaScriptを記述できるアプリケーションにカスタムコードスニペットを挿入して、訪問者IDとメタデータを設定する方法について説明します。この方法は、IT部門が管理する標準的なデプロイメントに代わる方法で、レジストリキーの代わりにJavaScriptコードを使用してウェブページからの訪問者を識別します。
前提条件
ブラウザスクリプトを使用して訪問者を特定するには、次の条件を満たす必要があります。
- Pendoサブスクリプションの管理者ユーザーであること。詳細については、役割と権限を参照してください。
- ブラウザにPendo Launcherの拡張機能をインストールしていること。拡張機能をサポートするすべてのブラウザが対象です。詳しくは、サポートされているブラウザを参照してください。詳しくは、Pendo Launcherを導入するためのITガイドをご覧ください。
- 社内で構築されたアプリケーションや、MS DynamicsやSalesforceのようなJavaScriptインジェクションを許可するSaaSアプリケーションなど、JavaScriptスニペットを挿入できるアプリケーションを用意しておくこと。
プロセス概要
設定した当初は、訪問者が匿名として設定されます。ブラウザ拡張機能（ここではPendo Launcher）が実行されているアプリケーションに初めてアクセスすると、Pendo Launcherでブラウザスクリプトを設定したアプリケーションのURLのウィンドウが開きます。指定したURLで訪問者を自動的に識別できない場合（ログインページが開く場合など）、訪問者は資格情報を入力する必要があり、その後画面が閉じます。
Pendo Launcherブラウザ拡張機能が訪問者を識別すると、訪問者は設定プロセスの一環として指定したURLに転送されます。このプロセスは一度だけ行われます。
ステップ1：Pendo Launcherを設定する
まず、ブラウザスクリプトで訪問者とメタデータを識別するために必要な機能を有効にする必要があります。
- Pendoで、［設定（Settings）］>［サブスクリプション設定（Subscription Settings）］に移動します。
- ［拡張機能の設定（Extension settings）］で、［ブラウザスクリプトを使用して訪問者メタデータを設定する（Set visitor metadata through browser scripting）］を選択します。
- ［識別アプリのURL（Identification app URL）］に、ブラウザスクリプトを設定するアプリケーションのURLを入力します。サブスクリプション全体に対して、1か所で設定すればOKです。
- 必要に応じて、プライバシーメッセージを追加します。［プライバシー意識向上バナーを表示する（Show Privacy Awareness Banner）］]を選択し、訪問者に本人確認を求める理由を説明するためにメッセージに含めるテキストを追加します。
- ［設定を保存（Save configuration）］を選択します。
2. ブラウザスクリプトの識別を有効にする
- Pendoで、［設定（Settings）］>［サブスクリプション設定（Subscription Settings）］に移動します。
-
［Applications（アプリケーション）］タブを開き、ステップ1の［識別アプリのURL（Identification App URL）］のエントリに一致するアプリケーションを開きます。たとえば、識別アプリのURLが
https://company.example.com/appsの場合、［ウェブサイト（Websites）］フィールドにcompany.example.comが含まれるアプリケーションを選択します。 -
［ブラウザスクリプティング用の訪問者識別関数を挿入する（Inject visitor identification function for browser scripting）］を選択します。これは、
window.__pendoIdentifyVisitor関数（ステップ3のコード内にあります）が挿入される場所を制御します。
ステップ3．識別JavaScriptスニペットを挿入する
次に、制御するアプリケーションにJavaScriptスニペットを挿入して、アプリケーションへの訪問者を識別します。
- Pendoで、［設定（Settings）］>［サブスクリプション設定（Subscription Settings）］に移動します。
- ［拡張機能の設定（Extension settings）］>［詳細設定（Advanced settings）］で、［ブラウザスクリプトを使用して訪問者メタデータを設定する（Set visitor metadata through browser scripting）］が選択されていることを確認します。これにより、さらに多くのオプションと変更が必要なスクリプトなどの情報が表示されます。
-
スクリプトをコピーしてプレーンテキストエディタに貼り付け、コードを編集して
VISITOR-UNIQUE-IDを、アプリケーション内の訪問者を識別するコードに置き換えます。 - 編集したコードを、ステップ2の識別アプリのURLに一致するURLのアプリケーションに挿入します。