HULFT Integrate で Adobe Analytics のデータ に接続

HULFT Integrate は、ドラッグ＆ドロップのユーザーインターフェースでコーポレーションフロー、データ変換、処理を簡単に作成できる最新のデータ連携プラットフォームです。CData JDBC Driver for Adobe Analytics と組み合わせることで、HULFT Integrate からリアルタイムの Adobe Analytics のデータ を扱うことができます。この記事では、Adobe Analytics への接続方法と、データを CSV ファイルに出力する手順をご紹介します。

CData JDBC ドライバーは、最適化されたデータ処理機能を備えており、リアルタイムの Adobe Analytics のデータ との連携において比類のないパフォーマンスを発揮します。Adobe Analytics に対して複雑な SQL クエリを発行すると、ドライバーはフィルタや集計などのサポートされている SQL 操作を直接 Adobe Analytics にプッシュし、サポートされていない操作（主に SQL 関数や JOIN 操作）は内蔵の SQL エンジンでクライアント側で処理します。また、動的なメタデータクエリ機能により、ネイティブなデータ型を使用して Adobe Analytics のデータ を操作・分析できます。

Adobe Analytics へのアクセスを有効化

HULFT Integrate プロジェクトから Adobe Analytics のデータ へのアクセスを有効にするには、以下の手順で設定します：

1. CData JDBC Driver の JAR ファイル（およびライセンスファイルがある場合はそれも）、cdata.jdbc.adobeanalytics.jar（および cdata.jdbc.adobeanalytics.lic）を、Integrate Server の jdbc_adapter サブフォルダにコピーします
2. HULFT Integrate Server を再起動し、HULFT Integrate Studio を起動します

Adobe Analytics のデータ にアクセスするプロジェクトの作成

JAR ファイルをコピーしたら、Adobe Analytics のデータ にアクセスするプロジェクトを作成できます。まず、Integrate Studio を開いて新しいプロジェクトを作成しましょう。

1. プロジェクト名を入力します
2. 「スクリプトを作成」チェックボックスがオンになっていることを確認します
3. 「次へ」をクリックします
4. スクリプト名を入力します（例：AdobeAnalyticstoCSV）

プロジェクトを作成したら、Adobe Analytics のデータ を CSV ファイルにコピーするためのコンポーネントをスクリプトに追加します。

Execute Select SQL コンポーネントの設定

ツールパレット（Database -> JDBC）から「Execute Select SQL」コンポーネントをスクリプトワークスペースにドラッグします。

1. 「必須設定」タブの接続先で、「追加」をクリックして Adobe Analytics 用の新しい接続を作成します。以下のプロパティを設定します：
   • 名前：Adobe Analytics Connection Settings
   • ドライバークラス名：cdata.jdbc.adobeanalytics.AdobeAnalyticsDriver
   • URL：jdbc:adobeanalytics:GlobalCompanyId=myGlobalCompanyId; RSID=myRSID; OAuthClientId=myOauthClientId; OauthClientSecret=myOAuthClientSecret; CallbackURL=myCallbackURL;
     
     

     組み込みの接続文字列デザイナー

     JDBC URL の構築には、Adobe Analytics JDBC Driver に組み込まれている接続文字列デザイナーをご利用ください。JAR ファイルをダブルクリックするか、コマンドラインから JAR ファイルを実行します。

     		java -jar cdata.jdbc.adobeanalytics.jar
     		

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

     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. トークンが期限切れになった際に、新しいアクセストークンを要求します
     
2. SQL ステートメントを記述します。例：

   SELECT Page, PageViews FROM AdsReport

3. 「抽出テスト」をクリックして、接続とクエリが正しく設定されていることを確認します
4. 「SQL を実行して出力スキーマを設定」をクリックします
5. 「完了」をクリックします

Write CSV File コンポーネントの設定

ツールパレット（File -> CSV）から「Write CSV File」コンポーネントをワークスペースにドラッグします。

1. クエリ結果を書き込むファイルを設定します（例：AdsReport.csv）
2. 「入力データ」を「Select SQL」コンポーネントに設定します
3. SQL クエリで選択した各フィールドのカラムを追加します
4. 「書き込み設定」タブで、「最初の行にカラム名を挿入する」チェックボックスをオンにします
5. 「完了」をクリックします

Adobe Analytics フィールドを CSV カラムにマッピング

「Select」コンポーネントの各カラムを、「CSV」コンポーネントの対応するカラムにマッピングします。

スクリプトの完成

「Start」コンポーネントを「Select」コンポーネントに、「CSV」コンポーネントを「End」コンポーネントにドラッグして接続します。スクリプトをビルドして実行すると、Adobe Analytics のデータ が CSV ファイルに出力されます。

CData JDBC Driver for Adobe Analyticsの30日間の無償トライアルをダウンロードして、HULFT Integrate でリアルタイムの Adobe Analytics のデータ を活用してみてください。ご不明な点があれば、サポートチームまでお気軽にお問い合わせください。