Adobe Analytics のデータをDataSpider Servista の連携先として使う方法

杉本和也
リードエンジニア

CData JDBC ドライバを使って、データ連携ツールのDataSpider Servista からAdobe Analytics のデータを連携利用する方法を解説。

DataSpider Servista は、異なるシステムのデータやアプリケーションをノンプログラミングで「つなぐ」データインテグレーションプラットフォームです。

CData JDBC ドライバはDataSpider Servista において、JDBC データソースとして利用することが可能です。通常のJDBC の検索・更新などのアイコンを使って、標準SQL でSaaS/Web DB のデータを扱うことを可能にします。この記事では、DataSpider で CData JDBC Driverを利用してAdobe Analytics のデータに外部データとしてSQL でアクセスする方法を紹介します。

CData JDBC Driver for AdobeAnalytics をDataSpider にコネクタとして登録

JDBC Driver をDataSpider と同じサーバーにインストール
DataSpider の外部JDBCドライバのパスにCData JDBC ドライバのcdata.jdbc.adobeanalytics.jar とcdata.jdbc.adobeanalytics.lic を配置
DataSpider 側：DataSpiderServista\server\plugin\data_processing\modules\jdbc_adapter

グローバルリソースのプロパティで、ドライバクラス名およびURL を入力。
- 接続名：任意
- 種別：デフォルト
- 接続タイプ：接続タイプ：JDBC（JDBC接続設定）
- ドライバクラス名：cdata.jdbc.adobeanalytics.AdobeAnalyticsDriver
- URL：jdbc:adobeanalytics:GlobalCompanyId=myGlobalCompanyId; RSID=myRSID; OAuthClientId=myOauthClientId; OauthClientSecret=myOAuthClientSecret; CallbackURL=myCallbackURL;
Adobe Analytics への接続

それでは、Adobe Analytics に接続していきましょう。接続するには、GlobalCompanyId およびRSID を識別する必要があります。デフォルトでは、ドライバーが会社とレポートスイートの識別を自動で試みますが、これらの値を明示的に指定することも可能です。詳しい手順については、 href="/kb/help/" target="_blank">ヘルプドキュメントの「Adobe Analytics への接続」セクションをご確認ください。

Adobe Analytics への認証

続いて、認証方法を設定しましょう。Adobe Analytics はOAuth 認証標準を利用しており、OAuth またはサービスアカウントで認証できます。

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

ユーザーアカウントでの認証では、すべてのフローでAuthScheme をOAuth に設定する必要があります。詳しい認証手順については、 href="/kb/help/" target="_blank">ヘルプドキュメントの「Adobe Analytics への認証」セクションをご参照ください。

サービスアカウント

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

サービスアカウントを使用したServer-to-Server OAuth で認証するには、AuthScheme をOAuthClient に設定します。接続には以下のプロパティを設定してください。
- InitiateOAuth：GETANDREFRESH に設定
- OAuthClientId：アプリケーション設定のクライアントId に設定
- OAuthClientSecret：アプリケーション設定のクライアントシークレットに設定
接続すると、CData 製品がサービスアカウントでのOAuth フローを以下の手順で完了します。
1. クライアントクレデンシャルOAuth フローで指定されたOAuthClientId およびOAuthClientSecret を使用して、アクセストークンを取得します
2. OAuthSettingsLocation にOAuth 値を保存し、接続間で永続化されるようにします
3. トークンが期限切れになった際に、新しいアクセストークンを要求します