PowerBuilder からAdobe Analytics データに連携

詳細情報をご希望ですか?

無償トライアル:

ダウンロードへ

製品の詳細情報へ:

Adobe Analytics JDBC Driver

Adobe Analytics のMetrics、Users、Reports、Segments にデータ連携するJava アプリケーションを簡単に構築。



この記事では、Adobe Analytics JDBC ドライバーを使用してPowerBuilder からAdobe Analytics にアクセスする方法を説明します。

CData JDBC Driver for Adobe Analytics は、標準ベースのコントロールであり、PowerBuilder を含むJDBC をサポートするプラットフォームまたは開発テクノロジーから使用できます。 また、PowerBuilder でCData JDBC Driver for Adobe Analytics を使用する方法についても詳しく説明します。

この記事では、CData JDBC Driver for Adobe Analytics を使用してデータを取得し、基本的なPowerBuilder アプリケーションを作成する方法を説明します。

PowerBuilder からAdobe Analytics データに接続

以下のステップに従ってDatabase Painter ツールを使用し、JDBC URL for Adobe Analytics に基づいてデータベースプロファイルを作成します。データベースプロファイルを使用して、接続プロパティを保存できます。Ⅾatabase Painter では、データをグラフィカルに操作したり、SQL クエリを実行したりできます。

  1. ドライバーJAR をPowerBuilder クラスパスに追加します。CLASSPATH システム環境変数を、インストールディレクトリのlib サブフォルダにあるドライバーJAR へのパスに設定します。

    NotePowerBuilder Classic を使用している場合は、[Tools]->[System Options]->[Java]をクリックし、ドライバーJAR へのパスを追加することもできます。

  2. [Tools]->[Database Painter]と進みます。
  3. JDBC のノードを右クリックし、[New Profile]をクリックします。
  4. [Database Profile Setup]ダイアログで、以下を入力します。
    • Profile Name:プロファイルのわかりやすい名前を入力します。
    • Driver Name:ドライバーのクラス名にcdata.jdbc.adobeanalytics.AdobeAnalyticsDriver を入力します。
    • URL:JDBC URL を入力します。

      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 に接続してください。

      ビルトイン接続文字列デザイナ

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

      java -jar cdata.jdbc.adobeanalytics.jar

      接続プロパティを入力し、接続文字列をクリップボードにコピーします。以下は一般的なJDBC URL です。

      jdbc:adobeanalytics:GlobalCompanyId=myGlobalCompanyId; RSID=myRSID; OAuthClientId=myOauthClientId; OauthClientSecret=myOAuthClientSecret; CallbackURL=myCallbackURL;
  5. テーブルを表示および編集するには、テーブルを右クリックして[Edit Data]->[Grid]をクリックします。

Adobe Analytics をPowerBuilder Controls と共に使用する

標準のPowerBuilder オブジェクトを使用してJDBC データソースに接続し、クエリを実行できます。以下の例は、Adobe Analytics をDataWindowに取得する方法を示しています。次のコードをopen メソッドに追加できます。

SQLCA.DBMS = "JDBC" SQLCA.AutoCommit = False SQLCA.DBParm = "Driver='cdata.jdbc.adobeanalytics.AdobeAnalyticsDriver',URL='jdbc:adobeanalytics:GlobalCompanyId=myGlobalCompanyId; RSID=myRSID; OAuthClientId=myOauthClientId; OauthClientSecret=myOAuthClientSecret; CallbackURL=myCallbackURL;"; CONNECT USING SQLCA; dw_adsreport.SetTransObject(SQLCA); dw_adsreport.Retrieve();