SalesforceとGainsightを連携する（データ連携／C360・R360画面の埋め込み）

GainsightとSalesforceを両方使っている企業様は多いですよね！
もちろん2つのツールはシームレスに連携することが可能です。

GainsightとSalesforceの連携は大きく分けると2つのできることがあります。

 【A】 SalesforceとGainsight間でデータを双方向で同期させる
 【B】Salesforceの画面の中に、GainsightのC360（顧客360度ビュー）を埋め込む

この記事では、上記をそれぞれ実施する場合の全ステップをまとめます。
特にA・Bを両方実施したい方は連携順序を正しく実施しないとエラーになりますので以下の順番で必ず実施してください。

　【🔍Agenda】

• 0. まず知っておきたい全体の構成とSTEP
• 【A】SalesforceとGainsight間でデータを同期させる
• 【B】Salesforceの画面の中に、GainsightのC360（顧客360度ビュー）を埋め込む​​​​​

A・B共に、連携するためには、Salesforce AppExchangeでGainsightのアプリをインストールします。
全体の構成イメージは以下の図の通りです。
データ連携のみ実施する場合は、手順①・②のみでOKです。UIをSalesforceに埋め込みたい場合は追加で③を実施しましょう、

ややこしい点として、
Salesforce AppExchangeには「Gainsight」の名前がついているパッケージが複数ありますので、
間違えて違うAppExchangeをインストールしないように⚠️注意しましょう。

• Gainsight CS Data Connector US / EU
  　データ連携のために必要です（上記図の①）リージョン別にインストールするAppが異なります（※後述）
• Gainsight Customer Success
  　Salesforce内に、GainsightのC360（顧客360度ビュー）を埋め込むために必要です。（上記図の③）

データ連携用のAppExchangeはリージョンごとにUS版とEU版が分かれているため、最初にリージョンを確認します。

貴社のGainsightのURLのサブドメインを見ると、リージョンが分かります。

• <subdomain>.gainsightcloud.com → US1（USパッケージを使用）
• <subdomain>.us2.gainsightcloud.com → US2（USパッケージを使用）
• <subdomain>.eu.gainsightcloud.com → EU（EUパッケージを使用）

US1とUS2は同じUSパッケージを使います。誤ったリージョンのパッケージをインストールすると、後続の接続・認証でエラーになるため、ここで必ず確認しておきましょう。

データ連携用のAppExchangeをSalesforceに追加します。
Salesforce ConnectorをGainsightで認証するために必ず必要です。
※参考ヘルプ：Install the Gainsight CS Data Connector Package

1. AppExchange Marketplace（appexchange.salesforce.com）を開き、Salesforceの管理者権限でログインします。
2. US環境なら Gainsight CS Data Connector US、EU環境なら Gainsight CS Data Connector EU を検索します。

   

3. パッケージを選び、Get It Now ボタンをクリックします。

4. Installation画面で対象Salesforce orgを確認し、Install in Production ボタンをクリックします。
5. 規約に同意して Confirm and Install ボタンをクリックします。
6. インストール権限を選択して Install を実行します。
   （必要なユーザーにアクセス権限を付与しない場合、Salesforceコネクタの認証が正常に行われない可能性があります。）

   

7. 完了後、Setup > Installed Packages にパッケージが表示されていることを確認します。

   

   

    

インストールが無事完了したら、今度はGainsight側からSalesforceへの接続を作ります。

1. Gainsightで 管理（Administration） > コネクタ2.0（Connectors 2.0） > 接続（Connections） に移動します。
2. 画面右上の接続を作成（Create Connection）ボタン をクリックします。
3. ConnectorにSalesforceを選びます。
4. Connection名を入力します。
5. Salesforce Org typeで 製品 または Sandbox を選択します。
6. Salesforce URLを入力します。
7. 認証 をクリックし、Salesforce OAuth画面でログインして 許可 を押します。

   

   接続に使用する Salesforce ユーザーには API Access が必要です。

「☑️Prefer signing in with your Salesforce URL?」 をONにする場合とは？

基本的には「オフ」のままで問題ありません。 ただし、以下のような場合はオンにする必要があります。

• 「認証」ボタンを押した際、エラーになって接続できない場合。

