概要
この記事では、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）］セクションで、データが予想される展開構成と一致していることを確認します。
