エクスペリエンスフラグメントのAdobe Targetへの書き出し

注意

AEMエクスペリエンスフラグメントは、Adobe Targetのデフォルトのワークスペースに書き出されます。
AEMは、 Adobe Targetとの統合.

書き出し可能エクスペリエンスフラグメント(Adobe Experience Manager as a Cloud Service(AEM) で作成、Adobe Target(Target) に対して ) 書き出したエクスペリエンスフラグメントは、Target アクティビティのオファーとして使用し、幅広くエクスペリエンスをテストおよびパーソナライズできます。

エクスペリエンスフラグメントをAdobe Targetに書き出すには、次の 3 つのオプションを使用できます。

HTML（デフォルト）:Web およびハイブリッドコンテンツ配信のサポート
JSON:ヘッドレスコンテンツ配信のサポート
HTML と JSON

AEMエクスペリエンスフラグメントをAdobe Targetに書き出すインスタンスを準備するには、次の操作が必要です。

Adobe Target と統合します。
クラウド設定を追加
レガシー設定の追加

その後、次の操作を実行できます。

エクスペリエンスフラグメントをAdobe Targetに書き出す
Adobe Targetでエクスペリエンスフラグメントを使用する
また、既にAdobe Targetに書き出されたエクスペリエンスフラグメントを削除する

エクスペリエンスフラグメントは、Adobe Targetのデフォルトのワークスペースに書き出すことも、Adobe Targetのユーザー定義のワークスペースに書き出すこともできます。

メモ

Adobe Targetワークスペースは、Adobe Target自体には存在しません。これらはAdobe IMS(Identity Management System) で定義および管理され、Adobe開発者コンソールを使用してソリューション全体で使用するために選択されます。

メモ

Adobe Targetのワークスペースを使用して、組織（グループ）のメンバーに対し、この組織のオファーとアクティビティの作成と管理のみを許可できます。他のユーザーへのアクセス権を付与することなく例えば、グローバルに関係する国固有の組織などです。

メモ

詳しくは、以下を参照してください。

前提条件

様々なアクションが必要です。

必要な操作 AEMとAdobe Targetの統合.
エクスペリエンスフラグメントはAEMオーサーインスタンスから書き出されるので、次の操作を行う必要があります。 AEM Link Externalizer を設定オーサーインスタンスを使用して、エクスペリエンスフラグメント内の参照が Web 配信用に外部化されていることを確認します。

メモ

デフォルトでカバーされていないリンクの書き換えでは、Experience Fragment Link Rewriter Provider が利用可能です。これにより、インスタンスに合わせてカスタマイズされたルールを開発できます。

クラウド設定を追加

フラグメントを書き出す前に、Adobe Target 用のクラウド設定をフラグメント、またはフォルダーに追加する必要があります。また、次のことも可能です。

エクスポートに使用するフォーマットオプションを指定します
宛先としての Target ワークスペースの選択
エクスペリエンスフラグメント内の参照を書き換える externalizer ドメインを選択します（オプション）

必要なオプションは、必要なフォルダーやフラグメントのページのプロパティで選択できます。仕様は必要に応じて継承されます。

エクスペリエンスフラグメントコンソールに移動します。
適切なフォルダーまたはフラグメントのページのプロパティを開きます。

メモ

クラウド設定をエクスペリエンスフラグメントの親フォルダーに追加すると、設定はすべての子に継承されます。

クラウド設定をエクスペリエンスフラグメント自体に追加すると、設定はすべての変更によって継承されます。
「クラウドサービス」タブを選択します。
の下 Cloud Service設定を選択します。 Adobe Target 」を選択します。

メモ

エクスペリエンスフラグメントオファーの JSON 形式はカスタマイズできます。これをおこなうには、顧客のエクスペリエンスフラグメントコンポーネントを定義し、そのプロパティを Sling Model コンポーネントに書き出す方法に注釈を付けます。

