概要
この記事では、MacコンピュータへのPendo Launcherのインストール手順を説明します。Macコンピュータへのインストール手順は、Windows PCの手順とは異なります。MDMデバイスでユーザーにPendo Launcherを強制的にインストールさせたくない場合は、Chrome管理コンソールからPendo Launcherをインストールすることも可能です。その手順はこちらです。Pendo Launcherのインストール計画を立てておけば、Pendo Launcherのインストールに必要な訪問者とアカウントのメタデータをチームが正確に取得するのに役立ちます。
注:Chromeの管理者コンソールからPendo Launcherを強制インストールすると、メタデータをプッシュすることはできません。
Macでのインストール手順
- 使用しているPendo LauncherのバージョンのGoogle Chrome拡張機能IDを確認する
- マシンに設定するメタデータ値を確認する
- これらの文字列を使用してChrome用の.plistファイルを作成する
- Chromeでポリシーの設定を確認する
Google Chrome拡張機能IDを確認する
このドキュメントでは、Google Chrome拡張機能IDを<EXTENSION_ID>と表記します。このIDはメジャーバージョンアップやマイナーバージョンアップを経ても変更されませんが、Chrome拡張機能ストアには他の組織で使用することを目的とした別のバージョンのPendo Launcherが配布されている場合があります。この値は、Chromeでchrome://extensionsと入力することで確認できます
メタデータ値を確認する
これらのメタデータ値は、アカウントまたは訪問者の2つのレベルに分けることができます。訪問者は個々の一意のユーザーです。これらのユーザーは、製品へのサインアップやログインの方法に基づいて識別できます。訪問者IDは通常、メールまたは一意の番号です。これは、複数の訪問者の集まりであるアカウントとは異なります。バックエンドに取り込むためには、取り込んだ値を事前にPendoで設定する必要があります。これらの値は、XMLと互換性のないすべての文字を取り除いた、文字列化されたJSONオブジェクトとして格納する必要があります。例は、以下のコードスニペットにあります。1{ 2 "id": "foo", 3 "bar": "baz", 4 "bingo": [ 5 1, 6 2, 7 3], 8 "tango": "2006-01-02T15:04:05.999-05:00" 9}
修正後:
1{ 2 "id": "foo", 3 "bar": "baz", 4 "bingo": [ 5 1, 6 2, 7 3], 8 "tango": "2006-01-02T15:04:05.999-05:00" 9}
.plistファイルを作成する
この文字列を使って、Chrome用の.plistファイルを作成します。plistファイルはMacのシステムに特有のものです。PLIST(プロパティリスト)は、アプリケーションの環境設定を保存するために使用される拡張機能です。XML形式のこれらのファイルには、さまざまなプログラムのプロパティと環境設定が含まれています。
注:このplistファイルはcom.google.Chrome.extensions.<YOUR_EXTENSION_ID>にプッシュする必要があります。
Property Listフィールドに、以下のスクリプトを入力します。
<plist version="1.0">
<dict>
<key>APIKey</key>
<string>あなたのAPIキー(必須)</string>
<key>visitor</key>
<string>訪問者の文字列(オプションですが、推奨)</string>
</dict>
</plist>
以下は、plistファイルの例です。
<?xml version="1.0"encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
<key>APIKey</key>
<string>INSERT API KEY<</string>
<key>visitor</key>
#訪問者IDを設定するための一般的な変数については、MDMのマニュアルを参照してください(例:john.doe@pendo.io)
<string>{"id": "john.doe@pendo.io"}</string>
</dict>
</plist>
ポリシーが正しく設定されたことを確認する
chrome://policyに移動します。[ポリシーの再読み込み(refresh policies)]をクリックすると、Pendo LauncherのChromeポリシーとして設定された文字列が表示されます。簡単に確認できるように、拡張機能がアクティブにデータを収集しているかどうかがPendo Launcherの色で表されています。Pendo Launcherアイコンがピンクの場合はアクティブで、データを収集しています。Pendo Launcherアイコンがグレーの場合、非アクティブで、データを収集していません。
メタデータが正しくエージェントに注入されていることを確認するには、Pendo Launcherの拡張アイコンを右クリックし、[デバッグ情報の表示(Show Debug Info)]をクリックします。

Pendo Launcherが適切に情報を収集している場合は、「Pendo Launcherはこのページのデータを収集しています(The Pendo Launcher is collecting data on this page)」というメッセージが表示されます。これは、Pendo Launcherが現在のウェブページの情報を収集するように設定されていることを意味します。

Pendo Launcherがページの情報を収集していない場合は、以下のメッセージが表示されます。

IDとメタデータが正しく構成されていることを確認するには、まず、ユーザーが誰として認識されているかを示す文字列を確認します。次に、[構成情報の表示(Show Configuration Info)]ボタンをクリックして、拡張機能内で構成されている設定を展開します。[拡張機能の設定を再取得(Re-fetch extension settings)]をクリックして、拡張機能に最新の設定が適用されていることを確認し、[IT管理の構成(IT-Managed Config)]セクションで、データが予想される展開構成と一致していることを確認します。
