IMS を使用した Adobe Analytics との統合

Analytics Standard API を介して AEM と Adobe Analytics を統合するには、Adobe Developer Console を使用して Adobe IMS(Identity Management System)を設定する必要があります。

メモ

Adobe Analytics Standard API 2.0 のサポートは、AEM 6.5.12.0 で新しく追加されました。このバージョンの API は IMS 認証をサポートします。

AEM での Adobe Analytics Classic API 1.4 の使用は、後方互換性のために引き続きサポートされています。Analytics Classic API はユーザーの資格情報認証を使用します

API の選択は、AEM/Analytics 統合に使用される認証方法によって決定されます。

詳しくは、2.0 API への移行でも参照できます。

前提条件

この手順を開始する前に、以下を実行します。

  • アドビサポートは、次のアカウントをプロビジョニングする必要があります。

    • アドビコンソール
    • Adobe 開発者コンソール
    • Adobe Analytics と
    • Adobe IMS(Identity Management System)
  • 組織のシステム管理者は、Admin Console を使用して、組織内で必要な開発者を関連する製品プロファイルに追加する必要があります。

    • これにより、Adobe Developer Console 内で統合を有効にするための権限が特定の開発者に与えられます。
    • 詳しくは、開発者の管理を参照してください。

IMS 設定の指定 - 公開鍵の生成

設定の最初の段階は、AEMで IMS 設定を作成し、公開鍵を生成することです。

  1. AEM で、ツール​メニューを開きます。

  2. セキュリティ​セクションで、Adobe IMS 設定​を選択します。

  3. 作成​を選択して、Adobe IMS テクニカルアカウント設定​を開きます。

  4. クラウド設定​の下のドロップダウンを使用して、Adobe Analytics を選択します。

  5. 新しい証明書の作成​をアクティブにして、新しいエイリアスを入力します。

  6. 証明書の作成」で確認します。

  7. ダウンロード(または​公開鍵のダウンロード)を選択してファイルをローカルドライブにダウンロードし、AEM と Adobe Analytics 統合のための IMS の設定時に使用できるようにします。

    注意

    この設定は、AEM で IMS 設定を完了するときに再び必要になるため、開いたままにしてください。

AEM と Adobe Analytics 統合のための IMS 設定

Adobe Developer Console を使用する場合は、Adobe Analytics でプロジェクト(統合)を作成し、AEM で使用するための権限を割り当てる必要があります。

プロジェクトの作成

Adobe Developer Console を開いて、AEM が使用する Adobe Analytics でプロジェクトを作成します。

  1. Adobe Developer Console を開いて、プロジェクトを表示します。

    https://developer.adobe.com/console/projects

  2. 既に作成したプロジェクトが表示されます。新規プロジェクトの作成​を選択 - 場所と使用方法は、以下に依存します。

    • まだプロジェクトがない場合は、 新規プロジェクトを作成が中央の下に表示されます。
      新規プロジェクトの作成 - 最初のプロジェクト
    • 既存のプロジェクトがある場合は、それらがリストされ、 新規プロジェクトの作成が右上に表示されます。
      新規プロジェクトの作成 - 複数のプロジェクト
  3. プロジェクトに追加​を選択し、続いて API を選択します。

    新しいプロジェクトの基本を学ぶ

  4. Adobe Analytics を選択し、続いて「次へ」を選択します。

    メモ

    Adobe Analytics を購読しているが、リストに表示されない場合は、前提条件を確認する必要があります。

    API を追加

  5. 認証のタイプとして、「サービスアカウント(JWT)」を選択し、「次へ」をクリックして進みます。

    認証のタイプを選択

  6. 公開鍵​をアップロードして、完了したら​次へ​をクリックして進みます。

    公開鍵をアップロード

  7. 資格情報を確認して、次へ​をクリックして進みます。

    資格情報を確認

  8. 必要な製品プロファイルを選択して、設定済み API を保存​に進みます。

    必要な製品プロファイルを選択

  9. 設定が確定します。

統合への権限の割り当て

次に、必要な権限を統合に割り当てる必要があります。

  1. Adobe Admin Console を開きます。

  2. 上部のツールバーの​製品​に移動し、左のパネルから、Adobe Analytics - <your-tenant-id>​を選択します。

  3. 製品プロファイル​を選択して、表示されるリストから必要なワークスペースを選択します(例:「デフォルトのワークスペース」)。

  4. API 資格情報​を選択して、必要な統合設定を選択します。

  5. 製品の役割​として、オブザーバー​の代わりに​編集者​を選択します。

Adobe Developer Console 統合プロジェクト用に保存された詳細

Adobe Developer プロジェクトコンソールで、すべての統合プロジェクトのリストを表示できます。

特定のプロジェクトエントリを選択して、設定の詳細を表示します。次のものが含まれます。

  • プロジェクトの概要
  • Insights
  • 資格情報
    • サービスアカウント(JWT)
      • 資格情報の詳細
      • JWT の生成
  • API
    • 例:Adobe Analytics

これらの一部では、AEM で Adobe Analytics の統合を完了する必要があります。

AEM での IMS 設定の完了

AEM に戻り、Analytics の統合プロジェクトから必要な値を追加して、IMS 設定を完了できます。

  1. AEM で IMS 設定を開くに戻ります。

  2. 次へ」を選択します。

  3. ここで、Adobe Developer Console 統合プロジェクト用に保存された詳細を使用できます。

    AEM IMS 設定の詳細

  4. 作成」で確定します。

  5. Adobe Analytics の設定が AEM コンソールに表示されます。

    IMS 設定

IMS 設定の確認

設定が期待どおりに動作していることを確認するには:

  1. 次を開きます。

    • https://localhost<port>/libs/cq/adobeims-configuration/content/configurations.html

    次に例を示します。

    • https://localhost:4502/libs/cq/adobeims-configuration/content/configurations.html
  2. 設定を選択します。

  3. ツールバーから​ヘルスチェック​を選択し、次に​チェック​を選択します。

    IMS 設定 - ヘルスチェック

  4. 成功すると、確認メッセージが表示されます。

Adobe Analytics Cloud Service の設定

これで、Cloud Service の設定を参照して Analytics Standard API を使用できるようになりました。

  1. ツール​メニューを開きます。次に、クラウドサービス​セクション内で、従来のクラウドサービス​を選択します。

  2. Adobe Analytics までスクロールダウンし、「今すぐ設定」を選択します。

    設定の作成​ダイアログが開きます。

  3. タイトル​と、必要に応じて​名前​を入力します(空白の場合、タイトルから生成されます)。

    また、必要なテンプレートを選択することもできます(複数のテンプレートを使用できる場合)。

  4. 作成」で確認します。

    コンポーネントの編集​ダイアログが開きます。

  5. Analytics 設定」タブに詳細を入力します。

    • 認証:IMS

    • IMS 設定:IMS 設定の名前を選択します。

  6. Analytics に接続」をクリックして、Adobe Analytics との接続を初期化します。

    接続に成功すると、「接続に成功しました」というメッセージが表示されます。

  7. メッセージの「OK」を選択します。

  8. 必要に応じて他のパラメーターを入力し、その後、ダイアログで「OK」をクリックして設定を確認します。

  9. これで、Analytics フレームワークの追加に進んで、Adobe Analytics に送信するパラメーターを設定できます。

このページ