次のコアコンポーネントを参照してください。コアコンポーネント — エクスペリエンスフラグメント
の下 Adobe Target 選択：
- 適切な設定
- 必須フォーマットオプション
- Adobe Target
- 必要に応じて、Externalizer ドメインを設定します。
注意

Externalizer ドメインはオプションです。

AEM Externalizer は、書き出されるコンテンツが特定の公開ドメイン。詳しくは、 AEM Link Externalizer の設定.

また、Externalizer ドメインは、Target に送信されるエクスペリエンスフラグメントのコンテンツにのみ関連し、「オファーコンテンツを表示」などのメタデータには関連しません。

例えば、フォルダーの場合：
保存して閉じます。

レガシー設定の追加

重要

新しいレガシー設定の追加は、エクスペリエンスフラグメントの書き出しでのみサポートされる特殊なシナリオです。

後クラウド設定の追加 Launch by Adobeを使用するには、最初にAEMをAdobe Targetと統合する場合、従来の設定を使用してAdobe Targetと手動で統合する必要もあります。

Target クラウド設定の作成

AEM が Adobe Target とやり取りできるようにするには、Target クラウド設定を作成します。この設定を作成するために、Adobe Target のクライアントコードとユーザー資格情報を入力します。

Target クラウド設定は複数の AEM キャンペーンと関連付けることができるので、設定は一度だけ作成します。Adobe Target クライアントコードが複数ある場合は、クライアントコードごとにひとつ設定を作成します。

Adobe Target からセグメントを同期するように、クラウド設定を指定できます。同期を有効にした場合は、クラウド設定が保存されるとすぐに、バックグラウンドでセグメントが Target から読み込まれます。

次の手順を実行して、AEM に Target クラウド設定を作成します。

