Exportieren von Experience Fragments nach Adobe Target exporting-experience-fragments-to-adobe-target
Sie können Experience Fragments, die in Adobe Experience Manager (AEM) erstellt wurden, nach Adobe Target (Target) exportieren. Diese können dann als Angebote in Target-Aktivitäten verwendet werden, um Erlebnisse im benötigten Umfang zu testen und zu personalisieren.
Es gibt drei Formatoptionen für den Export eines Experience Fragments in Adobe Target:
- HTML (Standard): Unterstützung der Bereitstellung von Web- und Hybridinhalten
- JSON: Unterstützung der Headless-Inhaltsbereitstellung
- HTML und JSON
AEM Experience Fragments können in den Standardarbeitsbereich in Adobe Target oder in benutzerdefinierte Arbeitsbereiche für Adobe Target exportiert werden. Dies erfolgt über die Adobe Developer Console, für die AEM mit Adobe Target über IMS integriert sein muss.
Voraussetzungen prerequisites
Verschiedene Aktionen sind erforderlich:
-
Sie müssen AEM mit Adobe Target über IMS integrieren.
note note NOTE IMS-Integrationen sind jetzt mit S2S OAuth konfiguriert. Frühere Konfigurationen wurden mit JWT-Berechtigungen erstellt, die in der Adobe Developer Console nicht mehr unterstützt werden. -
Experience Fragments werden aus der AEM-Autoreninstanz exportiert. Daher müssen Sie auf der Autoreninstanz den AEM Link Externalizer konfigurieren, um sicherzustellen, dass alle Verweise im Experience Fragment für die Web-Bereitstellung externalisiert werden.
note note NOTE Für das Umschreiben von Links, die nicht von der Standardeinstellung abgedeckt werden, ist der Experience Fragment Link Rewriter Provider verfügbar. Dadurch können für Ihre Instanz benutzerdefinierte Regeln entwickelt werden.
Hinzufügen der Cloud-Konfiguration add-the-cloud-configuration
Bevor Sie ein Fragment exportieren, müssen Sie die Cloud-Konfiguration für Adobe Target zum Fragment oder Ordner hinzufügen. Dies ermöglicht Ihnen auch:
- die für den Export zu verwendenden Formatoptionen anzugeben
- einen Target-Arbeitsbereich als Ziel auszuwählen
- eine Externalizer-Domain zum Umschreiben von Verweisen im Experience Fragment auszuwählen (optional)
Die erforderlichen Optionen können in den Seiteneigenschaften des erforderlichen Ordners bzw. Fragments ausgewählt werden. Die Spezifikation wird nach Bedarf vererbt.
-
Navigieren Sie zur Experience Fragment-Konsole.
-
Öffnen Sie die Seiteneigenschaften für den entsprechenden Ordner oder das Fragment.
note note NOTE Wenn Sie die Cloud-Konfiguration zum übergeordneten Ordner des Experience Fragments hinzufügen, wird die Konfiguration von allen untergeordneten Elementen geerbt. Wenn Sie die Cloud-Konfiguration zum Experience Fragment selbst hinzufügen, wird die Konfiguration an alle Varianten vererbt. -
Wählen Sie die Registerkarte Cloud-Services aus.
-
Wählen Sie unter Cloud Service-Konfiguration in der Dropdown-Liste den Eintrag Adobe Target.
note note NOTE Das JSON-Format eines Experience Fragment-Angebots kann angepasst werden. Definieren Sie dazu eine kundenspezifische Experience Fragment-Komponente und kommentieren Sie dann, wie die Eigenschaften im Komponenten-Sling-Modell exportiert werden. Beachten Sie die Kernkomponente: Kernkomponenten – Experience Fragments Wählen Sie unter Adobe Target Folgendes aus:
- die passende Konfiguration
- die Option für das erforderliche Format
- einen Adobe Target-Arbeitsbereich
- falls erforderlich – die Externalizer-Domain
note caution CAUTION Die Externalizer-Domain ist optional. Ein AEM Externalizer wird konfiguriert, wenn die exportierten Inhalte auf eine bestimmte Veröffentlichungs-Domain verweisen sollen. Weitere Informationen finden Sie unter Konfigurieren des AEM Link Externalizers. Beachten Sie außerdem, dass Externalizer-Domains nur für den Inhalt des Experience Fragments, das an Target gesendet wird, relevant sind und nicht Metadaten wie Inhalte zum Anzeigen von Angeboten. Zum Beispiel für einen Ordner:
-
Speichern und schließen.
Ein Experience Fragment nach Adobe Target exportieren exporting-an-experience-fragment-to-adobe-target
Exportieren eines Experience Fragments aus AEM in Target (nach Angabe der Cloud-Konfiguration):
-
Navigieren Sie zur Experience Fragment-Konsole.
-
Wählen Sie das Experience Fragment aus, das Sie in nach Target exportieren möchten.
note note NOTE Es muss sich um eine Experience Fragment Web-Variante handeln. -
Klicken Sie auf In Adobe Target exportieren.
note note NOTE Wenn das Experience Fragment bereits exportiert wurde, wählen Sie In Adobe Target aktualisieren. -
Klicken Sie auf Exportieren ohne Veröffentlichung bzw. auf Veröffentlichen.
note note NOTE Wenn Sie Veröffentlichen auswählen, wird das Experience Fragment sofort veröffentlicht und an Target gesendet. -
Klicken Sie im Bestätigungsdialogfeld auf OK.
Ihr Experience Fragment sollte jetzt in Target enthalten sein.
note note NOTE In der Listenansicht der Konsole und in den Eigenschaften werden verschiedene Details des Exports angezeigt. note note NOTE Beim Anzeigen eines Experience Fragments in Adobe Target gibt Zuletzt geändert an, wann das Fragment zuletzt in AEM geändert wurde. Es ist nicht das Datum, an dem das Fragment zuletzt in Adobe Target exportiert wurde.
Ihre Experience Fragments in Adobe Target verwenden using-your-experience-fragments-in-adobe-target
Nach dem Ausführen der zuvor genannten Aufgaben wird das Experience Fragment auf der Seite „Angebote“ in Adobe Target angezeigt. Schauen Sie sich die spezifische Target-Dokumentation an, um zu erfahren, was Sie dort erreichen können.
Löschen eines bereits nach Adobe Target exportierten Experience Fragments deleting-an-experience-fragment-already-exported-to-adobe-target
Das Löschen eines Experience Fragments, das bereits in Target exportiert wurde, kann Probleme verursachen, wenn das Fragment bereits in einem Angebot in Adobe Target verwendet wird. Durch das Löschen des Fragments wird das Angebot unbrauchbar, da der Fragmentinhalt von AEM bereitgestellt wird.
So vermeiden Sie solche Situationen:
-
Wenn das Experience Fragment derzeit nicht in einer Aktivität verwendet wird, ermöglicht AEM es den Benutzenden, das Fragment ohne Warnmeldung zu löschen.
-
Wenn das Experience Fragment derzeit von einer Aktivität in Adobe Target verwendet wird, werden AEM-Benutzende durch eine Fehlermeldung über die möglichen Auswirkungen eines Löschens des Fragments auf die Aktivität gewarnt.
Die Fehlermeldung in AEM untersagt den Benutzenden nicht das (erzwungene) Löschen des Experience Fragments. Wenn das Experience Fragment gelöscht wurde, gilt Folgendes:
-
Das Target-Angebot mit dem AEM Experience Fragment kann unerwünschtes Verhalten zeigen
- Das Angebot wird wahrscheinlich noch gerendert, da das Experience Fragment-HTML nach Target verschoben wurde
- Verweise im Experience Fragment funktionieren möglicherweise nicht ordnungsgemäß, wenn referenzierte Assets auch in AEM gelöscht wurden.
-
Es sind keine weiteren Änderungen am Experience Fragment möglich, da es nicht mehr in AEM vorhanden ist.
-
Entfernen von Client-Bibliotheken aus nach Target exportierten Experience Fragments removing-clientlibs-from-fragments-exported-target
Experience Fragments enthalten vollständige HTML-Tags und alle erforderlichen Client-Bibliotheken (CSS/JS), um das Fragment genau so wiederzugeben, wie es von dem Inhaltsautor bzw. der Inhaltsautorin des Experience Fragments erstellt wurde. Dies ist beabsichtigt.
Wenn Sie ein Experience Fragment-Angebot mit Adobe Target auf einer Seite verwenden, die von AEM bereitgestellt wird, enthält die Zielseite bereits alle erforderlichen Client-Bibliotheken. Außerdem wird das überflüssige HTML im Experience Fragment-Angebot ebenfalls nicht benötigt (siehe Überlegungen).
Im Folgenden finden Sie ein Pseudobeispiel für HTML in einem Experience Fragment-Angebot:
<!DOCTYPE>
<html>
<head>
<title>…</title>
<!-- all the client libraries (css/js) -->
…
</head>
<body>
<!--/* Actual XF Offer content would appear here... */-->
</body>
</html>
Wenn AEM ein Experience Fragment in Adobe Target exportiert, verwendet es mehrere zusätzliche Sling-Selektoren. Beispielsweise könnte die URL für das exportierte Experience Fragment wie folgt aussehen (beachten Sie nocloudconfigs.atoffer):
- http://www.your-aem-instance.com/content/experience-fragments/my-offers/my-xf-offer.nocloudconfigs.atoffer.html
Der Selektor nocloudconfigs wird mithilfe von HTL definiert und kann überlagert werden, indem er aus der folgenden Quelle kopiert wird:
- /libs/cq/experience-fragments/components/xfpage/nocloudconfigs.html
Der Selektor atoffer wird bei der Nachbearbeitung mit Sling Rewriter angewendet. Beide können verwendet werden, um die Client-Bibliotheken zu entfernen.
Beispiel example
Für unsere Zwecke veranschaulichen wir dies mit nocloudconfigs.
Überlagerungen overlays
In diesem Beispiel werden die Überlagerungen eingefügt, um die Client-Bibliotheken und die überflüssige HTML zu entfernen. Es wird davon ausgegangen, dass Sie den Experience Fragment-Vorlagentyp bereits erstellt haben. Zu den notwendigen Dateien, die von /libs/cq/experience-fragments/components/xfpage/ kopiert werden müssen, gehören:
nocloudconfigs.htmlhead.nocloudconfigs.htmlbody.nocloudconfigs.html
Überlagerungen vom Vorlagentyp template-type-overlays
Für dieses Beispiel verwenden wir die folgende Struktur:
Diese Dateien enthalten folgende Inhalte:
-
body.nocloudconfigs.html
-
head.nocloudconfigs.html
-
nocloudconfigs.html
data-sly-unwrap zum Entfernen des Body-Tags zu verwenden, benötigen Sie nocloudconfigs.html.Überlegungen considerations
Wenn Sie sowohl AEM-Sites als auch Nicht-AEM-Sites mit Experience Fragment-Angeboten in Adobe Target unterstützen möchten, müssen Sie zwei Experience Fragments (zwei verschiedene Vorlagentypen) erstellen:
-
Eins mit der Überlagerung zum Entfernen von clientlibs/extra HTML
-
Eins, das nicht über die Überlagerung verfügt und daher die erforderlichen clientlibs enthält