インテグレーションをPendoに接続する場合、またはパブリックAPIエンドポイントを使用する場合、Pendoでインテグレーションキーを生成します。すべてのインテグレーションにインテグレーションキーが必要なわけではありません。
このキーは、Pendoのインストールスクリプトに表示されるアプリケーションキー(通称「スニペット」)とは異なります。インストールスクリプトのアプリケーションキーは、Pendoをアプリケーションに接続するものです。詳細については、インストールスクリプトを使用したPendoの実装に関する開発者ガイドを参照してください。
Pendo Feedbackのインテグレーションには、別のキーが必要です。詳細と手順については、Pendo Feedback APIキーをご覧ください。
要件
インテグレーションを設定するには、Pendoの管理者権限と、インテグレーションキーへのアクセス権が必要です。詳細は、役割と権限についてを参照してください。
サブスクリプションの管理者は、この機能を有効にできます。管理者の方で、この機能が表示されない場合は、Pendoのアカウント担当者にお問い合わせください。
インテグレーションキーは特定のユーザーに関連付けられているものではなく、誰でも使用できます。したがって、この値を秘密にしておくことが重要です。
インテグレーションキーの作成
- [設定(Settings)]>[インテグレーション(Integrations)]>[インテグレーションキー(Integration Keys)]に移動します。
- [+インテグレーションキーを追加(+ Add Integration Key)]を選択します。
- インテグレーションキーにわかりやすい説明を入力します。
-
[作成(Create)]を選択します。
- 紛失または削除されたインテグレーションキーを取得することはできないため、作成時にPendoの外部で新しいキーを安全に取得して保管してください。
インテグレーションキーの回復
インテグレーションキーは作成時のみ表示され、UIには表示されません。紛失したインテグレーションキーは復元できません。既存のキーの値が見つからない場合は、新しいキーを作成する必要があります。Pendoでは、生成されるキーの数に制限はありません。
インテグレーションキーを使用したサブスクリプションへのアクセス
インテグレーションキーは、サブスクリプション内の特定のアプリケーションに関連付けられていません。インテグレーションキーを使うと、Pendoサブスクリプション内のすべてのアプリケーションにアクセスできます。Pendoに複数のアプリケーションがある場合、特定のアプリケーションまたはすべてのアプリケーションからのデータをリクエストする方法については、APIドキュメントのマルチアプリセクションをご覧ください。
また、インテグレーションキーは特定の環境に関連付けられていません。Pendoサブスクリプションには、Pendoがインストールされているすべての環境のデータが含まれています。ただし、除外リストには、本番ドメイン以外のイベントの除外など、イベントを除外する機能があります。オプションのブラックリストパラメータをAPIリクエストで使用して、除外リストのイベントをレスポンスに含めるかどうかを指定できます。