Integration

Verwenden von Adobe Experience Platform Launch über die Adobe Developer Console

AEM Sites 6.5

Voraussetzungen

  • Die AEM-Autoren- und -Veröffentlichungsinstanz wird auf dem localhost-Port 4502 bzw. 4503 ausgeführt.

  • Experience Cloud

    • Es besteht Zugriff auf die Adobe Experience Cloud-Bereitstellung Ihres Unternehmens: https://<yourcompany>.experiencecloud.adobe.com

    • Bereitstellung von Experience Cloud mit den folgenden Lösungen:

      note note
      NOTE
      Sie sollten in Launch über die Berechtigungen „Entwickeln“, „Genehmigen“, „Veröffentlichen“, „Erweiterungen verwalten“ und „Umgebungen verwalten“ verfügen. Wenn Sie einen dieser Schritte nicht ausführen können, da die Optionen in der Benutzeroberfläche nicht verfügbar sind, wenden Sie sich an Ihre Experience Cloud-Admins, um Zugriff anzufordern. Weitere Informationen zu Adobe Experience Platform Launch-Berechtigungen finden Sie in der Dokumentation.
  • Browser-Plug-ins

    • Adobe Experience Cloud Debugger (Chrome)
    • Launch and DTM Switch (Chrome)

Beteiligte Benutzerinnen und Benutzer

Für diese Integration müssen folgende Zielgruppen einbezogen werden. Bei bestimmten Aufgaben benötigen Sie außerdem unter Umständen Administratorzugriff.

  • Entwicklerin oder Entwickler
  • AEM-Admin
  • Experience Cloud-Admin

Einführung

AEM bietet eine vorkonfigurierte Integration mit Experience Platform Launch. Mit dieser Integration können AEM-Admins Experience Platform Launch einfach über eine benutzerfreundliche Oberfläche konfigurieren, wodurch bei der Konfiguration dieser beiden Tools der Aufwand und die Fehleranzahl reduziert werden. Und durch das bloße Hinzufügen der Adobe Target-Erweiterung zu Experience Platform Launch können wir alle Funktionen von Adobe Target auf AEM-Web-Seiten nutzen.

In diesem Abschnitt werden die folgenden Integrationsschritte behandelt:

  • Launch

    • Erstellen einer Launch-Eigenschaft
    • Hinzufügen einer Target-Erweiterung
    • Erstellen eines Datenelements
    • Erstellen einer Seitenregel
    • Einrichten von Umgebungen
    • Erstellen und Veröffentlichen
  • AEM

    • Erstellen eines Cloud-Service
    • Erstellen

Launch

Erstellen einer Launch-Eigenschaft

Eine Eigenschaft ist ein Container, den Sie beim Bereitstellen von Tags auf Ihrer Site mit Erweiterungen, Regeln, Datenelementen und Bibliotheken füllen.

  1. Navigieren Sie zur Adobe Experience Cloud-Bereitstellung Ihres Unternehmens: https://<yourcompany>.experiencecloud.adobe.com.

  2. Melden Sie sich mit Ihrer Adobe ID an und stellen Sie sicher, dass Sie sich in der richtigen Organisation befinden.

  3. Klicken Sie in der Lösungsauswahl auf Launch und wählen Sie dann die Schaltfläche Zu Launch gehen aus.

    Experience Cloud – Launch

  4. Vergewissern Sie sich, dass Sie sich in der richtigen Organisation befinden, und fahren Sie dann mit dem Erstellen einer Launch-Eigenschaft fort.
    Experience Cloud – Launch

    Weitere Informationen zum Erstellen von Eigenschaften finden Sie in der Produktdokumentation unter Erstellen einer Eigenschaft.

  5. Klicken Sie auf die Schaltfläche Neue Eigenschaft.

  6. Geben Sie einen Namen für Ihre Eigenschaft ein (z. B. AEM Target-Tutorial).

  7. Geben Sie localhost.com als Domain ein, da dies die Domain ist, über die die WKND-Demo-Site ausgeführt wird. Obwohl das Feld Domain erforderlich ist, funktioniert die Launch-Eigenschaft in jeder Domain, in der sie implementiert ist. Dieses Feld dient vor allem dazu, Menüoptionen im Regel-Builder vorab aufzufüllen.

  8. Klicken Sie auf die Schaltfläche Speichern.

    Launch – Neue Eigenschaft

  9. Öffnen Sie die soeben erstellte Eigenschaft und klicken Sie auf die Registerkarte „Erweiterungen“.

Hinzufügen einer Target-Erweiterung

Die Adobe Target-Erweiterung unterstützt Client-seitige Implementierungen, indem at.js verwendet wird, das JavaScript-SDK von Target für das moderne Web. Kundinnen und Kunden, die weiterhin die ältere Target-Bibliothek mbox.js verwenden, sollten auf at.js aktualisieren, um Launch zu verwenden.

