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 はOAuth 認証標準を利用しています。 OAuth 統合またはサービスアカウント統合で認証できます。OAuth を使って認証するには、アプリケーションを作成してOAuthClientId、OAuthClientSecret、およびCallbackURL 接続プロパティを取得しなければなりません。認証方法については、ヘルプドキュメントの「OAuth 認証の使用」を参照してください。

   GlobalCompanyIdの取得

   GlobalCompanyId は必須の接続プロパティです。Global Company ID がわからない場合は、Swagger UI のusers/me エンドポイントのリクエストURL で見つけることができます。Swagger UI にログインした後、ユーザーエンドポイントを展開し、「GET users/me」ボタンをクリックします。「Try it out」ボタンと「Execute」ボタンをクリックします。リクエストURL のusers/me エンドポイントの直前に表示されるGlobal Company ID をメモします。

   Report Suite Id の取得

   Report Suite ID （RSID）は必須の接続プロパティです。Adobe Analytics UI で、「管理者」->「レポートスイート」に進むと、名前の横にある識別子とともにレポートスイートのリストが表示されます。

   GlobalCompanyId、RSID、およびOAuth 接続プロパティを設定して、Adobe Analytics に接続してください。

   ビルトイン接続文字列デザイナー

   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 にサポートされているクエリについてのより詳しい情報は、ドライバーのヘルプドキュメントを参照してください。