この記事では、モバイルデバイス管理(MDM)ツールを使用して、MacのGoogle ChromeウェブブラウザにPendo Launcher拡張機能を構成する手順について説明します。
この記事で説明するプロセスを使用して、次の種類のデータを構成できます。
- APIキー
- 訪問者ID
- メタデータ
前提条件
エンドユーザーのデバイスで拡張機能を構成する前に、まずエンドユーザーのブラウザに拡張機能をインストールする必要があります。すべての導入オプションについては、Pendo Launcherを導入するためのITガイドを参照してください。また、展開ステップを実行する前に、ブラウザ拡張機能の実装を計画するという記事を読むことをお勧めします。
ステップ1. 構成する値を決定する
Pendo Launcherを完全に展開するには、APIキーと訪問者IDを構成する必要があります。役割や場所などのメタデータを含めることもできます。これらのメタデータは、アナリティクスやガイドのターゲット設定に活用できます。適切な訪問者IDとメタデータの選択に関する詳細は、ブラウザ拡張機能の実装を計画するを参照してください。
APIキー
構成プロセスのステップ2に必要なAPIキーは、[設定(Settings)]>[サブスクリプション設定(Subscription Settings)]に移動すると確認できます。以下のような個別の拡張機能APIキーが、ページ上部に表示されます。
{
"APIKey": {
"Value": "c022bb1e-676d-4c58-731c-caf13fe12a89"
}
}
訪問者IDとメタデータ
訪問者情報は、XMLと互換性のないすべての文字を取り除いた、文字列のJSONオブジェクトとして形式化する必要があります。このファイルの作成方法は以下のとおりです。
1. 以下のような情報を含む通常のJSONオブジェクトを作成します。
{
"id": "foo",
"bar": "baz",
"bingo": [
1,
2,
3
],
"tango": "2006-01-02T15:04:05.999-05:00"
}
2. 文字列を取り除くには、freeformatter.comやcodebeautify.orgなどのオンラインツールを使います。上記のオブジェクトから得られる文字列は以下のようになります。
{
"id": "foo",
"bar": "baz",
"bingo": [
1,
2,
3
],
"tango": "2006-01-02T15:04:05.999-05:00"
}
3. この訪問者オブジェクトに値を動的に入力する方法については、MDMツールのドキュメントを参照してください。たとえば、Jamfでペイロード変数を使うと、対象となるエンドユーザーに固有の値を構成プロファイルに動的に挿入できます。
ステップ2. .plistファイルを作成する
ステップ1で作成した文字列を使用して .plistファイルを作成します。Plist(プロパティリスト)ファイルは、アプリケーション設定の保存に使用されるMacシステムに固有の拡張子です。XML形式のこれらのファイルには、さまざまなプログラムのプロパティと環境設定が含まれています。
利用中のマシンにcom.google.Chrome.extensions.epnhoepnmfjdbjjfanpjklemanhkjgil.plist
というファイルを作成します。以下のコードをファイルにコピーし、ステップ1で決定した値を挿入します。
<?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>ここに あなたの 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>c025bc1f-606d-4d62-731c-caf13fe12j24</string>
<key>visitor</key>
<string>{"id": "john.smith@example.com"}</string>
</dict>
</plist>
ステップ3. .plistファイルをエンドユーザーのデバイスにプッシュする
MDMツールを使用して、.plist
ファイルを構成プロファイルとしてエンドユーザーのデバイスにプッシュします。この構成プロファイルの優先ドメインは、com.google.Chrome.extensions.epnhoepnmfjdbjjfanpjklemanhkjgil.plist
です。お使いのツールの要件として、アップロードする前に.plist
ファイルを構成プロファイルに変換する必要がある場合は、オープンソースツールmcxToProfileを使用してください。
MDMツールには、カスタム構成プロファイルを展開する方法に関する具体的な手順が記載されています。以下は、Macデバイスで使用される最も一般的なMDMツールのドキュメントです。
- Jamf(PendoのドキュメントJamfを使用してmacOS版Chromeで構成するも参照してください)
- Kandji
- Hexnode
- Workspace ONE
ステップ4. 構成を検証する
まず、物理的にアクセスできる単一のデバイスでスクリプトをテストし、構成が正しいことを検証します。検証では、構成プロファイルの存在を確認し、正しいブラウザの動作を検証します。
構成プロファイルの存在を確認する
構成プロファイルが正常に構成されたことを確認するには、次の2つの方法があります。
Appleのシステム設定
- Macのアップルメニューで[システム設定]を選択します。
- サイドバーで[プライバシーとセキュリティ(Privacy & Security)] を選択します。
- [その他(Others)]で[プロファイル(Profile)]を選択します。下にスクロールすると見つかる場合があります。
- MDMツールで設定した名前の構成プロファイルを検索し、存在することを確認します。
コマンドライン
- Macターミナルアプリを開きます。
- コマンド
cd /Library/Managed\ Preferences
を入力して、管理対象設定フォルダー(managed preferences folder)に移動します。 com.google.Chrome.plist
ファイルが存在することを確認します。- コマンド
defaults read /Library/Managed\ Preferences/com.google.Chrome
を入力します。 - ステップ2で設定した値と内容が一致していることを確認します。
ブラウザの動作を検証する
ブラウザが構成プロファイルの内容を正しく読み取っていることを確認します。
- 構成プロファイルを使用してデバイス上でChromeを開きます。Chromeアプリがすでに実行されている場合は、終了して再度開きます。
- Chromeのブラウザに、Pendo Launcherブラウザ拡張機能をインストールします。Pendo Launcherの強制インストールをすでに設定している場合は、この手順をスキップできます。
- Pendoなど、Chrome以外のウェブページにアクセスします。
- ブラウザのツールバーの右上にあるPendo Launcher拡張機能アイコンを右クリックします。
- [デバッグ情報を表示(Show Debug Info)]を選択します。
- [識別対象(Identified as)]フィールドの訪問者IDが正しいことを確認します。
- [コンフィギュレーション情報を表示(Show Configuration Info)]を選択します。
- [IT管理の構成(IT-Managed Config]ドロップダウンメニューを開き、構成値を検索して、その値が存在することを確認します。