Amazon S3

Amazon S3との接続を確立するには：

1. [関数タイプ]フィールドから、Amazon S3を選択します。
2. 該当するS3 バケットを選択します。
   1. Gainsightマネージドを選択した場合は、Gainsight 接続ドロップダウンリストから必要な接続を選択します。
   2. Gainsight PX マネージドを選択した場合は、[PXカスタムファイル]ドロップダウンリストから必要なロールアップを選択します。

メモ: Gainsight PXから既存の標準アドプションエクスプローラープロジェクトに追加の使用状況データを取り込むためには、[プロジェクト設定] ページで [Gainsight PX から使用状況データをインポートする] チェックボックスが選択されていることを確認します。この操作は後戻りできません。

3. アドプションエクスプローラーオブジェクトがデータを収集するファイルパスを入力します。
4. ファイルパスで日付パターンを使用するために、 [パターンを使用] チェックボックスを有効にします(オプション)。
   1. 必要なフィルタータイプを選択します。日付パターンはテキスト '${pattern}' で指定するか、ファイルパス内で開始することができます。

EQUALSの例：「bucket_name/usageinfo_data/2018-10-10/data.csv」と「bucket_name/usageinfo_data/2018-10-11/data.csv」の 2 つの日付のS3バケットにデータを整理した場合は、ファイルパスを「bucket_name/usageinfo_data/${pattern}/data.csv」として入力できます。

で始まるの例：S3バケットのデータを「2019-10-10/bucket_name/usageinfo_data.csv」として整理した場合、アドプションエクスプローラーによって「${pattern}」が毎日または毎週のスケジュールに基づいて日付に自動的に置き換えられるので、ファイルパス「${pattern}/bucket_name/usageinfo_data.csv」を入力することができます。

5. ファイルが利用できない場合は、[ファイルが存在しない場合はソースを無視する] チェックボックスを選択して、ファイル処理を無視します(オプション) 。
6. [フィールドセパレータ] フィールドから、適用可能なデータデリミタを選択します。
7. [テキスト修飾子とエスケープ文字] フィールドで、必要な引用符とエスケープ文字をそれぞれ構成します。
8. [圧縮タイプ]ドロップダウンから、圧縮形式を選択します。
9. 入手可能で時刻を入力し、S3でファイルが入力した時刻より前に利用可能であることを確認します。
10. 後に利用可能フィールドに、フィールドが取得のために選択されるまでの必要経過日数を入力します。入力した日数以内にファイルの使用が可能であることを確認してください。
11. [データをインポートする頻度] セクションから、プロジェクトにデータを取り込む頻度 (日次または週次) を選択します。 

メモ：Amazon S3からの使用状況データは、アドプションエクスプローラーオブジェクトに24時間以内に取り込まれます。

12. [メタデータのインポート] をクリックして詳細を保存し、次の手順に進みます。

Gainsight

Gainsightとの接続を確立するには：

1. [関数タイプ]フィールドから、Gainsightを選択します。
2. [オブジェクトタイプ]ドロップダウンから、自身のソース データが保存されている適切なオブジェクトを選択します。これにより、MDAオブジェクトフィールドとその下にあるオプションが有効になります。

メモ: Gainsightのシステムオブジェクトは、Gainsightデータソースの下には表示されません。

3. [MDAオブジェクト]ドロップダウンリストから、必要なオブジェクトを選択します。
4. [データをインポートする頻度]セクションから、プロジェクトにデータを取り込む頻度 (日次または週次) を選択します。 

メモ：Gainsightからの使用状況データは、アドプションエクスプローラーオブジェクトに24 時間以内に取り込まれます。

5. [メタデータのインポート] をクリックして詳細を保存し、次の手順に進みます。

Google Analytics (GA)

アドプションエクスプローラーは、GA4とUniversal Analytics (UA) をサポートしています。GA4を使用してWebまたはモバイルアプリケーションの分析を追跡している場合、使用状況データをアドプションエクスプローラーオブジェクトにインポートすることができます。アドプションエクスプローラーは、古いバージョンのGoogle Analyticsのプロパティも引き続きサポートしています。

前提条件

Google Analyticsから使用状況データを取り込むためには、Googleプラットフォームで次のAPIが有効になっていることを確認してください：

• Google Analytics Admin API: GAプロパティを取得するために必要です
• アナリティクス レポート API: レポート目的でユニバーサルプロパティへのアクセスを提供します
• Google Analytics API: Gainsightなどのツールに取り込めれるように、Google Analyticsデータを接続して設定することができます

メモ: GA4からデータを取り込む場合には、Google Analytics Data APIも有効になっていることを確認してください。このAPIを使用すると、レポート目的でGA4関連データにアクセスすることができます。

Google Analyticsとの接続を確立するには：

1. [関数タイプ]フィールドから、Google Analyticsを選択します。
2. [GAプロジェクト]ドロップダウンから、既に承認されている既存のGoogleプロジェクトを選択するか、[+新しい接続を承認] を選択して新しいプロジェクトをセットアップできます。

