Adobe I/O を使用した Adobe Target との統合

Target Standard APIを使用してAEMとAdobe Targetを統合するには、Adobe IMS(Identity Management System)とAdobe I/Oの設定が必要です。

メモ

Adobe Target Standard APIのサポートは、AEM 6.5で新たに追加されました。Target Standard APIはIMS認証を使用します。

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

APIの選択は、AEM/Targetの統合に使用される認証方法によって実行されます。
テナントIDとクライアントコードの節も参照してください。

前提条件

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

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

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

    • これにより、特定の開発者に対し、開発内での統合を有効にする権限をAdobe I/Oできます。
    • 詳しくは、開発者の管理を参照してください。

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

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

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

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

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

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

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

  6. 証明書を作成​して確定します。

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

    注意

    この設定は開いたままにしておきます。 AEMでIMS設定を完了すると、再度必要になります。

Adobe TargetとAEMの統合のためのAdobe I/Oの設定

AEMが使用するAdobe I/Oプロジェクト(統合)をAdobe Targetと作成し、必要な権限を割り当てる必要があります。

プロジェクトの作成

Adobe I/Oコンソールを開き、AEMが使用するAdobe TargetとのI/Oプロジェクトを作成します。

メモ

Adobe I/Oチュートリアルも参照してください。

  1. プロジェクトのAdobe I/Oコンソールを開きます。

    https://console.adobe.io/projects

  2. 既に存在するすべてのプロジェクトが表示されます。 「新しいプロジェクトを作成」を選択します。場所と使用方法は次の条件によって異なります。

    • まだプロジェクトがない場合は、新しいプロジェクトを作成​は中央、下に配置されます。

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

    • 既に既存のプロジェクトがある場合は、それらが一覧表示され、新しいプロジェクトを作成​が右上に表示されます。

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

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

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

    メモ

    Adobe Targetを購読しているが、リストに表示されない場合は、前提条件を確認してください。

  5. 公開鍵​をアップロードし、完了したら、「次 」を続行します。

  6. 資格情報を確認し、次へ​を続行します。

  7. 必要な製品プロファイルを選択し、「設定済みAPIを保存」で続行します。

    メモ

    と共に表示される製品プロファイルは、以下の条件によって異なります。

    • Adobe Target Standard — デフォルトのワークスペース​のみ使用可能
    • Adobe Target Premium — 使用可能なすべてのワークスペースが次のように表示されます

  8. 作成が確認されます。

統合への権限の割り当て

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

  1. Adobe Admin Console​を開きます。

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

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

  4. 統合」を選択し、必要な統合設定を選択します。

  5. ​製品ロール​としてエディター​を選択します。監視者​の代わりに。

Adobe I/O統合プロジェクト用に保存される詳細

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

表示(特定のプロジェクトエントリの右側)を選択して、設定に関する詳細を表示します。 有効なタイプには以下が含まれます。

  • プロジェクトの概要
  • インサイト
  • 秘密鍵証明書
    • サービスアカウント(JWT)
      • 資格情報の詳細
      • JWTを生成
  • API
    • 例: Adobe Target

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

AEMでのIMS設定の完了

AEMに戻ると、TargetのAdobe I/O統合から必要な値を追加して、IMS設定を完了できます。

  1. AEM🔗で開いているIMS設定に戻ります。

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

  3. ここでは、Adobe I/O🔗のの詳細を使用できます。

    • タイトル:テキスト。
    • 認証サーバー:下の例のように、下の「 "aud" Payload」セクシ ​ョンの行からこれをコピー&ペ "https://ims-na1.adobelogin.com" ーストします。
    • APIキー:Targetの統合の「概要」セク 🔗 ションからAdobe I/Oをコピーします。
    • クライアント秘密鍵:TargetのAdobe I/O統合の「 🔗 概要」セクションでこれを生成し、
    • ペイロード:TargetのAdobe I/O統合の「 JWTを生 成」セクションからコピーします。

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

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

IMS設定の確認

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

  1. 次を開きます::

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

    例えば、次の操作が可能です。

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

  3. ツールバーの「ヘルスチェック」を選択し、「チェック」を選択します。

  4. 成功した場合は、次のメッセージが表示されます。

Adobe TargetCloud Serviceの設定

設定は、Target Standard APIを使用するCloud Service向けに参照できるようになりました。

  1. ツール​メニューを開きます。 次に、「Cloud Services」セクションで、「レガシーCloud Services」を選択します。

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

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

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

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

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

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

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

    • 認証:IMS

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

      メモ

      IMSの場合、この値はTarget自体から取得する必要があります。 Targetにログインし、URLからテナントIDを抽出できます。

      例えば、URLが次のような場合、

      https://experience.adobe.com/#/@yourtenantid/target/activities

      次に、yourtenantidを使用します。

    • クライアントコード:テナントIDとク ライアントコードの節を参照し てください。

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

    • APIタイプ:REST

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

    • 正確なターゲット設定を使用する:デフォルトでは、このチェックボックスはオンになっています。オンにすると、クラウドサービス設定はコンテンツが読み込まれるまでコンテキストの読み込みを待機します。続きのメモを確認してください。

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

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

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

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

    メモ

    Target Classic APIを使用するCloud Serviceの設定は廃止されま した(「Adobe Recommendations設定」タブを使用)。

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

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

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

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

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

Adobe Experience Manager 6.5.8.0では、Target設定ウィンドウに「Client Code」フィールドが追加されていました。

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

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

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

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

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

メモ

既存の Target 設定を変更する場合:

  1. テナント ID を再入力します。
  2. Target に再接続します。
  3. 設定を保存します。

このページ