Die Target-Erweiterung besteht aus zwei Hauptteilen:

  • der Erweiterungskonfiguration, die die Einstellungen der Hauptbibliothek verwaltet

  • Regelaktionen für Folgendes:

    • Laden von Target (at.js)
    • Hinzufügen von Parametern zu allen Mboxes
    • Hinzufügen von Parametern zur globalen Mbox
    • Auslösen der globalen Mbox
  1. Unter Erweiterungen können Sie die Liste der Erweiterungen sehen, die bereits für Ihre Launch-Eigenschaft installiert sind. (Die Core-Erweiterung von Experience Platform Launch ist standardmäßig installiert.)

  2. Klicken Sie auf die Option Erweiterungskatalog und suchen Sie im Filter nach „Target“.

  3. Wählen Sie die neueste at.js-Version von Adobe Target aus und klicken Sie auf die Option Installieren.
    Launch – Neue Eigenschaft

  4. Klicken Sie auf die Schaltfläche Konfigurieren. Daraufhin werden das Konfigurationsfenster mit Ihren importierten Target-Kontoanmeldeinformationen sowie die at.js-Version für diese Erweiterung angezeigt.
    Target – Erweiterungskonfiguration

    Wenn Target über asynchrone Launch-Einbettungs-Codes bereitgestellt wird, sollten Sie auf Ihren Seiten vor den Launch-Einbettungs-Codes ein Pre-Hiding-Snippet fest codieren, um ein Flackern des Inhalts zu verhindern. An späterer Stelle werden wir mehr über das Pre-Hiding-Snippet erfahren. Sie können das Pre-Hiding-Snippet hier herunterladen.

  5. Klicken Sie auf Speichern, um das Hinzufügen der Target-Erweiterung zu Ihrer Launch-Eigenschaft abzuschließen. Die Target-Erweiterung sollte jetzt unter der Erweiterungsliste Installiert aufgeführt sein.

  6. Wiederholen Sie die obigen Schritte, um nach der Erweiterung „Experience Cloud ID Service“ zu suchen und diese zu installieren.
    Erweiterung – Experience Cloud ID Service

Einrichten von Umgebungen

  1. Klicken Sie auf die Registerkarte Umgebung für Ihre Site-Eigenschaft. Dort wird die Liste der Umgebungen angezeigt, die für Ihre Site-Eigenschaft erstellt werden. Standardmäßig wird für Entwicklung, Staging und Produktion jeweils eine Instanz erstellt.

Datenelement – Seitenname

Erstellen und Veröffentlichen

  1. Klicken Sie auf die Registerkarte Veröffentlichung für Ihre Site-Eigenschaft. Generieren wir nun eine Bibliothek, um unsere Änderungen (Datenelemente, Regeln) zu erstellen und in einer Entwicklungsumgebung bereitzustellen.

    embed

    https://video.tv.adobe.com/v/28412?quality=12&learn=on

  2. Veröffentlichen Sie Ihre Änderungen aus der Entwicklungsumgebung in einer Staging-Umgebung.

    embed

    https://video.tv.adobe.com/v/28419?quality=12&learn=on

  3. Führen Sie die Option Für Staging erstellen aus.

  4. Sobald der Build abgeschlossen ist, führen Sie Zur Veröffentlichung genehmigen aus, wodurch Ihre Änderungen von einer Staging-Umgebung in eine Produktionsumgebung verschoben werden.
    Vom Staging zur Produktion

  5. Führen Sie abschließend die Option Erstellen und in Produktion veröffentlichen aus, um Ihre Änderungen auf die Produktion zu übertragen.
    Erstellen und in Produktion veröffentlichen

Adobe Experience Manager

NOTE
Gewähren Sie der Adobe Developer-Integration Zugriff auf ausgewählte Arbeitsbereiche mit der entsprechenden Rolle, damit ein zentrales Team nur in wenigen Arbeitsbereichen API-gesteuerte Änderungen vornehmen kann.
  1. Erstellen einer IMS-Integration in AEM mit den Adobe Developer-Anmeldeinformationen. (01:12 bis 03:55).
  2. Erstellen einer Eigenschaft in Experience Platform Launch. (siehe Erklärung oben).
  3. Erstellen einer Experience Platform Launch-Integration mithilfe der IMS-Integration aus Schritt 1, um Ihre Launch-Eigenschaft zu importieren.
  4. Zuordnen der Experience Platform Launch-Integration in AEM zu einer Site mithilfe der Browser-Konfiguration. (05:28 bis 06:14).
  5. Manuelle Validierung der Integration. (06:15 bis 06:33).
  6. Verwenden des Launch/DTM-Browser-Plug-ins. (06:34 bis 06:50).
  7. Verwenden des Browser-Plug-ins für Adobe Experience Cloud Debugger. (06:51 bis 07:22).

Nunmehr haben Sie AEM mithilfe von Adobe Experience Platform Launch in Adobe Target integriert, wie in Option 1 beschrieben.

Wenn Sie AEM Experience Fragment-Angebote verwenden möchten, um Ihre Personalisierungsaktivitäten zu unterstützen, gehen Sie zum nächsten Kapitel und integrieren Sie AEM mithilfe der veralteten Cloud-Services in Adobe Target.

recommendation-more-help
d30c09d2-e4b1-4b0b-a09a-250d84817092