Exportera Experience Fragments till Adobe Target exporting-experience-fragments-to-adobe-target
Du kan exportera Experience Fragments, som har skapats i Adobe Experience Manager (AEM), till Adobe Target (Target). De kan sedan användas som erbjudanden i Target-aktiviteter för att testa och personalisera upplevelser i stor skala.
Det finns tre formatalternativ för att exportera ett Experience Fragment till Adobe Target:
- HTML (standard): Stöd för leverans av webb- och hybridinnehåll
- JSON: Stöd för leverans av headless-innehåll
- HTML & JSON
AEM Experience Fragments kan exporteras till standardarbetsytan i Adobe Target eller till användardefinierade arbetsytor för Adobe Target. Detta görs med Adobe Developer Console, som AEM måste integreras med Adobe Target med IMS.
Förutsättningar prerequisites
Du måste utföra olika åtgärder:
-
Du måste integrera AEM med Adobe Target med IMS.
note note NOTE IMS-integreringar har nu konfigurerats med S2S OAut. Tidigare konfigurationer gjordes med JWT-autentiseringsuppgifter som nu är borttagna i Adobe Developer Console. -
Experience Fragments exporteras från AEM författarinstans, så du måste konfigurera AEM Link Externalizer för författarinstansen för att se till att alla referenser i Experience Fragment är externaliserade för webbleverans.
note note NOTE Experience Fragment Link Rewriter-providern är tillgänglig för läntreskrivning som inte omfattas av standardinställningen. Med detta kan ni utveckla anpassade regler för er instans.
Lägg till molnkonfigurationen add-the-cloud-configuration
Innan du exporterar ett fragment måste du lägga till molnkonfigurationen för Adobe Target i fragmentet eller mappen. Detta gör även att du kan:
- ange de formatalternativ som ska användas för exporten
- välj en målarbetsyta som mål
- välj en Externalizer-domän för att skriva om referenser i Experience Fragment (valfritt)
De obligatoriska alternativen kan väljas i Sidegenskaper för den obligatoriska mappen och/eller fragmentet. Specifikationen ärvs vid behov.
-
Navigera till konsolen Experience Fragments.
-
Öppna Sidegenskaper för rätt mapp eller fragment.
note note NOTE Om du lägger till molnkonfigurationen i den överordnade Experience Fragment-mappen ärvs konfigurationen av alla underordnade. Om du lägger till molnkonfigurationen i själva Experience Fragment ärvs konfigurationen av alla variationer. -
Markera fliken Cloud Service.
-
Under Konfiguration av Cloud Service väljer du Adobe Target i listrutan.
note note NOTE JSON-formatet i ett Experience Fragment-erbjudande kan anpassas. För att göra detta definierar du en Customer Experience Fragment-komponent och kommenterar sedan hur dess egenskaper ska exporteras i komponentens Sling Model. Se kärnkomponenten: Kärnkomponenter - Upplevelsefragment Under Adobe Target väljer du:
- lämplig konfiguration
- det obligatoriska formatalternativet
- en Adobe Target-arbetsyta
- vid behov - Externalizer-domänen
note caution CAUTION Externalizer-domänen är valfri. En AEM Externalizer konfigureras när du vill att det exporterade innehållet ska peka på en specifik publiceringsdomän. Mer information finns i Konfigurera AEM Link Externalizer. Observera också att Externalizer-domäner bara är relevanta för innehållet i Experience Fragment som skickas till Target, och inte för metadata som Visa erbjudandeinnehåll. För en mapp:
-
Spara och stäng.
Exportera ett Experience Fragment till Adobe Target exporting-an-experience-fragment-to-adobe-target
Så här exporterar du ett Experience Fragment från AEM till Target (efter att du har angett molnkonfigurationen):
-
Navigera till Experience Fragment-konsolen.
-
Välj den Experience Fragment som du vill exportera till mål.
note note NOTE Det måste vara en webbvariant för Experience Fragment. -
Klicka på Exportera till Adobe Target.
note note NOTE Om Experience Fragment redan har exporterats väljer du Uppdatera i Adobe Target. -
Klicka på Exportera utan publicering eller Publish efter behov.
note note NOTE Om du väljer Publish publiceras Experience Fragment direkt och skickas till Target. -
Klicka på OK i bekräftelsedialogrutan.
Din Experience Fragment bör nu vara i Target.
note note NOTE Olika detaljer i exporten visas i listvyn i konsolen och i Egenskaper. note note NOTE När du visar ett Experience Fragment i Adobe Target är det senast ändrade-datum som visas det datum då fragmentet senast ändrades i AEM, inte det datum då fragmentet senast exporterades till Adobe Target.
Använda dina upplevelsefragment i Adobe Target using-your-experience-fragments-in-adobe-target
När du har utfört ovanstående uppgifter visas Experience Fragment på offertsidan i Adobe Target. Titta på den specifika Target-dokumentationen för att lära dig mer om vad du kan uppnå där.
Ta bort ett Experience Fragment som redan har exporterats till Adobe Target deleting-an-experience-fragment-already-exported-to-adobe-target
Om du tar bort ett Experience Fragment som redan har exporterats till Target kan det orsaka problem om fragmentet redan används i ett erbjudande i Adobe Target. Om du tar bort fragmentet blir erbjudandet oanvändbart eftersom fragmentinnehållet levereras av AEM.
För att undvika sådana situationer:
-
Om Experience Fragment inte används för närvarande i en aktivitet kan AEM användaren ta bort fragmentet utan ett varningsmeddelande.
-
Om Experience Fragment används av en aktivitet i Adobe Target får AEM ett felmeddelande om eventuella konsekvenser som en borttagning av fragmentet kan ha för aktiviteten.
Felmeddelandet i AEM förhindrar inte användaren från att (tvinga) ta bort Experience Fragment. Om Experience Fragment tas bort:
-
Målerbjudandet med AEM Experience Fragment kan visa oönskat beteende
- Erbjudandet kommer troligtvis fortfarande att återges eftersom Experience Fragment HTML flyttades till Target
- Eventuella referenser i Experience Fragment kanske inte fungerar korrekt om refererade resurser också tas bort i AEM.
-
Alla ytterligare ändringar av Experience Fragment är omöjliga eftersom Experience Fragment inte längre finns i AEM.
-
Ta bort ClientLibs från Experience Fragments som exporterats till Target removing-clientlibs-from-fragments-exported-target
Experience Fragments innehåller fullständiga html-taggar och alla nödvändiga klientbibliotek (CSS/JS) för att återge fragmentet exakt som det skapades av Experience Fragment Content Author. Det här är underdesign.
När du använder ett Experience Fragment-erbjudande med Adobe Target på en sida som levereras av AEM innehåller målsidan redan alla nödvändiga klientbibliotek. Dessutom behövs inte heller den överflödiga HTML-koden i Experience Fragment-erbjudandet (se Considerations).
Här följer ett pseudoexempel på html i ett Experience Fragment-erbjudande:
<!DOCTYPE>
<html>
<head>
<title>…</title>
<!-- all the client libraries (css/js) -->
…
</head>
<body>
<!--/* Actual XF Offer content would appear here... */-->
</body>
</html>
När AEM exporterar ett Experience Fragment till Adobe Target sker detta på en hög nivå med hjälp av flera ytterligare Sling Selectors. URL:en för det exporterade Experience Fragment kan till exempel se ut så här (meddelande nocloudconfigs.atoffer):
- http://www.your-aem-instance.com/content/experience-fragments/my-offers/my-xf-offer.nocloudconfigs.atoffer.html
nocloudconfigs-väljaren definieras med hjälp av HTML och kan överlappas genom att den kopieras från:
- /libs/cq/experience-fragments/components/xfpage/nocloudconfigs.html
atoffer-väljaren används för efterbearbetning med Sling Rewriter. Båda kan användas för att ta bort klientbiblioteken.
Exempel example
I detta syfte ska vi illustrera hur du gör detta med nocloudconfigs.
Övertäckningar overlays
I det här exemplet tar de övertäckningar som ingår bort klientbiblioteken och den överflödiga HTML-koden. Du förutsätts redan ha skapat malltypen Experience Fragment. Nödvändiga filer som behöver kopieras från /libs/cq/experience-fragments/components/xfpage/ är:
nocloudconfigs.htmlhead.nocloudconfigs.htmlbody.nocloudconfigs.html
Malltypsövertäckningar template-type-overlays
I det här exemplet ska vi ha följande struktur:
Innehållet i dessa filer är följande:
-
body.nocloudconfigs.html
-
head.nocloudconfigs.html
-
nocloudconfigs.html
data-sly-unwrap för att ta bort body-taggen behöver du nocloudconfigs.html.Överväganden considerations
Om du behöver stöd för både AEM och icke-AEM webbplatser med Experience Fragment Offers i Adobe Target måste du skapa två Experience Fragments (två olika malltyper):
-
En med övertäckningen som tar bort clientlibs/extra html
-
En som inte har övertäckningen och därför innehåller de nödvändiga klientlibs