Tableau からAdobe Analytics にJDBC Driver で連携してビジュアライズ

こんにちは！ドライバー周りのヘルプドキュメントを担当している古川です。

CData Driver for AdobeAnalytics を使って、BI・ビジュアライズツールのTableau からAdobe Analytics のデータをノーコードで連携して利用できます。この記事では、CData JDBC Driver for AdobeAnalytics を使います。JDBC は、Windows 版のTabelau でもMac 版のTableau でも同じように利用できます。

Tabelau からAdobe Analytics のデータへの接続を確立

Tableau での操作の前に.jar ファイルを以下のパスに格納します：

• Windows: C:\Program Files\Tableau\Drivers
• MacOS: ~/Library/Tableau/Drivers

.jar ファイルを配置したら、Adobe Analytics への接続を設定します。

1. Tableau を開きます。
2. ［データ］->［新しいデータソース］を開きます。
3. ［その他のデータベース（JDBC）］をクリックします。
4. URL にJDBC 接続文字列を入力します。

Adobe Analytics への接続

Adobe Analytics に接続するには、GlobalCompanyId およびRSID を識別する必要があります。デフォルトで、ドライバーは会社とレポートスイートの識別を自動で試みますが、これらの値を明示的に指定することもできます。方法はヘルプドキュメントの「Adobe Analytics への接続」セクションを参照してください。

Adobe Analytics への認証

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

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

すべてのユーザーアカウントフローでAuthScheme をOAuth に設定する必要があります。OAuth 経由のAdobe 認証では、2週間ごとにリフレッシュトークンを更新する必要があります。詳しい認証方法については、ヘルプドキュメントの「Adobe Analytics への認証」セクションを参照してください。

サービスアカウント

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

サービスアカウントを使用したServer-to-Server OAuthで認証するには、AuthScheme をOAuthClient に設定します。接続するには次のプロパティを設定します。

• InitiateOAuth：GETANDREFRESH に設定。
• OAuthClientId：アプリケーション設定のクライアントId に設定。
• OAuthClientSecret：アプリケーション設定のクライアントシークレットに設定。

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

1. クライアントクレデンシャルOAuth フローで指定されたOAuthClientId およびOAuthClientSecret を使用して、アクセストークンを取得します。
2. OAuthSettingsLocation にOAuth 値を保存し、接続間で永続化されるようにします。
3. トークンが期限切れになった際に、新しいアクセストークンを要求します。

JDBC Driver の接続文字列デザイナーを使う

JDBC 接続文字列を作るには、Adobe Analytics JDBC Driver のビルトイン接続文字列デザイナーを使う方法があります。ドライバーの.jar ファイルをダブルクリックするか、コマンドラインから.jar ファイルを実行します。

Windows:

java -jar 'C:\Program Files\CData\CData JDBC Driver for AdobeAnalytics 2019\lib\cdata.jdbc.adobeanalytics.jar'

MacOS:

java -jar cdata.jdbc.adobeanalytics.jar

接続プロパティに値を入力して、生成される接続文字列をクリップボードにコピーします。

JDBC URLを設定する際には、Max Rows プロパティを設定することをお勧めします。これにより取得される行数が制限され、パフォーマンスを向上させます。

デザイナーで生成されるJDBC URL のサンプル：

jdbc:adobeanalytics:GlobalCompanyId=myGlobalCompanyId; RSID=myRSID; OAuthClientId=myOauthClientId; OauthClientSecret=myOAuthClientSecret; CallbackURL=myCallbackURL;
5. 方言：SQL92
6. サインインをクリックします。
7. 接続エラーの場合には、Java がダウンロードされていない場合、Java が64bit マシン用ではなく32bit 用である、などの場合がありますので確認をお願いします。