複数レベルのアカウントの管理

概要

複数のレベルのアカウントがある場合(子アカウントの上に親アカウントがある場合など)は、この追加情報をスニペットでPendoに渡すことができます。

また、親アカウントのサブスクリプション設定はPendoの担当者が別途有効にする必要があり、success@pendo.ioまたはカスタマーサクセスマネージャーに連絡してリクエストすることができます。

 

重要:この機能を実装する前に、以下の情報をよく読んで、お客様の組織に適した設定であることを確認してください。

1. この変更の構造は、アカウントオブジェクトにリンクされたオブジェクトを追加するだけではありません。accountIdは、parentAccountIdがchildAccountIdの前に付加されたものに置き換えられ、parentAccountId::childAccountIdの形式になります。この文字列は、スニペット内のaccountIdとparentAccountIdの指定から作成されます(本記事の最後に例があります)。

2. このような構造になっているため、親アカウントをオフにして子アカウントIDだけを渡すようにすると、親アカウントにリンクしていた場合には、同じ子アカウントIDを持っていたデータとの統合ができななります。この場合は、新しいアカウントIDのセットを一から作成することになります。

3. PendoのUIでは、デフォルトで訪問者ページとアカウントページが用意されており、それぞれ訪問者とアカウントが一覧表示されています。親アカウントがオンになっている場合、親アカウントを有効にした後で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>
注:スニペットにはすでに正しいAPIキーが入力されているため、アプリ内のインストール設定ページからインストールスニペットを取得することをお勧めします。これは一般的なスニペットで、最後の行を実際のAPIキーと入れ替える必要があります

モバイルの親アカウント

親アカウントは、モバイルアプリケーションでも有効です。

  1. ウェブアプリケーションと同様に、まずPendoサブスクリプション設定で「親アカウント」にチェックを入れる必要があります。
  2. Pendo SDKの初期化でアカウントIDを設定するときは、次の特別な形式を使用して、親アカウントIDも設定します:parentAccountId::accountId

制限事項:現時点では、モバイルSDKを使用して親アカウントのメタデータを設定することはできません。