Integration mit Adobe Analytics mithilfe von IMS

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.

Voraussetzungen

Bevor Sie mit diesem Verfahren beginnen:

• Adobe-Support muss Ihr Konto für Folgendes bereitstellen:

  • Adobe Console
  • Adobe Developer Console
  • Adobe Analytics und
  • Adobe IMS (Identity Management System)

• Der Systemadministrator Ihres Unternehmens sollte die Admin Console verwenden, um die erforderlichen Entwickler in Ihrem Unternehmen den relevanten Produktprofilen hinzuzufügen.

  • Dadurch erhalten die spezifischen Entwickler Berechtigungen zum Aktivieren von Integrationen in der Adobe Developer Console.
  • Weitere Informationen finden Sie unter Verwalten von Entwicklern.

Konfigurieren einer IMS-Konfiguration - Generieren eines öffentlichen Schlüssels

Der erste Schritt der Konfiguration besteht darin, eine IMS-Konfiguration in AEM zu erstellen und den öffentlichen Schlüssel zu generieren.

1. Öffnen Sie AEM Instrumente Menü.

2. Im Sicherheit Abschnittsauswahl Adobe IMS-Konfigurationen.

3. Auswählen Erstellen , um Technische Kontokonfiguration für Adobe IMS.

4. Verwenden der Dropdown-Liste unter Cloud-Konfiguration auswählen Adobe Analytics.

5. Aktivieren Neues Zertifikat erstellen und geben Sie einen neuen Alias ein.

6. Bestätigen mit Zertifikat erstellen.

   

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

   VORSICHT

   Lassen Sie diese Konfiguration geöffnet. Sie wird bei Abschließen der IMS-Konfiguration in AEM.

   

IMS für Adobe Analytics-Integration mit AEM konfigurieren

Mithilfe der Adobe Developer Console müssen Sie ein Projekt (Integration) mit Adobe Analytics erstellen (AEM verwenden) und dann die erforderlichen Berechtigungen zuweisen.

Erstellen des Projekts

Öffnen Sie die Adobe Developer Console, um ein Projekt mit Adobe Analytics zu erstellen, das AEM Folgendes verwenden wird:

1. Öffnen Sie die Adobe Developer Console for Projects:

   https://developer.adobe.com/console/projects

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

     

3. Auswählen Zum Projekt hinzufügen gefolgt von API:

   

4. Auswählen Adobe Analytics, dann Nächste:

   HINWEIS

   Wenn Sie Adobe Analytics abonniert haben, es jedoch nicht aufgeführt sehen, sollten Sie die Option Voraussetzungen.

   

5. Auswählen Dienstkonto (JWT) als Authentifizierungstyp angeben, fahren Sie dann mit Nächste:

   

6. Öffentlichen Schlüssel hochladen und nach Abschluss des Vorgangs mit Nächste:

   

7. Überprüfen Sie die Anmeldeinformationen und fahren Sie mit Nächste:

   

8. Wählen Sie die erforderlichen Produktprofile aus und fahren Sie mit Konfigurierte API speichern:

   

9. Die Konfiguration wird bestätigt.

Zuweisen von Berechtigungen zur Integration

Sie müssen der Integration jetzt die erforderlichen Berechtigungen zuweisen:

1. Adobe öffnen Admin Console:

   • https://adminconsole.adobe.com

2. Navigieren Sie zu Produkte (obere Symbolleiste) und wählen Sie Adobe Analytics - <your-tenant-id> (im linken Bereich).

3. Auswählen Produktprofile, dann den gewünschten Arbeitsbereich aus der angezeigten Liste. Beispiel: Standardarbeitsbereich.

4. Auswählen API-Anmeldeinformationen, dann die erforderliche Integrationskonfiguration.

5. Auswählen Editor als Produktrolle; anstelle von Beobachter.

Für das Adobe Developer Console-Integrationsprojekt gespeicherte Details

In der Adobe Developer Projects Console können Sie eine Liste aller Integrationsprojekte anzeigen:

• https://developer.adobe.com/console/projects

Wählen Sie einen bestimmten Projekteintrag aus, um weitere Details zur Konfiguration anzuzeigen. Dazu gehören:

• Projektübersicht
• Insights
• Berechtigungen
  • Dienstkonto (JWT)
    • Details zu Berechtigungen
    • JWT generieren
• APIS
  • Beispiel: Adobe Analytics

Einige davon müssen Sie in AEM die Integration für Adobe Analytics abschließen.

Abschließen der IMS-Konfiguration in AEM

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:

1. Kehren Sie zu IMS-Konfiguration geöffnet in AEM.

2. Wählen Sie Weiter aus.

3. Hier können Sie die Für das Adobe Developer Console-Integrationsprojekt gespeicherte Details:

   • Titel: Ihr Text.
   • Autorisierungsserver: Kopieren/Einfügen Sie dies aus dem aud der Nutzlast unten, z. B. https://ims-na1.adobelogin.com im Beispiel unten
   • API-Schlüssel: Kopieren Sie dies aus dem Anmeldeinformationen Abschnitt Projektübersicht
   • Client Secret: Generieren Sie dies im Registerkarte "Client-Geheimnis"im Abschnitt "Service-Konto (JWT)"und kopieren
   • Nutzlast: Kopieren Sie dies aus dem Registerkarte "JWT generieren"im Abschnitt "Dienstkonto (JWT)"

   

4. Bestätigen Sie mit Erstellen.

5. Ihre Adobe Analytics-Konfiguration wird in der AEM Console angezeigt.

   

IMS-Konfiguration bestätigen

So überprüfen Sie, ob die Konfiguration erwartungsgemäß funktioniert:

1. Öffnen Sie:

   • https://localhost<port>/libs/cq/adobeims-configuration/content/configurations.html

   Beispiel:

   • https://localhost:4502/libs/cq/adobeims-configuration/content/configurations.html

2. Wählen Sie Ihre Konfiguration aus.

3. Auswählen Konsistenzprüfung aus der Symbolleiste, gefolgt von Überprüfen.

   

4. Bei erfolgreicher Ausführung wird eine Bestätigungsmeldung angezeigt.

Konfigurieren des Adobe Analytics Cloud-Dienstes

Auf die Konfiguration kann nun verwiesen werden, damit ein Cloud Service die Analytics Standard-API verwenden kann:

1. Öffnen Sie die Instrumente Menü. Anschließend innerhalb der Cloud Services Bereich, wählen Sie Ältere Cloud Services.

2. Scrollen Sie nach unten zu Adobe Analytics und wählen Sie Jetzt konfigurieren.

   Die Konfiguration erstellen wird geöffnet.

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

4. Bestätigen Sie mit Erstellen.

   Die Komponente bearbeiten wird geöffnet.

5. Geben Sie die Details im Analytics-Einstellungen tab:

   • Authentifizierung: IMS

   • IMS-Konfiguration: den Namen der IMS-Konfiguration auswählen

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

7. Auswählen OK auf der Nachricht angezeigt.

8. Füllen Sie ggf. weitere Parameter aus, gefolgt von OK im Dialogfeld, um die Konfiguration zu bestätigen.

9. Sie können jetzt fortfahren Hinzufügen eines Analytics-Frameworks , um Parameter zu konfigurieren, die an Adobe Analytics gesendet werden.