Gainsight NXTをSalesforceにインストールして設定する
重要 - 画像/情報は四半期ごとのリリースで更新されます!
四半期ごとのリリースにて、最新の機能・情報を反映し、画像を含めた情報は更新されます。
概要
Gainsight は、カスタマーサクセス担当者が収益の拡大、顧客維持率の向上、および業務の効率化を実現するためのアプリケーションです。Gainsight Customer Success アプリは Gainsight プラットフォームの最新バージョンであり、Salesforce の UI から Gainsight Customer Success を利用することが可能です。Gainsight Customer Success の詳細については、Gainsight NXT 概要 の記事をご参照ください。Salesforce の UI で Gainsight Customer Success の使用を開始するには、まず Salesforce AppExchange から Gainsight Customer Success アプリケーションをダウンロードしてインストールする必要があります。
前提条件
パッケージをインストールする前に、以下の要件が満たされていることを確認してください。
- 有効な Gainsight NXT テナントが存在すること。
- Salesforce コネクターが Gainsight NXT で設定・連携済みであること。
- Salesforce ユーザーが Gainsight に同期済みであること。
- Salesforce エディションが Developer、Enterprise、またはそれ以上であること。
- Salesforce で AppExchange パッケージのダウンロード権限を保有していること。
- Gainsight Customer Success パッケージの最新バージョン(2.1.0)をインストールすること。
重要
公式の Gainsight Customer Success パッケージのインストール リンクを使用して、パッケージの最新バージョンをインストールしてください。最新バージョンではパスワードは不要です。パスワードが必要なのは古いバージョン(1.X)のみです。パッケージのパスワードが必要な場合は、Gainsight のプロジェクトマネージャーまたは CSM にお問い合わせください。
Gainsight Customer Success の詳細については、Gainsight NXT 概要 の記事をご参照ください。

