Die Integration von AEM mit Adobe Analytics über die Analytics Standard-API erfordert die Konfiguration von Adobe IMS (Identity Management-System) mithilfe der Adobe Developer Console.
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 Die Analytics Classic-API verwendet die Authentifizierung von 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:
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, eine IMS-Konfiguration in AEM zu erstellen und den öffentlichen Schlüssel zu generieren.
Öffnen Sie AEM Instrumente Menü.
Im Sicherheit Abschnittsauswahl Adobe IMS-Konfigurationen.
Auswählen Erstellen , um Technische Kontokonfiguration für Adobe IMS.
Verwenden der Dropdown-Liste unter Cloud-Konfiguration auswählen Adobe Analytics.
Aktivieren Neues Zertifikat erstellen und geben Sie einen neuen Alias ein.
Bestätigen mit Zertifikat erstellen.
Auswählen Download (oder Öffentlichen Schlüssel herunterladen), um die Datei auf Ihr lokales Laufwerk herunterzuladen, damit sie einsatzbereit ist, wenn IMS für die Adobe Analytics-Integration mit AEM konfigurieren.
Lassen Sie diese Konfiguration geöffnet. Sie wird bei Abschließen der IMS-Konfiguration in AEM.
Mithilfe der Adobe Developer Console müssen Sie ein Projekt (Integration) mit Adobe Analytics erstellen (AEM verwenden) und dann die erforderlichen Berechtigungen zuweisen.
Öffnen Sie die Adobe Developer Console, um ein Projekt mit Adobe Analytics zu erstellen, das AEM Folgendes verwenden wird:
Öffnen Sie die Adobe Developer Console for Projects:
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 wird zentriert sein, unten.
Wenn Sie bereits über vorhandene Projekte verfügen, werden diese aufgelistet und Neues Projekt erstellen oben rechts.
Auswählen Zum Projekt hinzufügen gefolgt von API:
Auswählen Adobe Analytics, dann Nächste:
Wenn Sie Adobe Analytics abonniert haben, es jedoch nicht aufgeführt sehen, sollten Sie die Option Voraussetzungen.
Auswählen Dienstkonto (JWT) als Authentifizierungstyp angeben, fahren Sie dann mit Nächste:
Öffentlichen Schlüssel hochladen und nach Abschluss des Vorgangs mit Nächste:
Überprüfen Sie die Anmeldeinformationen und fahren Sie mit Nächste:
Wählen Sie die erforderlichen Produktprofile aus und fahren Sie mit Konfigurierte API speichern:
Die Konfiguration wird bestätigt.
Sie müssen der Integration jetzt die erforderlichen Berechtigungen zuweisen:
Adobe öffnen Admin Console:
Navigieren Sie zu Produkte (obere Symbolleiste) und wählen Sie Adobe Analytics - <your-tenant-id> (im linken Bereich).
Auswählen Produktprofile, dann den gewünschten Arbeitsbereich aus der angezeigten Liste. Beispiel: Standardarbeitsbereich.
Auswählen API-Anmeldeinformationen, dann die erforderliche Integrationskonfiguration.
Auswählen Editor als Produktrolle; anstelle von Beobachter.
In der Adobe Developer Projects Console können Sie eine Liste aller Integrationsprojekte anzeigen:
Wählen Sie einen bestimmten Projekteintrag aus, um weitere Details zur Konfiguration anzuzeigen. Dazu gehören:
Einige davon müssen Sie in AEM die Integration für Adobe Analytics abschließen.
Kehren Sie zu AEM zurück und Sie können die IMS-Konfiguration abschließen, indem Sie erforderliche Werte aus dem Integrationsprojekt für Analytics hinzufügen:
Kehren Sie zu IMS-Konfiguration geöffnet in AEM.
Wählen Sie Weiter aus.
Hier können Sie die Für das Adobe Developer Console-Integrationsprojekt gespeicherte Details:
aud
der Nutzlast unten, z. B. https://ims-na1.adobelogin.com
im Beispiel untenBestä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.
Auswählen Konsistenzprüfung aus der Symbolleiste, gefolgt von Überprüfen.
Bei erfolgreicher Ausführung wird eine Bestätigungsmeldung angezeigt.
Auf die Konfiguration kann nun verwiesen werden, damit ein Cloud Service die Analytics Standard-API verwenden kann:
Öffnen Sie die Instrumente Menü. Anschließend innerhalb der Cloud Services Bereich, wählen Sie Ältere Cloud Services.
Scrollen Sie nach unten zu Adobe Analytics und wählen Sie Jetzt konfigurieren.
Die Konfiguration erstellen wird geöffnet.
Geben Sie einen Titel und, falls gewünscht, ein Name (Wenn Sie das Feld leer lassen, wird dies 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 im Analytics-Einstellungen tab:
Authentifizierung: IMS
IMS-Konfiguration: den Namen der IMS-Konfiguration auswählen
Klicken Verbindung zu Analytics herstellen , um die Verbindung mit Adobe Analytics zu initialisieren.
Wenn die Verbindung erfolgreich hergestellt wurde, wird die Meldung Verbindung erfolgreich angezeigt.
Auswählen OK auf der Nachricht angezeigt.
Füllen Sie ggf. weitere Parameter aus, gefolgt von OK im Dialogfeld, um die Konfiguration zu bestätigen.
Sie können jetzt fortfahren Hinzufügen eines Analytics-Frameworks , um Parameter zu konfigurieren, die an Adobe Analytics gesendet werden.