Adobe Experience Manager-inhoudsfragmenten aem-fragments

Door Adobe Experience Manager as a Cloud Service te integreren met Adobe Journey Optimizer, kunt u nu uw AEM-inhoudsfragmenten naadloos opnemen in uw Journey Optimizer-inhoud. Deze gestroomlijnde verbinding vereenvoudigt het proces van toegang tot en gebruik van AEM-inhoud, waardoor persoonlijke en dynamische campagnes en reizen kunnen worden gemaakt.

Meer over de Fragmenten van de Inhoud van AEM leren, verwijs naar ​ Werkend met de Fragmenten van de Inhoud ​ in de documentatie van Experience Manager.

Voordat u begint start

AVAILABILITY
Voor klanten in de gezondheidszorg is de integratie alleen mogelijk na het in licentie geven van het Journey Optimizer Healthcare Shield- en Adobe Experience Manager Enhanced Security-add-on-aanbod.

Beperkingen limitations

Houd rekening met de volgende beperkingen wanneer u werkt met Adobe Experience Manager Content Fragments in Journey Optimizer:

  • de Types van Fragmenttypes van Inhoud: De eenvoudige Fragmenten van de Inhoud en de genestelde Fragmenten van de Inhoud worden gesteund. Variaties in inhoudsfragmenten worden momenteel niet ondersteund.

  • Meertalige inhoud: Slechts wordt de handstroom gesteund. Elke taalvariant moet onafhankelijk van elkaar zijn ontworpen in Adobe Experience Manager, gecodeerd, gepubliceerd en handmatig zijn geselecteerd in Journey Optimizer. Er is geen automatische taalresolutie of fallback-mechanisme.

  • Toegang van de Bewaarplaats: Journey Optimizer integreert exclusief met Adobe Experience Manager publiceer rij, waar de Fragmenten van de Inhoud door een openbaar, niet voor authentiek verklaard eindpunt beschikbaar zijn. Hoewel Author repositories kunnen verschijnen in de repository kiezer, kunnen alleen Content Fragments die gepubliceerd worden naar de Publish tier gebruikt worden in Journey Optimizer.

  • status van het Fragment van de Inhoud: De vertoningen van Journey Optimizer de Fragmenten van de Inhoud met Gepubliceerde en Gewijzigde status. In alle gevallen wordt alleen de meest recente gepubliceerde versie gebruikt. Als een fragment na publicatie wordt gewijzigd, worden deze wijzigingen pas in Journey Optimizer doorgevoerd als het inhoudsfragment opnieuw wordt gepubliceerd in Adobe Experience Manager. Er is geen automatische afstemming van versies tussen Adobe Experience Manager en Journey Optimizer.

  • Personalization: Slechts profielattributen, contextuele attributen, statische koorden, en pre-gedeclareerde variabelen worden gesteund. Afgeleide of berekende kenmerken worden niet ondersteund.

  • Updates en versioning: De updates van het Fragment van de inhoud vereisen handherpublicatie van Adobe Experience Manager. Er is geen automatische afstemming van versies tussen Adobe Experience Manager en Journey Optimizer. Wanneer een inhoudsfragment in Adobe Experience Manager wordt gepubliceerd, ontvangt Journey Optimizer een gebeurtenis en updates aan de Journey Optimizer-zijde. Als de update succesvol is, is deze na 5 minuten beschikbaar voor Eenheidstijden en in de volgende batch voor Gebruiksgevallen Batch.

  • Caching en het proef: De Fragmenten van de inhoud worden teruggewonnen in echt - tijd van Adobe Experience Manager publiceren rij. Er is geen pre-render of momentopname caching. Proefdrukken voor campagnes en reizen weerspiegelen altijd de meest recente gepubliceerde versie van het inhoudsfragment en historische versies kunnen niet worden vergrendeld voor proefdrukken.

  • toegang van de Gebruiker: Het wordt geadviseerd om het aantal gebruikers met toegang te beperken om de Fragmenten van de Inhoud te publiceren om het risico van toevallige fouten te verminderen.

Stroom van inhoudssynchronisatie content-sync-flow

De integratie tussen Adobe Experience Manager en Journey Optimizer volgt deze gegevensstroom:

  1. creeer en auteur ​: De inhoud wordt gecreeerd en in Adobe Experience Manager gevormd als Fragments van de Inhoud.

  2. het Etiketteren ​: De Fragmenten van de inhoud moeten met de Journey Optimizer-Specifieke markering (ajo-enabled:{OrgId}/{SandboxName}) worden geëtiketteerd.

  3. publiceer ​: De Fragmenten van de inhoud worden gepubliceerd in Adobe Experience Manager, die hen ter beschikking stellen van Journey Optimizer.

  4. Toegang: Journey Optimizer haalt en toont beschikbare de Fragmenten van de Inhoud van Adobe Experience Manager publiceren instantie in real time.

  5. Integratie: De Fragmenten van de inhoud worden geselecteerd en in campagnes of reizen geïntegreerd.

