Exportieren von Inhaltsfragmenten nach Adobe Target exporting-content-fragments-to-adobe-target

CAUTION
  • Die AEM Inhaltsfragmente 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 Inhaltsfragmente, 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 die Option zum Exportieren eines Inhaltsfragments nach Adobe Target:

  • JSON: Unterstützung der Headless-Inhaltsbereitstellung

Um Ihre Instanz für den Export von AEM-Inhaltsfragmenten nach Adobe Target vorzubereiten, müssen Sie Folgendes tun:

Danach können Sie:

Inhaltsfragmente können in den Standardarbeitsbereich in Adobe Target oder in benutzerdefinierte Arbeitsbereiche für Adobe Target exportiert werden.

NOTE
Die Adobe Target-Arbeitsbereiche sind nicht in Adobe Target selbst vorhanden. Sie werden in Adobe IMS (Identity Management System) definiert und verwaltet und dann zur lösungsübergreifenden Verwendung mithilfe der Adobe-Entwicklerkonsole ausgewählt.
NOTE
Adobe Target-Arbeitsbereiche können verwendet werden, um es Mitgliedern einer Organisation (Gruppe) zu ermöglichen, Angebote und Aktivitäten nur für diese Organisation zu erstellen und zu verwalten, ohne anderen Benutzern Zugriff zu gewähren. Zum Beispiel länderspezifische Organisationen innerhalb eines globalen Konzerns.

Voraussetzungen prerequisites

Die folgende Aktion ist erforderlich:

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-Domäne zum Umschreiben von Verweisen im Inhaltsfragment 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.

  1. Navigieren Sie zur Assets-Konsole.

  2. Öffnen Sie die Seiteneigenschaften für den entsprechenden Ordner oder das Fragment.

    note note
    NOTE
    Wenn Sie die Cloud-Konfiguration zum übergeordneten Ordner des Inhaltsfragments hinzufügen, wird die Konfiguration von allen untergeordneten Elementen übernommen.
    Wenn Sie die Cloud-Konfiguration zum Inhaltsfragment hinzufügen, wird die Konfiguration von allen Varianten übernommen.
  3. Wählen Sie die Registerkarte Cloud-Services aus.

  4. Wählen Sie unter Cloud Service-Konfiguration in der Dropdown-Liste den Eintrag Adobe Target.

    note note
    NOTE
    Das JSON-Format des Angebots eines Inhaltsfragments kann angepasst werden. Definieren Sie dazu eine kundenspezifische Inhaltsfragment-Komponente und kommentieren Sie dann, wie die Eigenschaften im Komponenten-Sling-Modell exportiert werden sollen.
    Siehe Kernkomponente: Kernkomponenten – Inhaltsfragmente
  5. 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-Domänen nur für den Inhalt des Inhaltsfragmentes, das an Target gesendet wird, relevant sind und nicht Metadaten wie Inhalte zum Anzeigen von Angeboten.

    Zum Beispiel für einen Ordner:

    Ordner – Cloud Services

  6. Speichern und schließen.

Hinzufügen der Legacy-Konfiguration add-the-legacy-configuration

IMPORTANT
Das Hinzufügen einer neuen Legacy-Konfiguration ist ein Sonderszenario, das nur für den Export von Inhaltsfragmenten unterstützt wird.

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:

  1. Gehen Sie zu Legacy Cloud Services: Über das AEM-LogoTools > 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.

  2. Klicken Sie im Abschnitt  Adobe Target auf Jetzt konfigurieren.

  3. Im Dialogfeld  Konfiguration erstellen:

    1. Geben Sie der Konfiguration einen Titel.
    2. Wählen Sie die Vorlage Adobe Target-Konfiguration aus.
    3. Klicken Sie auf Erstellen.

Sie können jetzt die neue Konfiguration zur Bearbeitung auswählen.

  1. Das Dialogfeld „Bearbeiten“ wird geöffnet.

    config-target-settings-dialog

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

  1. Klicken Sie auf der Seite für die Target-Konfiguration auf das Pluszeichen (+) neben „Verfügbare Konfigurationen“.

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

  3. 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.

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

