Integration mit Adobe Target mithilfe von IMS integration-with-adobe-target-using-ims

Die Integration von AEM mit Adobe Target über die Target Standard-API erfordert die Konfiguration von Adobe IMS (Identity Management-System) mithilfe der Adobe Developer-Konsole.

NOTE
Die Unterstützung für die Adobe Target Standard-API ist in AEM 6.5 neu. Die Target Standard-API verwendet die IMS-Authentifizierung.
Die Verwendung der Adobe Target Classic-API in AEM wird aus Gründen der Abwärtskompatibilität weiterhin unterstützt. Die Target Classic-API verwendet die Authentifizierung mit Benutzeranmeldeinformationen.
Die API-Auswahl wird von der Authentifizierungsmethode gesteuert, die für die AEM/Target-Integration verwendet wird.
Siehe auch den Abschnitt Mandanten-ID und Client-Code.

Voraussetzungen prerequisites

Bevor Sie mit diesem Verfahren beginnen:

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

    • Adobe Console
    • Adobe-Entwicklerkonsole
    • Adobe Target 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 Technische Kontokonfiguration für Adobe IMS zu öffnen.

  4. Wählen Sie in der Dropdown-Liste unter Cloud-Konfiguration die Option Adobe Target 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 Target-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.

    Informationsmeldung zum Hinzufügen eines Zertifikats in Adobe I/O

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

Erstellen Sie mithilfe der Adobe Developer Console ein Projekt (Integration) mit Adobe Target, das AEM verwenden kann, und weisen Sie dann die erforderlichen Berechtigungen zu.

Erstellen des Projekts creating-the-project

Um ein Projekt mit Adobe Target 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. Position 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 wird oben rechts angezeigt.

      Neues Projekt erstellen – Mehrere Projekte

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

    Adobe-Entwicklerkonsole

  4. Wählen Sie Adobe Target aus und klicken Sie dann auf Weiter:

    note note
    NOTE
    Wenn Sie Adobe Target abonniert haben, es jedoch nicht aufgeführt sehen, sollten Sie die Voraussetzungen überprüfen.

    Klicken auf „Weiter“

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

    Hinzufügen von Integrationen mithilfe der Developer Console

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

    Erstellen eines Projekts

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

    note note
    NOTE
    Welche Produktprofile angezeigt werden, hängt von folgenden Voraussetzungen ab:
    • Adobe Target Standard – nur Standardarbeitsbereich ist verfügbar
    • Adobe Target Premium – alle verfügbaren Arbeitsbereiche werden aufgelistet, wie unten dargestellt

    Auswählen einer API zum Hinzufügen

  8. Die Erstellung wurde 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 Target - <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 Anzeigen (rechts neben einem bestimmten Projekteintrag). Dazu gehören:

  • Projektübersicht

  • Insights

  • Berechtigungen

    • Dienstkonto (JWT)

      • Details zu Anmeldedaten
      • JWT generieren
  • APIs

    • Beispiel: Adobe Target

Einige davon benötigen Sie, um die Integration von Adobe Target in AEM mithilfe von IMS abzuschließen.

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

Zurück in AEM können Sie die IMS-Konfiguration abschließen, indem Sie die erforderlichen Werte aus der Adobe Developer Console für Target 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 Details aus der Projektkonfiguration in der Adobe-Entwicklerkonsole verwenden:

    • Titel: Ihr Text.
    • Autorisierungs-Server: Übernehmen Sie diese Angabe per Kopieren und Einfügen aus der aud-Zeile im Abschnitt Payload unten, z. B. https://ims-na1.adobelogin.com im nachstehenden Beispiel.
    • API-Schlüssel: Kopieren Sie dies aus dem Abschnitt Übersicht.
    • Client-Geheimnis: Generieren Sie dies im Abschnitt Übersicht und kopieren Sie es.
    • Payload: Kopieren Sie diese aus dem Abschnitt JWT generieren

    Konfiguration des technischen Kontos

  4. Bestätigen Sie mit Erstellen.

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

    Konfiguration des technischen Adobe IMS-Kontos

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

    Adobe IMS-Konfigurationen

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

    Überprüfen einer Konfiguration

Konfigurieren des Adobe Target Cloud-Dienstes configuring-the-adobe-target-cloud-service