• SSO（シングルサインオン）が強制されている場合: 企業のセキュリティポリシーで「標準の login.salesforce.com からのアクセスを禁止し、自社のカスタムドメイン経由でのみログインや外部アプリの認証を許可する」という設定がされている場合。 

作成されたconnectの3点リーダから、「GainsightをSalesforceにリンク」（Link Gainsight to Salesforce）をクリックします。

◼️これを実施することでできるようになること

・これによりGainsightの各機能（ルールエンジンやData Designer、Reportsなど）からSalesforceオブジェクトを指定できるようになります。

・後述の【B】Salesforceの画面の中に、GainsightのC360（顧客360度ビュー）を埋め込もうとしている場合は必須です！

いよいよSalesforceのデータをGainsightに連携するジョブ設定をしていきます。

実は、SalesforceからGainsightへのデータ連携には2つの方法があり、
どちらを使うか・どう組み合わせるかで設定方法が変わってきます。

①：コネクタ2.0（Connectors 2.0）の標準OOB JOB
　→かんたんに同期できる標準的な連携方法です。

②：ルールエンジン（Rules Engine）

　→データを加工してからGainsightに連携したい場合など、Salesforceのデータをそのまま連携するだけでなく、一部加工が必要になる場合はこちらで連携します。
 

上記のどちらを使えば良いかは導入時に一緒に設計のご支援をしますが、
それぞれの違いや具体的な連携方法は以下の記事にまとめているのでこちらをご確認いただきながらデータ連携を実施してください。

データ連携は無事できましたか？
ここからは、Salesforceの取引先画面内でGainsightのC360を表示する方法について解説します！

⚠️　注意　⚠️　　　　　　　　　　　　　　　　　　　　　　　　　
GainsightとSalesforceのデータが連携されていないとエラー⛔になります。
※会社オブジェクトにSFDC IDが連携されている必要があります
必ず上記のデータ連携が完了していることを確認してから作業を実施するようにしてください。
　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　

画面埋め込み用のAppExchangeをSalesforceに追加します。

1. AppExchange Marketplace（appexchange.salesforce.com）を開き、Salesforceの管理者権限でログインします。
2. 「Gainsight Customer Success」 を検索します。

   

    

3. Get It Now をクリックし、必要に応じてAppExchangeにログインします。

   

    

4. Install in Productionを選択します。

   

    

5. 規約に同意して Confirm and Install をクリックします。

   

    

6. セキュリティレベルを選択して Install します（Gainsight推奨は Install for Admins Only）。

   

    

Appをインストールしただけではまだユーザーは使えません。まずはライセンスを割り当てます。

1. Salesforceの「インストール済みパッケージ（Installed Packages ）」 画面に行き、
   Gainsight Customer Successの 「ライセンスの管理」 をクリックします。

   

    

2. Add Users からSalesforceでGainsightのC360を見れるようにする対象ユーザーを選んで追加します。

   

    

・初期状態ではまだトライアル状態で、5ライセンスが付与され、1つはインストールした管理者に自動割り当てされます。
・1〜2時間後に自動でプロビジョニングされ、契約に基づいたライセンスが付与されます
・もし2時間以上経ってもライセンスが更新されない場合は、Gainsightの担当までご連絡ください。

ライセンスの付与に続いて、対象ユーザーへ権限セットを割り当てます。
これによりSalesforce内にGainsightタブが表示されます。

1. 設定 > ユーザー > 権限セット に移動します。
2. Gainsight関連の権限セットとして、「Gainsight CS」「Gainsight Team Viewer」があります。
   widgetで閲覧するだけのユーザーは「Gainsight Team Viewer」、GSを操作するユーザーは「Gainsight CS」にアサインしておきましょう。

3. 

   権限セット比較

   権限セット	権限概要	対象	Gainsight側のライセンスタイプの考え方	Salesforce上でできること
   Gainsight Team Viewer	Salesforce 内の Gainsight ウィジェットへのユーザーアクセス権限を付与するための権限セットです。	顧客状況の確認が中心で、Gainsight を日常的に操作しない方に向いています。（営業、役員など）	一般的には Viewer License と組み合わせて利用します。	Salesforce 上の  widget から、C360、R360などの情報を参照できます。Timeline では記録やコメントなど一部の操作も可能です。
   Gainsight CS	ウィジェットだけでなく、Salesforce 内で Gainsight アプリ自体にアクセスするための権限セットです。	Gainsight 本体を Salesforce から利用する方に向いています。（CSM、ポストセールス、Ops、管理者など）	主に Full License のユーザーで利用する想定ですが、最終的なアクセス範囲は Salesforce の権限セット名だけではなく、Gainsight 側で設定されたライセンスタイプと 権限設定 に依存します。	Salesforce 上で Gainsight を新しいタブとして表示して利用できます。

    

