[AEM Sites]{class="badge positive" title="AEM Sitesに適用）。"}
Adobe Target へのコンテンツフラグメントの書き出し exporting-content-fragments-to-adobe-target
Adobe Experience Manager as a Cloud Service（AEM）で作成されたコンテンツフラグメントを Adobe Target（Target）に書き出すことができます。 書き出したエクスペリエンスフラグメントは、Target アクティビティのオファーとして使用し、幅広くエクスペリエンスをテストおよびパーソナライズできます。
コンテンツフラグメントをAdobe Targetに書き出す場合に使用できるオプションは次のとおりです。
- JSON：ヘッドレスコンテンツ配信のサポート
AEM コンテンツフラグメントをAdobe Targetに書き出すインスタンスを準備するには、次の手順を実行する必要があります。
これにより、次のことが可能になります。
コンテンツフラグメントは、デフォルトのワークスペースまたはユーザー定義のワークスペースを使用して、Adobe Targetに書き出すことができます。
前提条件 prerequisites
次のアクションが必要です。
- AEM と Adobe Target を統合する必要があります。
クラウド設定の追加 add-the-cloud-configuration
フラグメントを書き出す前に、Adobe Targetの Cloud Configuration をフラグメントまたはフォルダーに追加する必要があります。 この結果、次のことも可能になります。
- 書き出しに使用する形式オプションを指定します。
- ターゲット ワークスペースを宛先として選択します。
必要なオプションは、必要なフォルダーの プロパティ で選択できます。仕様は必要に応じて継承されます。
-
Assets コンソールに移動します。
-
適切なフォルダーの プロパティ を開きます。
note NOTE クラウド設定をコンテンツフラグメントの親フォルダーに追加した場合、設定はすべての子に継承されます。 -
「クラウドサービス」タブを選択します。
-
クラウドサービス設定で、ドロップダウンリストからターゲット設定を選択します。
-
Adobe Target ワークスペースを選択します。
例：
-
保存して閉じます。
レガシー設定の追加 add-the-legacy-configuration
Adobe Experience Platform Launch を使用するためのクラウド設定を追加した後で、最初 AEM を Adobe Target と統合するには、レガシー設定を使用して Adobe Target と手動で統合する必要もあります。
Target クラウド設定の作成 creating-a-target-cloud-configuration
AEM が Adobe Target とやり取りできるようにするには、Target クラウド設定を作成します。 設定を作成するには、Adobe Target のクライアントコードとユーザーの資格情報を指定します。
複数の AEM キャンペーンに設定を関連付けることができるので、Target クラウド設定を作成するのは 1 回のみです。 複数の Adobe Target クライアントコードがある場合、各クライアントコードに対して 1 つの設定を作成します。
クラウド設定を設定して、Adobe Target からセグメントを同期することができます。 同期を有効にした場合、クラウド設定が保存されるとすぐに、バックグラウンドでセグメントが Target から読み込まれます。
AEMで Target クラウド設定を作成するには、以下の手順を実行します。
-
AEM ロゴ > ツール > Cloud Services > Legacy Cloud Servicesを使用して、Legacy Cloud Servicesに移動します。
例：（http://localhost:4502/libs/cq/core/content/tools/cloudservices.html）Adobe Experience Cloud の概要ページが開きます。
-
「Adobe Target」セクションで、「今すぐ設定」をクリックします。
-
設定を作成ダイアログで、次の操作を実行します。
- 設定の「タイトル」を入力します。
- 「Adobe Target 設定」テンプレートを選択します。
- 「作成」をクリックします。
これで、新しい設定を選択して編集できます。
-
編集ダイアログが開きます。
-
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 は非推奨／廃止予定です）。
note NOTE 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 をアップロードします。 デフォルトのライブラリを使用する場合は、空白のままにします。
note NOTE デフォルトでは、Adobe Target設定ウィザードをオプトインすると、正確なターゲティングが有効になります。 正確なターゲティングとは、クラウドサービスの設定が、コンテキストの読み込みを待ってからコンテンツを読み込むことを意味します。 その結果、パフォーマンスに関しては、正確なターゲティングによって、コンテンツを読み込む前に数ミリ秒の遅延が生じる場合があります。 正確なターゲティングは、オーサーインスタンスで常に有効になっています。 ただし、パブリッシュインスタンスでは、クラウドサービス設定（ http://localhost:4502/etc/cloudservices.html）の「正確なターゲティング」の横にあるチェックマークをオフにして、正確なターゲティングをグローバルでオフにすることができます。 また、クラウドサービス設定での設定に関係なく、個々のコンポーネントに対して正確なターゲティングのオン／オフを切り替えることもできます。この設定を変更しても、作成済みの対象コンポーネントには影響しません***。*** これらのコンポーネントには直接変更を加える必要があります。
- 「Adobe Target に接続」をクリックして、Target の接続を開始します。 接続に成功すると、「接続に成功しました」というメッセージが表示されます。 メッセージの「OK」をクリックして、ダイアログの「OK」をクリックします。
Target フレームワークの追加 adding-a-target-framework
Target クラウド設定を設定したら、Target フレームワークを追加します。 このフレームワークは、使用可能な ContextHub コンポーネントから Adobe Target に送信されるデフォルトのパラメーターを識別します。 Target は、パラメーターを使用して、現在のコンテキストに適用されるセグメントを決定します。
1 つの Target 設定に対して複数のフレームワークを作成できます。 Web サイトのセクションごとに異なるパラメーターセットを Target に送信する必要がある場合は、複数のフレームワークが便利です。 送信する必要のあるパラメーターのセットごとにフレームワークを作成します。 Web サイトの各セクションを適切なフレームワークに関連付けます。 Web ページでは、一度に1つのフレームワークのみを使用できます。
-
Target 設定ページで、「利用可能な設定」の横の「+」（プラス符号）をクリックします。
-
フレームワークを作成ダイアログで、「タイトル」を指定し、「Adobe Target フレームワーク」を選択して、「作成」をクリックします。
フレームワークページが表示されます。 マッピングできる ContextHub の情報を表すコンポーネントがサイドキックに表示されます。
-
マッピングに使用するデータを表す ClientContext コンポーネントをドロップターゲットにドラッグします。 または、ContextHub ストアコンポーネントをフレームワークにドラッグします。
note NOTE マッピング時に、パラメーターは単純な文字列を使用して mbox に渡されます。 ContextHub から配列をマッピングすることはできません。 例えば、サイト訪問者に関する プロファイルデータ を使用して Target キャンペーンを管理するには、「プロファイルデータ」コンポーネントをページにドラッグします。 Target パラメーターへのマッピングに使用できるプロファイルデータ変数が表示されます。
-
該当する列の「共有」チェックボックスをオンにして、Target システムで表示する変数を選択します。
note NOTE パラメーターの同期は、AEM から Adobe Target への一方向のみです。
フレームワークが作成されました。 フレームワークをパブリッシュインスタンスにレプリケートするには、サイドキックの「フレームワークをアクティベート」オプションを使用します。
Adobe Target へのコンテンツフラグメントの書き出し exporting-a-content-fragment-to-adobe-target
（クラウド設定を指定した後に）コンテンツフラグメントを AEM から Target に書き出すには、次の手順を実行します。
-
Assets コンソールのコンテンツフラグメントに移動します。
-
Target に書き出すコンテンツフラグメントを選択します。
-
「Adobe Target オファーに書き出し」を選択します。
このような状況を回避するには、次の手順に従います。
-
コンテンツフラグメントが現在アクティビティで使用されていない場合、AEM を使用すると、警告メッセージを表示せずにフラグメントを削除できます。
-
コンテンツフラグメントが現在 Target のアクティビティで使用されている場合、フラグメントを削除するとアクティビティに影響が及ぶ可能性があると、AEM ユーザーに警告メッセージが表示されます。
AEM のエラーメッセージは、ユーザーによるコンテンツフラグメントの（強制）削除を禁止するものではありません。 コンテンツフラグメントが削除された場合は、次のような結果になります。
-
AEM コンテンツフラグメントを使用した Target オファーで望ましくない動作が見られる場合があります。
- コンテンツフラグメント が Target にプッシュされたため、オファーは引き続きレンダリングされる可能性があります。
- 参照されているアセットが AEM でも削除されている場合、コンテンツフラグメント内の参照はすべて正しく機能しない可能性があります。
-
もちろん、コンテンツフラグメントはAEMには存在しないため、コンテンツフラグメントをさらに変更することは不可能です。
-
その他のリソース further-resources
詳しくは、以下のトピックを参照してください。
-