Ruby でODBC 経由でAdobe Analytics に接続して、モダンなクラウド連携アプリを開発。
CData ODBC Driver for Adobe Analytics を使うと、簡単にRuby アプリケーションにリアルタイムAdobe Analytics データを連携・統合できます。 Tこの記事では、Adobe Analytics] データにリアルタイムに連携するRuby アプリケーションを構築して、クエリを実行し、結果を表示してみます。
Adobe Analytics データのODBC 接続を設定
通常はCData ODBC Driver のインストール後にODBC DSN 接続ウィザードが立ち上がり、設定を行うことができます。 もしODBC DSN 接続が未済の場合には、Microsoft ODBC データソースアドミニストレータでODBC DSN を作成および設定することができます。
Adobe Analytics はOAuth 認証標準を利用しています。 OAuth 統合またはサービスアカウント統合で認証できます。OAuth を使って認証するには、アプリケーションを作成してOAuthClientId、OAuthClientSecret、およびCallbackURL 接続プロパティを取得しなければなりません。認証方法については、ヘルプドキュメントの「OAuth 認証の使用」を参照してください。
GlobalCompanyIdの取得
GlobalCompanyId は必須の接続プロパティです。Global Company ID がわからない場合は、Swagger UI のusers/me エンドポイントのリクエストURL で見つけることができます。Swagger UI にログインした後、ユーザーエンドポイントを展開し、[GET users/me]ボタンをクリックします。[Try it out]ボタンと[Execute]ボタンをクリックします。リクエストURL のusers/me エンドポイントの直前に表示されるGlobal Company ID をメモします。
Report Suite Id の取得
Report Suite ID (RSID)は必須の接続プロパティです。Adobe Analytics UI で、[管理者]->[レポートスイート]に進むと、名前の横にある識別子とともにレポートスイートのリストが表示されます。
GlobalCompanyId、RSID、およびOAuth 接続プロパティを設定して、Adobe Analytics に接続してください。
Ruby および必要なGem のインストール
If you do not have Ruby installed, refer to the Ruby インストールページ. Ruby をインストールしたら、次にruby-dbi、dbd-odbc、ruby-odbc gems をインストールします:
gem install dbi
gem install dbd-odbc
gem install ruby-odbc
Adobe Analytics データに連携するRuby アプリケーションの作成
Ruby ファイル (例: AdobeAnalyticsSelect.rb) を作成し、テキストエディタで開きます。ファイルに次のコードをコピーします:
#connect to the DSN
require 'DBI'
cnxn = DBI.connect('DBI:ODBC:CData AdobeAnalytics Source','','')
#execute a SELECT query and store the result set
resultSet = cnxn.execute("SELECT Page, PageViews FROM AdsReport WHERE City = 'Chapel Hill'")
#display the names of the columns
resultSet.column_names.each do |name|
print name, "\t"
end
puts
#display the results
while row = resultSet.fetch do
(0..resultSet.column_names.size - 1).each do |n|
print row[n], "\t"
end
puts
end
resultSet.finish
#close the connection
cnxn.disconnect if cnxn
これで、Ruby で Adobe Analytics データが接続できるようになります。簡単にコマンドラインからファイルを叩いて接続を確認してみましょう。:
ruby AdobeAnalyticsSelect.rb
Adobe Analytics へのSQL-92 企画のSQL を使って、Ruby に簡単にAdobe Analytics を連携できます。是非、トライアルで試してみてください。