複数レベルのアカウントがある場合(子アカウントの上に親アカウントがある場合など)は、この追加情報をインストールスクリプトでPendoに渡すことができます。
また、親アカウントのサブスクリプション設定は、Pendoの担当者が別途有効にする必要があります。success@pendo.ioまたはカスタマーサクセスマネージャーを通じてリクエストしてください。
この機能を実装する前に、以下の情報をよく読んで、お客様の組織に適した設定であることを確認してください。
1. この変更の構造は、アカウントオブジェクトにリンクされたオブジェクトを追加するだけではありません。accountIdは、parentAccountIdがchildAccountIdの前に付加されたものに置き換えられ、parentAccountId::childAccountIdの形式になります。この文字列は、スニペット内のaccountIdとparentAccountIdの指定から作成されます(本記事の最後に例があります)。
2. このような構造になっているため、親アカウントをオフにして子アカウントIDだけを渡すようにすると、親アカウントにリンクしていた場合には、同じ子アカウントIDを持っていたデータとの統合ができななります。この場合は、新しいアカウントIDのセットを一から作成することになります。
3. Pendo UIでは、デフォルトで[訪問者(Visitors)]ページと[アカウント(Accounts)]ページが用意されており、それぞれ訪問者とアカウントが一覧表示されています。親アカウントがオンになっている場合、親アカウントを有効にした後でPendoの[アカウント]ページに移動すると、実際にデフォルトで親アカウントに設定されているため、アカウント(中間レベル)の指標の表示が制限されます。現在、アカウントおよび親アカウントのすべての指標をアプリ内で表示することはできません。アカウントレポートを作成してアカウントレベルの指標を掘り下げることはいつでもできますが、Pendo UIの[アカウント]では同じチャートやグラフは表示されません。
4. この構造は、アカウントに基づくデータで計算するように設定されているダッシュボードウィジェットが、parentAccountId::childAccountIdの組み合わせのデータを取り込むことを意味しています。
インストールスクリプトの構造
複数レベルのアカウントを持つインストールスクリプトの構造は以下のようになります。
<script>
(function(apiKey){
(function(p,e,n,d,o){var v,w,x,y,z;o=p[d]=p[d]||{};o._q=[];
v=['initialize','identify','updateOptions','pageLoad'];for(w=0,x=v.length;w<x;++w)(function(m){
o[m]=o[m]||function(){o._q[m===v[0]?'unshift':'push']([m].concat([].slice.call(arguments,0)));};})(v[w]);
y=e.createElement(n);y.async=!0;y.src='https://cdn.pendo.io/agent/static/'+apiKey+'/pendo.js';
z=e.getElementsByTagName(n)[0];z.parentNode.insertBefore(y,z);})(window,document,'script','pendo');
// 訪問者に関する情報が利用可能になった場合はいつでも、これを呼び出します。
// 値の種類には文字列、数値、またはブール値を使用してください。
pendo.initialize({
visitor: {
id: 'VISITOR-UNIQUE-ID' // Required if user is logged in
// email: // Optional
// role: // Optional
// You can add any additional visitor level key-values here,
// as long as it's not one of the above reserved names.
},
account: {
id: 'ACCOUNT-UNIQUE-ID' // Highly recommended
// name: // Optional
// planLevel: // Optional
// planPrice: // Optional
// creationDate: // Optional
// You can add any additional account level key-values here,
// as long as it's not one of the above reserved names.
},
parentAccount: {
id: 'PARENT-ACCOUNT-UNIQUE-ID'
// name: // Optional
// You can add any additional master account level
// key-values here.
}
})('<ACTUAL_API_KEY_HERE>');
</script>
モバイルの親アカウント
親アカウントは、モバイルアプリケーションでも有効です。
- ウェブアプリケーションと同様に、まずPendoサブスクリプション設定で「親アカウント」にチェックを入れる必要があります。
- Pendo SDKの初期化でアカウントIDを設定するときは、次の特別な形式を使用して、親アカウントIDも設定します:parentAccountId::accountId
制限事項:現時点では、モバイルSDKを使用して親アカウントのメタデータを設定することはできません。