1. Pendo Adoptヘルプセンター
  2. インストール
  3. 構成

構成プロファイルを使用してmacOS版Chromeで構成する

最終更新日:

この記事では、モバイルデバイス管理（MDM）ツールを使用して、MacのChromeウェブブラウザにPendo Launcher拡張機能を構成する手順について説明します。

  1. 構成する値を決定します。
  2. お使いのデバイスで.plistファイルを作成します。
  3. .plistファイルをエンドユーザーのデバイスにプッシュします。
  4. 構成が正常に行われたことを検証します。

この記事で説明するプロセスを使用して、次の種類のデータを構成できます。

  • APIキー
  • 訪問者ID
  • メタデータ

前提条件

エンドユーザーのデバイスで拡張機能を構成する前に、まずエンドユーザーのブラウザに拡張機能をインストールする必要があります。すべてのインストールオプションについては、Pendo Launcherを導入するためのITガイドをご覧ください。また、展開ステップを実行する前に、Adoptのインストールを計画するの記事を読むことをお勧めします。

ステップ1. 構成する値を決定する

Pendo Launcherを完全に展開するには、API キーと訪問者IDを構成する必要があります。役割や場所などのメタデータを含めることもできます。これらのメタデータは、アナリティクスやガイドのターゲット設定に活用できます。訪問者IDやメタデータを適切に選択する方法については、Adoptのインストールを計画するをご覧ください。

APIキー

構成プロセスのステップ2に必要なAPIキーは、［設定（Settings）］>［サブスクリプション（Subscription）］に移動すると確認できます。個別の拡張機能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ファイルを作成する

利用中のマシンに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>{&quot;id&quot;: &quot;john.smith@example.com&quot;}</string>
  </dict>
</plist>

ステップ3. .plistファイルをエンドユーザーのデバイスにプッシュする

MDMツールを使用して、.plistファイルを構成プロファイルとしてエンドユーザーのデバイスにプッシュします。この構成プロファイルの優先ドメインは、com.google.Chrome.extensions.epnhoepnmfjdbjjfanpjklemanhkjgil.plistです。お使いのツールの要件として、アップロードする前に .plistファイルを構成プロファイルに変換する必要がある場合は、オープンソースツールmcxToProfileを使用してください。

MDMツールには、カスタム構成プロファイルを展開する方法に関する具体的な手順が記載されています。以下は、Macデバイスで使用される最も一般的なMDMツールのドキュメントです。

ステップ4. 構成を検証する

まず、物理的にアクセスできる単一のデバイスでスクリプトをテストし、構成が正しいことを検証します。検証では、構成プロファイルの存在を確認し、正しいブラウザの動作を検証します。

構成プロファイルの存在を確認する

構成プロファイルが正常に構成されたことを確認するには、次の2つの方法があります。

Appleのシステム設定

  1. Macのアップルメニューで［システム設定］を選択します。
  2. サイドバーで［プライバシーとセキュリティ］ を選択します。
  3. ［プロファイル］を選択します。下にスクロールすると見つかる場合があります。
  4. MDMツールで設定した名前の構成プロファイルを検索し、存在することを確認します。

コマンドライン

  1. Macターミナルアプリを開きます。
  2. コマンドcd /Library/Managed\ Preferencesを入力して、管理対象設定フォルダー（managed preferences folder）に移動します。
  3. com.google.Chrome.plistファイルが存在することを確認します。
  4. コマンドdefaults read /Library/Managed\ Preferences/com.google.Chromeを入力します。
  5. ステップ2で設定した値と内容が一致していることを確認します。

ブラウザの動作を検証する

ブラウザが構成プロファイルの内容を正しく読み取っていることを確認します。

  1. 構成プロファイルを使用してデバイス上でChromeを開きます。Chromeアプリがすでに実行されている場合は、終了して再度開きます。
  2. Chromeのブラウザに、Pendo Launcherブラウザ拡張機能をインストールします。Pendo Launcherの強制インストールをすでに設定している場合は、この手順をスキップできます。
  3. https://pendo.io/など、Chrome以外のウェブページにアクセスします。
  4. ブラウザのツールバーの右上にあるPendo Launcher拡張機能アイコンを右クリックします。
  5. ［デバッグ情報を表示（Show Debug Info）］を選択します。
  6. ［識別対象（Identified as）］フィールドの訪問者IDが正しいことを確認します。
  7. ［コンフィギュレーション情報を表示（Show Configuration Info）］を選択します。
  8. ［IT管理の構成（IT-Managed Config］ドロップダウンメニューを開き、構成値を検索して、その値が存在することを確認します。

IT管理

関連記事