はじめに
Adobe Analytics Realtimeでは、インサイトをリアルタイムのデータ駆動型の応答に変換できます。DomoのAdobe Analytics Realtimeコネクターを使用すると、選択したAdobe Analytics Report Suiteからデータを取得できます。Adobe Analytics APIの詳細については、ウェブサイト( https://marketing.adobe.com/developer/en_US/get-started/introduction/c-introduction )を参照してください。 Adobe Analyticsアカウントには、Data Centerから接続します。このトピックでは、Adobe Analytics Realtimeコネクターユーザーインターフェース固有のフィールドとメニューについて説明します。DataSetの追加や更新スケジュールの設定、DataSet情報の編集に関する一般的な情報は、「 コネクターを使用してDataSetを追加する 」を参照してください。必要条件
Adobe Analytics v2に接続してDataSetを作成するには、Adobe Developer ConsoleでAdobe Analyticsサービスアカウント(JWT)プロジェクトを作成し、以下の情報を入力する必要があります。- クライアントID(APIキー)
- クライアントシークレット
- テクニカルアカウントID
- 組織ID
- Adobe統合用のPEM形式の秘密キー
Adobe Developer Consoleで新しいOAuthプロジェクトを作成する
Adobe Developer Consoleで新しいOAuthプロジェクトを作成するには、以下の手順を実行します。- https://console.adbe.io/projects にログインします。
- [Create new project] をクリックします。

- [Add API] をクリックしてAdobeサービスを開始します。

- 利用可能なAPIは [Add an API] ウィンドウにリストされます。 [Adobe Analytics] を選択します。

- 認証タイプを選択します。ここでは、[Service Account (JWT)] を選択します。

- [Generate a key pair] を選択して、 [Generate Keypair] をクリックします。

- 新しく生成されたキーペアがシステムにダウンロードされます。次に、パブリックキーがJWTプロジェクトにアップロードされ、秘密キーがシステムにダウンロードされます。

- config.zipファイルを解凍してconfigディレクトリを開き、任意のテキストエディターでprivate.keyファイルを開きます。このファイルに記述されている 秘密キー を、Domoの[認証情報]セクションに貼り付けます。
- [Next] をクリックします。
- 目的の製品プロフィールを選択して [Save Configured API] をクリックします。
- [Project APIs and Services] ページが表示されます。画面をスクロールダウンすると、 クライアントID、クライアントシークレット、テクニカルアカウントID 、 組織ID が表示されます。これらの情報を使用して、Domo内にAdobe Analytics JWTアカウントが作成されます。

- (任意)プロジェクト名をわかりやすい名前に変更します。[Project Overview] ページに移動して [Edit Project] をクリックします。
Adobe Analytics Realtimeアカウントに接続する
このセクションではAdobe Analytics Realtimeコネクターページの [認証情報] と [データの選択] ペインのオプションについて説明します。このページのほかのペインの項目にある [スケジュール設定] や [DataSetに名前を付け、説明を入力] に関しては、コネクタータイプのほとんどで共通です。詳細については「 コネクターを使用してDataSetを追加する 」を参照してください。[認証情報]ペイン
このペインには、Adobe Analytics Realtimeアカウントに接続するための認証情報の入力フィールドが含まれています。下表では、各フィールドに必要な内容を説明しています。フィールド | 説明 |
|---|---|
| Client ID (API Key) | クライアントIDを入力します。 |
| Client Secret | クライアントシークレットを入力します。 |
| Technical Account ID | テクニカルアカウントIDを入力します。 |
| Organization ID | 組織IDを入力します。 |
| Private Key | Adobe統合環境のPEM形式の秘密キーを貼り付けます。 |
[詳細]ペイン
このペインには、2つのメインメニューである [Report Suite] と [Report Type] のほか、選択したレポートタイプに応じて表示または非表示になるその他の様々なメニューがあります。メニュー | 説明 | ||||
|---|---|---|---|---|---|
| Company | Adobe Analyticsで設定されている会社名を入力します。ここで入力した会社名が、Company.GetEndpointメソッドのパラメーターとして使用されます( https://github.com/AdobeDocs/analyti…GetEndpoint.md を参照)。 | ||||
Report Suite | データを取得するAdobe Analyticsレポートスイートを選択します。 | ||||
Report Type | レポートタイプを選択します。レポートタイプは、DataSetの設定に必要な入力を決定します。 レポートタイプは次のとおりです。
|
「Easy - Predefined」レポートタイプのオプション
Predefined Report | 実行するレポートを選択します。レポートタイプのリストについては、次のセクションを参照してください。 | ||||||||||||||||||||||||||||||||||||||
Report | 定義済みレポートを選択します。これらのレポートは [Report Type] で [Easy - Predefined] を選択した場合 のみ 利用可能です。
|
「Intermediate - Custom」レポートタイプのオプション
Metrics | レポートには最大30メトリクス選択できます。Adobe Analyticsのメトリクスについての詳細は、 https://marketing.adobe.com/develope…ng-1-4/metrics を参照してください。 |
Elements | 最大で4つの要素名を選択できます。 要素 はレポートのメトリクスデータの分類構造です。例えば、ページ閲覧数(メトリクス)をページのアクセスに使用されたブラウザー(要素)別に分類したレポートを作成できます。作成されるレポートには、ブラウザーのタイプ別にページ閲覧数が一覧で表示されます。 要素についての詳細は、 https://marketing.adobe.com/develope…g-1-4/elements を参照してください。 |
| Additional Element Information | 追加要素の情報を入力します。 APIエクスプローラー で定義されている要素のJSONフォーマットを使用して、カスタマイズを行います。 例:
|
Date Granularity | 分の間隔を「 minute:[interval] 」という形式で指定します。間隔は1~60の整数で指定します。例えば「 minute:3 」と指定すると、要求した日付範囲が3分間隔でレポートされます。 |
| Sort Method(オプション) | データのソート方法を示す文字列を入力します。例:
|
| Add Date Granularity | 上に指定する時間粒度に基づいてデータを集計するか、それともすべてのデータを集計するかを選択します。 |
Duration | レポートのデータの対象を、単一の日付にするか一定の期間にするかを指定します。 |
Report Date | レポートのデータを、選択した [Date Granularity] に従い、特定日付とするか相対日付とするかを選択します。例えば、 [Date Granularity]に[Day] を選択すると、レポートの日付として [Today] を選択できます。この場合、データが更新されるたびに、現在の日付のデータが表示されます。 |
Select Specific Date | データを取得する日付を選択します。 |
Date From | 日付範囲の開始日を、特定日付とするか相対日付とするかを指定します。範囲の最後の日付を、 [Date To] で選択します。これらのメニューのオプションは、選択した [Date Granularity] によって決まります。 例えば、 [Date Granularity]に[Week] を選択すると、 [Date From]に [Last Week] 、 [Date To]に[This Week] を選択できます。これで、レポートが更新されるたびに、今週と先週のデータが表示されます。 |
Date To | 日付範囲の最終日を、特定日付とするか相対日付とするかを指定します。日付範囲の最初の日付を、 [Date From] で選択します。これらのメニューのオプションは、選択した [Date Granularity] によって決まります。 例えば、 [Date Granularity]に[Week] を選択すると、 [Date From]に [Last Week] 、 [Date To]に[This Week] を選択できます。これで、レポートが更新されるたびに、今週と先週のデータが表示されます。 |
「Advanced - Query」レポートタイプのオプション
オプション | 説明 |
|---|---|
Query | Adobe Analytics Web Service APIエクスプローラークエリを使ってレポートのデータを取得します。クエリについての詳細は、 https://marketing.adobe.com/develope…r#Report.Queue を参照してください。 例:
|
その他のペイン
スケジュール設定、再試行、更新に関するオプションなど、コネクターインターフェースのその他のペインに表示されるオプションについては、「 コネクターを使用してDataSetを追加する 」を参照してください。よくある質問
Adobe Analytics v2 OAuthコネクターとAdobe Analytics Realtime JWTコネクターの違いは何ですか?
Adobe Analytics v2 OAuthコネクターとAdobe Analytics Realtime JWTコネクターの違いは何ですか?
このコネクターでは、どのバージョンのAdobe Analytics APIが使用されますか?
このコネクターでは、どのバージョンのAdobe Analytics APIが使用されますか?
このコネクターを作成するにはどのような認証情報が必要ですか?
このコネクターを作成するにはどのような認証情報が必要ですか?
APIについて知っておくべき制約事項はありますか?
APIについて知っておくべき制約事項はありますか?
どちらのAdobe Analyticsコネクターを使用すればよいですか?
どちらのAdobe Analyticsコネクターを使用すればよいですか?