Exportieren von Experience Fragments nach Adobe Target exporting-experience-fragments-to-adobe-target
- Die AEM Experience Fragments werden in den Standardarbeitsbereich von Adobe Target exportiert.
- AEM muss gemäß den Anweisungen unter Integration mit Adobe Target mit Adobe Target integriert werden.
Sie können Experience Fragments, die in Adobe Experience Manager as a Cloud Service (AEM) erstellt wurden, nach Adobe Target (Target) exportieren. Diese können dann als Angebote in Target-Aktivitäten verwendet werden, um Erlebnisse in großem Maßstab zu testen und zu personalisieren.
Es gibt drei Formatoptionen für den Export eines Experience Fragments nach Adobe Target:
- HTML (Standard): Unterstützung der Bereitstellung von Web- und Hybridinhalten
- JSON: Unterstützung der Headless-Inhaltsbereitstellung
- HTML und JSON
Um Ihre Instanz für den Export AEM Experience Fragments nach Adobe Target vorzubereiten, müssen Sie Folgendes tun:
Danach können Sie:
Experience Fragments können in den Standardarbeitsbereich in Adobe Target oder in benutzerdefinierte Arbeitsbereiche für Adobe Target exportiert werden.
Voraussetzungen prerequisites
Verschiedene Aktionen sind erforderlich:
-
Sie müssen AEM mit Adobe Target integrieren.
-
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 Webbereitstellung 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 (oder von beiden) 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 Variationen 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. Siehe 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 publish Domain verweisen sollen. Weitere Informationen finden Sie unter Konfigurieren des AEM Link Externalizer. 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.
Hinzufügen der Legacy-Konfiguration add-the-legacy-configuration
Nachdem Sie die Cloud-Konfiguration für die Verwendung von Experience Platform Launch hinzugefügt haben, müssen Sie die Integration von AEM mit Adobe Target auch manuell mit einer Legacy-Konfiguration durchführen.
Erstellen einer Target-Cloud-Konfiguration creating-a-target-cloud-configuration
Um AEM die Interaktion mit Adobe Target zu ermöglichen, erstellen Sie eine Target-Cloud-Konfiguration. Um die Konfiguration zu erstellen, geben Sie den Adobe Target-Clientcode und die Benutzeranmeldeinformationen an.
Sie erstellen die Target-Cloud-Konfiguration nur einmal, da Sie die Konfiguration mit mehreren AEM-Kampagnen verknüpfen können. Wenn Sie mehrere Adobe Target-Clientcodes haben, erstellen Sie für jeden Clientcode eine Konfiguration.
Sie können die Cloud-Konfiguration so konfigurieren, dass Segmente aus Adobe Target synchronisiert werden. Wenn Sie die Synchronisierung aktivieren, werden Segmente im Hintergrund aus Target importiert, sobald die Cloud-Konfiguration gespeichert wurde.
Gehen Sie wie folgt vor, um eine Target-Cloud-Konfiguration in AEM zu erstellen:
-
Gehen Sie zu Legacy Cloud Services: Über das AEM-Logo > Tools > Cloud-Services zu Legacy Cloud Services.
Zum Beispiel: (http://localhost:4502/libs/cq/core/content/tools/cloudservices.html)Die Übersichtsseite Adobe Experience Cloud wird geöffnet.
-
Klicken Sie im Abschnitt Adobe Target auf Jetzt konfigurieren.
-
Im Dialogfeld Konfiguration erstellen:
- Geben Sie der Konfiguration einen Titel.
- Wählen Sie die Vorlage Adobe Target-Konfiguration aus.
- Klicken Sie auf Erstellen.
Sie können jetzt die neue Konfiguration zur Bearbeitung auswählen.
-
Das Dialogfeld „Bearbeiten“ wird geöffnet.
-
Geben Sie im Dialogfeld Adobe Target-Einstellungen Werte für diese Eigenschaften an.
-
Authentifizierung: dies ist standardmäßig IMS (Benutzeranmeldedaten werden nicht mehr unterstützt)
-
Client-Code: Der Client-Code des Target-Kontos
-
Mandanten-ID: die Mandanten-ID
-
IMS-Konfiguration: Wählen Sie die gewünschte Konfiguration aus der Dropdown-Liste aus
-
API-Typ: standardmäßig auf REST gesetzt (XML ist veraltet)
-
A4T-Analytics-Cloud-Konfiguration: Wählen Sie die Analyse-Cloud-Konfiguration aus, die für Target-Aktivitätsziele und -metriken verwendet wird. Sie benötigen sie, wenn Sie Adobe Analytics als Quelle für das Reporting für bestimmte Inhalte verwenden.
-
Präzises Targeting verwenden: Dieses Kontrollkästchen ist standardmäßig aktiviert. Wenn diese Option aktiviert ist, wartet die Cloud-Service-Konfiguration auf das Laden des Kontexts, bevor der Inhalt geladen wird. Siehe folgenden Hinweis.
-
Segmente aus Adobe Target synchronisieren: Aktivieren Sie diese Option, um in Target definierte Segmente herunterzuladen und in AEM zu verwenden. Wählen Sie diese Option aus, wenn die Eigenschaft „API-Typ“ auf „REST“ festgelegt ist, da Inline-Segmente nicht unterstützt werden und Sie immer Segmente aus Target verwenden müssen. (Der AEM-Begriff „Segment“ ist gleichbedeutend mit dem Target-Begriff „Zielgruppe“.)
-
Client-Bibliothek: dies ist standardmäßig AT.js (mbox.js wird nicht mehr unterstützt)
note note NOTE Die Target-Bibliotheksdatei AT.js ist die neue Implementierungsbibliothek für Adobe Target. Sie ist sowohl auf typische Web-Implementierungen als auch auf Einzelseitenanwendungen ausgelegt. mbox.js ist veraltet und wird zu einem späteren Zeitpunkt entfernt. Adobe empfiehlt die Verwendung von „AT.js“ anstelle von „mbox.js“ als Client-Bibliothek. „AT.js“ bietet gegenüber der Bibliothek von „mbox.js“ verschiedene Verbesserungen: - Verbesserte Seitenladezeiten für Web-Implementierungen
- Verbesserte Sicherheit
- Bessere Implementierungsoptionen für Single Page Applications (SPA)
- „at.js“ enthält die Komponenten, die in „target.js“ enthalten waren, weshalb kein Aufruf mehr an „target.js“ erfolgt
Sie können im Dropdown-Menü Client-Bibliothek die Datei „AT.js“ oder „mbox.js“ auswählen. -
Verwenden des Tag Management Systems zur Bereitstellung der Client-Bibliothek: Wählen Sie diese Option, um die Client-Bibliothek aus Adobe Launch oder einem anderen Tag-Management-System (oder DTM, das nicht mehr unterstützt wird) zu verwenden.
-
Benutzerdefinierte AT.js: Durchsuchen, um Ihre benutzerdefinierte AT.js-Datei hochzuladen. Lassen Sie das Feld leer, um die Standardbibliothek zu verwenden.
note note NOTE Wenn Sie den Opt-in für den Adobe Target-Konfigurationsassistenten durchführen, wird die „präzise Zielgruppenerfassung“ aktiviert. Präzise Zielgruppenerfassung bedeutet, dass für die Cloud Service-Konfiguration gewartet wird, bis das Laden des Kontexts erfolgt ist, bevor der Inhalt geladen wird. Aus diesem Grund kann hinsichtlich der Leistung eine präzise Zielgruppenbestimmung eine Verzögerung von einigen Millisekunden verursachen, bevor das Laden des Inhalts erfolgt. Die präzise Zielgruppenerfassung ist auf der Autoreninstanz immer aktiviert. Auf der Veröffentlichungsinstanz können Sie die präzise Zielgruppenerfassung aber global deaktivieren, indem Sie in der Cloud Service-Konfiguration das Häkchen neben „Präzise Zielgruppenerfassung“ entfernen (http://localhost:4502/etc/cloudservices.html). Sie können die präzise Zielgruppenerfassung auch für einzelne Komponenten aktivieren und deaktivieren, unabhängig von Ihrer Einstellung in der Cloud-Service-Konfiguration. Wenn Sie bereits Zielkomponenten erstellt haben und Sie diese Einstellung ändern, wirken sich Ihre Änderungen nicht auf diese Komponenten aus. Sie müssen alle Änderungen an diesen Komponenten direkt vornehmen.
-
-
Klicken Sie auf Mit Adobe Target verbinden, um die Verbindung mit Target zu initialisieren. Wenn die Verbindungsherstellung erfolgreich war, wird die Meldung Die Verbindung wurde hergestellt angezeigt. Klicken Sie auf OK und dann auf OK.
Hinzufügen eines Target-Frameworks adding-a-target-framework
Nachdem Sie die Target-Cloud-Konfiguration konfiguriert haben, fügen Sie ein Target-Framework hinzu. Das Framework bestimmt die Standardparameter, die von den verfügbaren ContextHub-Komponenten an Adobe Target gesendet werden. Target nutzt die Parameter, um die Segmente zu ermitteln, die für den aktuellen Kontext gelten.
Sie können mehrere Frameworks für eine einzelne Target-Konfiguration erstellen. Mehrere Frameworks sind nützlich, wenn Sie für unterschiedliche Abschnitte Ihrer Website jeweils einen anderen Parametersatz an Target senden müssen. Erstellen Sie ein Framework für jeden Parametersatz, der gesendet werden muss. Verknüpfen Sie jeden Bereich Ihrer Website mit dem entsprechenden Framework. Beachten Sie, dass für eine Webseite nur jeweils ein Framework verwendet werden kann.
-
Klicken Sie auf der Seite für die Target-Konfiguration auf das Pluszeichen (+) neben „Verfügbare Konfigurationen“.
-
Geben Sie im Dialogfeld „Framework erstellen“ einen Titel an, wählen Sie die Option Adobe Target-Framework und klicken Sie auf Erstellen.
Die Framework-Seite wird geöffnet. Sidekick bietet Komponenten mit Informationen zu dem ContextHub, den Sie zuordnen können.
-
Ziehen Sie die ClientContext-Komponente mit den Daten, die Sie für die Zuordnung nutzen möchten, auf das Ablageziel. Alternativ hierzu können Sie die ContextHub-Store-Komponente auf das Framework ziehen.
note note NOTE Bei der Zuordnung werden Parameter über einfache Zeichenfolgen an eine mBox übergeben. Es ist nicht möglich, Arrays aus ContextHub zuzuordnen. Ziehen Sie beispielsweise die Komponente Profildaten auf die Seite, um Profildaten zu Ihren Websitebesuchern zum Steuern Ihrer Target-Kampagne zu verwenden. Es werden die Profildatenvariablen angezeigt, die für die Zuordnung zu Target-Parametern verfügbar sind.
-
Wählen Sie die Variablen aus, die für das Adobe Target-System sichtbar sein sollen, indem Sie das Kontrollkästchen Freigeben in den entsprechenden Spalten auswählen.
note note NOTE Das Synchronisieren von Parametern erfolgt nur in eine Richtung, nämlich von AEM zu Adobe Target.
Ihr Framework wird erstellt. Um das Framework auf der Veröffentlichungsinstanz zu replizieren, verwenden Sie die Option Framework aktivieren aus dem Sidekick.
Ein Experience Fragment nach Adobe Target exportieren exporting-an-experience-fragment-to-adobe-target
So exportieren Sie ein Experience Fragment aus AEM nach 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. -
Wählen Sie Nach Adobe Target exportieren aus
note note NOTE Wenn das Experience Fragment bereits exportiert wurde, wählen Sie In Adobe Target aktualisieren. -
Wählen Sie Exportieren ohne Veröffentlichung bzw. Veröffentlichen aus.
note note NOTE Wenn Sie Veröffentlichen auswählen, wird das Experience Fragment sofort veröffentlicht und an Target gesendet. -
Wählen Sie im Bestätigungsdialogfeld OK aus.
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 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 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 Target verwendet wird, werden AEM-Benutzende durch eine Fehlermeldung über die möglichen Auswirkungen des 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.
-
Natürlich sind keine weiteren Änderungen am Experience Fragment möglich, da es nicht mehr in AEM vorhanden ist.
-