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

最終更新日: 2023-09-14
  • 作成対象:
  • Admin

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 Analytics の セキュリティ セクション、選択 Adobe IMS設定.

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

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

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

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

    Adobe IMSテクニカルアカウント設定ウィザード

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

    注意

    この設定は開いたままにしておきます。この設定は、次の場合に再び必要になります。 AEMでの IMS 設定の完了.

    キーをAdobe I/Oに追加するための情報ダイアログ

AEM との Adobe Analytics 統合用の IMS の設定

Adobe Developerコンソールを使用して、Adobe Analyticsでプロジェクト(統合)を作成し (AEMで使用するために )、必要な権限を割り当てます。

プロジェクトの作成

AEMで使用できるAdobe Analyticsを使用したプロジェクトを作成するには、Adobe Developerコンソールを開きます。

注意

現在、AdobeはAdobe Developerコンソールの サービスアカウント (JWT) 資格情報のタイプ。

次を使用しない OAuth サーバー間通信 秘密鍵証明書のタイプ。今後サポートされる予定です。

  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 までスクロールダウンし、「今すぐ設定」を選択します。

    The 設定を作成 ダイアログボックスが開きます。

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

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

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

    The コンポーネントを編集 ダイアログボックスが開きます。

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

    • 認証:IMS

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

  6. Adobe Analyticsとの接続を初期化するには、 Analytics に接続.

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

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

  8. 必要に応じて他のパラメーターを入力し、その後にを入力します。 OK をクリックして設定を確認できるようにします。

  9. 次に進むことができます: Analytics フレームワークの追加 Adobe Analyticsに送信するパラメーターを設定する場合。

このページ