Adobe Analytics のデータを帳票ツールbiz-Stream で連携利用する方法

宮本航太
プロダクトスペシャリスト

CData JDBC ドライバを使って、帳票ツールのbiz-Stream で Adobe Analytics をノーコードで連携。

biz-Stream は、多様な表現が可能なWeb 帳票ソリューションです。

この記事では、biz-Stream からCData JDBC ドライバ経由でAdobe Analytics のデータにリアルタイムで連携接続して帳票から利用する方法を紹介します。CData Drivers を使うことで、RDB のようにbiz-Stream 内でAdobe Analytics のデータを扱うことができるようになります。

biz-Stream へのAdobe Analytics JDBC ドライバーの配置

デフォルトの内容でインストールした場合、以下のパスに jar ファイルが配置されますので、その jar ファイルを biz-Stream の所定のパスにコピーします。

cdata.jdbc.adobeanalytics.jar
cdata.jdbc.adobeanalytics.lic （試用版では.lic ファイルは不要）

コピー元：C:\Program Files\CData\CData JDBC Driver for AdobeAnalytics 20xxJ\lib
コピー先：C:\Program Files (x86)\brainsellers\biz-Stream レイアウト・デザイナ\lib_jdbc

biz-Stream からAdobe Analytics への接続設定

レイアウトデザイナを起動後、リソース定義にて Adobe Analytics への接続設定を行います。ドライバー選択のプルダウンに CData AdobeAnalytics JDBC Driver が表示されますので選択します。

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 フローを以下の手順で完了します。

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

サーバURLは以下の形式で入力します。
URL:

jdbc:adobeanalytics:GlobalCompanyId=myGlobalCompanyId; RSID=myRSID; OAuthClientId=myOauthClientId; OauthClientSecret=myOAuthClientSecret; CallbackURL=myCallbackURL;

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

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

Windows:

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

MacOS:

java -jar cdata.jdbc.adobeanalytics.jar

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

接続文字列デザイナーを使って、JDBC URL を生成する (Salesforce is shown.)

次にデータ取得条件を設定します。SQL 定義から定義名を設定し、編集ボタンをクリックします。

上のグレーエリアで右クリック → テーブルリストと選択しますと、Adobe Analytics のオブジェクトがリストで表示されます。使用するテーブルを選択します。

ここでは取得対象の項目や条件などを設定することができます。対象項目や条件を指定できたらOKボタンをクリックし、戻った画面で追加ボタンをクリックします。

最後にデータソース設定を行います。データソース定義名に先ほど設定したものを選択し、画面下部にある追加ボタンをクリックします。これでbiz-Stream でAdobe Analytics のデータを利用する準備ができました。

Adobe Analytics のデータをリアルタイムで参照するbiz-Stream 帳票のデザイン

用紙設定を行います。今回は A4 設定にしました。設定後は画面下部にある追加ボタンをクリックします。

ページ設定では新規ボタンをクリックします。

ここではレイアウトデザイナが帳票テンプレートを xml で保存しますので、ファイル名を設定します。

レイアウトにはさまざまなメニューがありますが、今回は表を使用します。表を設定後、Adobe Analytics から取得したデータをセットするエリアを作成します。各セルにテキストボックスを挿入し、そのテキストボックス自体に Adobe Analytics の項目を紐づけします。
※ヘッダーにもそれぞれテキストボックスを追加します。