DBArtisan でJDBC 経由でAdobe Analytics データ をデータ連携利用

こんにちは！ウェブ担当の加藤です。マーケ関連のデータ分析や整備もやっています。

CData JDBC Driver for AdobeAnalytics は、データベースとしてAdobe Analytics のデータ に連携できるようにすることで、Adobe Analytics のデータ をDBArtisan などのデータベース管理ツールにシームレスに連携します。ここでは、DBArtisan でAdobe Analytics のJDBC ソースを作成する方法を説明します。データを直観的に標準SQL で実行できます。

Adobe Analytics データ をDBArtisan Projects に連携

以下のステップに従って、Adobe Analytics をプロジェクトのデータベースインスタンスとして登録します。

1. DBArtisan で、［Data Source］->［Register Datasource］とクリックします。
2. ［Generic JDBC］を選択します。
3. ［Manage］をクリックします。
4. 表示されるダイアログで、［New］をクリックします。ドライバーの名前を入力し、［Add］をクリックします。次に、ドライバーJAR に移動します。ドライバーJAR は、インストールディレクトリのlib サブフォルダにあります。
5. Connection URL ボックスで、JDBC URLに資格情報とその他の必要な接続プロパティを入力します。

   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 URL の構成については、Adobe Analytics JDBC Driver に組み込まれている接続文字列デザイナーを使用してください。JAR ファイルのダブルクリック、またはコマンドラインからJAR ファイルを実行します。

   java -jar cdata.jdbc.adobeanalytics.jar

   接続プロパティを入力し、接続文字列をクリップボードにコピーします。

   下は一般的な接続文字列です。

   jdbc:adobeanalytics:GlobalCompanyId=myGlobalCompanyId; RSID=myRSID; OAuthClientId=myOauthClientId; OauthClientSecret=myOAuthClientSecret; CallbackURL=myCallbackURL;
6. ウィザードを終了して、Adobe Analytics に接続します。Adobe Analytics エンティティは、［Datasource Explorer］に表示されます。

ほかのデータベースを使うのと同じように、Adobe Analytics を使うことができます。 Adobe Analytics API にサポートされているクエリについてのより詳しい情報は、ドライバーのヘルプドキュメントを参照してください。