SnapLogic でAdobe Analytics を外部サービスに連携

こんにちは！ドライバー周りのヘルプドキュメントを担当している古川です。

SnapLogic はintegration Platform-as-a-Service（iPaaS）であり、ユーザーはノーコードでデータ連携フローを作成できます。CData JDBC ドライバと組み合わせることで、ユーザーはSnapLogic ワークフローからAdobe Analytics を含む250を超えるSaaS、ビッグデータ、NoSQL データソースのリアルタイムデータに接続できます。

組み込みの最適化されたデータ処理によって、CData JDBC Driver はリアルタイムAdobe Analytics のデータを高速に扱えます。プラットフォームがAdobe Analytics に複雑なSQL クエリを発行すると、ドライバーはフィルタや集計などのサポートされているSQL 操作をAdobe Analytics に直接プッシュし、サポートされていない操作（主にSQL 関数とJOIN 操作）は組み込みSQL エンジンを利用してクライアント側で処理します。組み込みの動的メタデータクエリを使用すると、ネイティブデータソース型を使用してAdobe Analytics のデータを操作することができます。

SnapLogic からAdobe Analytics に接続する

SnapLogic からAdobe Analytics のデータに接続するには、CData Adobe Analytics JDBC Driver をダウンロードしてインストールします。インストール画面に従ってください。インストールが完了すると、インストール先のディレクトリ（デフォルトでは、C:/Program Files/CData/CData JDBC Driver for AdobeAnalytics/lib）にJAR ファイルが作成されます。

Adobe Analytics JDBC Driver をアップロードする

インストール後、JDBC JAR ファイルをSnapLogic 内のディレクトリ（例えば、projects/Jerod Johnson）にManager タブからアップロードします。

接続を設定する

JDBC Driver がアップロードされると、Adobe Analytics への接続を作成できます。

1. Designer タブに移動します。
2. Snaps から「JDBC」を展開して、「Generic JDBC - Select」snap をdesigner にドラッグします。
3. Add Account をクリック（または既存のものを選択）して、「Continue」をクリックします。
4. 次のフォームでは、JDBC 接続プロパティを設定します。
   • JDBC JARs 以下にアップロードしたJAR ファイルを追加します。
   • JDBC Driver Class をcdata.jdbc.adobeanalytics.AdobeAnalyticsDriver に設定します。

   • JDBC URL をAdobe Analytics JDBC Driver 用のJDBC 接続文字列に設定します。例えば、

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

     です。

     NOTE： RTK は評価版もしくは製品版のキーです。詳しくは、CData のサポートチームにご連絡ください。

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

     JDBC URL の作成の補助として、Adobe Analytics JDBC Driver に組み込まれている接続文字列デザイナーが使用できます。JAR ファイルをダブルクリックするか、コマンドラインからjar ファイルを実行します。

     java -jar cdata.jdbc.adobeanalytics.jar

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

     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 フローを完了します。

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

5. 接続プロパティの入力後、「Validate」、そして「Apply」をクリックします。

Adobe Analytics のデータを読み込む

接続を検証、適用後に開くフォームで、クエリを設定します。

• Schema name を"AdobeAnalytics" に設定します。
• Table name を、スキーマ名を使用したAdobe Analytics 用のテーブルに設定します。例えば、"AdobeAnalytics"."AdsReport" です（ドロップダウンを使用して利用可能なテーブルの全リストを確認できます）。
• テーブルから、使用したい項目ごとにOutput fields を追加します。

Generic JDBC - Select snap を保存します。

接続とクエリを設定したら、snap の終端部分（以下のハイライト部分）をクリックしてデータをプレビューします。

結果が期待どおりのものであることを確認したら、他のsnap を追加してAdobe Analytics のデータを別のエンドポイントに渡すこともできます。

Adobe Analytics のデータを外部サービスにパイプ

本記事では、データをGoogle Spreadsheet にロードします。他のあらゆるサポートされているsnap が使用でき、Generic JDBC snap を他のCData JDBC ドライバと利用してデータを外部サービスに移すこともできます。

1. まず、「Worksheet Writer」snap を"Generic JDBC - Select" snap の終端部分にドロップします。
2. Google Sheets に接続するアカウントを追加します。
3. Worksheet Writer snap を、Adobe Analytics のデータをGoogle Spreadsheet に書き込むよう設定します。

これで、接続済みのパイプラインを実行してAdobe Analytics からデータを抽出し、Google Spreadsheet にプッシュできます。

詳細情報と無償評価版

CData JDBC Driver for AdobeAnalytics を使えば、Adobe Analytics のデータを外部サービスに連携するためのパイプラインをSnapLogic で作成できます。Adobe Analytics への接続に関する詳細については、CData のAdobe Analytics 連携ページを参照してください。30日の無償評価版をダウンロードして今すぐ使い始めましょう。