Exportieren eines Inhaltsfragments nach Adobe Target exporting-a-content-fragment-to-adobe-target

CAUTION
Für Medien-Assets wie Bilder wird nur ein Verweis nach Target exportiert. Das Asset selbst bleibt in AEM Assets gespeichert und wird von der AEM-Veröffentlichungsinstanz bereitgestellt.
Deshalb muss das Inhaltsfragment mit allen zugehörigen Assets veröffentlicht werden, bevor es nach Target exportiert wird.

So exportieren Sie ein Inhaltsfragment aus AEM in Target (nach Angabe der Cloud-Konfiguration):

  1. Navigieren Sie zu Ihrem Inhaltsfragment in der Assets-Konsole.

  2. Wählen Sie das Inhaltsfragment aus, das Sie in die Zielgruppe exportieren möchten.

  3. Wählen Sie Nach Adobe Target-Angebote exportieren aus.

    Nach Adobe Target exportieren

  4. Wählen Sie Exportieren ohne Veröffentlichung bzw. Veröffentlichen aus.

    note note
    NOTE
    Welche Aktionen tatsächlich angezeigt werden, hängt vom Status Ihres Fragments und der zugehörigen Assets ab.
    Wenn alles bereits veröffentlicht wurde und seitdem nichts mehr geändert wurde, wird dieser Schritt übersprungen.
    note note
    NOTE
    Wenn Sie Veröffentlichen auswählen, wird das Inhaltsfragment sofort veröffentlicht und an Target gesendet.
  5. Wählen Sie im Bestätigungsdialogfeld OK aus.

    Ihr Inhaltsfragment sollte sich jetzt in Target befinden.

    note note
    NOTE
    Viele Details des Exports können in der Listenansicht der Konsole und den Eigenschaften eingesehen werden.
    note note
    NOTE
    Beim Anzeigen eines Inhaltsfragments 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.
NOTE
Alternativ können Sie den Export auch über den Seiteneditor durchführen, indem Sie vergleichbare Befehle im Menü Seiteninformationen verwenden.

Verwenden Ihrer Inhaltsfragmente in Adobe Target using-your-content-fragments-in-adobe-target

Nach dem Ausführen der zuvor genannten Aufgaben wird das Inhaltsfragment auf der Seite „Angebote“ in Target angezeigt. In der spezifischen Target-Dokumentation erfahren Sie, was Sie dort erreichen können.

NOTE
Beim Anzeigen eines Inhaltsfragments 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.

Löschen eines bereits nach Adobe Target exportierten Inhaltsfragments deleting-a-content-fragment-already-exported-to-adobe-target

Wie beim Exportieren kann auch das Löschen eines Inhaltsfragments aus Adobe Target über die obere Symbolleiste der Assets-Konsole ausgewählt werden, sobald das Fragment ausgewählt wurde:

Löschen in Adobe Target

Das Löschen eines Inhaltsfragments, 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 Inhaltsfragment derzeit nicht in einer Aktivität verwendet wird, ermöglicht AEM es den Benutzenden, das Fragment ohne Warnmeldung zu löschen.

  • Wenn das Inhaltsfragment 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 Inhaltsfragments. Wenn das Inhaltsfragment gelöscht wurde, gilt Folgendes:

    • Das Target-Angebot mit dem AEM-Inhaltsfragment kann unerwünschtes Verhalten zeigen

      • Das Angebot wird wahrscheinlich weiterhin gerendert, da das Inhaltsfragment an Target übermittelt wurde.
      • Verweise im Inhaltsfragment funktionieren möglicherweise nicht ordnungsgemäß, wenn referenzierte Assets in AEM ebenfalls gelöscht wurden.
    • Natürlich sind keine weiteren Änderungen am Inhaltsfragment möglich, da es nicht mehr in AEM vorhanden ist.

Weitere Ressourcen further-resources

Weitere Informationen finden Sie in den folgenden Themen:

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab