IMS を使用した Adobe Analytics との統合 integration-with-adobe-analytics-using-ims

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

NOTE
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 への移行でも参照できます。

前提条件 prerequisites

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

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

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

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

IMS 設定の指定 - 公開鍵の生成 configuring-an-ims-configuration-generating-a-public-key

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

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

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

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

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

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

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

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

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

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

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

Adobe Analytics と AEM の統合に向けた IMS の設定 configuring-ims-for-adobe-analytics-integration-with-aem

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

プロジェクトの作成 creating-the-project

AEM で使用できる Adobe Analytics とのプロジェクトを作成するには、Adobe Developer Console を開きます。

CAUTION
現在、アドビでは Adobe Developer Console の サービスアカウント(JWT) ​資格情報タイプのみをサポートします。
OAuth サーバー間 ​資格情報タイプは使用しないでください。これは今後サポートされる予定です。
  1. Adobe Developer Console を開いて、プロジェクトを表示します。

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

  2. 自分が持つプロジェクトが表示されます。「新規プロジェクトを作成」を選択します。場所と使用方法は、次の条件によって異なります。

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

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

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

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

    API を追加

  5. 認証のタイプとして​ サービスアカウント(JWT) ​を選択し、「次へ」で続行します。

    認証のタイプを選択

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

    公開鍵をアップロード

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

    資格情報を確認

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

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

  9. 設定が確認されました。

統合への権限の割り当て assigning-privileges-to-the-integration

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

  1. Adobe Admin Console を開きます。

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

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

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

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

Adobe Developer Console 統合プロジェクト用に保存された詳細 details-stored-for-the-ims-integration-project

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

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

  • プロジェクトの概要

  • Insights

  • 資格情報

    • サービスアカウント(JWT)

      • 資格情報の詳細
      • JWT の生成
  • API

    • 例:Adobe Analytics

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

AEM での IMS 設定の完了 completing-the-ims-configuration-in-aem

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

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

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

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

    AEM IMS 設定の詳細

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

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

    IMS 設定

IMS 設定の確認 confirming-the-ims-configuration

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

  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 の設定 configuring-the-adobe-analytics-cloud-service

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

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

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

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

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

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

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

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

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

    • 認証:IMS

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

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

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

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

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

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

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2