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

Target Standard APIを介してAEMをAdobe Targetと統合するには、AdobeIMS(Identity Managementシステム)とAdobe I/Oの設定が必要です。

メモ

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

AEMでのAdobe TargetクラシックAPIの使用は、後方互換性を維持するために引き続きサポートされています。 ターゲットクラシックAPIは、ユーザー資格情報認証を使用します。

APIの選択は、AEM/ターゲット統合に使用される認証方式によって決定されます。
テナントID」と「クライアントコード」も参照してください。

前提条件

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

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

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

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

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

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

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

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

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

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

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

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

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

    注意

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

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

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

プロジェクトの作成

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標準 — デフォルトのワークスペース​のみ使用可能
    • Adobe Targetプレミアム — 使用可能なすべてのワークスペースが、次のように表示されます。

  8. 作成が確認される。

統合への権限の割り当て

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

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

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

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

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

  5. エディター​を​製品の役割​として選択します。オブザーバー​の代わりに。

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

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

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

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

これらの一部は、AEMでのターゲット用にAdobe I/O統合を完了する必要があります。

AEMでのIMS設定の完了

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

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

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

  3. Adobe I/O🔗の詳細を使用するには、次の手順に従います。

    • タイトル:テキスト。
    • 認証サーバー:下の "aud" 例のように、下の ​Payloadセクションの "https://ims-na1.adobelogin.com" 行からこれをコピー&ペーストします。
    • APIキー:ターゲットのために、Adobe I/O統合の「 🔗 概要」セクションからこれをコピーします。
    • クライアントシークレット:ターゲット用のAdobe I/O統合の 🔗 概要セクションでこれを生成し、
    • ペイロード:ターゲット用のAdobe I/O統合の Generate 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:AdobeIMSテナントID。「テナントID」と「クライアントコード」も参照してください。

      メモ

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

      例えば、URLが次の場合、

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

      その場合はyourtenantidを使用します。

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

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

    • APIタイプ:REST

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

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

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

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

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

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

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

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

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

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

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

Adobe Experience Manager6.5.8.0では、「クライアントコード」フィールドがターゲット設定ウィンドウに追加されていました。

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

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

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

  • デフォルトでは、(最初に追加された場合は)クライアントコードもテナントIDフィールドに自動的にコピーされます。
  • デフォルトのテナントIDセットを変更するオプションがあります。
  • したがって、ターゲットへのバックエンド呼び出しはテナントIDに基づき、ターゲットへのクライアント側呼び出しはクライアントコードに基づきます。

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

メモ

既存のターゲット設定を変更する場合:

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

このページ

Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now