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

注意

AEM エクスペリエンスフラグメントは、Adobe Target のデフォルトのワークスペースに書き出されます。
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 リライタープロバイダーが利用可能です。これにより、インスタンスに合わせてカスタマイズされたルールを開発できます。

クラウド設定の追加

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

書き出しに使用する形式オプションを指定する
Target ワークスペースを宛先として選択する
エクスペリエンスフラグメントに含まれる参照を書き換えるための Externalizer ドメインを選択する（オプション）

必要なオプションは、 ページのプロパティ 必要なフォルダー、フラグメント、またはその両方のいずれか。仕様は必要に応じて継承されます。

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

メモ

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

クラウド設定をエクスペリエンスフラグメント自体に追加すると、その設定はすべてのバリエーションに継承されます。
「クラウドサービス」タブを選択します。
クラウドサービス設定で、ドロップダウンリストから「Adobe Target」を選択します。

メモ

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

詳しくは、コアコンポーネントガイドのエクスペリエンスフラグメントコンポーネントを参照してください。
Adobe Target で以下を選択します。
- 適切な設定
- 必要な形式オプション
- Adobe Target ワークスペース
- Externalizer ドメイン（必要な場合）
注意

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

AEM Externalizer を設定するのは、コンテンツの書き出し先を特定のパブリッシュドメインに指定する場合です。詳しくは、AEM Link Externalizer の設定を参照してください。

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

例えば、フォルダーの場合は下図のようになります。
保存して閉じます。

レガシー設定の追加

重要

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

Adobe Experience Platform Launch を使用するためのクラウド設定を追加した後で、最初 AEM を Adobe Target と統合するには、レガシー設定を使用して Adobe Target と手動で統合する必要もあります。

Target クラウド設定の作成

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

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

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

AEMで Target クラウド設定を作成するには、以下の手順を実行します。

AEM ロゴ／ツール／クラウドサービス／従来のクラウドサービスを使用して、従来のクラウドサービスに移動します。（例：http://localhost:4502/libs/cq/core/content/tools/cloudservices.html）

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

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

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

Target フレームワークの追加

Target クラウド設定を設定したら、Target フレームワークを追加します。このフレームワークは、使用可能な ContextHub コンポーネントから Adobe Target に送信されるデフォルトのパラメーターを識別します。Target は、パラメーターを使用して、現在のコンテキストに適用されるセグメントを決定します。

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

Target 設定ページで、「利用可能な設定」の横の「+」（プラス符号）をクリックします。
フレームワークを作成ダイアログで、「タイトル」を指定し、「Adobe Target フレームワーク」を選択して、「作成」をクリックします。

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

メモ

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

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

メモ

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

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