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

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

NOTE
Adobe Target Standard API のサポートは、AEM 6.5 の新機能です。Target Standard API は IMS 認証を使用します。
AEM での Adobe Target Classic API の使用は、後方互換性のために引き続きサポートされています。Target Classic API はユーザーの資格情報認証を使用します
API の選択は、AEM/Target 統合に使用される認証方法によって決定されます。
テナント ID とクライアントコード 」の節も参照してください。

前提条件 prerequisites

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

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

    • アドビコンソール
    • Adobe 開発者コンソール
    • Adobe Target と
    • 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 Target」を選択します。

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

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

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

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

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

    Adobe I/O に証明書を追加する情報メッセージ

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

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

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

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

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

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

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

    • まだプロジェクトがない場合は、「新規プロジェクトを作成」が中央の下に表示されます。

      新規プロジェクトの作成 - 最初のプロジェクト

    • 既存のプロジェクトがある場合は、それらのプロジェクトがリストされ、「新規プロジェクトを作成」は右上に表示されます。

      新規プロジェクトの作成 - 複数のプロジェクト

  3. プロジェクトに追加 ​を選択し、続いて API を選択します。

    Adobe Developer Console

  4. Adobe Target を選択し、続いて​ 次へ ​を選択します。

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

    「次へ」をクリック

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

    Developer Console を使用した統合の追加

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

    プロジェクトの作成

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

    note note
    NOTE
    で表示される製品プロファイルは、次のものがあるかどうかによって異なります。
    • Adobe Target Standard - デフォルトのワークスペース ​のみ使用可能です
    • Adobe Target Premium - 以下に示すように、使用可能なすべてのワークスペースが一覧表示されます

    追加する API の選択

  8. 作成が確定されました。

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

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

  1. Adobe Admin Console を開きます。

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

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

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

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

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

Adobe Developer Console - プロジェクトから、すべての統合プロジェクトのリストを表示できます。

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

  • プロジェクトの概要

  • Insights

  • 資格情報

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

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

    • 例:Adobe Target

これらの一部については、IMS に基づいて AEM で Adobe Target の統合を完了する必要があります。

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

AEM に戻り、Adobe Developer Console の Target 向け統合から必要な値を追加して、IMS 設定を完了できます。

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

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

  3. ここで、Adobe Developer Console のプロジェクト設定の詳細を使用できます。

    • タイトル:テキスト。
    • 認証サーバー:以下の​ ペイロード ​セクションの aud 行からこれをコピーして貼り付けます。例:以下の例では https://ims-na1.adobelogin.com
    • API キー:これを「概要」セクションからコピーします
    • クライアント秘密鍵:これを「概要」セクションで生成してコピーします
    • ペイロード:これを「JWT を生成」セクションからコピーします

    テクニカルアカウント設定

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

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

    Adobe 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. ツールバーから​ ヘルスチェック ​を選択し、次に​ チェック ​を選択します。

    Adobe IMS 設定

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

    設定の確認

Adobe Target Cloud Service の設定 configuring-the-adobe-target-cloud-service

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

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

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

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

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

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

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

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

  5. Adobe Target 設定 ​タブに詳細を入力します。

    • 認証:IMS

    • テナント ID:Adobe IMS テナント ID。テナント ID とクライアントコードセクションも参照してください。

      note note
      NOTE
      IMS の場合、この値は Target 自体から取得する必要があります。Target にログインし、URL からテナント ID を抽出できます。
      例えば、URL が次のような場合:
      https://experience.adobe.com/#/@yourtenantid/target/activities
      次に、yourtenantidを使用します。
    • クライアントコードテナント ID とクライアントコードセクションを参照してください。

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

    • API のタイプ:REST

    • A4T Analytics クラウド設定:ターゲットアクティビティの目標と指標に使用する Analytics Cloud 設定を選択します。これは、コンテンツをターゲット化するときに、Adobe Analytics をレポートソースとして使用している場合に必要です。クラウド設定が表示されない場合は、A4T Analytics Cloud の設定のメモを参照してください。

    • 正確なターゲティングの使用:デフォルトではこのチェックボックスはオンになっています。選択した場合、クラウドサービス設定は、コンテキストの読み込みを待ってからコンテンツを読み込みます。次のメモを参照してください。

    • Adobe Target からセグメントを同期:Target で定義されているセグメントをダウンロードして AEM で使用するには、このオプションをオンにします。API タイプのプロパティが REST の場合は、このオプションを選択します。インラインセグメントがサポートされず、常に Target のセグメントを使用する必要があるためです。(AEM の用語「セグメント」は、Target の「オーディエンス」と同じです。)

    • クライアントライブラリ:AT.js クライアントライブラリと mbox.js(非推奨)のどちらを使用するかを選択します。

    • タグ管理システムを使用したクライアントライブラリの配信:DTM(非推奨)、Adobe Launch またはその他のタグ管理システムを使用します。

    • カスタムの AT.js:タグ管理ボックスをオンにした場合またはデフォルトの AT.js を使用する場合は空にします。それ以外の場合は、カスタム AT.js をアップロードします。AT.js を選択した場合にのみ表示されます。

    note note
    NOTE
    Target Classic API を使用する Cloud Service の設定は廃止されました(「Adobe Recommendations 設定」タブを使用します)。
  6. Target に接続」をクリックして、Adobe Target との接続を初期化します。

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

  7. メッセージで「OK」を選択し、ダイアログボックスで「OK」を選択すると、設定を確認できます。

  8. これで、Target フレームワークの追加に進み、Target に送信する ContextHub または ClientContext パラメーターを設定できます。AEM エクスペリエンスフラグメントを Target に書き出す場合は、この設定が不要な場合があります。

テナント ID と クライアントコード tenant-client

Adobe Experience Manager 6.5.8.0 では、Target 設定ウィンドウに「クライアントコード」フィールドが追加されました。

「テナント ID」フィールドおよび「クライアントコード」フィールドを設定する場合は、次の点に注意してください。

  1. ほとんどのお客様の場合、テナント ID とクライアントコードは同じです。つまり、両方のフィールドに同じ情報が含まれ、フィールドは同じになります。両方のフィールドにテナント ID を必ず入力してください。
  2. 従来の目的では、テナント ID とクライアントコードのフィールドに異なる値を入力することもできます。

どちらの場合も、次の点に注意してください。

  • デフォルトでは、「クライアントコード」(最初に追加した場合)も「テナント ID」フィールドに自動的にコピーされます。
  • オプションで、デフォルトのテナント ID セットを変更できます。
  • これにより、バックエンドから Target への呼び出しはテナント ID に基づいて行われ、クライアントサイドから Target への呼び出しはクライアントコードに基づいて行われます。

前述のように、AEM 6.5 では最初のケースが最も一般的です。いずれにせよ、両方 ​のフィールドに、要件に応じた正しい情報が含まれていることを確認してください。

NOTE
既存の Target 設定を変更する場合:
  1. テナント ID を再入力します。
  2. Target に再接続します。
  3. 設定を保存します。
recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2