各製品の資料を入手。
詳細はこちら →
製品をチェック
JReport Designer でAdobe Analytics のデータを連携
JReport Designer でAdobe Analytics に連携するチャートとレポートを作成します。
最終更新日：2022-10-10
この記事で実現できるAdobe Analytics 連携のシナリオ
こんにちは！ウェブ担当の加藤です。マーケ関連のデータ分析や整備もやっています。
CData JDBC Driver for AdobeAnalytics を使用すると、Adobe Analytics がリレーショナルデータベースであるかのようにダッシュボードやレポートからリアルタイムデータにアクセスでき、使い慣れたSQL クエリを使用してAdobe Analytics] をクエリできます。ここでは、JDBC データソースとしてAdobe Analytics に連携し、JReport Designer でAdobe Analytics のレポートを作成する方法を説明します。
Adobe Analytics のデータに接続
- C:\JReport\Designer\bin\setenv.bat を編集し、JAR ファイルの場所をADDCLASSPATH 変数に追加します。
... set ADDCLASSPATH=%JAVAHOME%\lib\tools.jar;C:\Program Files\CData\CData JDBC Driver for AdobeAnalytics 2016\lib\cdata.jdbc.adobeanalytics.jar; ...
- ［File］［New］［Data Source］と進み、新しいデータソースを作成します。
- 表示されるダイアログで、データソースの名前(CData JDBC Driver for AdobeAnalytics) を作成し、JDBC を選択して［OK］をクリックします。
- ［JDBC Connection Information］ダイアログで、JDBC ドライバーへの接続を構成します。
- Driver:［Driver］ボックスにチェックがついていることを確認し、ドライバーのクラスの名前を入力します。
cdata.jdbc.adobeanalytics.AdobeAnalyticsDriver - URL:jdbc:adobeanalytics: から始まり、その後にセミコロンで区切られた接続プロパティのリストが続く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 フローを完了します。
- クライアントクレデンシャルOAuth フローで指定されたOAuthClientId およびOAuthClientSecret を使用して、アクセストークンを取得します。
- OAuthSettingsLocation にOAuth 値を保存し、接続間で永続化されるようにします。
- トークンが期限切れになった際に、新しいアクセストークンを要求します。
ビルトイン接続文字列デザイナー
JDBC URL の構成については、Adobe Analytics JDBC Driver に組み込まれている接続文字列デザイナーを使用してください。JAR ファイルのダブルクリック、またはコマンドラインからJAR ファイルを実行します。
java -jar cdata.jdbc.adobeanalytics.jar接続プロパティを入力し、接続文字列をクリップボードにコピーします。
JDBC URL を構成する際、Max Rows 接続プロパティを設定することもできます。これによって戻される行数を制限するため、可視化・レポートのデザイン設計時のパフォーマンスを向上させるのに役立ちます。
以下は一般的なJDBC URLです。
jdbc:adobeanalytics:GlobalCompanyId=myGlobalCompanyId; RSID=myRSID; OAuthClientId=myOauthClientId; OauthClientSecret=myOAuthClientSecret; CallbackURL=myCallbackURL; - User:認証に使用するユーザー名は、通常空白のままにします。
- Password:User と同様に認証に使用するパスワードも、通常は空白のままにします。
- Driver:［Driver］ボックスにチェックがついていることを確認し、ドライバーのクラスの名前を入力します。
［Add Table］ダイアログで、レポート（またはこのデータソースを使用する予定のレポート）に含めるテーブルを選択し、［Add］をクリックします。
ダイアログがテーブルのロードを完了したら、［Done］をクリックします。
- ［Catalog Browser］では、レポートの作成に使用するクエリを作成できます。今すぐ、またはレポートの作成後に作成できますが、どちらにしても、 データソース(CData JDBC Driver for Adobe Analytics) を展開()し、［Queries］を右クリックして［Add Query］を選択します。
- ［Add Table/View/Query］ダイアログで、JDBC URL とTables を展開() し、クエリで使用するテーブルを選択して［OK］をクリックします。
- ［Query Editor］ダイアログで、含めるカラムを選択するか、［SQL］ボタンをクリックして以下のようにカスタムクエリを手動で入力できます。
SELECT Page, PageViews FROM AdsReport WHERE City = 'Chapel Hill'
クエリが作成されたら、［OK］をクリックして［Query Editor］ダイアログを閉じます。この時点で、Adobe Analytics を新規または既存のレポートに追加する準備が整いました。
NOTE: クエリが作成されると、クエリに基づいて［Business View］を作成できます。［Business View］を使用すると、クエリに基づいてWeb レポートまたはライブラリコンポーネントを作成できます。これについてのより詳しい情報は、JReport のチュートリアルを参照してください。
レポートにAdobe Analytics のデータを追加
Adobe Analytics を使用してレポートを作成することができるようになりました。
- 新しいレポートを作成(［File］［New］［Page Report］) するか、既存のレポートの［Chart Wizard］を開きます。
- クエリを選択(または上記を参照して新しいクエリを作成) します。
- クエリのカラムからグラフの［Category］と［Value］を割り当て、［Finish］をクリックします。
- レポートの［View］タブをクリックし、チャートを表示します。
関連コンテンツ