Wanneer een inhoudsfragment in Adobe Experience Manager wordt gepubliceerd, wordt een gebeurtenis verzonden om de inhoud aan de Journey Optimizer-zijde bij te werken. Als de update is gelukt, wordt het inhoudsfragment binnen ongeveer 5 minuten beschikbaar voor eenheidreizen en in de volgende verwerkingsbatch voor batchgebruik. Zodra de update beschikbaar is in Journey Optimizer, wordt de meest recente gepubliceerde inhoud gebruikt voor alle toepasselijke campagnes en reizen.

Levenscyclus van inhoudsfragment

Inhoudsfragmenten volgen verschillende fasen in de levenscyclus, afhankelijk van de Adobe Experience Manager-laag waarin ze voorkomen. ​ leer meer in de documentatie van Adobe Experience Manager ​

De inhoud wordt gecreeerd en op de rij van de Auteur geleid, waar de fragmenten statussen zoals Nieuw, Ontwerp, Gepubliceerd, Gewijzigd, of Unpublished kunnen hebben. Deze statussen zijn slechts op de rij van de Auteur van toepassing en steunen inhoudsverwezenlijking en overzicht.

Wanneer een tevreden Fragment wordt gepubliceerd, wordt een exemplaar gecreeerd op publiceer rij en blootgesteld door een openbaar, niet voor authentiek verklaard eindpunt. Journey Optimizer integreert exclusief met dit publiceer rij.

Als gevolg hiervan heeft Journey Optimizer alleen oppervlakken van Gepubliceerde of Gewijzigde inhoudsfragmenten en wordt altijd de meest recente gepubliceerde versie gebruikt. Wijzigingen die na publicatie worden aangebracht, worden pas in Journey Optimizer doorgevoerd als het inhoudsfragment opnieuw wordt gepubliceerd.

Een tag maken en toewijzen in Experience Manager

Voordat u het inhoudsfragment in Journey Optimizer kunt gebruiken, moet u een specifieke tag voor Journey Optimizer maken:

  1. Heb toegang tot uw milieu van Experience Manager.

  2. Van het menu van Hulpmiddelen, uitgezochte Tags.

  3. Klik creëren Markering.

  4. Controleer of de id voldoet aan de volgende syntaxis: ajo-enabled:{AJO-OrgId}/{AJO-SandboxName} .

  5. Klik creëren.

  6. Bepaal uw Model van het Fragment van de Inhoud zoals die in ​ wordt gedetailleerd de documentatie van Experience Manager ​ en wijs uw pas gecreëerde markering van Journey Optimizer toe.

Deze real-time verbinding zorgt ervoor dat uw inhoud altijd up-to-date is, maar betekent ook dat wijzigingen in gepubliceerde fragmenten onmiddellijk van invloed zullen zijn op actieve campagnes en reizen.

U kunt nu beginnen met het maken en configureren van het inhoudsfragment voor later gebruik in Journey Optimizer. Leer meer in ​ documentatie van Experience Manager ​.

Experience Manager-inhoudsfragmenten toevoegen aem-add

