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/ターゲット統合に使用される認証方式によって決定されます。
この手順を開始する前に、次の手順を実行します。
Adobe サポートは、次の目的でアカウントをプロビジョニングする必要があります。
組織のシステム管理者は、Admin Consoleを使用して、組織内の必要な開発者を関連する製品プロファイルに追加する必要があります。
設定の最初の段階は、AEMでIMS設定を作成し、公開鍵を生成することです。
AEMで、ツールメニューを開きます。
「セキュリティ」セクションで、「AdobeIMS設定」を選択します。
「作成」を選択して、AdobeIMSテクニカルアカウント設定を開きます。
「クラウド設定」の下のドロップダウンを使用して、「Adobe Target」を選択します。
新しい証明書を作成をアクティブ化し、新しいエイリアスを入力します。
証明書の作成で確認します。
「Download(またはDownload Public Key)」を選択してファイルをローカルドライブにダウンロードし、AEMとのAdobe Target統合用にAdobe I/Oを設定する際に使用できるようにします。
この設定を開いたままにしておくと、AEMでIMS設定を完了したときに、再び必要になります。
AEMで使用するAdobe TargetとのAdobe I/Oプロジェクト(統合)を作成し、必要な権限を割り当てる必要があります。
Adobe I/Oコンソールを開き、AEMで使用するAdobe TargetのI/Oプロジェクトを作成します。
Adobe I/Oのチュートリアルも参照してください。
プロジェクト用のAdobe I/Oコンソールを開く:
自分が所有しているプロジェクトが表示されます。 「新しいプロジェクトを作成」を選択します。場所と使用方法は次のとおりです。
まだプロジェクトがない場合は、新しいプロジェクトを作成は中央、下に配置されます。
既に既存のプロジェクトがある場合は、これらが一覧表示され、新しいプロジェクトを作成が右上に表示されます。
プロジェクト追加にを選択し、次にAPIを選択します。
Adobe Targetを選択し、次へ:
Adobe Targetを購読しているが、リストに表示されていない場合は、前提条件を確認する必要があります。
公開鍵をアップロードし、完了したら 次へ:
秘密鍵証明書を確認し、次へに進みます。
必要な製品プロファイルを選択し、設定済みAPIの保存に進みます。
に表示される製品プロファイルは、次の項目があるかどうかによって異なります。
作成が確認される。
次に、必要な権限を統合に割り当てる必要があります。
Adobe Admin Consoleを開きます。
製品(上部のツールバー)に移動し、Adobe Target- <your-tenant-id>(左のパネル)を選択します。
「製品のプロファイル」を選択し、表示されるリストから必要なワークスペースを選択します。 例えば、デフォルトのワークスペースです。
「統合」を選択し、必要な統合設定を選択します。
エディターを製品の役割として選択します。オブザーバーの代わりに。
Adobe I/Oプロジェクトコンソールから、すべての統合プロジェクトのリストを確認できます。
表示(特定のプロジェクトエントリの右側)を選択して、設定に関する詳細を表示します。 有効なタイプには以下が含まれます。
これらの一部は、AEMでのターゲット用にAdobe I/O統合を完了する必要があります。
AEMに戻ると、ターゲットに必要な値をAdobe I/O統合から追加して、IMS設定を完了できます。
AEM](#configuring-an-ims-configuration-generating-a-public-key)で開いている[IMS設定に戻ります。
「次へ」を選択します。
ここでは、Adobe I/O](#details-stored-for-the-adobe-io-integration-project)の[詳細を使用できます。
"aud"
例のように、下の Payloadセクションの "https://ims-na1.adobelogin.com"
行からこれをコピー&ペーストします。作成で確認します。
Adobe Target設定がAEMコンソールに表示されます。
設定が期待どおりに動作していることを確認するには:
次のファイルを開きます。
https://localhost<port>/libs/cq/adobeims-configuration/content/configurations.html
次に例を示します。
https://localhost:4502/libs/cq/adobeims-configuration/content/configurations.html
設定を選択します。
ツールバーから「ヘルスをチェック」を選択し、続けて「チェック」を選択します。
成功すると、次のメッセージが表示されます。
Target Standard APIを使用するCloud Serviceに対して、設定を参照できるようになりました。
ツールメニューを開きます。 次に、Cloud Servicesセクション内で、レガシーCloud Servicesを選択します。
Adobe Targetまで下にスクロールし、今すぐ設定を選択します。
設定を作成ダイアログが開きます。
タイトルを入力し、必要に応じて名前を入力します(空白の場合は、タイトルから生成されます)。
また、必要なテンプレートを選択することもできます(複数のテンプレートが使用可能な場合)。
作成で確認します。
コンポーネントを編集ダイアログが開きます。
「Adobe Target設定」タブに詳細を入力します。
認証:IMS
テナントID:adobeIMSテナントID
IMSの場合、この値はターゲット自体から取得する必要があります。 ターゲットにログインし、URLからテナントIDを抽出できます。
例えば、URLが次の場合、
https://experience.adobe.com/#/@yourtenantid/target/activities
その場合はyourtenantid
を使用します。
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 を選択した場合にのみ表示されます。
次に例を示します。
「ターゲットに接続」をクリックして、Adobe Targetとの接続を初期化します。
接続に成功すると、「接続に成功しました」というメッセージが表示されます。
メッセージで「OK」を選択し、次に設定を確認するダイアログで「OK」を選択します。
これで、ターゲットフレームワークの追加に進み、ターゲットに送信するContextHubまたはClientContextのパラメーターを設定できます。 これは、AEMエクスペリエンスフラグメントをターゲットに書き出す場合には必要でない場合があります。