將體驗片段匯出到 Adobe Target exporting-experience-fragments-to-adobe-target
您可以將在Adobe Experience Manager (AEM)中建立的體驗片段匯出至Adobe Target (Target)。 接著,可將這些選件做為Target活動中的選件,以大規模測試並個人化體驗。
有三個格式選項可用於將體驗片段匯出至Adobe Target:
- HTML(預設):支援網頁和混合式內容傳遞
- JSON:支援Headless內容傳送
- HTML 和 JSON
AEM體驗片段可以匯出至Adobe Target中的預設工作區,或匯出至Adobe Target的使用者定義工作區。 這是使用Adobe Developer Console完成的,對此,AEM必須使用IMS🔗與Adobe Target 整合。
先決條件 prerequisites
需要執行各種動作:
-
您必須使用IMS🔗 整合AEM與Adobe Target。
note note NOTE IMS整合現在已設定為S2S OAut。 先前是使用JWT認證進行設定,而現在Adobe Developer Console已棄用。 -
體驗片段會從AEM編寫執行個體匯出,因此您必須在編寫執行個體上設定AEM連結外部化程式,以確保體驗片段中的任何參考都會外部化以供Web傳遞。
note note NOTE 對於預設未涵蓋的連結重寫,體驗片段連結重寫器提供者可供使用。 如此一來,您就可以針對執行個體開發自訂規則。
新增雲端設定 add-the-cloud-configuration
在匯出片段之前,您必須將 Adobe Target 的 雲端設定 新增到片段或資料夾。 這也可讓您:
- 指定要用於匯出的格式選項
- 選取Target工作區作為目的地
- 選取外部化器網域,以重寫體驗片段中的參照(選用)
可以在必要資料夾和/或片段的 頁面屬性 中選取必要選項;必要時將繼承規格。
-
導覽至 體驗片段 主控台。
-
開啟適當資料夾或片段的 頁面屬性。
note note NOTE 如果您將雲端設定新增至體驗片段父資料夾,設定將由所有子系繼承。 如果您將雲端設定新增至體驗片段本身,該設定會由所有變數繼承。 -
選取「雲端服務」標籤。
-
在 Cloud Service設定 下,從下拉式清單中選取 Adobe Target。
note note NOTE 可自訂體驗片段選件的JSON格式。 若要這麼做,請定義客戶體驗片段元件,然後註明如何在元件Sling模型中匯出其屬性。 請參閱核心元件: 核心元件 — 體驗片段 在 Adobe Target 下選取:
- 適當的設定
- 所需的格式選項
- Adobe Target工作區
- 如有必要 — Externalizer網域
note caution CAUTION Externalizer網域是選用的。 當您想要匯出的內容指向特定的 發佈 網域時,會設定AEM Externalizer。 如需詳細資訊,請參閱設定AEM連結外部器。 另請注意,外部化器網域僅與傳送至Target的體驗片段內容相關,與檢視選件內容之類的中繼資料無關。 例如,針對資料夾:
-
儲存並關閉。
將體驗片段匯出至Adobe Target exporting-an-experience-fragment-to-adobe-target
若要將體驗片段從AEM匯出至Target (在指定雲端設定後):
-
導覽至體驗片段主控台。
-
選取您要匯出至Target的體驗片段。
note note NOTE 它必須是體驗片段Web變數。 -
按一下 匯出至Adobe Target。
note note NOTE 如果體驗片段已匯出,請選取「在Adobe Target中更新」。 -
視需要按一下 匯出而不發佈 或 Publish。
note note NOTE 選取 Publish 會立即發佈體驗片段並將其傳送到Target。 -
在確認對話方塊中按一下 確定。
您的體驗片段現在應該在Target中。
note note NOTE 匯出的各種詳細資料可在主控台的 清單檢視 和 內容 中看見。 note note NOTE 在Adobe Target中檢視體驗片段時,看到的 上次修改 日期是上次在AEM中修改片段的日期,而非上次將片段匯出至Adobe Target的日期。
在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
nocloudconfigs
選擇器是使用HTL定義的,而且可以從以下位置複製以覆蓋:
- /libs/cq/experience-fragments/components/xfpage/nocloudconfigs.html
atoffer
選擇器已使用Sling重寫程式套用後續處理。 兩者皆可用來移除使用者端程式庫。
範例 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
移除內文標籤,您需要nocloudconfigs.html
。考量事項 considerations
如果您需要使用Adobe Target中的體驗片段選件支援AEM網站和非AEM網站,您必須建立兩個體驗片段(兩種不同的範本型別):
-
具有覆蓋以移除clientlibs/額外html的元件
-
沒有覆蓋的網域,因此包含必要的clientlibs