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 IMS(Identity Management System)で定義および管理され、あらゆるソリューションで使用できるように Adobe 開発者コンソールで選択されます。

メモ

Adobe Target のワークスペースを使用すると、組織(グループ)のメンバーは、他のユーザーにアクセス権を付与することなく、その組織専用のオファーとアクティビティを作成および管理することができます。例えば、国際的な企業の国別の組織などです。

前提条件

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

  1. AEM と Adobe Target を統合する必要があります。

  2. エクスペリエンスフラグメントは AEM オーサーインスタンスから書き出されるので、オーサーインスタンスに AEM Link Externalizer を設定して、クスペリエンスフラグメント内のあらゆる参照が web 配信用に外部化されるようにする必要があります。

    メモ

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

クラウド設定の追加

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

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

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

  1. エクスペリエンスフラグメント​コンソールに移動します。

  2. 適切なフォルダーまたはフラグメントの​ページのプロパティ​を開きます。

    メモ

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

    クラウド設定をエクスペリエンスフラグメント自体に追加した場合、設定はすべてのバリエーションに継承されます。

  3. クラウドサービス」タブを選択します。

  4. クラウドサービス設定​で、ドロップダウンリストから「Adobe Target」を選択します。

    メモ

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

    詳しくは、コアコンポーネントガイドのエクスペリエンスフラグメントコンポーネントを参照してください。

  5. Adobe Target で以下を選択します。

    • 適切な設定
    • 必要な形式オプション
    • Adobe Target ワークスペース
    • Externalizer ドメイン(必要な場合)
    注意

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

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

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

    例えば、フォルダーの場合は下図のようになります。

    フォルダー - Cloud Services
  6. 保存して閉じます

レガシー設定の追加

重要

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

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

Target クラウド設定の作成

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

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

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

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

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

    Adobe Experience Cloud の概要ページが開きます。

  2. Adobe Target」セクションで、「今すぐ設定」をクリックします。

  3. 設定を作成​ダイアログで、次の操作を実行します。

    1. 設定の「タイトル」を入力します。
    2. Adobe Target 設定」テンプレートを選択します。
    3. 作成」をクリックします。

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

  1. 編集ダイアログが開きます。

    config-target-settings-dialog

  2. 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 は非推奨(廃止予定)となり、後日で削除される予定です。

      Adobeでは、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) をクリックします。 また、クラウドサービス設定での設定に関係なく、個々のコンポーネントに対して正確なターゲティングのオン/オフを切り替えることもできます。

      この設定を変更しても、作成済みの対象コンポーネントには影響しません​***。***​これらのコンポーネントに対して直接変更を加える必要があります。

  3. Adobe Target に接続」をクリックして、Target の接続を開始します。接続に成功すると、「接続に成功しました」というメッセージが表示されます。メッセージの「OK」をクリックして、ダイアログの「OK」をクリックします。

Target フレームワークの追加

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

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

  1. Target 設定ページで、「利用可能な設定」の横の「+」(プラス符号)をクリックします。

  2. フレームワークを作成ダイアログで、「タイトル」を指定し、「Adobe Target フレームワーク」を選択して、「作成」をクリックします。

    フレームワークページが表示されます。マッピングできる ContextHub の情報を表すコンポーネントがサイドキックに表示されます。

  3. マッピングに使用するデータを表す ClientContext コンポーネントをドロップターゲットにドラッグします。または、ContextHub ストア​コンポーネントをフレームワークにドラッグします。

    メモ

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

    例えば、サイト訪問者に関する​プロファイルデータ​を使用して Target キャンペーンを管理するには、「プロファイルデータ」コンポーネントをページにドラッグします。Target パラメーターへのマッピングに使用できるプロファイルデータ変数が表示されます。

  4. 該当する列の「共有」チェックボックスをオンにして、Target システムで表示する変数を選択します。

    メモ

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

フレームワークが作成されました。 フレームワークをパブリッシュインスタンスにレプリケートするには、 フレームワークを有効化 オプションを選択します。

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

注意

画像などのメディアアセットの場合、参照のみが Target に書き出されます。 アセット自体はAEM Assetsに保存されたままで、AEMパブリッシュインスタンスから配信されます。

このため、Target に書き出す前に、エクスペリエンスフラグメントと関連するすべてのアセットを公開する必要があります。

(クラウド設定を指定した後に)エクスペリエンスフラグメントをAEMから Target に書き出すには、次の手順を実行します。

  1. エクスペリエンスフラグメントコンソールに移動します。

  2. ターゲットに書き出すエクスペリエンスフラグメントを選択します。

    メモ

    エクスペリエンスフラグメント Web バリエーションにする必要があります。

  3. タップまたはクリック Adobe Targetに書き出し.

    メモ

    エクスペリエンスフラグメントが既に書き出されている場合は、Adobe Target でアップデート を選択します。

  4. タップまたはクリック 公開せずに書き出し または 公開 必要に応じて。

    メモ

    公開​を選択すると、エクスペリエンスフラグメントはすぐに公開され、Target に送信されます。

  5. 確認ダイアログで「OK」をタップ/クリックします。

    エクスペリエンスフラグメントは Target に送信されているはずです。

    メモ

    書き出しについての様々な詳細は、コンソールの​リスト表示​と​プロパティ​で参照できます。

    メモ

    Adobe Targetでエクスペリエンスフラグメントを表示すると、 最終変更日 表示される日付は、フラグメントがAdobe Targetに最後に書き出された日付ではなく、AEMでフラグメントが最後に変更された日付です。

メモ

または、ページエディターで、 ページ情報 メニュー

Adobe Target でのエクスペリエンスフラグメントの使用

ここまでのタスクを完了すると、エクスペリエンスフラグメントが Target のオファーページに表示されます。ご覧ください 特定の Target ドキュメント そこで何を達成できるかを学ぶために

メモ

Adobe Targetでエクスペリエンスフラグメントを表示すると、 最終変更日 表示される日付は、フラグメントがAdobe Targetに最後に書き出された日付ではなく、AEMでフラグメントが最後に変更された日付です。

Adobe Target に書き出し済みのエクスペリエンスフラグメントの削除

Target に書き出し済みのエクスペリエンスフラグメントを削除すると、そのフラグメントが既に Target のオファーで使用されている場合に問題が発生する可能性があります。フラグメントコンテンツがAEMによって配信されるので、フラグメントを削除すると、オファーが使用できなくなります。

このような状況を回避するには、次の手順に従います。

  • エクスペリエンスフラグメントが現在アクティビティで使用されていない場合、AEMを使用すると、警告メッセージを表示せずにフラグメントを削除できます。

  • エクスペリエンスフラグメントが現在 Target のアクティビティで使用されている場合、フラグメントを削除するとアクティビティに影響が及ぶ可能性があると、AEM ユーザーに警告メッセージが表示されます。

    AEMのエラーメッセージは、ユーザーによるエクスペリエンスフラグメントの削除(強制)を禁止していません。 エクスペリエンスフラグメントが削除された場合は、次のような結果になります。

    • AEM エクスペリエンスフラグメントを使用した Target オファーで望ましくない動作が見られる場合があります。

      • エクスペリエンスフラグメント HTML が Target にプッシュされたため、オファーが引き続きレンダリングされる可能性があります。
      • 参照されているアセットが AEM でも削除されている場合、エクスペリエンスフラグメント内の参照はどれも正しく機能しない可能性があります。
    • 当然ながら、エクスペリエンスフラグメントが AEM には存在しないため、さらに変更することは不可能です。

このページ