4. 対象の権限セットを開いて、「割り当ての管理」 をクリックします。

   

    

5. 「割り当てを追加」から対象ユーザーを選んで Assign します。
6. 最後に 「割り当て」 をクリックします。

続いて、SalesforceにApp Exchangeからインストールした「Gainsight Customer Success」パッケージのTenant設定で、GainsightテナントのリージョンとSalesforce側の設定を一致させます。

1. Salesforceの 設定 >  インストール済みパッケージ > Gainsight Customer Success > 設定を開きます。

   

    

2. 設定画面の Tenants で、Gainsight tenant URLに対応するリージョンを選択します。
   ※💡貴社のGainsightのURLのサブドメインを見ると、リージョンが分かります💡
   　<subdomain>.gainsightcloud.com → US1（USパッケージを使用）
   　<subdomain>.us2.gainsightcloud.com → US2（USパッケージを使用）
   　<subdomain>.eu.gainsightcloud.com → EU（EUパッケージを使用）
   　

   

    

新しい埋め込み方式はLightning Web Components（LWC）が前提です。
LWCを使う前に、Salesforce側で2つの前提設定が必要です。

1. Salesforceの 設定 > セキュリティ > 信頼済み URLを開きます。
2. 「新規信頼済みURL」ボタンをクリックします。
3. GainsightのGateway URLを信頼済み URLに追加します

   項目	内容
   API 参照名	任意の一意な名前 ex）gainsight_gateway_us2
   URL	貴社のGainsightのリージョンごとにURLが異なります（先ほど「9.」で確認した貴社のGainsightのリージョンに対応した以下のURLを入力してください。） US1: https://gateway.gainsightcloud.com  US2: https://gateway.us2.gainsightcloud.com EU: https://gateway.eu.gainsightcloud.com
   CSP ディレクティブ	以下の3つにチェックをいれてください。 ・connect-src (スクリプト)　　　  ☑️ ・frame-src (iframe コンテンツ)　 ☑️ ・style-src (スタイルシート)　　     ☑️

   

    

4. 「保存＆新規」ボタンを押して登録する。

5. 続いて、貴社のGainsightのログインURL（自社のGainsight tenant domain）も信頼済み URLに追加します。

   

6. 「保存」ボタンを押して登録する。

Trusted URLsの未設定はLWCが動かない最も多い原因の一つです。LWC配置後に画面が真っ白になる場合は、まずここを確認しましょう。

1. [設定] を開きます。

2. 左側の「クイック検索」ボックスに 「セッションの設定」 と入力し、検索結果から [セッションの設定] をクリックします。

3. 画面を下へスクロールし、「Lightning Web セキュリティ」セクション（または項目一覧の中）にある、以下のチェックボックスを探します。 「Lightning Web コンポーネント用および Aura コンポーネント用 Lightning Web セキュリティの使用」 のチェックをONにします。

   

4. 画面一番下にある [保存] ボタンをクリックすると、LWSが有効化されます。

事前準備が長くて疲れてきてないですか？ここまでで事前の設定はかんぺきです。

ここからがいよいよ「C360全体の埋め込み」です。

考え方は、Salesforce のレコードページに Gainsight 360 Widget を置いて、All Sections を表示するだけです。

1-1. 埋め込み先のレコードページで、Gainsight 360 Widget を配置する

1. Salesforce で、画面を埋め込みたいページを実際に開いた状態（取引先ページなど）で、画面右上の⚙️マークを押します。

2. ページを編集 をクリックするとページ編集画面に遷移します。

   

3. 左側の Components 検索で Gainsight と入れます。

4. Gainsight 360 Widget を探します。

5. ページ上の表示したい位置にドラッグ＆ドロップします。

6. 画面右のプロパティで、Layout Type = C360 を選び、Section to Render = All Sections （C360全体が出る）を選びます。

7. 保存を押すことで更新されます。

   