Die Konfiguration kann nun referenziert werden, damit ein Cloud Service die Target 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 Target 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 Adobe Target-Einstellungen ein:

    • Authentifizierung: IMS

    • Mandanten-ID: die Adobe IMS-Mandanten-ID. Siehe auch den Abschnitt Mandanten-ID und Client-Code.

      note note
      NOTE
      Für IMS muss dieser Wert aus Target selbst übernommen werden. Sie können sich bei Target anmelden und die Mandanten-ID aus der URL extrahieren.
      Wenn die URL beispielsweise wie folgt aussieht:
      https://experience.adobe.com/#/@yourtenantid/target/activities
      Dann ist yourtenantid die Mandanten-ID.
    • Client-Code: siehe den Abschnitt Mandanten-ID und Client-Code.

    • IMS-Konfiguration: Name der IMS-Konfiguration

    • API-Typ: REST

    • A4T-Analytics-Cloud-Konfiguration: Wählen Sie die Analytics Cloud-Konfiguration aus, die für Target-Aktivitätsziele und -metriken verwendet wird. Sie benötigen sie, wenn Sie Adobe Analytics als Quelle für das Reporting für bestimmte Inhalte verwenden. Falls Ihre Cloud-Konfiguration nicht angezeigt wird, hilft Ihnen der Hinweis unter Konfigurieren der A4T-Analytics Cloud-Konfiguration weiter.

    • Präzises Targeting verwenden: Dieses Kontrollkästchen ist standardmäßig aktiviert. Wenn diese Option aktiviert ist, wartet die Cloud-Service-Konfiguration auf das Laden des Kontexts, bevor der Inhalt geladen wird. Siehe folgenden Hinweis.

    • Segmente aus Adobe Target synchronisieren: Wählen Sie diese Option, um in Target definierte Segmente herunterzuladen und in AEM zu verwenden. Wählen Sie diese Option, wenn die Eigenschaft „API-Typ“ auf „REST“ festgelegt ist, da Inline-Segmente nicht unterstützt werden und Sie immer Segmente aus Target verwenden müssen.  (Der AEM-Begriff „Segment“ ist gleichbedeutend mit dem Target-Begriff „Zielgruppe“.)

    • Client-Bibliothek: Wählen Sie aus, ob die Client-Bibliothek AT.js oder mbox.js (veraltet) verwendet werden soll.

    • Verwenden des Tag-Management-Systems zum Bereitstellen der Client-Bibliothek: Verwenden Sie DTM (nicht mehr unterstützt), Adobe Launch oder ein anderes Tag-Management-System.

    • Benutzerdefinierte AT.js: Lassen Sie dieses Feld leer, wenn Sie das Feld „Tag Management“ aktiviert haben oder die standardmäßige Datei „AT.js“ verwenden möchten. Alternativ hierzu können Sie Ihre benutzerdefinierte Datei „AT.js“ hochladen. Es wird nur angezeigt, wenn Sie „AT.js“ ausgewählt haben.

    note note
    NOTE
    Konfiguration eines Cloud-Service zur Verwendung der Target Classic-API ist veraltet (verwendet die Registerkarte Adobe Recommendations-Einstellungen ).
  6. Klicken Sie auf Mit Target verbinden, um die Verbindung mit Adobe Target zu initialisieren.

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

  7. Wählen Sie in der Meldung OK und anschließend im Dialogfeld ebenfalls OK aus, um die Konfiguration zu bestätigen.

  8. Sie können jetzt ein Target-Framework hinzufügen, um ContextHub- oder ClientContext-Parameter zu konfigurieren, die an Target gesendet werden. Beachten Sie, dass dies möglicherweise nicht für den Export von AEM Experience Fragments nach Target erforderlich ist.

Mandanten-ID und Client-Code tenant-client

Mit Adobe Experience Manager 6.5.8.0 wurde das Feld „Client-Code“ zum Target-Konfigurationsfenster hinzugefügt.

Beachten Sie beim Konfigurieren der Felder für die Mandanten-ID und den Clientcode Folgendes:

  1. Für die meisten Kunden sind die Mandanten-ID und der Clientcode identisch. Das bedeutet, dass beide Felder die gleichen Werte enthalten. Achten Sie darauf, dass Sie die Mandanten-ID in beide Felder eingeben.
  2. Sollten Sie über ältere Werte verfügen, können Sie auch verschiedene Werte in die Felder „Mandanten-ID“ und „Clientcode“ eingeben.

Beachten Sie in beiden Fällen Folgendes:

  • Standardmäßig wird der Clientcode (wenn er zuerst eingegeben wird) automatisch in das Feld „Mandanten-ID“ kopiert.
  • Sie können optional den standardmäßigen Mandanten-ID-Satz ändern.
  • Dementsprechend basieren die Backend-Aufrufe an Target auf der Mandanten-ID und die Client-seitigen Aufrufe an Target auf dem Clientcode.

Wie bereits erwähnt, ist der erste Fall der geläufigste für AEM 6.5. Achten Sie so oder so darauf, dass beide Felder die richtigen Informationen entsprechend Ihren Anforderungen enthalten.

NOTE
Wenn Sie eine bestehende Target-Konfiguration ändern möchten:
  1. Geben Sie die Mandanten-ID erneut ein.
  2. Stellen Sie zu Target eine neue Verbindung her.
  3. Speichern Sie die Konfiguration.
recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2