IMS を使用した Adobe Target との統合 integration-with-adobe-target-using-ims
Target Standard API を介して AEM と Adobe Target を統合するには、Adobe Developer Console を使用して Adobe IMS(Identity Management System)を設定する必要があります。
「テナント ID とクライアントコード 」の節も参照してください。
前提条件 prerequisites
この手順を開始する前に、以下を実行します。
IMS 設定の指定 - 公開鍵の生成 configuring-an-ims-configuration-generating-a-public-key
設定の最初の段階は、AEMで IMS 設定を作成し、公開鍵を生成することです。
-
AEM で、ツール メニューを開きます。
-
「セキュリティ」セクションで、「Adobe IMS 設定」を選択します。
-
「作成」を選択して、Adobe IMS テクニカルアカウント設定 を開きます。
-
クラウド設定 の下のドロップダウンを使用して、「Adobe Target」を選択します。
-
新しい証明書の作成 をアクティブにして、新しいエイリアスを入力します。
-
「証明書の作成」で確認します。
-
「ダウンロード」(または「公開鍵のダウンロード」)を選択してファイルをローカルドライブにダウンロードし、Adobe Target と AEM の統合に向けて IMS を設定する際に使用できるようにします。
note caution CAUTION この設定は、AEM で IMS 設定を完了する際に再び必要になるため、開いたままにしてください。
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 を開きます。
-
Adobe Developer Console を開いて、プロジェクトを表示します。
-
自分が持つプロジェクトが表示されます。「新規プロジェクトを作成」を選択します。場所と使用方法は、次のとおりです。
-
まだプロジェクトがない場合は、「新規プロジェクトを作成」が中央の下に表示されます。
-
既存のプロジェクトがある場合は、それらのプロジェクトがリストされ、「新規プロジェクトを作成」は右上に表示されます。
-
-
プロジェクトに追加 を選択し、続いて API を選択します。
-
Adobe Target を選択し、続いて 次へ を選択します。
note note NOTE Adobe Target を購読しているが、リストに表示されない場合は、 前提条件を確認する必要があります。 -
公開鍵 をアップロードして、完了したら「次へ」をクリックして進みます。
-
資格情報を確認して、「次へ」をクリックして進みます。
-
必要な製品プロファイルを選択して、設定済み API を保存 に進みます。
note note NOTE で表示される製品プロファイルは、次のものがあるかどうかによって異なります。 - Adobe Target Standard - デフォルトのワークスペース のみ使用可能です
- Adobe Target Premium - 以下に示すように、使用可能なすべてのワークスペースが一覧表示されます
-
作成が確定されました。
統合への権限の割り当て assigning-privileges-to-the-integration
次に、必要な権限を統合に割り当てます。
-
Adobe Admin Console を開きます。
-
製品 (上部のツールバー)に移動し、Adobe Target - <your-tenant-id>(左のパネルから)を選択します。
-
製品プロファイル を選択して、表示されるリストから必要なワークスペースを選択します(例:「デフォルトのワークスペース」)。
-
API 資格情報 を選択して、必要な統合設定を選択します。
-
製品の役割 として、オブザーバー の代わりに 編集者 を選択します。
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 設定を完了できます。
-
AEM で IMS 設定を開くに戻ります。
-
「次へ」を選択します。
-
ここで、Adobe Developer Console のプロジェクト設定の詳細を使用できます。
- タイトル:テキスト。
- 認証サーバー:以下の ペイロード セクションの
aud
行からこれをコピーして貼り付けます。例:以下の例ではhttps://ims-na1.adobelogin.com
- API キー:これを「概要」セクションからコピーします
- クライアント秘密鍵:これを「概要」セクションで生成してコピーします
- ペイロード:これを「JWT を生成」セクションからコピーします
-
「作成」で確定します。
-
Adobe Target の設定が AEM コンソールに表示されます。
IMS 設定の確認 confirming-the-ims-configuration
設定が期待どおりに動作していることを確認するには:
-
次を開きます。
https://localhost<port>/libs/cq/adobeims-configuration/content/configurations.html
例:
https://localhost:4502/libs/cq/adobeims-configuration/content/configurations.html
-
設定を選択します。
-
ツールバーから ヘルスチェック を選択し、次に チェック を選択します。
-
成功すると、次のメッセージが表示されます。
Adobe Target Cloud Service の設定 configuring-the-adobe-target-cloud-service
これで、Cloud Service の設定を参照して Target Standard API を使用できるようになりました。
-
ツール メニューを開きます。次に、クラウドサービス セクション内で、従来のクラウドサービス を選択します。
-
Adobe Target までスクロールダウンし、「今すぐ設定」を選択します。
設定を作成 ダイアログボックスが開きます。
-
「タイトル」と、必要に応じて「名前」を入力します(空白の場合、タイトルから生成されます)。
また、必要なテンプレートを選択することもできます(複数のテンプレートを使用できる場合)。
-
「作成」で確認します。
コンポーネントを編集 ダイアログボックスが開きます。
-
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 設定」タブを使用します)。 -
-
「Target に接続」をクリックして、Adobe Target との接続を初期化します。
接続に成功すると、「接続に成功しました」というメッセージが表示されます。
-
メッセージで「OK」を選択し、ダイアログボックスで「OK」を選択すると、設定を確認できます。
-
これで、Target フレームワークの追加に進み、Target に送信する ContextHub または ClientContext パラメーターを設定できます。AEM エクスペリエンスフラグメントを Target に書き出す場合は、この設定が不要な場合があります。
テナント ID と クライアントコード tenant-client
Adobe Experience Manager 6.5.8.0 では、Target 設定ウィンドウに「クライアントコード」フィールドが追加されました。
「テナント ID」フィールドおよび「クライアントコード」フィールドを設定する場合は、次の点に注意してください。
- ほとんどのお客様の場合、テナント ID とクライアントコードは同じです。つまり、両方のフィールドに同じ情報が含まれ、フィールドは同じになります。両方のフィールドにテナント ID を必ず入力してください。
- 従来の目的では、テナント ID とクライアントコードのフィールドに異なる値を入力することもできます。
どちらの場合も、次の点に注意してください。
- デフォルトでは、「クライアントコード」(最初に追加した場合)も「テナント ID」フィールドに自動的にコピーされます。
- オプションで、デフォルトのテナント ID セットを変更できます。
- これにより、バックエンドから Target への呼び出しはテナント ID に基づいて行われ、クライアントサイドから Target への呼び出しはクライアントコードに基づいて行われます。
前述のように、AEM 6.5 では最初のケースが最も一般的です。いずれにせよ、両方 のフィールドに、要件に応じた正しい情報が含まれていることを確認してください。
- テナント ID を再入力します。
- Target に再接続します。
- 設定を保存します。