Die Integration von AEM mit Adobe Analytics über die Analytics Standard-API erfordert die Konfiguration von Adobe IMS (Identity Management-System) mithilfe der Adobe-Entwicklerkonsole.
Die Unterstützung für die Adobe Analytics Standard API 2.0 ist neu in AEM 6.5.12.0. Diese API-Version unterstützt die IMS-Authentifizierung.
Die Verwendung der Adobe Analytics Classic API 1.4 in AEM wird aus Gründen der Abwärtskompatibilität weiterhin unterstützt. Die Analytics Classic-API verwendet die Authentifizierung mit Benutzeranmeldeinformationen.
Die API-Auswahl wird von der Authentifizierungsmethode gesteuert, die für die AEM/Analytics-Integration verwendet wird.
Weitere Informationen finden Sie unter Migration zu den 2.0-APIs.
Bevor Sie mit diesem Verfahren beginnen:
Der Adobe-Support muss Ihr Konto für Folgendes bereitstellen:
Der Systemadministrator Ihres Unternehmens sollte die Admin Console verwenden, um die erforderlichen Entwickler in Ihrem Unternehmen den relevanten Produktprofilen hinzuzufügen.
Der erste Schritt der Konfiguration besteht darin, in AEM eine IMS-Konfiguration zu erstellen und den öffentlichen Schlüssel zu generieren.
Öffnen Sie in AEM das Menü Tools.
Im Sicherheit Bereich, wählen Sie Adobe IMS-Konfigurationen.
Wählen Sie Erstellen aus, um Technische Kontokonfiguration für Adobe IMS zu öffnen.
Dropdown-Liste unter Cloud-Konfiguration auswählen Adobe Analytics.
Aktivieren Sie Neues Zertifikat erstellen und geben Sie einen neuen Alias ein.
Bestätigen Sie mit Zertifikat erstellen.
Wählen Sie Herunterladen (oder Öffentlichen Schlüssel herunterladen) aus, um die Datei auf Ihr lokales Laufwerk herunterzuladen, damit sie einsatzbereit ist, wenn Sie IMS für die Adobe Analytics-Integration mit AEM konfigurieren.
Lassen Sie diese Konfiguration geöffnet. Sie wird erneut benötigt, wenn Abschließen der IMS-Konfiguration in AEM.
Erstellen Sie mithilfe der Adobe Developer-Konsole ein Projekt (Integration) mit Adobe Analytics (zur Verwendung AEM) und weisen Sie dann die erforderlichen Berechtigungen zu.
Um ein Projekt mit Adobe Analytics zu erstellen, das AEM verwenden können, öffnen Sie die Adobe Developer-Konsole:
Derzeit unterstützt Adobe nur das Dienstkonto (JWT) Berechtigungstyp.
Verwenden Sie nicht das OAuth Server-zu-Server Berechtigungstyp, der in Zukunft unterstützt wird.
Öffnen Sie die Adobe-Entwicklerkonsole für Projekte:
Alle Projekte, die Sie haben, werden angezeigt. Auswählen Neues Projekt erstellen - Ort und Nutzung hängen von Folgendem ab:
Wenn Sie noch kein Projekt haben, Neues Projekt erstellen ist zentriert, unten.
Wenn Sie bereits über vorhandene Projekte verfügen, werden diese aufgelistet und Neues Projekt erstellen befindet sich oben rechts.
Wählen Sie Zum Projekt hinzufügen und dann API aus:
Wählen Sie Adobe Analytics und dann Weiter aus:
Wenn Sie Adobe Analytics abonniert haben, es jedoch nicht aufgeführt wird, sollten Sie die Voraussetzungen prüfen.
Auswählen Dienstkonto (JWT) als Authentifizierungstyp angeben, fahren Sie dann mit Nächste:
Laden Sie Ihren öffentlichen Schlüssel hoch und setzen Sie den Vorgang anschließend mit Weiter fort:
Überprüfen Sie die Anmeldeinformationen und setzen Sie den Vorgang mit Weiter fort:
Wählen Sie die erforderlichen Produktprofile aus und setzen Sie den Vorgang mit Konfigurierte API speichern fort:
Die Konfiguration wird bestätigt.
Weisen Sie der Integration jetzt die erforderlichen Berechtigungen zu:
Öffnen Sie die Adobe Admin Console:
Navigieren Sie zu Produkte (obere Symbolleiste) und wählen Sie Adobe Analytics - <Ihre-Mandanten-ID> (im linken Bereich) aus.
Wählen Sie Produktprofile und dann den gewünschten Arbeitsbereich aus der angezeigten Liste aus. Beispielsweise den Standardarbeitsbereich.
Wählen Sie API-Anmeldeinformationen und dann die erforderliche Integrationskonfiguration aus.
Wählen Sie Editor als Produktrolle aus anstelle von Beobachter.
In der Adobe-Entwicklerkonsole wird eine Liste aller Integrationsprojekte angezeigt:
Um weitere Details zur Konfiguration anzuzeigen, wählen Sie einen bestimmten Eintrag für das Projekt aus. Dazu gehören:
Einige davon müssen Sie die Integration für Adobe Analytics in AEM abschließen.
Kehren Sie zu AEM zurück und Sie können die IMS-Konfiguration abschließen, indem Sie die erforderlichen Werte aus dem Integrationsprojekt für Analytics hinzufügen:
Kehren Sie zur in AEM geöffneten IMS-Konfiguration zurück.
Wählen Sie Weiter aus.
Hier können Sie die für das Integrationsprojekt in der Adobe-Entwicklerkonsole gespeicherten Details verwenden:
aud
-Zeile im Abschnitt Payload unten, z. B. https://ims-na1.adobelogin.com
im nachstehenden Beispiel.Bestätigen Sie mit Erstellen.
Ihre Adobe Analytics-Konfiguration wird in der AEM Console angezeigt.
So überprüfen Sie, ob die Konfiguration erwartungsgemäß funktioniert:
Öffnen Sie:
https://localhost<port>/libs/cq/adobeims-configuration/content/configurations.html
Beispiel:
https://localhost:4502/libs/cq/adobeims-configuration/content/configurations.html
Wählen Sie Ihre Konfiguration aus.
Wählen Konsistenzprüfung auf der Symbolleiste aus, gefolgt von Überprüfen.
Bei Erfolg wird eine Bestätigungsmeldung angezeigt.
Die Konfiguration kann nun referenziert werden, damit ein Cloud Service die Analytics Standard-API verwenden kann:
Öffnen Sie das Menü Tools. Wählen Sie dann im Abschnitt Cloud Services den Eintrag Ältere Cloud Services aus.
Scrollen Sie nach unten zu Adobe Analytics und wählen Sie Jetzt konfigurieren aus.
Die Konfiguration erstellen wird geöffnet.
Geben Sie einen Titel und, falls gewünscht, ein Name (Wenn Sie das Feld leer lassen, wird es aus dem Titel generiert.)
Sie können auch die gewünschte Vorlage auswählen (wenn mehrere Vorlagen verfügbar sind).
Bestätigen Sie mit Erstellen.
Die Komponente bearbeiten wird geöffnet.
Geben Sie die Details auf der Registerkarte Analytics-Einstellungen ein:
Authentifizierung: IMS
IMS-Konfiguration: Name der IMS-Konfiguration
Um die Verbindung mit Adobe Analytics zu initialisieren, klicken Sie auf Verbindung zu Analytics herstellen.
Wenn die Verbindungsherstellung erfolgreich war, wird die Meldung Die Verbindung wurde hergestellt angezeigt.
Wählen Sie in der Meldung OK aus.
Füllen Sie ggf. weitere Parameter aus, gefolgt von OK im Dialogfeld, damit Sie die Konfiguration bestätigen können.
Sie können jetzt fortfahren Hinzufügen eines Analytics-Framework , um Parameter zu konfigurieren, die an Adobe Analytics gesendet werden.