接続の設定

コネクタには、Tableau の外部で接続設定を構築およびテストできるConnection Builder が付属しています。また、Tableau の接続ダイアログにリストされていないオプションを提供するために使用できる接続文字列を作成することもできます。

Connection Builder の設定

Connection Builder にアクセスする方法は2つあります。

Windows では、スタートメニューのCData Tableau Connector for Adobe Analytics フォルダの下に［Connection Builder］というショートカットが表示されます。
また、ドライバーのインストールディレクトリに移動し、lib ディレクトリで.jar ファイルを実行することによってもConnection Builder を開始できます。

Connection Builder では、接続プロパティに値を設定し、［接続テスト］ボタンをクリックして、その動作を確認することができます。また、［クリップボードにコピー］ボタンを使用して、Tableau で使用する接続文字列をコピーすることもできます。

Adobe Analytics への接続

In order to connect to Adobe Analytics, the GlobalCompanyId and RSID need to be identified. By default, the connector attempts to automatically identify your company and report suite. Alternatively, you can identify the company and report suite explicitly:

Global Company Id

GlobalCompanyId はオプションの接続プロパティです。空のままにすると、connector が自動的にGlobal Company ID の検出を試みます。 Global Company ID を検索するには：

Swagger UI 上のusers/me エンドポイントのリクエストURL で見つけます。
ユーザーエンドポイントを展開し、GET users/me ボタンをクリックします。
［Try it out］ボタン ->［Execute］ボタンをクリックします。
GlobalCompanyId 接続プロパティを、リクエストURL のusers/me エンドポイントの直前に表示されるGlobal Company ID に設定します。

Report Suite Id

RSID はオプションの接続プロパティです。設定されていない場合、ドライバーが自動的に検出を試みます。名前の横にある識別子とともにレポートスイートの完全なリストを取得するには、［管理者］->［レポートスイート］に進みます。

Adobe Analytics への認証

Adobe Analytics はOAuth 認証標準を利用しています。 OAuth 統合またはサービスアカウント統合で認証できます。

ユーザーアカウント（OAuth）

AuthScheme は、すべてのユーザーアカウントフローでOAuth に設定する必要があります。

デスクトップアプリケーション

CData は、OAuth デスクトップ認証を簡略化する埋め込みOAuth アプリケーションを提供します。代わりに、カスタムOAuth アプリケーションを作成することも可能です。カスタムアプリケーションの作成およびその理由については、カスタムOAuth アプリの作成を参照してください。

OAuth アクセストークンの取得およびリフレッシュ

次を設定して、接続してください。

InitiateOAuth：GETANDREFRESH に設定。InitiateOAuth を使うと、OAuth 交換の繰り返しや、手動でのOAuthAccessToken 設定を避けられます。
OAuthClientId（カスタムアプリのみ）：アプリの登録時に割り当てられたクライアントId に設定。
OAuthClientSecret（カスタムアプリのみ）：アプリの登録時に割り当てられたクライアントシークレットに設定。
CallbackURL（カスタムアプリのみ）：アプリの登録時に定義されたリダイレクトURL に設定。例：https://localhost:3333

接続すると、connector はデフォルトブラウザでAdobe Analytics のOAuth エンドポイントを開きます。ログインして、アプリケーションにアクセス許可を与えます。connector はこれでOAuth プロセスを完了します。

connector はAdobe Analytics からアクセストークンを取得し、それを使ってデータをリクエストします。
OAuth 値はOAuthSettingsLocation で指定されたパスに保存され、接続間で永続化されるようにします。

connector はアクセストークンの期限が切れると自動的にリフレッシュします。

サービスアカウント（JWT OAuth）

この方法で認証するには、AuthScheme をOAuthJWT に設定します。

サービスアカウントには、ブラウザでのユーザー認証を必要としないサイレント認証があります。
このフローでは、アプリケーションを作成する必要があります。アプリの作成および認可については、カスタムOAuth アプリの作成を参照してください。これでサービスアカウントにアクセス権があるAdobe Analytics データに接続できます。

次の接続プロパティを設定して、接続してください。

InitiateOAuth：GETANDREFRESH に設定。
OAuthClientId：アプリケーション設定のクライアントId に設定。
OAuthClientSecret：アプリケーション設定のクライアントシークレットに設定。
OAuthJWTCertType："PUBLIC_KEY_FILE" に設定。
OAuthJWTCert：生成した.key ファイルのパスに設定。
OAuthJWTCertPassword：.key ファイルのパスワードに設定。
OAuthJWTSubject：Adobe I/O コンソール統合からのTechnical Account ID のサブジェクト。形式は[email protected] です。
OAuthJWTIssuer：Adobe I/O コンソール統合からのOrganization ID の発行者。形式はorg_ident@AdobeOrg です。Adobe I / O API へのアクセス用に設定された組織を識別します。

接続すると、connector はサービスアカウントでのOAuth フローを完了します。

connector に要求されるクレームセットでJWT を作成し、サインします。
JWT はアクセストークンと交換されます。
OAuthSettingsLocation にOAuth 値を保存し、接続間で永続化されるようにします。
トークンの期限が切れたときは、JWT を送り、新しいアクセストークンと交換します。

次のステップ

次の手順については、Adobe Analytics API への認証を含むデータの取得を参照してください。

Tableau Connector for Adobe Analytics