に移動します。 従来のCloud Services 経由 AEMロゴ > ツール > Cloud Services > 従来のCloud Services.
例：(http://localhost:4502/libs/cq/core/content/tools/cloudservices.html)

この Adobe Experience Cloud 概要ページが開きます。
内 Adobe Target セクションで、 今すぐ設定.
内 設定を作成 ダイアログ：
1. 設定に タイトル.
2. を選択します。 Adobe Target Configuration テンプレート。
3. 「作成」をクリックします。

これで、編集する新しい設定を選択できます。

編集ダイアログが開きます。
内 Adobe Target Settings ダイアログで、これらのプロパティの値を指定します。
- 認証:デフォルトは IMS です（ユーザー資格情報は廃止されました）
- クライアントコード：Target アカウントのクライアントコード
- テナント ID:テナント ID
- IMS 設定:ドロップダウンリストから必要な設定を選択します。
- API タイプ:デフォルトは REST です（XML は非推奨です）
- A4T Analytics クラウド設定：ターゲットアクティビティの目標と指標に使用する Analytics クラウド設定。これは、コンテンツをターゲット化するときに、Adobe Analytics をレポートソースとして使用している場合に必要です。
- 正確なターゲット設定を使用：デフォルトでは、このチェックボックスはオンになっています。オンにすると、クラウドサービス設定はコンテンツが読み込まれるまでコンテキストの読み込みを待機します。続きのメモを確認してください。
- Adobe Targetからセグメントを同期： このオプションを選択すると、Target で定義されたセグメントをダウンロードしてAEMで使用することができます。「API のタイプ」プロパティが REST のときは、インラインのセグメントがサポートされておらず、常に Target からセグメントを使用する必要があるので、このオプションをオンにする必要があります（AEM の用語「セグメント」は、Target の「オーディエンス」と同じです）。
- クライアントライブラリ： デフォルトは AT.js です（mbox.js は非推奨です）。
  メモ
  ターゲットライブラリファイル AT.JSは、一般的な Web 実装とシングルページアプリケーションの両方のために設計された、Adobe Targetの新しい実装ライブラリです。
  
  mbox.js は廃止され、後の段階で削除されます。
  
  mbox.js の代わりに AT.js をクライアントライブラリとして使用することをお勧めします。
  
  AT.js は、mbox.js ライブラリと比較して、いくつかの点で改善されています。
  - Web 実装のページ読み込み時間が改善されています。
  - セキュリティが改善されています。
  - 単一ページアプリケーションの実装オプションが改善されています。
  - target.js に含まれていたコンポーネントが AT.js にも含まれているので、target.js への呼び出しがなくなりました。
  クライアントライブラリドロップダウンメニューでは、AT.js または mbox.js を選択できます。
- Tag Management System を使用してクライアントライブラリを配信 - Launch または他のタグ管理システム（または、廃止される DTM）のクライアントライブラリを使用する場合は、このオプションをAdobeします。
- カスタムの AT.js:を参照して、カスタム AT.js をアップロードします。デフォルトのライブラリを使用する場合は空白のままにします。
  
  メモ
  
  デフォルトでは、Adobe Target 設定ウィザードをオプトインすると、正確なターゲット設定が有効になります。
  
  正確なターゲット設定を有効にすると、クラウドサービス設定はコンテンツが読み込まれるまでコンテキストの読み込みを待機します。結果として、正確なターゲット設定を有効にすると、パフォーマンスの面ではコンテンツの読み込みに数ミリ秒の遅延が発生することがあります。
  
  正確なターゲット設定はオーサーインスタンスでは常に有効になっています。ただし、パブリッシュインスタンスではクラウドサービス設定（http://localhost:4502/etc/cloudservices.html）の正確なターゲット設定の横にあるチェックマークをオフにすることで、正確なターゲット設定をグローバルにオフにできます。また、クラウドサービス設定の設定に関係なく、個々のコンポーネントの正確なターゲット設定のオンとオフを切り替えることもできます。
  
  この設定を変更しても、作成済み******の対象コンポーネントには影響しません。これらのコンポーネントには直接変更を加える必要があります。
「Adobe Target に接続」をクリックして、Target の接続を開始します。接続に成功すると、「接続に成功しました」というメッセージが表示されます。メッセージの「OK」をクリックして、ダイアログの「OK」をクリックします。

Target に接続できない場合は、トラブルシューティングのセクションを参照してください。

Target フレームワークの追加

Target クラウド設定を設定したら、Target フレームワークを追加します。このフレームワークは、使用可能な ContextHub コンポーネント。 Target はこのパラメーターを使用して、現在のコンテキストに該当するセグメントを判別します。

ひとつの Target 設定に対して複数のフレームワークを作成できます。複数のフレームワークは、Web サイトの異なるセクション向けの異なるセットのパラメーターを Target に送信する必要があるときに便利です。送信する必要があるパラメーターのセットごとにフレームワークを作成します。Web サイトの各セクションに該当するフレームワークを関連付けます。Web ページでは、一度に 1 つのフレームワークのみを使用できます。

Target 設定ページで、 + （プラス記号）をクリックします。
フレームワークを作成ダイアログで、 タイトルを選択し、 Adobe Target Frameworkをクリックし、作成.

フレームワークページが表示されます。サイドキックは、 ContextHub 地図を作れる
マッピングに使用するデータを表す ClientContext コンポーネントをドロップターゲットにドラッグします。または、ContextHub ストアコンポーネントをフレームワークにドラッグします。

メモ

マッピングするときに、パラメーターは単純な文字列を介して mbox に渡されます。ContextHub から配列をマッピングすることはできません。

例えば、 プロファイルデータ Target キャンペーンを制御するためのサイト訪問者について、 プロファイルデータ コンポーネントをページに追加します。 Target パラメーターへのマッピングに使用できるプロファイルデータ変数が表示されます。
該当する列の「共有」チェックボックスをオンにして、Target システムで表示する変数を選択します。

メモ

パラメーターの同期は、AEM から Adobe Target への一方向のみです。

フレームワークが作成されます。フレームワークをパブリッシュインスタンスにレプリケートするには、サイドキックで「フレームワークをアクティベート」オプションを使用します。