DokumentationAEM 6.5Benutzerhandbuch

Integration mit Adobe Analytics mithilfe von IMS integration-with-adobe-analytics-using-ims

Last update: Fri Apr 12 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Erstellt für:

  • Admin

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.

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

Voraussetzungen prerequisites

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 Systemadministrator Ihres Unternehmens sollte die Admin Console verwenden, um die erforderlichen Entwickler in Ihrem Unternehmen den relevanten Produktprofilen hinzuzufügen.

    • Dadurch erhalten diese Entwicklerinnen und Entwickler die Berechtigung, Integrationen in der Adobe-Entwicklerkonsole zu aktivieren.
    • Siehe Verwalten von Entwickelnden.

Konfigurieren einer IMS-Konfiguration – Generieren eines öffentlichen Schlüssels configuring-an-ims-configuration-generating-a-public-key

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 die technische Kontokonfiguration für Adobe IMS zu öffnen.

  4. Wählen Sie in der Dropdown-Liste unter Cloud-Konfiguration den Eintrag Adobe Analytics aus.

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

  6. Bestätigen Sie mit Zertifikat erstellen.

    Konfigurationsassistent für technische Adobe IMS-Konten

  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.

    note caution
    CAUTION
    Lassen Sie diese Konfiguration geöffnet, denn sie wird beim Abschließen der IMS-Konfiguration in AEM wieder benötigt.

    Infodialogfeld zum Hinzufügen des Schlüssels zu Adobe I/O

Konfigurieren von IMS für die Adobe Analytics-Integration mit AEM configuring-ims-for-adobe-analytics-integration-with-aem

Erstellen Sie über die Adobe Developer Console ein Projekt (Integration) mit Adobe Analytics (für die Verwendung durch AEM) und weisen Sie die erforderlichen Berechtigungen zu.

Erstellen des Projekts creating-the-project

Um ein Projekt mit Adobe Analytics zu erstellen, das AEM verwenden kann, öffnen Sie die Adobe Developer Console:

CAUTION
Derzeit unterstützt Adobe nur den Anmeldedatentyp Service-Konto (JWT) der Adobe Developer Console.
Verwenden Sie nicht den Anmeldedatentyp OAuth-Server-zu-Server, der in Zukunft unterstützt wird.

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

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

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

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

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

    Erste Schritte mit Ihrem neuen Projekt

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

    note note
    NOTE
    Wenn Sie Adobe Analytics abonniert haben, es jedoch nicht aufgeführt wird, sollten Sie die Voraussetzungen prüfen.

    Hinzufügen einer API

  5. Wählen Sie Dienstkonto (JWT) als Typ der Authentifizierung und fahren Sie mit Weiter fort:

    Authentifizierungstyp auswählen

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

    Öffentlichen Schlüssel hochladen

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

    Anmeldeinformationen überprüfen

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

    Erforderliche Produktprofile auswählen

  9. Die Konfiguration wird bestätigt.

Zuweisen von Berechtigungen zur Integration assigning-privileges-to-the-integration

Weisen Sie der Integration jetzt die erforderlichen Berechtigungen zu:

  1. Öffnen Sie die Adobe Admin Console:

  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 details-stored-for-the-ims-integration-project

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

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

  • Projektübersicht

  • Insights

  • Berechtigungen

    • Dienstkonto (JWT)

      • Details zu Anmeldedaten
      • JWT generieren

  • APIs

    • Beispiel: Adobe Analytics

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

Abschließen der IMS-Konfiguration in AEM completing-the-ims-configuration-in-aem

Wenn Sie zu AEM zurückkehren, können Sie die IMS-Konfiguration abschließen, indem Sie die erforderlichen 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:

    AEM IMS-Konfigurationsdetails

  4. Bestätigen Sie mit Erstellen.

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

    IMS-Konfiguration

Überprüfen der IMS-Konfiguration confirming-the-ims-configuration

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.

    IMS-Konfiguration – Konsistenzprüfung

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

Konfigurieren des Adobe Analytics Cloud-Dienstes configuring-the-adobe-analytics-cloud-service

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

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

  8. Vervollständigen Sie weitere Parameter nach Bedarf, und bestätigen Sie die Konfiguration mit OK im Dialogfeld.

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

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2