1-４. 実際に表示されることを確認する

以上で設定は完了です！👏👏👏
実際の Salesforce レコード画面を開いて、C360 が表示されることを確認します。

C360の表示が無事できたら、画面の埋め込みは、応用として以下も可能です。
応用もしながら見やすい形にしていくとどんどん使いやすくなりますよね！
以下の方法についてもやりたい人はぜひ実施してみてください😊

• C360のうち特定のタブのみ表示させる
• 取引先以外のレコード（Opportunity / Case / カスタムオブジェクトなど）にC360を出す

ここでいう「タブ単位」は、個別タブ、複数タブ、または全タブを選べるという意味です。

1. 基本の配置まではC360全体と同じ

1. Lightning アプリケーションビルダー を開く

2. 対象の Record Page の編集画面で、Gainsight 360 Widget を配置する

2-2. 1つのタブだけ表示したい場合

1. ウィジェット設定で Layout Type = C360 を選びます。

2. Section to Render で表示したいセクションを1つ選んで保存します。

   

    

これで、Salesforce 側にはその1つのタブだけが表示されます。

ちなみに、人気の設定は、Salesforceのタブを複数作り、1つのタブに1つのGainsightのタブを表示させる方法です🙌

1つのタブの中にまたGainsightのタブが複数分かれているのは分かりずらいので、1タブ＝1Gainsightタブで設定すると見やすくて普段Gainsightを利用しない営業の方にも人気です！

ぜひやってみてください！
 

2-3. 1タブに複数タブ表示したい場合

おすすめは上記で先述したように1タブにつきGainsightも1タブを表示させる方法ですが、
一応、1タブに複数のGainsightタブを表示することも可能になっています。

1. ウィジェット設定で Layout Type = C360 を選びます。

2. Sections to Render に、表示したいセクション名を ; 区切りで入力して保存します。
   ex.）COCKPIT;TIMELINE

   

    

これで、必要なタブだけに絞って Salesforce 上へ出せます。

3-1. Account Mapping を設定する

1. Salesforce の 設定 > インストール済みパッケージ を開きます。

2. Gainsight Customer Success パッケージ の 設定 を押します。

3. Mapping を開き、Account タブを選びます。

4. Add を押します。

5. Object Name に対象オブジェクト名を入れます。（ex.Opportunity／Case）

6. Field Name に、そのオブジェクト上の Account ID フィールドを指定します。

7. Save Mappings を押します。

   

    

これで、その Salesforce オブジェクト上でも、該当 Account の C360 を出せるようになります。

◼️パターンA: まずはシンプルに表示されるか検証する

最初の検証なら、次の設定が一番シンプルです。

• Layout Type = C360

• Section to Render = All Sections

🕺🏻向いているケース

• まずは「Salesforce上でC360が動くか」を確認したい

• どのタブを残すべきか、まだ運用が固まっていない
   

◼️パターンB: 営業向けに最低限だけ見せたい

次のように、必要タブだけ絞るのが実運用ではおすすめです。

• 例: SUMMARY;TIMELINE

• 例: COCKPIT;TIMELINE

向いているケース:

• Salesforce 利用者に必要最小限だけ見せたい

• 画面を軽くしたい

• CSM向けのフルC360と、Sales向けの簡易表示を分けたい

公式ドキュメント / ヘルプ

• Configure Gainsight Lightning Web Components for Salesforce
  — C360 を Salesforce に埋め込む中心ドキュメントです。LWC の前提条件、配置方法、表示オプションがまとまっています。
• Install and Configure Gainsight Customer Success in Salesforce
  — パッケージ導入、ライセンス、Permission Set、テナント設定、Mapping の公式手順です。
• Permissions for Viewer Group in Gainsight NXT
  — 閲覧専用ユーザー向けのアクセス制御。
• Enable Lightning Web Security in an Org
  — Salesforce 側の LWS 有効化手順です。Gainsight の公式記事からも参照されています。

以上でSalesforceとGainsightの連携設定はすべて完了です🙌

データ連携から画面埋め込みまで一通り設定できると、SalesforceのAccount画面を開くだけでGainsightの顧客情報をすぐ確認できるようになります。CSMの日々の業務効率UPだけでなく、営業とCSMの活動を線でつながることになり、連動性もぐっと上げることが実現できます！
ぜひやってみてください！