はじめに
Adobe Analyticsを使用すると、顧客との相互作用を実行可能なインサイトに変え、ビジネスの全体像を把握できるようになります。JWT認証とパーティションをサポートするAdobe Analytics API v2コネクターを使用すると、顧客や様々なメトリクス、ディメンション、セグメントに関するデータを取得し、Webエンゲージメントの大きな全体像を把握することができます。Adobe Analyticsは、サイト訪問者の行動を測定するためのあらゆるツールを提供します。Domoを使用してAdobeの様々なWebアナリティクスメトリクスにアクセスし、これらをCRM、POS、財務その他のあらゆるシステムと組み合わせることによって、適切な情報に基づいた判断をより迅速に下すことができます。Domo内に取り込んだデータを使用してWebプレゼンスの刻々と変化する成長のスナップショットを作成し、Adobe Analyticsメトリクスが、設定しておいた閾値に到達したと同時に通知を受け取ることができます。このコネクターはパーティショニングをサポートしており、カスタムレポートを使用しています。Adobe Analytics APIについて詳しくは、Webサイト（https://marketing.adobe.com/developer/en_US/get-started/introduction/c-introduction）を参照してください。
Adobe Analytics APIには、Data Centerで接続します。このトピックでは、JWT認証とパーティションをサポートするAdobe Analytics API v2コネクターのユーザーインターフェース固有のフィールドとメニューについて説明します。DataSetの追加や更新スケジュールの設定、DataSet情報の編集に関する一般的な情報は、「 データコネクターを使用してDataSetを追加する」を参照してください。
必要条件
Adobe Analytics v2に接続してDataSetを作成するには、Adobe Developer ConsoleでAdobe Analyticsサービスアカウント（JWT）プロジェクトを作成し、以下の情報を入力する必要があります。
- クライアントID（APIキー）
-
クライアントシークレット
-
テクニカルアカウントID
-
組織ID
-
Adobe統合用のPEM形式のプライベートキー
Adobe Developer ConsoleでJWT認証をサポートする新しいプロジェクトを作成する
Adobe Developer Consoleで新しいプロジェクトを作成するには、以下の操作を実行します。
- https://console.adbe.io/projectsにログインします。
- ［新規プロジェクトを作成］をクリックします。
［APIを追加］をクリックしてAdobeサービスを開始します。
4. 利用可能なAPIは［APIを追加］ウィンドウにリストされます。［Adobe Analytics］を選択します。
5. 認証タイプを選択します。ここでは、［サービスアカウント（JWT）］を選択します。
6. ［キーペアを生成］を選択して［次へ］をクリックします。
7. 新しく生成されたキーペアがシステムにダウンロードされます。次に、パブリックキーがJWTプロジェクトにアップロードされ、プライベートキーがシステムにダウンロードされます。
8. config.zipファイルを解凍してconfigディレクトリを開き、任意のテキストエディターでprivate.keyファイルを開きます。このファイルに記述されているプライベートキーを、Domoの［認証情報］セクションに貼り付けます。
9. ［次へ］をクリックします。
10. 目的の製品プロフィールを選択して［設定したAPIを保存］をクリックします。
11.［プロジェクトのAPIとサービス］ページが表示されます。画面をスクロールダウンすると、クライアントID、クライアントシークレット、テクニカルアカウントID、組織IDが表示されます。これらの情報を使用して、Domo内にAdobe Analytics JWTアカウントが作成されます。
12. （任意）プロジェクト名をわかりやすい名前に変更します。［プロジェクトの概要］ページに移動して［プロジェクトを編集］をクリックします。
Adobe Analytics API v2アカウントに接続する
このセクションでは、Adobe Analytics API v2コネクターのページの［認証情報］および［詳細］ペインのオプションについて説明します。このページのほかのペインの項目にある［スケジュール設定］や［DataSetの名前を付け説明を入力］に関しては、ほとんどのタイプのコネクターで共通しています。詳細については、「データコネクターを使用してDataSetを追加する」を参照してください。
［認証情報］ペイン
このペインには、Adobe Analytics API v2に接続する認証情報の入力フィールドが含まれています。下表では、各フィールドに必要な内容を説明しています。
|
フィールド |
説明 |
|---|---|
| クライアントID（APIキー） | クライアントIDを入力します。 |
| クライアントシークレット | クライアントシークレットを入力します。 |
| テクニカルアカウントID | テクニカルアカウントIDを入力します。 |
| 組織ID | 組織IDを入力します。 |
| シークレットキー | Adobe統合環境のPEM形式のプライベートキーを貼り付けます。 |
有効な認証情報を一度入力しておくと、いつでも同じアカウントを使用してJWT認証とパーティションをサポートする新しいAdobe Analytics v2 DataSetを作成することができます。コネクターアカウントは、Data Centerの［アカウント］タブで管理できます。このタブの詳細については、「コネクターのユーザーアカウントを管理する」を参照してください。
［詳細］ペイン
このペインには、メインとなる［レポート］メニューのほか、選択したレポートタイプに応じ表示・非表示となる様々なメニューが準備されています。
|
メニュー |
説明 |
||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
レポート |
JWT認証とパーティションをサポートするAdobe Analytics API v2コネクターの以下のレポートから、実行するレポートを選択します。以下のレポートが利用できます。
|
||||||||||||||
| グローバル会社ID | 会社を選択します。 | ||||||||||||||
| レポートスイートID | レポートスイートIDを選択します。 | ||||||||||||||
| メトリクス | 利用可能なメトリクスからメトリクスを選択します。 | ||||||||||||||
| ディメンション | ドリルの順番でディメンションを選択します。 | ||||||||||||||
| セグメント | データをセグメントでフィルターする場合は、セグメントを選択します。 | ||||||||||||||
| 異常検出レポート | 異常検出を含めるには、ボックスをチェックします。 | ||||||||||||||
| レポートの日付 | レポートの日付を選択します。 | ||||||||||||||
| タイプを含める | ユーザーが所有していない追加の計算メトリクスを含めます。「すべて」オプションは「共有」よりも優先されます。 | ||||||||||||||
| 単一の日付 | レポートのデータが特定の日付か、または今日から何日前までの相対的なものかを選択します。 | ||||||||||||||
| 特定の日付 | 日付セレクターを使用して特定の日付を選択します。 | ||||||||||||||
| 相対日付 | 何日前に遡ってデータを取得したいか、［遡る日数］フィールドに日数を入力します。今日を指定するには「today」または「0」、昨日なら「yesterday」または「1」、過去7日間のデータを取得するには「today-7」または「7」と指定します。 | ||||||||||||||
| 日付範囲 | 特定の日付範囲または相対日付範囲を選択します。 | ||||||||||||||
| 開始日 - 特定 | 日付セレクターを使用して、日付範囲の 最初の日付を選択します。 | ||||||||||||||
| 終了日 - 特定 | 日付セレクターを使用して、日付範囲の最後の日付を選択します。 | ||||||||||||||
| 開始日 - 相対 |
データを取得したい過去の日数（開始日）を入力します。終了日までの日数と組み合わせて、表示する日付の範囲を作成します。 例えば、開始日に「10」、終了日に「5」を入力した場合、レポートには10日前から5日前のデータが含まれます。 |
||||||||||||||
| 終了日 - 相対 |
データを取得したい過去の日数（終了日）を入力します開始日までの日数と組み合わせて、表示する日付の範囲を作成します。 例えば、開始日に「10」、終了日に「5」を入力した場合、レポートには10日前から5日前のデータが含まれます。 |
その他のペイン
スケジュール設定、再試行、オプションの更新など、コネクターインターフェースのその他のペインに表示されるオプションについては、「データコネクターを使用してDataSetを追加する」を参照してください。
よくある質問
Adobe Analytics JWTアカウントが正しく作成されたにもかかわらず、それから約2週間後に「Adobe Analytics JWTアカウントが無効になりました」というアラートが表示されました。このアラートが表示されるのはなぜですか？この場合はどうすればよいですか？
JWTトークンを作成するときに、その有効期限を設定します。JWTの有効期限が終了しているか確認してください。Adobe Analyticsは、IMSアクセストークンと交換してすぐに期限切れになるような、非常に有効期限の短い（数分）トークンを提案しています。したがって、新しいアクセストークンが要求されるたびに、そのJWTに署名して交換します。これが安全な方法です。詳細は、JWTサービスアカウントの依頼を参照してください。
Adobe Analytics v2 OAuthコネクターとAdobe Analytics v2 JWTコネクターの違いは何ですか？
Adobe Analytics v2 OAuthコネクターではOAuth認証機能が使用されますが、Adobe Analytics v2 JWTコネクターではJWT認証機能が使用されます。Adobeは、JWT認証機能を使用することを推奨しています。OAuth認証機能の場合、OAuth更新トークンの有効期限が2週間で切れてしまうため、2週間ごとにOAuthアカウントを更新する必要があります。
このコネクターでは、どのバージョンのAdobe Analytics APIが使用されますか？
このコネクターはAdobe Analytics APIのバージョン2（https://analytics.adobe.io/api/2）を使用します。
各レポートコールによってこのコネクターで呼び出されるのはどのエンドポイントですか？
| レポート名 | エンドポイントURL（1つまたは複数） |
|---|---|
| 計算メトリクス | /calculatedmetrics |
| コレクション | /collections/suites |
| ディメンション | /dimensions |
| メトリクス | /metrics |
| レポート | /reports |
| セグメント | /segments |
| ユーザー | /users |
このコネクターを作成するにはどのような認証情報が必要ですか？
Adobe Analytics v2 JWTプロジェクトに関連付けられているクライアントID（APIキー）、クライアントシークレット、テクニカルアカウントID、組織ID、プライベートキーが必要になります。
APIについて知っておくべき制約事項はありますか？
Adobe Analytics API 2.0のマルチディメンションでレポートを実行するために、Domoは複数の小さなAPI呼び出しでデータを取得します。多数のディメンションのデータを取得したり、長い時間をかけてデータを取得した場合、DataSetは24時間後にタイムアウトする可能性があります。これを防ぐには、データ量を減らしたりディメンションを減らす必要があります。
どちらのAdobe Analyticsコネクターを使用すればよいですか？
Adobeは、JWT認証をサポートするAdobe Analytics v2コネクターを使用することを推奨しています。Adobe Analytics v2 OAuthコネクターではOAuth更新トークンが使用されますが、このトークンは2週間で有効期限が切れてしまうため、2週間ごとにアカウントを更新する必要があります。
トラブルシューティング
- 認証が有効であることを確認してください。
- 設定を見直し、すべての必須項目が選択されていることを確認してください。
- コネクターの履歴にエラーメッセージが記録されていないかどうかを確認してください。
- まれに、多過ぎる情報をリクエストした結果、API制限またはタイムアウトに達する場合があります。記録されている場合は、コネクターの実行履歴でエラーメッセージと実行時間を確認することができます。また、取得するアカウント数やレポートのメトリクス数を減らしたり、取得するタイムフレームを短縮したりすることができます。
コメント
0件のコメント
サインインしてコメントを残してください。