Pendo Launcherブラウザ拡張機能を使用してPendoをデプロイする場合、追加のAPI keyを構成して、複数のアプリケーションからのイベントデータを複数のPendoサブスクリプションに送信できます。
仕組み
アプリケーションデータを複数のサブスクリプションに送信するには、Pendo Launcherブラウザ拡張機能を設定するのと同じ方法で、拡張機能の元のAPIキーに加えて追加の設定が必要です。サブスクリプションはPendoの任意のデータ環境に存在する可能性があり、各サブスクリプションがどの環境に属しているかを指定することが必要な場合があります。
拡張機能は、指定したすべてのサブスクリプションからアプリケーションリストをダウンロードし、設定されているすべてのアプリケーションを追跡します。
データの重複や不整合を避けるため、同じURLをターゲットとするサブスクリプション間で複数のアプリケーションを保有することはできません。2つのアプリケーションがターゲットURLで重複する場合、データ送信には1つのアプリケーションのみが使用されます。
複数のサブスクリプションにデータを送信するには、次のものが必要です。
- サブスクリプションのAPIキー。サブスクリプション管理者は、[設定(Settings)]>[サブスクリプション設定(Subscription settings)]>[拡張機能(Extension)]でサブスクリプションのAPIキーを確認できます。
-
サブスクリプションのデータ環境。Pendoにアクセスする際に使用するURLを確認すると、お客様のサブスクリプションがどのデータ環境でホストされているかを確認できます。
-
デフォルトのUSデータ環境のURLは
app.pendo.ioで、一般に「io」環境と呼ばれています。 - US1データ環境のURLは
us1.app.pendo.ioです。 - EUデータ環境のURLは
app.eu.pendo.ioです。 - 日本のデータ環境のURLは
app.jp.pendo.ioです。 - オーストラリアデータ環境のURLは
app.au.pendo.ioです。
-
デフォルトのUSデータ環境のURLは
拡張機能の設定を更新する
複数のサブスクリプションにデータを送信するには、以前使用したPendo Launcherブラウザ拡張機能の設定を編集して、additionalAPIKeysを含めます。追加のサブスクリプションが元の(プライマリ)サブスクリプションとは異なるデータ環境にある場合は、キーと共に環境を指定する必要があります。以下はその例です。
APIKey: 'API_KEY_FOR_SUB1',
dataEnvironment: 'eu'
additionalAPIKeys: [
'{"key": "API_KEY_FOR_SUB2", "env": "io"}',
'API_KEY_FOR_SUB3'
]
上記の例では、プライマリサブスクリプションのAPIキーはAPI_KEY_FOR_SUB1で、EUデータ環境に存在します。2番目のサブスクリプションのAPIキーはAPI_KEY_FOR_SUB2で、デフォルト("io")の米国データ環境に存在します。3番目のサブスクリプションのAPIキーはAPI_KEY_FOR_SUB3で、EUデータ環境に存在します。
コードの例
次の例では、Pendo Launcher ブラウザ拡張機能を使用して、さまざまな環境でadditionalAPIKeysパラメータを設定する方法を示します。
Microsoft Intune
IntuneのPendo構成ドキュメントで説明されているPowerShellスクリプトに次のコンテンツを追加します。
# 追加のAPIKeys情報を保持する変数を作成
$additionalAPIKeys_array
=
"[
'{"key": "API_KEY_FOR_SUB2", "env": "io"}',
'API_KEY_FOR_SUB3'
]"
# APIKeyと訪問者プロパティの横にadditionalAPIKeysプロパティを設定
Set-ItemProperty -Path $registry_path_chrome -Name "additionalAPIKeys" -Value $additionalAPIKeys_array -Type ExpandString
additionalAPIKeysの値は、JSON形式の文字列配列を含む拡張文字列(REG_EXPAND_SZ)である必要があります。
Google管理コンソール
{"APIKey":{"Value":"API_KEY_FOR_SUB1"},"dataEnvironment":{"Value":"eu"},"additionalAPIKeys":{"Value":["{\"key\": \"API_KEY_FOR_SUB2\",\"env\":\"io\"}","API_KEY_FOR_SUB3"]}}
macOS構成プロファイル
<?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_KEY_FOR_SUB1</string>
<key>dataEnvironment</key>
<string>eu</string>
<key>additionalAPIKeys</key>
<array
<string>
{"key": "API_KEY_FOR_SUB2","env":"io"}</string>
<string>API_KEY_FOR_SUB3</string
</array>
</dict>
</plist>
検証
まず、物理的にアクセスできる単一のデバイスでスクリプトをテストし、構成が正しいことを検証します。検証では、レジストリキーが正しく設定されていること、および拡張機能が期待どおりに構成されていることを確認します。
レジストリキーの設定を確認する
- Windowsデバイスでレジストリエディタを開きます。タスクバーの検索ボックスに「regedit」と入力し、結果から[レジストリエディタ(Registry Editor)](デスクトップアプリ)を選択します。
[HKEY_LOCAL_MACHINE]>[SOFTWARE]>[Google]>[Chrome]>[3rdparty]>[extensions]>[epnhoepnmfjdbjjfanpjklemanhkjgil]の順でレジストリキーの場所に移動します。
レジストリキーは以下の図のように表示されます。
ブラウザに拡張機能が構成されていることを確認する
レジストリキーが設定されていることを確認したら、ブラウザの拡張機能が有効になっていることを確認し、コンテンツが正しくフォーマットされているかどうか検証します。 なお、Intuneがエンドデバイスで設定スクリプトを実行するには、最大で24時間かかります。
- 構成プロファイルのあるデバイス上でChromeを開きます。アプリがすでに実行されている場合は、終了して再度開きます。
- https://www.pendo.io/ をコピーして、ブラウザのURLバーに貼り付けます。
- ブラウザのツールバーの右上にあるPendo Launcher拡張機能を見つけます。表示されない場合は、パズルアイコンを選択して、さらに拡張機能を表示する必要がある場合があります。
- 拡張機能アイコンを右クリックし、[コンフィギュレーション情報を表示]を選択します。
- [構成タブを表示(Show Configuration Tab)]>[IT管理の構成(IT-Managed Config)]を選択します。
additionalAPIKeysプロパティとその内容が存在するか確認します。