1. 新しい接続を作成する場合は、資格情報を入力してサインインするために、Googleのサインインページにリダイレクトされます。
2. 認証が成功すると、[新しく追加] ポップアップが表示され、次の情報を入力する必要があります：

1. プロジェクト名
2. プロジェクト
3. GAアカウント
4. ウェブプロパティ

メモ: 必要な情報に関しては、データベース管理者に連絡する必要がある場合があります。

3. [メタデータのインポート] をクリックして詳細を保存し、次の手順に進みます。

メモ:

• GAは週毎の取り込みスケジュールをサポートしていません。使用状況データは日単位でしか取り込むことができません。
• GAからの使用状況データは、48 時間後に利用可能になります。従って、使用状況データは、アドプションエクスプローラーオブジェクトに72時間以内に取り込まれます。

Salesforce

Salesforceをデータソースとして使用している場合には、Gainsight 組織からSalesforce組織への接続が承認されていることを確認してください。ソース接続を承認する方法の詳細な手順については、追加リソースの記事接続を認証するを参照してください。

Salesforceソース接続が承認されたら:

1. [関数タイプ]フィールドから、Salesforceを選択します。 
2. [SFDCオブジェクト]ドロップダウンから、自身のソースデータが利用可能なオブジェクトを選択します。
3. [データをインポートする頻度]セクションから、プロジェクトにデータを取り込む頻度 (日次または週次) を選択します。 

メモ：Salesforceからの使用状況データは、アドプションエクスプローラーオブジェクトに24時間以内に取り込まれます。

4. [メタデータのインポート] をクリックして詳細を保存し、次の手順に進みます。

Snowflake

Snowflakeソース接続により、管理者はSnowflakeからアドプションエクスプローラー時系列オブジェクトにほぼリアルタイムで使用状況データ/テレメトリ データを取り込むことができます。

前提条件：スキーマに対する作成ステージのアクセス許可が付与されている場合、アドプションエクスプローラーはSnowflakeコネクタを使用して5GBを超えるデータをプルする機能があります。

Snowflakeとの接続を確立するには：

1. [関数タイプ]フィールドから、Snowflakeを選択します。
2. [接続名]ドロップダウンリストにある、セットアップ済みの接続のリストから必要な接続を選択します。
3. [接続名]ドロップダウンリストにある、[新しい接続の追加]を選択して新しい接続をセットアップするか、セットアップ済みの接続のリストから必要な接続を選択します。

メモ: 既存の接続を編集または削除することも可能です。

4. [SNOWFLAKEの接続を追加]ポップアップで、次の情報を追加します。
   1. 接続名
   2. データベース名
   3. ホスト
   4. スキーマ
   5. ウエアハウス
   6. ユーザー
   7. パスワード
       
5. [接続テスト]をクリックして、入力された接続の詳細が機能するかどうかを確認します。

メモ: 入力された詳細にエラーがある場合、システムはエラーに基づいてそれぞれのエラーメッセージを表示します。

6. [保存] をクリックします。
7. [テーブル名]ドロップダウンリストから、必要なテーブルまたはビューを選択します。
8. [データをインポートする頻度]セクションから、プロジェクトにデータを取り込む頻度 (日次または週次) を選択します。 

メモ：Snowflakeからの使用状況データは、アドプションエクスプローラーオブジェクトに24時間以内に取り込まれます。

9. [メタデータのインポート] をクリックして詳細を保存し、次の手順に進みます。

Postgres、MySQL、またはRedshift

アドプションエクスプローラーを使用すると、Postgres、MySQL、Redshiftなどの外部ソースから、ほぼリアルタイムで使用状況データ/テレメトリデータを取り込むことが可能です。接続が確立されると、これらのソースからの使用状況データをアドプションエクスプローラー時系列オブジェクトに取り込むことが可能です。

Postgres、MySQL、またはRedshiftとの接続を確立するには：

1. [接続タイプ]フィールドから、該当するデータベースを選択します。 
2. [接続名]ドロップダウンから、既存の接続を選択するか、[+新しい接続を追加] を選択して新しい接続をセットアップすることができます。

メモ：それぞれのアイコンを使用して、既存の接続を編集または削除することもできます。

1. [接続の追加]ポップアップが表示され、次の情報を入力する必要があります：

1. 接続名
2. データベース名
3. ホスト
4. スキーマ
5. ポート
6. ユーザー
7. パスワード
8. SSL有効

メモ: 必要な情報に関しては、データベース管理者に連絡する必要がある場合があります。

2. [接続テスト]をクリックして、入力された接続の詳細を確認します。検証が成功すると、[保存]ボタンが表示されます。エラーがある場合は強調表示されます。

3. [テーブル]ドロップダウンリストから、必要なテーブルまたはビューを選択します。
4. [データをインポートする頻度]セクションから、プロジェクトにデータを取り込む頻度 (日次または週次) を選択します。 

メモ：Postgres、Redshift、またはMySQLからの使用状況データは、アドプションエクスプローラーオブジェクトに24時間以内に取り込まれます。

5. [メタデータのインポート] をクリックして詳細を保存し、次の手順に進みます。