Birst でAdobe Analytics データのビジュアライゼーションを構築

加藤龍彦
デジタルマーケティング

CData JDBC Driver とBirst クラウドエージェントを使用して、Birst でAdobe Analytics のデータのリアルタイムの視覚化を構築します。

Birst は、組織が複雑なプロセスを迅速に理解し、最適化することを支援するクラウドビジネスインテリジェンス（BI）ツールおよび分析プラットフォームです。CData JDBC Driver for AdobeAnalytics と組み合わせると、Birst Cloud Agent を経由してリアルタイムAdobe Analytics のデータに接続し、ビジュアライズを構築できます。ここでは、Cloud Agent を使用してAdobe Analytics に連携し、Birst で動的レポートを作成する方法を段階的に説明します。

強力なデータ処理機能により、CData JDBC Driver はBirst のAdobe Analytics のデータ操作に高いパフォーマンスを提供します。Birst からAdobe Analytics への複雑なSQL クエリを発行すると、ドライバーはフィルタや集計などのサポートされているSQL 操作を直接Adobe Analytics にプッシュし、組込みSQL エンジンを利用してクライアント側でサポートしない操作を処理します。組み込みの動的メタデータクエリにより、JDBC ドライバーはネイティブのBirst データ型を使用してAdobe Analytics のデータを視覚化および分析することを可能にします。

Birst でAdobe Analytics データへのJDBC 接続を設定

Birst プロジェクトを作成する前に、JDBC Driver を操作するためのBirst Cloud Agent をインストールする必要があります。また、JDBC ドライバーのJAR ファイル(および存在する場合はLIC ファイル)をCloud Agent のインストール場所の/drivers/ ディレクトリにコピーします。

ドライバーとCloud Agent のインストールが完了したら、開始できます。

Birst で新しいプロジェクトを作成します。
接続に名前を付けます。(e.g. CDataAdobeAnalytics)
Live Access を選択します。
エージェントを選択します。
Database Type をOther に設定します。

SQL タイプをMSSQL に設定します。
接続文字列を設定します。
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. トークンが期限切れになった際に、新しいアクセストークンを要求します
ビルトイン接続文字列デザイナー

JDBC URL の構成については、Adobe Analytics JDBC Driver に組み込まれている接続文字列デザイナーを使用してください。JAR ファイルのダブルクリック、またはコマンドラインからJAR ファイルを実行します。
```
java -jar cdata.jdbc.adobeanalytics.jar
```
接続プロパティを入力し、接続文字列をクリップボードにコピーします。

JDBC URL を構成する際、Max Rows 接続プロパティを設定することもできます。これによって戻される行数を制限するため、可視化・レポートのデザイン設計時のパフォーマンスを向上させるのに役立ちます。

以下はAdobe Analytics の一般的なJDBC 接続文字列です。
```
jdbc:adobeanalytics:GlobalCompanyId=myGlobalCompanyId; RSID=myRSID; OAuthClientId=myOauthClientId; OauthClientSecret=myOAuthClientSecret; CallbackURL=myCallbackURL;
```
Driver Name cdata.jdbc.adobeanalytics.AdobeAnalyticsDriver を設定し、［Save］をクリックします。

NOTE Adobe Analytics への認証は接続文字列に管理されるため、［Security Credentials］は空白でも問題ありません。

Adobe Analytics データオブジェクトを設定

接続が構成されたら、データセットのスキーマを構成し、ビジュアライズするテーブル、ビュー、そしてカラムを選択することができるようになります。

スキーマを選択します。 (e.g. AdobeAnalytics)
［Tables］や［Views］をクリックしてこれらのエンティティに接続し、［Apply］をクリックします。
アクセスする［Tables］と［Columns］を選択し、［Done］をクリックします。

オブジェクトが構成されたら、Pronto Prepare and Relate ツールを用いて、データ準備の実行やデータのリレーションを検出できるようになります。

ビジュアライゼーションを構築

データを準備し、接続されたオブジェクト間のリレーションを定義することで、ビジュアライゼーションを構築することができるようになります。

メニューから、Visualizer ツールを選択します。

オブジェクトからMeasures & Categories を選択します。
選択したMeasure(s) に適切なビジュアライゼーションを選択し、構成します。

Live Adobe Analytics のデータ in a Birst visualization

CData JDBC Driver for AdobeAnalytics をCloud Agent やBirst とともに用いることにより、Adobe Analytics で簡単に堅牢なビジュアライゼーションとレポートを作成できます。30日の無償評価版をダウンロードし、Birst ビジュアライゼーションの構築を開始してください。