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.

HINWEIS

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.

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.

      Neues Projekt erstellen - erstes Projekt

    • Wenn Sie bereits über vorhandene Projekte verfügen, werden diese aufgelistet und Neues Projekt erstellen oben rechts.

      Neues Projekt erstellen - Mehrere Projekte

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

    Erste Schritte mit Ihrem neuen Projekt

  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.

    Fügen Sie eine API hinzu

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

    Authentifizierungstyp auswählen

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

    Öffentlichen Schlüssel hochladen

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

    Prüfberechtigungen

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

    Erforderliche Produktprofile auswählen

  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:

  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:

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:

    AEM IMS-Konfigurationsdetails

  4. Bestätigen Sie mit Erstellen.

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

    IMS-Konfiguration

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.

    IMS-Konfiguration - Systemdiagnose

  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.

Auf dieser Seite