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.

NOTE
Adobe Target arbetsytor finns inte i själva Adobe Target. De definieras och hanteras i Adobe IMS (Identity Management System) och väljs sedan ut för användning i olika lösningar med hjälp av integreringar från Adobe Developer Console.
NOTE
Adobe Target arbetsytor kan användas för att tillåta medlemmar i en organisation (grupp) att endast skapa och hantera erbjudanden och aktiviteter för den här organisationen, utan att ge åtkomst till andra användare. Till exempel landsspecifika organisationer inom ett globalt område.

Förutsättningar prerequisites

Du måste utföra olika åtgärder:

  1. 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.
  2. 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.

  1. Navigera till konsolen Experience Fragments.

  2. Ö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.
  3. Markera fliken Cloud Service.

  4. 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:

    Mapp - Cloud Service

  5. Spara och stäng.

Exportera ett Experience Fragment till Adobe Target exporting-an-experience-fragment-to-adobe-target

CAUTION
För medieresurser, till exempel bilder, exporteras bara en referens till Target. Resursen lagras i AEM Assets och levereras från den AEM publiceringsinstansen.
Därför måste Experience Fragment, med alla relaterade resurser, publiceras innan du exporterar till Target.

Så här exporterar du ett Experience Fragment från AEM till Target (efter att du har angett molnkonfigurationen):

  1. Navigera till Experience Fragment-konsolen.

  2. 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.
  3. Klicka på Exportera till Adobe Target.

    note note
    NOTE
    Om Experience Fragment redan har exporterats väljer du Uppdatera i Adobe Target.
  4. 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.
  5. 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.
NOTE
Du kan också exportera från sidredigeraren med jämförbara kommandon på menyn Sidinformation .

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.

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.

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.

NOTE
Mer information finns i Redigerbara mallar.

Ö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.html
  • head.nocloudconfigs.html
  • body.nocloudconfigs.html

Malltypsövertäckningar template-type-overlays

I det här exemplet ska vi ha följande struktur:

Malltypsövertäckningar

Innehållet i dessa filer är följande:

  • body.nocloudconfigs.html

    body.nocloudconfigs.html

  • head.nocloudconfigs.html

    head.nocloudconfigs.html

  • nocloudconfigs.html

    nocloudconfigs.html

NOTE
Om du vill använda 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

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2