Adobe Target へのエクスペリエンスフラグメントの書き出し exporting-experience-fragments-to-adobe-target
- Externalizer ドメイン を選択できるようになりました。
注意: Externalizer ドメインは、Target に送信されるエクスペリエンスフラグメントのコンテンツにのみ関連し、「オファーコンテンツを表示」などのメタデータには関連しません。
-
エクスペリエンスフラグメントは、次のいずれかに書き出すことができます。
- デフォルトのワークスペース。
- クラウド設定で指定された名前付きワークスペース。
- メモ: 特定のワークスペースに書き出すには、Adobe Target Premium が必要です。
-
AEM は IMS を使用した Adobe Target と統合する必要があります。
- AEM エクスペリエンスフラグメントは、Adobe Target のデフォルトのワークスペースに書き出されます。
- AEM は、 Adobe Target との統合の手順に従って Adobe Target と統合する必要があります。
Adobe Target(Target)向けに Adobe Experience Manager(AEM)で作成されたエクスペリエンスフラグメントを書き出すことができます。その後、Target アクティビティでオファーとして使用して、エクスペリエンスを大規模にテストおよびパーソナライズできます。
エクスペリエンスフラグメントをAdobe Target に書き出す際には、3 つのフォーマットオプションを利用できます。
- HTML(デフォルト):Web およびハイブリッドコンテンツ配信のサポート
- JSON:ヘッドレスコンテンツ配信のサポート
- HTML と JSON
AEM エクスペリエンスフラグメントは、Adobe Target のデフォルトワークスペースまたは Adobe Target のユーザー定義ワークスペースに書き出すことができます。これは、Adobe Developer Console を使用して行います。その場合、AEM は IMS を使用した Adobe Target と統合する必要があります。
前提条件 prerequisites
様々なアクションが必要です。
-
エクスペリエンスフラグメントはAEMオーサーインスタンスから書き出されるので、次の操作を行う必要があります。 AEM Link Externalizer を設定 オーサーインスタンスを使用して、エクスペリエンスフラグメント内の参照が Web 配信用に外部化されていることを確認します。
note note NOTE デフォルトでカバーされていないリンクの書き換えについては、Experience Fragment Link リライタープロバイダーが利用可能です。これにより、インスタンスに合わせてカスタマイズされたルールを開発できます。
クラウド設定の追加 add-the-cloud-configuration
フラグメントを書き出す前に、 クラウド設定 対象: Adobe Target をフラグメントまたはフォルダーに追加します。 この結果、次のことも可能になります。
- エクスポートに使用する形式オプションを指定します。
- Target ワークスペースを宛先として選択する
- エクスペリエンスフラグメント内の参照を書き換える Externalizer ドメインを選択します(オプション)。
必要なオプションは、必要なフォルダーやフラグメントの ページのプロパティ で選択できます。仕様は必要に応じて継承されます。
-
エクスペリエンスフラグメント コンソールに移動します。
-
適切なフォルダーまたはフラグメントの ページのプロパティ を開きます。
note note NOTE クラウド設定をエクスペリエンスフラグメントの親フォルダーに追加すると、設定はすべての子に継承されます。 クラウド設定をエクスペリエンスフラグメント自体に追加した場合、設定はすべてのバリエーションに継承されます。 -
「クラウドサービス」タブを選択します。
-
クラウドサービス設定 で、ドロップダウンリストから「Adobe Target」を選択します。
note note NOTE エクスペリエンスフラグメントオファーの JSON 形式はカスタマイズできます。これをおこなうには、顧客のエクスペリエンスフラグメントコンポーネントを定義し、そのプロパティを Sling Model コンポーネントに書き出す方法に注釈を付けます。 コアコンポーネントを参照してください。 コアコンポーネント - エクスペリエンスフラグメント Adobe Target の下で、次を選択します。
- 適切な設定
- 必要な形式オプション
- Adobe Target ワークスペース
- 必要に応じて、 Externalizer ドメインを設定します。
note caution CAUTION Externalizer ドメインはオプションです。 AEM Externalizer は、書き出されたコンテンツが特定の 公開 ドメイン。 詳しくは、 AEM Link Externalizer の設定. また、Externalizer ドメインは、Target に送信されるエクスペリエンスフラグメントのコンテンツにのみ関係があり、「オファーコンテンツを表示」などのメタデータには関係しません。 例えば、フォルダーの場合は下図のようになります。
-
保存して閉じる。
Adobe Target へのエクスペリエンスフラグメントの書き出し exporting-an-experience-fragment-to-adobe-target
(クラウド設定を指定した後に)エクスペリエンスフラグメントをAEMから Target に書き出すには、次の手順に従います。
-
エクスペリエンスフラグメントコンソールに移動します。
-
ターゲットに書き出すエクスペリエンスフラグメントを選択します。
note note NOTE エクスペリエンスフラグメント web のバリエーションである必要があります。 -
クリック Adobe Targetにエクスポート.
note note NOTE エクスペリエンスフラグメントが既に書き出されている場合は、「Adobe Target でアップデート」を選択します。 -
クリック 公開せずに書き出し または 公開 必要に応じて。
note note NOTE 選択 公開 は、エクスペリエンスフラグメントをすぐに公開し、Target に送信します。 -
クリック OK をクリックします。
これで、エクスペリエンスフラグメントが Target に表示されます。
note note NOTE 書き出しについての様々な詳細は、コンソールの リスト表示 と プロパティ で参照できます。 note note NOTE Adobe Target でエクスペリエンスフラグメントを表示すると、表示される 最終変更日 は、フラグメントが最後に Adobe Target に書き出された日付ではなく、AEM でフラグメントが最後に変更された日付です。
Adobe Target でのエクスペリエンスフラグメントの使用 using-your-experience-fragments-in-adobe-target
上記のタスクを実行すると、エクスペリエンスフラグメントがAdobe Targetのオファーページに表示されます。 以下を見る: 特定の Target ドキュメント そこで何を達成できるかを学ぶために
Adobe Target に書き出し済みのエクスペリエンスフラグメントの削除 deleting-an-experience-fragment-already-exported-to-adobe-target
Target に既に書き出されたエクスペリエンスフラグメントを削除すると、そのフラグメントが既にAdobe Targetのオファーで使用されている場合に、問題が発生する可能性があります。 フラグメントコンテンツが AEM によって配信されるので、フラグメントを削除すると、オファーが使用できなくなります。
このような状況を回避するには、次の手順に従います。
-
エクスペリエンスフラグメントが現在アクティビティで使用されていない場合、AEM ではユーザーが警告メッセージを表示せずにフラグメントを削除できます。
-
エクスペリエンスフラグメントがAdobe Targetのアクティビティで使用中の場合は、フラグメントを削除するとアクティビティに発生する可能性がある結果についてAEMユーザーに警告するエラーメッセージが表示されます。
AEM のエラーメッセージは、ユーザーによるエクスペリエンスフラグメントの(強制)削除を禁止するものではありません。エクスペリエンスフラグメントが削除された場合は、次のような結果になります。
-
AEM エクスペリエンスフラグメントを使用した Target オファーで望ましくない動作が見られる場合があります。
- エクスペリエンスフラグメント HTML が Target にプッシュされたため、オファーが引き続きレンダリングされる可能性があります。
- 参照されているアセットが AEM でも削除されている場合、エクスペリエンスフラグメント内の参照はどれも正しく機能しない可能性があります。
-
エクスペリエンスフラグメントはAEMには存在しなくなったので、エクスペリエンスフラグメントに対するそれ以上の変更はできません。
-
Target に書き出したエクスペリエンスフラグメントからの ClientLibs の削除 removing-clientlibs-from-fragments-exported-target
エクスペリエンスフラグメントには、完全な html タグと、エクスペリエンスフラグメントコンテンツ作成者が作成したとおりにフラグメントをレンダリングするために必要なすべてのクライアントライブラリ (CSS/JS) が含まれます。 これは仕様によるものです。
AEMで配信されるページ上でAdobe Targetと共にエクスペリエンスフラグメントオファーを使用する場合、ターゲットページには、必要なすべてのクライアントライブラリが既に含まれています。 また、エクスペリエンスフラグメントオファーの不要な HTML も必要ありません(考慮事項を参照)。
次に、エクスペリエンスフラグメントオファーの HTML の擬似例を示します。
<!DOCTYPE>
<html>
<head>
<title>…</title>
<!-- all the client libraries (css/js) -->
…
</head>
<body>
<!--/* Actual XF Offer content would appear here... */-->
</body>
</html>
AEMがAdobe Targetにエクスペリエンスフラグメントを書き出す場合は、追加の Sling セレクターをいくつか使用します。 例えば、書き出されたエクスペリエンスフラグメントの URL は次のようになります(nocloudconfigs.atoffer
に注意)。
- http://www.your-aem-instance.com/content/experience-fragments/my-offers/my-xf-offer.nocloudconfigs.atoffer.html
The nocloudconfigs
セレクターは、HTL を使用して定義され、次の場所からコピーしてオーバーレイできます。
- /libs/cq/experience-fragments/components/xfpage/nocloudconfigs.html
The atoffer
セレクターを次を使用して後処理に適用: Sling Rewriter. いずれかを使用して、クライアントライブラリを削除できます。
例 example
ここでは、 nocloudconfigs
.
オーバーレイ overlays
この特定の例では、オーバーレイが含まれているため、クライアントライブラリ と 不要な HTML が削除されます。エクスペリエンスフラグメントのテンプレートタイプを既に作成していることを前提としています。 コピーする必要があるファイル /libs/cq/experience-fragments/components/xfpage/
次を含む:
nocloudconfigs.html
head.nocloudconfigs.html
body.nocloudconfigs.html
テンプレートタイプのオーバーレイ template-type-overlays
この例では、次の構造を使用します。
これらのファイルの内容は次のとおりです。
-
body.nocloudconfigs.html
-
head.nocloudconfigs.html
-
nocloudconfigs.html
data-sly-unwrap
body タグを削除するには、 nocloudconfigs.html
.検討事項 considerations
Adobe Targetでエクスペリエンスフラグメントオファーを使用してAEMサイトとAEM以外のサイトの両方をサポートする必要がある場合は、2 つのエクスペリエンスフラグメント(2 つの異なるテンプレートタイプ)を作成する必要があります。
-
clientlibs/extra html を削除するオーバーレイを使用しているもの
-
オーバーレイがなく、必要な clientlibs が含まれているもの