AppExchange上のGainsightパッケージについて
Salesforce AppExchange で Gainsight を検索すると、それぞれ異なるユースケースに対応した複数の Gainsight パッケージが表示されます。以下の表を参考に、要件に最も合ったパッケージを選択してください。
| パッケージ | 用途 | 対象ユーザー |
|---|---|---|
| Gainsight Customer Success | Salesforce の UI から Gainsight NXT にアクセスするためのメインアプリケーション。360 ウィジェット、Gainsight タブ、コア機能が含まれます。 | Salesforce 内で Gainsight を使用したいすべてのお客様 |
| Gainsight CS Data Connector US | Salesforce と Gainsight 間の安全な連携を実現するコネクテッドアプリ。Salesforce コネクターによるデータ同期に必要です。 | Salesforce コネクターを使用するすべての米国リージョンのお客様 |
| Gainsight CS Data Connector EU | EU リージョンのお客様向けコネクテッドアプリ。米国版と同じ機能を提供します。 | Salesforce コネクターを使用するすべての EU リージョンのお客様 |
| Gainsight CS ECA | Gainsight ブラウザー拡張機能およびモバイルアプリ向けの Salesforce ベース SSO ログインを有効にする外部クライアントアプリです。 | Salesforce 経由で認証を行う Gainsight プラグインまたはモバイルアプリを使用しているお客様 |
注記:ほとんどのお客様は、Gainsight Customer Success パッケージと、お客様のリージョンに対応する Data Connector パッケージ(US または EU)の両方をインストールする必要があります。これらのパッケージは追加費用なしでご利用いただけます。
リージョンの確認方法
リージョンは Gainsight NXT テナントの URL によって決まります。
-
US1(デフォルト): <サブドメイン>.gainsightcloud.com → Gainsight CS Data Connector US をインストール
-
US2: <サブドメイン>.us2.gainsightcloud.com → Gainsight CS Data Connector US をインストール
-
EU: <サブドメイン>.eu.gainsightcloud.com → Gainsight CS Data Connector EU をインストール
インストールと設定のワークフロー
Salesforce の UI から Gainsight Customer Success にアクセスできるようにするには、以下のタスクを実行する必要があります。
-
Salesforce AppExchange から新しい Gainsight Customer Success アプリケーションをインストールします。
-
必要な Salesforce ユーザーに Gainsight CS ライセンスを割り当てます。
-
旧来の Gainsight パッケージから移行するユーザーは、ライセンスを自動的に移行できます。
-
新しいパッケージのライセンスは、旧来のパッケージのライセンスをすでに保有しているユーザーに自動的に割り当てることができます。
-
詳細については、本記事内の「Gainsight Customer Success パッケージからのライセンス移行」セクションをご参照ください。
-
-
Gainsight CS 権限セットを割り当てます。Salesforce 内で Gainsight NXT にアクセスする必要があるユーザーに対して割り当ててください。
-
旧来のパッケージの権限セットは自動的に移行できます。
-
新しいパッケージの権限セットは、旧来の権限セットをすでに保有しているユーザーに自動的に割り当てることができます。
-
-
Gainsight NXT ドメイン設定を構成します。お使いの Salesforce 組織を適切な Gainsight NXT テナントリージョンに接続します。
-
ライセンスの割り当てとドメイン設定は並行して構成することも可能ですが、Gainsight ではドメイン設定の構成前に、まずライセンスと権限セットの割り当てを完了させることを推奨しています。
-
-
Salesforce のページレイアウトを更新します。アカウント、商談、およびケースのレイアウトに Gainsight 360 ウィジェット(Lightning Web コンポーネント)を追加します。
-
カスタムオブジェクトウィジェットを設定します(該当する場合)。GS NXT 360 スマートウィジェットをすでに使用しているお客様が対象です。
新しいGainsight Customer Successパッケージについて
旧来の Gainsight CSM パッケージを使用している場合は、新しい Gainsight Customer Success パッケージへのアップグレードを推奨します。この新しいマネージドパッケージは軽量で、Salesforce 組織への影響を最小限に抑えるよう設計されています。
主なメリットは以下のとおりです。
- カスタムオブジェクトが 1 つのみ、少数の Visualforce ページ、および最小限の Apex クラスで構成されています。
- 旧来のパッケージとは異なり、標準 Salesforce オブジェクトにトリガーを追加しません。
新しいパッケージへの移行後、旧来のパッケージをアンインストールすることで以下のことが可能です。
-
70 以上の未使用カスタムオブジェクトを削除して、Salesforce の制限をクリアにできます。
-
タスクオブジェクトのトリガーを削除できます。
-
不要になった Apex クラス、Visualforce ページ、およびコンポーネントを整理できます。
重要:新しい Gainsight Customer Success パッケージには、Salesforce 用の Lightning Web コンポーネントが含まれています。詳細については、Salesforce 用 Gainsight Lightning Web コンポーネントの設定 の記事をご参照ください。
AppExchangeからGainsight Customer Successアプリをインストールする
Gainsight Customer Success アプリケーションをインストールするには、以下の手順に従ってください。
-
Salesforce 組織にログインします。
-
Salesforce アプリメニューから、AppExchange をクリックします。Salesforce AppExchange が新しいタブで開きます。

-
グローバル検索バーに「Gainsight」と入力し、Enter キーを押します。利用可能なすべての Gainsight パッケージが表示されます。
-
Gainsight Customer Success を選択します。

- 今すぐ入手 をクリックします。AppExchange ログインダイアログが表示されます。

- ログイン をクリックします。Salesforce AppExchange に自動的にログインされます。

- 本番環境にインストール または サンドボックスにインストール をクリックして、インストールを開始します。注記:Salesforce サンドボックス環境で Gainsight NXT を使用するには、ユーザーが本番環境の SFDC インスタンスから継承した権限セットとライセンスを保有している必要があります。

-
インストールの詳細と個人情報を確認します。
-
(オプション)プロフィールを編集 をクリックして個人情報を更新します。
-
利用規約に同意し、確認してインストール をクリックします。

注記:ログイン画面にリダイレクトされた場合は、ログイン資格情報を入力してください。
- プロンプトが表示された場合は、パッケージのパスワードを入力します。注記:Gainsight Customer Success パッケージの最新バージョンにはパスワードは不要です。パスワードの入力を求められた場合は、旧バージョンをインストールしようとしている可能性があります。Gainsight のプロジェクトマネージャーまたは CSM にお問い合わせください。
- Gainsight Customer Success パッケージをインストールまたはアップグレードするには、以下のいずれかのアクセスレベルを選択します。
- 管理者のみにインストール(推奨):Salesforce 管理者プロファイルを持つユーザーにのみフルアクセスを付与します。このオプションを使用して、個別レベルでアクセスと権限を管理します。
- すべてのユーザーにインストール(非推奨):内部カスタムプロファイルに割り当てられたすべてのユーザーにフルアクセスを付与します。すべてのユーザーがアクセスを必要とする場合にのみ使用してください。
- 特定のプロファイルにインストール(非推奨):Gainsight 担当者に相談した場合にのみ使用してください。
- インストール をクリックします。

インストールが完了すると、メールで確認通知が届きます。メール内でバージョン、組織名、およびユーザー名を確認できます。

Gainsight ライセンスを割り当てる
このセクションでは、Gainsight Customer Success パッケージのライセンスをユーザーに割り当てる手順を説明します。
デフォルトでは、Gainsight Customer Success をインストールすると 5 つのライセンスが付与されます。そのうち 1 つは、パッケージをインストールした管理者に自動的に割り当てられます。この管理者が残りの 4 つのライセンスを必要なユーザーに割り当てることができます。ライセンスの追加が必要な場合は、Gainsight にお問い合わせください。
ライセンスを割り当てるには、以下の手順に従ってください。
-
設定 をクリックします。
-
クイック検索 オプションから インストール済みパッケージ に移動します。

-
Gainsight Customer Success の横にある ライセンスの管理 をクリックします。インストール済みパッケージのページに、割り当て済みおよび使用中のライセンス数が表示されます。例えば、以下の画面では 1 つのライセンスが割り当て済みであり、他の 4 ユーザーにさらに割り当てることができます。
注記
-
ライセンス数は更新されるまでに数時間かかる場合があります。想定どおりに更新されない場合は、support@gainsight.com にお問い合わせください。
-
Salesforce はサンドボックス環境でのマネージドパッケージライセンスをサポートしていません。サンドボックスが作成されると、本番環境のアクティブなマネージドパッケージライセンスはすべてのユーザーに自動的に割り当てられます。

- ユーザーを追加 をクリックします。

-
ユーザーを選択し、追加 をクリックします。

選択したユーザーは、利用可能なライセンスに基づいて割り当てられます。許可されたライセンス数と使用中のライセンス数が更新されます(以下の例を参照)。

|
重要Gainsight のレポートで Salesforce オブジェクトを使用する場合、ユーザー検索は LicenseDefinitionKey フィールド(SFDC または AUL)に基づいてユーザーを取得します。このフィールドは以下の参照階層の一部です。 ユーザー → プロファイル → UserLicense → LicenseDefinitionKey ライセンスタイプ別にユーザーを取得するには、OAUTH ユーザーが Salesforce で設定と構成の表示権限を保有している必要があります。この権限が付与されていない場合、ユーザー検索は失敗します。 |
Gainsight NXT 権限セットを割り当てる
Gainsight CS ライセンスを割り当てたら、ユーザーに Gainsight CS 権限セットを割り当てることができます。Gainsight CS 権限セットを持つユーザーは、Salesforce 組織内で Gainsight を新しいタブとして表示できます。
注記:Visualforce へのアクセスを含まない Gainsight CS 権限セットをユーザーに付与したくない場合は、代わりに Gainsight CS API 権限セットを使用してください。
Gainsight CS 権限セットを割り当てるには、以下の手順に従ってください。
- 設定 > ユーザー管理 > 権限セット に移動します。

