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

Voraussetzungen

Bevor Sie mit diesem Verfahren beginnen:

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

  • Adobe Console
  • Adobe-Entwicklerkonsole
  • Adobe Analytics und
  • Adobe IMS (Identity Management System)

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

  • Dadurch erhalten diese Entwicklerinnen und Entwickler die Berechtigung, Integrationen in der Adobe-Entwicklerkonsole zu aktivieren.
  • Weitere Informationen finden Sie unter Verwalten von Entwicklern.

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

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

1. Öffnen Sie in AEM das Menü Tools.

2. Wählen Sie im Abschnitt Sicherheit die Option Adobe IMS-Konfigurationen aus.

3. Wählen Sie Erstellen aus, um Technische Kontokonfiguration für Adobe IMS zu öffnen.

4. Wählen Sie über die Dropdown-Liste unter Cloud-Konfiguration die Option Adobe Analytics aus.

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

6. Bestätigen Sie mit Zertifikat erstellen.

   

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

   VORSICHT

   Lassen Sie diese Konfiguration geöffnet. Sie wird beim Abschließen der IMS-Konfiguration in AEM erneut benötigt.

   

Konfigurieren von IMS für die Adobe Analytics-Integration mit AEM

Mithilfe der Adobe-Entwicklerkonsole müssen Sie ein Projekt (Integration) mit Adobe Analytics erstellen (zur Verwendung durch AEM) und dann die erforderlichen Berechtigungen zuweisen.

Erstellen des Projekts

Öffnen Sie die Adobe-Entwicklerkonsole, um ein Projekt mit Adobe Analytics zu erstellen, das AEM verwenden wird:

1. Öffnen Sie die Adobe-Entwicklerkonsole für Projekte:

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

2. Alle vorhandenen Projekte werden angezeigt. Wählen Sie Neues Projekt erstellen aus. Position und Verwendung hängen von Folgendem ab:

   • Wenn Sie noch kein Projekt haben, wird Neues Projekt erstellen unten in der Mitte angezeigt.
     
   • Wenn Sie bereits über vorhandene Projekte verfügen, werden diese aufgelistet und Neues Projekt erstellen wird oben rechts angezeigt.
     

3. Wählen Sie Zum Projekt hinzufügen und dann API aus:

   

4. Wählen Sie Adobe Analytics und dann Weiter aus:

   HINWEIS

   Wenn Sie Adobe Analytics abonniert haben, es jedoch nicht aufgeführt ist, sollten Sie die Voraussetzungen überprüfen.

   

5. Wählen Sie Dienstkonto (JWT) als Authentifizierungstyp aus und setzen Sie den Vorgang mit Weiter fort:

   

6. Laden Sie Ihren öffentlichen Schlüssel hoch und setzen Sie den Vorgang anschließend mit Weiter fort:

   

7. Überprüfen Sie die Anmeldeinformationen und setzen Sie den Vorgang mit Weiter fort:

   

8. Wählen Sie die erforderlichen Produktprofile aus und setzen Sie den Vorgang mit Konfigurierte API speichern fort:

   

9. Die Konfiguration wird bestätigt.

Zuweisen von Berechtigungen zur Integration

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

1. Öffnen Sie die Adobe Admin Console:

   • https://adminconsole.adobe.com

2. Navigieren Sie zu Produkte (obere Symbolleiste) und wählen Sie Adobe Analytics - <Ihre-Mandanten-ID> (im linken Bereich) aus.

3. Wählen Sie Produktprofile und dann den gewünschten Arbeitsbereich aus der angezeigten Liste aus. Beispielsweise den Standardarbeitsbereich.

4. Wählen Sie API-Anmeldeinformationen und dann die erforderliche Integrationskonfiguration aus.

5. Wählen Sie Editor als Produktrolle aus anstelle von Beobachter.

Für das Integrationsprojekt in der Adobe-Entwicklerkonsole gespeicherte Details

In der Adobe-Entwicklerkonsole wird eine Liste aller Integrationsprojekte angezeigt:

• 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 Anmeldedaten
    • JWT generieren
• APIs
  • Beispiel: Adobe Analytics

Einige davon benötigen Sie, um die Integration von Adobe Analytics mit AEM abzuschließen.

Abschließen der IMS-Konfiguration in AEM

Zurück in AEM können Sie die IMS-Konfiguration abschließen, indem Sie erforderliche Werte aus dem Integrationsprojekt für Analytics hinzufügen:

1. Kehren Sie zur in AEM geöffneten IMS-Konfiguration zurück.

2. Wählen Sie Weiter aus.

3. Hier können Sie die für das Integrationsprojekt in der Adobe-Entwicklerkonsole gespeicherten Details verwenden:

   • Titel: Ihr Text.
   • Autorisierungsserver: Übernehmen Sie dies per Kopieren und Einfügen aus der aud-Zeile im Abschnitt Payload unten, z. B. https://ims-na1.adobelogin.com.
   • API-Schlüssel: Kopieren Sie dies aus dem Abschnitt Anmeldedaten in der Projektübersicht.
   • Client-Geheimnis: Generieren Sie dies auf der Registerkarte „Client-Geheimnis“ im Abschnitt „Dienstkonto (JWT)“ und kopieren Sie es.
   • Payload: Kopieren Sie dies von der Registerkarte „JWT generieren“ im Abschnitt „Dienstkonto (JWT)“.

   

4. Bestätigen Sie mit Erstellen.

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

   

Überprüfen der IMS-Konfiguration

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. Wählen Konsistenzprüfung auf der Symbolleiste aus, gefolgt von Überprüfen.

   

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

Konfigurieren des Adobe Analytics Cloud-Dienstes

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

1. Öffnen Sie das Menü Tools. Wählen Sie dann im Abschnitt Cloud Services den Eintrag Ältere Cloud Services aus.

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

   Das Dialogfeld Konfiguration erstellen wird geöffnet.

3. Geben Sie einen Titel und, falls gewünscht, einen Namen ein. (Wenn Sie das Feld leer lassen, wird der Name 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.

   Das Dialogfeld Komponente bearbeiten wird geöffnet.

5. Geben Sie die Details auf der Registerkarte Analytics-Einstellungen ein:

   • Authentifizierung: IMS

   • IMS-Konfiguration: Name der IMS-Konfiguration

6. Klicken Sie auf Verbindung zu Analytics herstellen, um die Verbindung mit Adobe Analytics zu initialisieren.

   Wenn die Verbindungsherstellung erfolgreich war, wird die Meldung Die Verbindung wurde hergestellt angezeigt.

7. Wählen Sie in der Meldung OK aus.

8. Füllen Sie ggf. weitere Parameter aus und bestätigen Sie die Konfiguration im Dialogfeld mit OK.

9. Sie können jetzt ein Analytics-Framework hinzufügen, um Parameter zu konfigurieren, die an Adobe Analytics gesendet werden.

Ressourcen für Business.Adobe.com