各製品の資料を入手。
詳細はこちら →
製品をチェック
SnapLogic でAdobe Analytics を外部サービスに連携
CData JDBC Driver を使用して、SnapLogic と外部サービスを連携。
最終更新日：2021-11-05
この記事で実現できる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 への接続を作成できます。
- Designer タブに移動します。
- Snaps から「JDBC」を展開して、「Generic JDBC - Select」snap をdesigner にドラッグします。
- Add Account をクリック（または既存のものを選択）して、「Continue」をクリックします。
- 次のフォームでは、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 フローを完了します。
- クライアントクレデンシャルOAuth フローで指定されたOAuthClientId およびOAuthClientSecret を使用して、アクセストークンを取得します。
- OAuthSettingsLocation にOAuth 値を保存し、接続間で永続化されるようにします。
- トークンが期限切れになった際に、新しいアクセストークンを要求します。
- 接続プロパティの入力後、「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 ドライバと利用してデータを外部サービスに移すこともできます。
- まず、「Worksheet Writer」snap を"Generic JDBC - Select" snap の終端部分にドロップします。
- Google Sheets に接続するアカウントを追加します。
- 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日の無償評価版をダウンロードして今すぐ使い始めましょう。
関連コンテンツ