-
Gainsight CS 権限セットをクリックします。
-
割り当ての管理 をクリックします。
-
割り当てを追加 をクリックします。

-
必要なユーザーのチェックボックスを選択し、割り当て をクリックします。
-
完了 をクリックします。
注記:この手順のビデオチュートリアルについては、元の英語ドキュメントに記載されている Vimeo リンクをご参照ください。

SalesforceでGainsight NXTドメイン設定を構成する
Gainsight Customer Success パッケージをインストールしたら、システムがお使いのテナントリージョン内で正しく動作するようにドメイン設定を構成する必要があります。以下の手順でドメイン設定をセットアップします。
-
Salesforce アカウントにログインします。
-
設定 に移動します。
-
クイック検索ボックス を使用して インストール済みパッケージ を検索し、選択します。
.png?revision=1)
- インストール済みパッケージの一覧から、Gainsight Customer Success パッケージを見つけてクリックします。

- 設定 をクリックします。新しいウィンドウが表示されます。

この設定ウィンドウには以下のセクションが含まれています。
-
テナント
-
ライセンス
-
権限
-
マッピング
-
ウィジェット設定
テナントの選択
テナントセクションでは、Gainsight NXT テナントの URL に基づいて適切なデータセンターを選択する必要があります。
-
US1 → <テナントサブドメイン>.gainsightcloud.com
-
US2 → <テナントサブドメイン>.us2.gainsightcloud.com
-
EU → <テナントサブドメイン>.eu.gainsightcloud.com
注記:US1 はすべての新規インストールのデフォルトリージョンです。

旧マネージドパッケージから新しいマネージドパッケージへの移行
旧来の Gainsight CSM パッケージ(ネームスペース:JCXM)を使用している場合、管理者は Gainsight CSM パッケージのユーザーの既存のライセンスと権限を新しい Gainsight Customer Success 軽量パッケージに移行することができます。新しいパッケージへの移行が必要なのは、JBCXM パッケージを使用している場合のみです。バージョン 2.1 以降を使用している場合、移行は不要です。
重要
Salesforce で Gainsight CS を設定する際は、コンポーネントを以下の順序で移行してください。
-
テナント
-
ライセンス
-
権限
-
マッピング
-
ウィジェット設定
Gainsight CSM パッケージからのライセンス移行
前提条件:新しいパッケージのライセンス数が旧来のパッケージのライセンス数以上であることを確認してください。これは、新しいパッケージから旧来のパッケージのライセンスを保有しているユーザーへのライセンスの正常な割り当てを確保するために必要です。
ライセンスを移行するには、以下の手順に従ってください。
- インストール済みパッケージ に移動します。
-
設定 をクリックします。Gainsight アプリケーショ にリダイレクトされます。
-
ライセンス をクリックします。
-
ライセンスの移行 チェックボックスを選択します。
-
保存 をクリックします。

Gainsight CSM パッケージからの権限セットの移行
UI では権限がライセンスより前に表示される場合がありますが、まずライセンスを移行し、その後に権限の移行を行う必要があります。順序を変えて移行すると、設定上の問題が発生する可能性があります。
管理者は、Gainsight CSM パッケージから新しい Gainsight CS パッケージへ、すべてのユーザーの既存の権限セットを移行することができます。
ライセンスを移行するには、以下の手順に従ってください。
-
インストール済みパッケージ に移動します。
-
設定 をクリックします。Gainsight アプリケーショ にリダイレクトされます。
-
権限 をクリックします。
-
権限の移行 チェックボックスを選択します。
-
保存 をクリックします。

