[Integration]{class="badge positive"}
Verwenden von Tags über Adobe Developer Console
[AEM Sites 6.5]{class="badge informative"}
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 der Datenerfassung ü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 Tags-Berechtigungen finden Sie in der Dokumentation.
-
-
Chrome-Browser-Erweiterungen
- Adobe Experience Cloud Debugger (https://chrome.google.com/webstore/detail/adobe-experience-platform/bfnnokhpnncpkdmbokanobigaccjkpob)
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 Tags. Mit dieser Integration können AEM-Admins Tags 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 Tags können wir alle Funktionen von Adobe Target auf AEM-Web-Seiten nutzen.
In diesem Abschnitt werden die folgenden Integrationsschritte behandelt:
-
Tags
- Erstellen einer Tags-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
Tags
Erstellen einer Tags-Eigenschaft
Eine Eigenschaft ist ein Container, den Sie beim Bereitstellen von Tags auf Ihrer Site mit Erweiterungen, Regeln, Datenelementen und Bibliotheken füllen.
- Navigieren Sie zur Adobe Experience Cloud-Bereitstellung Ihres Unternehmens:
https://<yourcompany>.experiencecloud.adobe.com. - Melden Sie sich mit Ihrer Adobe ID an und stellen Sie sicher, dass Sie sich in der richtigen Organisation befinden.
- Klicken Sie in der Lösungsauswahl auf Experience Platform, dann auf den Abschnitt Datenerfassung und wählen Sie Tags aus.
-
Vergewissern Sie sich, dass Sie sich in der richtigen Organisation befinden, und fahren Sie dann mit dem Erstellen einer Tags-Eigenschaft fort.
Weitere Informationen zum Erstellen von Eigenschaften finden Sie in der Produktdokumentation unter Erstellen einer Eigenschaft.
-
Klicken Sie auf die Schaltfläche Neue Eigenschaft.
-
Geben Sie einen Namen für Ihre Eigenschaft ein (z. B. AEM Target-Tutorial).
-
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 Tags-Eigenschaft in jeder Domain, in der sie implementiert ist. Dieses Feld dient vor allem dazu, Menüoptionen im Regel-Builder vorab aufzufüllen.
-
Klicken Sie auf die Schaltfläche Speichern.
-
Ö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 Tags 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
-
Unter Erweiterungen können Sie die Liste der Erweiterungen sehen, die bereits für Ihre Tags-Eigenschaft installiert sind. (Die Core-Erweiterung von Adobe Launch ist standardmäßig installiert.)
-
Klicken Sie auf die Option Erweiterungskatalog und suchen Sie im Filter nach „Target“.
-
Wählen Sie die neueste at.js-Version von Adobe Target aus und klicken Sie auf die Option Installieren.
-
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.
Wenn Target über asynchrone Tags-Einbettungs-Codes bereitgestellt wird, sollten Sie auf Ihren Seiten vor den Tags-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.
-
Klicken Sie auf Speichern, um das Hinzufügen der Target-Erweiterung zu Ihrer Tags-Eigenschaft abzuschließen. Die Target-Erweiterung sollte nun unter der Erweiterungsliste Installiert aufgeführt sein.
-
Wiederholen Sie die obigen Schritte, um nach der Erweiterung „Experience Cloud ID Service“ zu suchen und diese zu installieren.
Einrichten von Umgebungen
- 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.
Erstellen und Veröffentlichen
-
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 -
Veröffentlichen Sie Ihre Änderungen aus der Entwicklungsumgebung in einer Staging-Umgebung.
embed -
Führen Sie die Option Für Staging erstellen aus.
-
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.
-
Führen Sie abschließend die Option Erstellen und in Produktion veröffentlichen aus, um Ihre Änderungen auf die Produktion zu übertragen.
Adobe Experience Manager
- Erstellen einer IMS-Integration in AEM mit den Adobe Developer-Anmeldeinformationen. (01:12 bis 03:55).
- Erstellen Sie unter der Datenerfassung eine Eigenschaft (siehe Erklärung oben).
- Erstellen Sie mithilfe der IMS-Integration aus Schritt 1 eine Tags-Integration, um Ihre Tags-Eigenschaft zu importieren.
- Ordnen Sie die Tags-Integration in AEM mithilfe der Browser-Konfiguration einer Site zu. (05:28 bis 06:14).
- Manuelle Validierung der Integration. (06:15 bis 06:33).
- Verwenden des Browser-Plug-ins für Adobe Experience Cloud Debugger. (06:51 bis 07:22).
An dieser Stelle haben Sie AEM erfolgreich in Adobe Target unter Verwendung von Tags integriert, wie unter 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.