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

Microsoft Intuneを使用してWindows版Chromeを構成する

最終更新日:

この記事では、Microsoft Intuneを使用して、Windowsコンピューター上のChromeウェブブラウザにPendo Launcher拡張機能を設定する手順について説明します。

  1. 構成する値を決定します。
  2. PowerShellスクリプトを作成します。
  3. PowerShellスクリプトをエンドユーザーのデバイスにプッシュします。
  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とメタデータ

ほとんどの場合、Windowsへの展開では、MDMツール（Intuneなど）を通じて訪問者IDのみが提供され、APIやCSVアップロードなどの他の手段を通じてメタデータが補足されます。ただし、ユーザーのマシン上で値を動的に取得するメソッドがある場合は、訪問者オブジェクトにメタデータを提供することができます。

メタデータの提供について詳しくは、「Active DirectoryスクリプトでPendoに送信するメタデータをカスタマイズする」を参照してください。

訪問者情報は、PowerShellと互換性のない文字をすべて取り除いた文字列から成るJSONオブジェクトとして形式化する必要があります。PowerShellのエスケープ文字については、Microsoftのドキュメント「引用規則について（About Quoting Rules）」を参照してください。

ステップ2. PowerShellスクリプトを作成する

利用中のマシンにpendo-launcher-config.ps1というファイルを作成します。以下のコードをファイルにコピーし、ステップ1で決定したAPIキーの値を挿入します。

 

$api_key = "your-api-key-goes-here"

$username = $null

# Wait for username to be populated
while ($username -eq $null) {
    $username = (Get-CimInstance Win32_Process -Filter 'name = "explorer.exe"' | Invoke-CimMethod -MethodName getowner).User
    if ($username -is [array]) {
        $username = $username[0]
    }
    $username = $username -replace ' ', '.'
    Start-Sleep -Seconds 5 # Sleep for 5 seconds (optional)
}

# Define the Visitor ID by converting the username to an email address
# Your definition of a Visitor ID may vary

$visitor_id = $username + "@pendo.io"

$visitor_json= "{ `"id`": `"$visitor_id`" }"

$registry_path_chrome = "HKLM:\SOFTWARE\Policies\Google\Chrome\3rdparty\extensions\epnhoepnmfjdbjjfanpjklemanhkjgil\policy"

$parent_path_chrome = Split-Path -Path $registry_path_chrome

# Create Chrome policy path for the Pendo Launcher if it does not exist

if (!(Test-Path $parent_path_chrome)) {
    New-Item -Path $parent_path_chrome -Force -ItemType Directory | Out-Null
}

if (!(Test-Path $parent_path_chrome\policy)) {
    New-Item -Path ("$parent_path_chrome\policy") -Force -ItemType Directory | Out-Null
}

# Set the API Key, Visitor ID, and Data Environment policies

Set-ItemProperty -Path $registry_path_chrome -Name "APIKey" -Value $api_key
Set-ItemProperty -Path $registry_path_chrome -Name "visitor" -Value $visitor_json -Type ExpandString

# For eu environments, change io to eu

Set-ItemProperty -Path $registry_path_chrome -Name "dataEnvironment" -Value "io"

exit 0

ステップ3. PowerShellスクリプトをエンドユーザーのデバイスにプッシュする

Microsoftのドキュメント「IntuneでWindows 10/11デバイス上のPowerShellスクリプトを使用する（Use PowerShell scripts on Windows 10/11 devices in Intune）」を参照してください。

  1. Microsoft Intune管理センター（https://intune.microsoft.com）に移動します。
  2. 左側のメニューから［デバイス（Devices）］>［スクリプト（Scripts）］を選択します。
  3. ［スクリプト］ページの上部にある［+追加（+ Add）］を選択します。これにより、新しいスクリプトが追加されます。
  4. ドロップダウンメニューから［Windows 10以降（Windows 10 and later）］を選択します。

    Decives Scripts.png

  5. ［基本（Basics）］タブで、スクリプトのわかりやすい名前（「Pendo Launcher Configuration」など）を入力します。［次へ（Next）］を選択して続行します。
  6. ［スクリプト設定（Script settings）］タブで、ステップ2で作成したpendo-launcher-config.ps1ファイルをアップロードします。［ログイン時の認証情報を使用してこのスクリプトを実行する（Run this script using the logged in credentials）］が［いいえ（No）］に設定されていることを確認します。［次へ］を選択して続行します。

    Add PS script.png

  7. ［割り当て（Assignments）］タブで、ランチャー構成を展開するデバイスのグループを選択します。［次へ］を選択して続行します。
    • 「Microsoft Intuneを使用してWindows版Chromeにインストールする」の手順に従った場合は、Pendo Launcherの強制インストールで対象としたグループと同じものを選択する必要があります。
    • まずは1台のデバイスで展開のテストと検証を行い、その後、エンドユーザーのデバイス全体をカバーするよう徐々に割り当て範囲を拡大することをお勧めします。

      Assignments tab.png

  8. ［確認と追加（Review + add）］タブで、スクリプト、設定、およびグループの割り当てを確認します。
  9. 確認が完了したら、［追加（Add）］を選択します。

    Review plus add.png

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

まず、物理的にアクセスできる単一のデバイスでスクリプトをテストし、構成が正しいことを検証します。検証では、レジストリキーが正しく設定されていること、および拡張機能が期待どおりに構成されていることを確認します。

レジストリキーの設定を確認する

  1. Windowsデバイスでレジストリエディタを開きます。タスクバーの検索ボックスに「regedit」と入力し、結果から［レジストリエディタ（Registry Editor）］（デスクトップアプリ）を選択します。
  2. ［HKEY_LOCAL_MACHINE］>［SOFTWARE］>［Google］>［Chrome］>［3rdparty］>［extensions］>［epnhoepnmfjdbjjfanpjklemanhkjgil］の順でレジストリキーの場所に移動します。

レジストリキーは以下のように表示されます。

ブラウザに拡張機能が構成されていることを確認する

レジストリキーが設定されていることを確認したら、ブラウザの拡張機能が有効になっていることを確認し、コンテンツが正しくフォーマットされているかどうか検証します。なお、Intuneがエンドデバイスで設定スクリプトを実行するには、最大で24時間かかります。

  1. 構成プロファイルのあるデバイス上でChromeを開きます。アプリがすでに実行されている場合は、終了して再度開きます。
  2. 「chrome://extensions」をコピーして、ブラウザのURLバーに貼り付けます。
  3. ブラウザのツールバーの右上にあるPendo Launcher拡張機能を見つけます。拡張機能が表示されない場合は、パズル型のアイコンを選択して拡張機能をさらに表示してください。
  4. 拡張機能アイコンを右クリックし、［デバッグ情報を表示（Show Debug Info）］を選択します。

    Show Debug Info.png

  5. ［構成タブを表示（Show Configuration Tab）］>［IT管理の構成（IT-Managed Config）］を選択します。
  6. 値がレジストリキーに設定されている値と一致していることを確認します。dataEnvironmentがデフォルト値のioに設定されている場合、dataEnvironmentキーはここでは表示されません。

    PendoLauncher.png

関連記事