Nadat u de AEM Content Fragments hebt gemaakt en gepersonaliseerd, kunt u deze nu importeren naar uw campagne of reis voor het optimaliseren van de reis.

  1. Creeer uw ​ Campagne ​ of ​ Reis ​.

  2. Om tot uw de inhoudsfragment van AEM toegang te hebben, klik het pictogram van Personalization binnen om het even welk tekstgebied, of open de broncode door een de inhoudscomponent van HTML.

  3. Klik in het menu AEM Content Fragment in het linkerdeelvenster op Open AEM CF selector .

  4. Selecteer een Content Fragment in de lijst met beschikbare items om deze te importeren in uw Journey Optimizer-inhoud.

  5. Klik op Show filters om de lijst met inhoudsfragmenten te verfijnen.

    Standaard is het filter Inhoudsfragment vooraf ingesteld om alleen goedgekeurde inhoud weer te geven.

  6. Nadat u Content Fragment hebt geselecteerd, klikt u op Select om het te openen.

  7. Klik op View fragment om de fragmentgegevens weer te geven. Als u het menu Fragment Info opent, wordt de editor alleen-lezen.

    Selecteer Preview in het rechtermenu om het fragment in Adobe Experience Manager weer te geven.

  8. Klik Meer actiepictogram om tot het geavanceerde menu van uw Fragment toegang te hebben:

    • Swap fragment
    • Explore references
    • Open in AEM

  9. Kies de gewenste velden in uw Fragment om aan uw inhoud toe te voegen.

  10. Om realtime personalisatie mogelijk te maken, moeten alle plaatsaanduidingen die binnen een Content fragment worden gebruikt, expliciet door de gebruiker worden gedeclareerd als parameters in de fragmenthulplijntag. Met de volgende methoden kunt u deze plaatsaanduidingen toewijzen aan profielkenmerken, contextafhankelijke kenmerken, statische tekenreeksen of vooraf gedefinieerde variabelen:

    1. Profiel of Contextual Attributen Toewijzing: wijs placeholder aan een profiel of contextafhankelijk attribuut toe, b.v. naam = profile.person.name.firstName.

    2. de Statische Toewijzing van het Koord: wijs een vaste koordwaarde toe door het binnen dubbele citaten te plaatsen, b.v. naam = "John".

    3. Veranderlijke Afbeelding: Verwijzing een variabele die vroeger binnen zelfde HTML wordt verklaard, b.v. naam = "variableName".
      In dit geval, zorg ervoor variableName alvorens fragmentidentiteitskaart toe te voegen wordt gedeclareerd, gebruikend volgende syntaxis:

      code language-html
      {% let variableName = attribute name %}
      

    In het voorbeeld hieronder, wordt naam placeholder in kaart gebracht aan profile.person.name.firstName attributen binnen het fragment.

    {modal="regular"}

  11. Klik op Save. U kunt nu uw berichtinhoud zoals die in ​ wordt gedetailleerd deze sectie ​ testen en controleren.
    Zodra u uw tests hebt uitgevoerd en de inhoud bevestigd, kunt u ​ uw campagne ​ verzenden of ​ uw reis ​ aan uw publiek publiceren.

Met Adobe Experience Manager kunt u de Journey Optimizer-campagnes of -reizen identificeren waar een inhoudsfragment wordt gebruikt. Leer meer in ​ documentatie van Adobe Experience Manager ​.

Problemen oplossen troubleshooting

Als u problemen tegenkomt bij het werken met Adobe Experience Manager Content Fragments in Journey Optimizer, raadpleegt u de volgende algemene problemen en resoluties:

Probleem
Oorzaak
Resolutie
Markering niet gevonden of het Fragment van de Inhoud niet zichtbaar in selecteur
De syntaxis van de Adobe Experience Manager-tag komt niet overeen met de vereiste indeling ajo-enabled:{OrgId}/{SandboxName}
Valideer dat identiteitskaart van de markering correcte identiteitskaart van de Organisatie en Naam Sandbox gebruikt. Zorg ervoor dat er geen spaties of onjuiste scheidingstekens zijn. Publiceer het inhoudsfragment opnieuw nadat u de tag hebt gecorrigeerd.
het Fragment van de Inhoud verschijnt niet in lijst
Inhoudsfragment bevindt zich in concept of is niet goedgekeurd
Alleen goedgekeurde en gepubliceerde inhoudsfragmenten worden weergegeven in de Journey Optimizer-kiezer. Publiceer het inhoudsfragment in Adobe Experience Manager en controleer of het de goedgekeurde status heeft.
Veranderlijke niet gedefiniëerde fout
Tijdelijke aanduiding voor Personalization is niet gedeclareerd in fragment helper-tag
Voeg alle vereiste parameters toe aan de fragmenthulplijntag. Elke tijdelijke aanduiding die in het inhoudsfragment wordt gebruikt, moet expliciet worden gedeclareerd met de toewijzing ervan.
de vertoningen van de proef onverwachte inhoud
Proef gebruikt de meest recente gepubliceerde versie van Adobe Experience Manager
Proefversies weerspiegelen altijd de meest recente publicatie van het inhoudsfragment in Adobe Experience Manager. Als u recente wijzigingen hebt aangebracht in Adobe Experience Manager, publiceert u het fragment opnieuw en vernieuwt u de proefdruk.
Ontkende Toegang (CPES) fout
Gebruikersrol is niet geautoriseerd voor toegang tot bepaalde kenmerken
Neem contact op met de systeembeheerder om te controleren of uw rol de juiste machtigingen heeft voor het profiel of de contextafhankelijke kenmerken die worden gebruikt in personalisatie.
de vertoningen van het fragment leeg of ontbrekende inhoud
Ontbrekende vereiste verpersoonlijkingsparameters of terugvalwaarden
Zorg ervoor dat alle vereiste parameters zijn opgegeven en denk na of u terugvalwaarden voor optionele kenmerken wilt toevoegen.

Als het probleem zich blijft voordoen, neemt u contact op met uw Adobe-vertegenwoordiger voor meer informatie over uw Content Fragment ID, campagne- of reis-id en eventuele weergegeven foutberichten.

recommendation-more-help
b22c9c5d-9208-48f4-b874-1cefb8df4d76