この記事では、現在Pendoをご利用中のお客様が、PendoプロダクトにFeedbackを追加する場合の手順を説明します。先へ進む前に、まずインストールスクリプトを使用したPendoの実装に関する開発者ガイドをお読みになることをお勧めします。
Pendo Feedbackは、アプリケーションのインストールスクリプト（「スニペット」）を編集することで、次のことをできるようにします。
- メールアドレスのフィールドなど、追加のメタデータを渡す
- Feedbackでセグメントの自動タグを作成する
インストールスクリプトを使用したPendo Feedbackのインストールについては、Pendo Academyに掲載している動画をご視聴ください。
旧Feedbackをご利用のお客様で最新の体験をご利用になりたい場合、またはPendoとPendo Feedbackの両方を新たにご利用になる場合は、インストールスクリプトを使用したPendoの実装に関する開発者ガイドに記載されている新規ユーザー向けの手順に従い、この記事のステップ1：初期化方法の変更を確認するで説明しているメタデータと自動タグの追加設定のアドバイスをご確認ください。
Feedbackのインストールプロセス
まず、Pendoをセルフホストしている場合は、お使いのPendoエージェントが最新バージョンであることを確認します。［設定（Settings）］に記載されているバージョン番号と、Pendoウェブエージェントアーカイブに記載されている最新バージョンを比較します。または、コンソールでpendo.getVersion()コマンドを使用して確認します。
次に、インストールコードの初期化方法に加える変更を特定します。詳細については、「ステップ1：初期化方法の変更を確認する」 をご覧ください。
最後に、メタデータフィールドへの変更でコードを更新して、Feedbackを追加します。手順については、「ステップ2：インストールスクリプトを再構成する」を参照してください。その後、Pendoはオンボーディングプロセスの一環としてFeedbackを有効にします。
ステップ1：初期化方法の変更を確認する
Pendo Feedbackは、次の情報を使用すると最も効果的に機能します。
-
- 一意のアカウントID（必須）
- 訪問者メタデータとしてのメールアドレス（通信用に強く推奨）
- 追加のコンテキストのための訪問者メタデータとしての氏名
- 訪問者レベルとアカウントレベルの自動タグ
- アカウントが有料顧客であるかどうか
- アカウントの価値（通常、月次または年次の定期的な価値）
FeedbackのアカウントID
FeedbackにはアカウントIDが必要です。訪問者がFeedbackで一意のレコードを作成するには、自分に関連づけられたアカウントIDが必要になります。これは、リクエストを送信したユーザーに関する重要な詳細情報を提供するものです。
正確なFeedbackの使用状況データを得るためには、アカウントIDを変更しないでください。
現在、Pendo Feedbackは訪問者を親アカウントにマッピングしません。エンドユーザーが同じ訪問者IDを持つ複数のアカウントに属している場合、Feedbackはそれらを一意の訪問者としてカウントします。
複数のアカウントがレポートに影響を与える可能性があるため、リクエストが関連付けられている訪問者を確認することが重要です。Feedbackでは重複したユーザーが作成されますが、訪問者とアカウントの両方が表示され、機能リクエストを訪問者とアカウントに関連付けることができます。
Pendo Feedbackでは、匿名の訪問者はサポートされていません。
メールアドレスのメタデータ
また、インストールスクリプトのメタデータフィールドにメールアドレスを渡すことを強くお勧めします。これは、メールアドレスを訪問者IDとして使用することとは異なります。
Pendoのレポートからアクセスできるメールのメタデータでは、カスタムセグメントを作成したり、Pendo Feedbackの中心的な部分として利用したりできます。インストールスクリプトに訪問者のメールアドレスを含めることで、オプションとして、ユーザーが配信登録しているリクエストの更新を知らせる通知メールや、エンゲージメントおよびプロダクトに関するメールを送信できます。
通知メールの配信は選択性です。訪問者はリクエストを作成するとき、またはリクエストに投票やコメントするときに配信を停止できます。詳細については、Feedbackの通知メールを参照してください。
Feedbackにおける自動タグ付け
Feedback UIでは、リクエスト、チームユーザー、訪問者、アカウントにタグを追加できます。訪問者およびアカウントレベルでタグ付けする最も効率的な方法は、自動タグ付けを使用することです。
自動タグ付けは次の目的で使用できます。
- アカウントレベルおよび訪問者レベルのタグに基づいて、Feedbackでリクエストのレポートを作成します。インストールスクリプトに自動タグを追加した後、［Feedback］>［レポート（Reports）］>［詳細設定（Advanced）］で、［ユーザーフィルター（User Filters）］と［アカウントフィルター（Account Filters）］の下にあるタグを選択してフィルタリングできます。
- メタデータフィールドがFeedbackのメタデータフィールドと1対1で関連付けられていないことから生じる状態を解決します。たとえば、Pendoにユーザー権限、役割、部門などの訪問者メタデータがある場合、これらをFeedbackで自動タグとして設定できます。
特定の訪問者またはアカウントからのリクエストに自動タグを付けることができます。特定のURLからのリクエストや他の条件に基づいてリクエストに自動タグを付けることはできません。
メタデータと同様に、何を自動タグとして送信するかは、PIIを念頭に置きながら、組織のポリシーに基づいて決定する必要があります。
自動タグ付けの詳細については、Feedbackにおける自動タグ付け（Auto-tagging in Feedback）を参照してください。
ステップ2：インストールスクリプトを再構成する
インストールスクリプトを使用したPendoの実装に関する開発者ガイドの「ステップ2：アプリケーションへのPendoのインストール」で説明されている手順でインストールスクリプトを再構成するか、以下の方法で再構成します。
- ブラウザでapp.pendo.ioから、［Pendoのプロダクト（Pendo Products）］ >［Feedback］>［プロダクト設定（Product Settings）］に移動します。
- ［Feedbackをインストール（Install Feedback）］を選択した後、［Pendoの設定（Pendo Settings）］で［スニペットをインストール（Install Snippet）］を選択すると、Pendoの［サブスクリプション設定（Subscription Settings）］に移動します。
- ［アプリケーション（Applications）」タブを開きます。
- ［アプリケーション］の一覧から該当するアプリケーションを探し、開きます。
- ［インストール設定（Install Settings）］タブを開きます。
- コードをテキストエディタにコピーして編集します。
- インストールスクリプトの訪問者オブジェクトとアカウントオブジェクト内のフィールド名を設定します。
- アプリ内のメタデータとタグをコードに取り込みます。
- アプリケーションのすべてのページにあるHTMLテンプレートのHeadタグにコードを貼り付けて、コードをアプリコードにコピーします。
JWTインストール
JSON Web Token（JWT）を使ってPendo Feedbackをインストールすることで、リソースセンターを通じてFeedbackが公開された場合に、悪意のある人物が別の訪問者になりすまそうとするリスクを軽減できます。PendoのインストールスクリプトとAPIキーには認証された訪問者しかアクセスできず、ユーザーになりすまそうと画策する人物はそのユーザーの訪問者IDとアカウントIDの両方を知る必要があるため、なりすましが発生するリスクは極めて低いと考えられます。
訪問者IDとアカウントIDsは、インストールスクリプトを介してPendoに渡す一意の識別子であり、一般に公開されていません。悪意のある人物が取得したとしても、エンドユーザーとして秘匿性の高いデータを見ることはできません。なりすましている訪問者の代わりにリクエストを送信することはできますが、訪問者のメールアドレスやその他のデータを見ることはできません。
詳細については、JWT署名付きメタデータを使用したインストールをご覧ください。
追加の設定
一部のエンドユーザーに対してFeedbackを無効にする
一部のユーザーのFeedbackへのアクセスをブロックするには、isableFeedback:trueを使用します。これで、そのユーザーに対してFeedbackが初期化されないようにすることができます。つまり、Feedbackはそのユーザーのデータを収集しないため、訪問者レコードが作成されず、そのユーザーはFeedbackにアクセスできなくなります。
これによって、Pendoによるユーザーの追跡が妨げられるわけではありません。
トラブルシューティング
自動タグがPendo Feedbackに表示されない
Feedbackは、initializeメソッドに書き込まれた訪問者タグとアカウントタグの値を受け取ります。Pendoエージェントから収集したメタデータの値をFeedback UIに表示するには、訪問者タグとアカウントタグのキー値ペアを配列形式で追加します。
Feedbackでの自動タグ付けについて詳しくはこちらをご覧ください。
コードテンプレート
visitor:{
id:'VISITOR-UNIQUE-ID'// Required if user is logged in// email: // Recommended if using Pendo Feedback, or NPS Email// full_name: // Recommended if using Pendo Feedback// role: // Optional
// tags: // Recommended if using Pendo Feedback
// 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// monthly_value:// Recommended if using Pendo Feedback// is_paying: // Recommended if using Pendo Feedback// planLevel: // Optional// planPrice: // Optional// creationDate: // Optional
// tags: // Recommended if using Pendo Feedback
// You can add any additional account level key-values here,// as long as it's not one of the above reserved names.}メタデータを用いたコード例
visitor:{
id: $user.ID,
email:'$user.email',
full_name:'$user.full_name',
role:'$user.accessLevel',
creationDate: $user.creationDate,
tags: ['$user.accessLevel','$user.creationDate']
},
account:{
id:'$account.ID',
name:'$account.name',
is_paying:'$account.is_paying',
monthly_value:'$account.monthly_value',
planLevel: $account.subscriptionCost,
isFoo: $account.isFoo,
tags: ['$account.subscriptionCost','$account.isFoo']
}Pendoに送られたコード例
visitor:{
id:62343,
email:'john@doe.com',
full_name:'John Doe',
role:'admin',
creationDate:1404326949156},
account:{
id:17,
name:'Acme, inc',
monthly_value:'99.99',
is_paying:true,
planLevel:995,
isFoo:false}