Gainsight NXT 組織にログインし、この Salesforce 組織への接続を承認してください。また、Salesforce コネクターを使用してこの組織のユーザーを Gainsight NXT 組織に同期し、当該ユーザーに Gainsight NXT へのアクセスを付与する必要があります。この設定を順を追って行う方法の詳細については、Salesforce における Gainsight NXT のオンボーディング をご参照ください。
この設定は必須であり、設定が行われていない場合は以下のエラーが発生します。

Gainsight CS 権限セットを持つユーザーは、Salesforce 組織内で新しいタブとして Gainsight を表示できるようになります。

アカウントおよびリレーションシップの列マッピング
アカウントとリレーションシップのマッピングにより、ワークフローに合わせてさまざまな Salesforce レコードレイアウトに Gainsight 360 ウィジェットを表示する柔軟性が得られます。Gainsight 360 ウィジェットを設定する際、システムは Gainsight アカウント ID(C360 の場合)またはリレーションシップ ID(R360 の場合)にマップする正しいフィールドを識別する必要があります。
-
アカウントマッピング:アカウントマッピングにより、アカウント以外のレイアウトに Gainsight C360 ウィジェットを表示できます。ウィジェットを表示するには:
-
オブジェクト名 テキストボックスに、ウィジェットを表示するレイアウトを入力します。
-
フィールド名 で、そのオブジェクトのアカウント ID を選択します。
-
ウィジェットには、アカウント ID がフィールド値と一致する企業の C360 が表示されます。

- リレーションシップマッピング:リレーションシップマッピングにより、任意のレイアウトに Gainsight R360 ウィジェットを表示できます。レイアウトを表示するには:
- オブジェクト名 テキストボックスに、ウィジェットを表示するレイアウトを入力します。
- フィールド名 で、そのオブジェクトの Gainsight リレーションシップ GSID を選択します。
注記:Gainsight リレーションシップ GSID は、R360 ウィジェットを表示するレイアウトのオブジェクトに書き戻す必要があります。ターゲットオブジェクトに GSID フィールドが存在しない場合、LWC は機能しません。

アカウントまたはリレーションシップのマッピングを追加するには、以下の手順に従ってください。
-
インストール済みパッケージ に移動します。
-
設定 をクリックします。Gainsight アプリケーショ にリダイレクトされます。
-
マッピング をクリックします。
-
アカウント または リレーションシップ タブを選択します。
-
追加 をクリックして、マッピングフィールドを追加します。

-
オブジェクト名 に、ソースのオブジェクト名を入力します。
-
フィールド名 に、マップ先のフィールド名を入力します。
-
マッピングを保存 をクリックします。
Gainsight CSM パッケージからのウィジェットの移行
C360 の Gainsight アカウント ID または R360 の リレーションシップ ID に対して正しいフィールドをマッピングしたら、各オブジェクトのウィジェットを設定できます。セクション名や、ウィジェットをサイドバーまたは新しいタブのどちらに表示するかを設定することができます。
ウィジェットを設定するには、以下の手順に従ってください。
-
インストール済みパッケージ に移動します。
-
設定 をクリックします。Gainsight アプリケーショ にリダイレクトされます。
-
ウィジェット設定 をクリックします。

-
追加 をクリックします。
-
オブジェクト名 に、ウィジェットに表示するオブジェクト名を入力します。
-
セクション名 ドロップダウンから、セクション名を選択します。
-
サイドバーで R360 を表示 チェックボックスを選択して、ウィジェットをスライドアウトパネルとして表示します。
-
新しいタブで R360 を開く チェックボックスを選択して、ウィジェットを新しいタブで開きます。
-
ウィジェット設定を保存 をクリックします。

テナントに対する SFDC_PACKAGE_NAMESPACE フィーチャートグルの更新
新しい Gainsight Customer Success パッケージのインストールが正常に完了したら、サポートチケットを発行し、Gainsight サポートチームと連携して、お使いのテナントの SFDC_PACKAGE_NAMESPACE フィーチャートグルの GAINSIGHT バリアントを有効化してください。
注記:この設定は、旧来のパッケージから新しいパッケージに移行するお客様にのみ必要です。