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.
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.
-
Öffnen Sie in AEM das Menü Tools.
-
Wählen Sie im Abschnitt Sicherheit die Option Adobe IMS-Konfigurationen aus.
-
Wählen Sie Erstellen aus, um Technische Kontokonfiguration für Adobe IMS zu öffnen.
-
Wählen Sie in der Dropdown-Liste unter Cloud-Konfiguration die Option Adobe Target aus.
-
Aktivieren Sie Neues Zertifikat erstellen und geben Sie einen neuen Alias ein.
-
Bestätigen Sie mit Zertifikat erstellen.
-
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.
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:
-
Öffnen Sie die Adobe-Entwicklerkonsole für Projekte:
-
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.
-
Wenn Sie bereits über vorhandene Projekte verfügen, werden diese aufgelistet und Neues Projekt erstellen wird oben rechts angezeigt.
-
-
Wählen Sie Zum Projekt hinzufügen und dann API aus:
-
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. -
Laden Sie Ihren öffentlichen Schlüssel hoch und setzen Sie den Vorgang anschließend mit Weiter fort:
-
Überprüfen Sie die Anmeldeinformationen und setzen Sie den Vorgang mit Weiter fort:
-
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
-
Die Erstellung wurde bestätigt.
Zuweisen von Berechtigungen zur Integration assigning-privileges-to-the-integration
Weisen Sie der Integration jetzt die erforderlichen Berechtigungen zu:
-
Öffnen Sie die Adobe Admin Console:
-
Navigieren Sie zu Produkte (obere Symbolleiste) und wählen Sie Adobe Target - <Ihre-Mandanten-ID> (im linken Bereich) aus.
-
Wählen Sie Produktprofile und dann den gewünschten Arbeitsbereich aus der angezeigten Liste aus. Beispielsweise den Standardarbeitsbereich.
-
Wählen Sie API-Anmeldeinformationen und dann die erforderliche Integrationskonfiguration aus.
-
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:
-
Kehren Sie zur in AEM geöffneten IMS-Konfiguration zurück.
-
Wählen Sie Weiter aus.
-
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
-
Bestätigen Sie mit Erstellen.
-
Ihre Adobe Target-Konfiguration wird in der AEM-Konsole angezeigt.
Überprüfen der IMS-Konfiguration confirming-the-ims-configuration
So überprüfen Sie, ob die Konfiguration erwartungsgemäß funktioniert:
-
Öffnen Sie:
https://localhost<port>/libs/cq/adobeims-configuration/content/configurations.html
Beispiel:
https://localhost:4502/libs/cq/adobeims-configuration/content/configurations.html
-
Wählen Sie Ihre Konfiguration aus.
-
Wählen Konsistenzprüfung auf der Symbolleiste aus, gefolgt von Überprüfen.
-
Bei erfolgreicher Ausführung wird eine Bestätigungsmeldung angezeigt:
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:
-
Öffnen Sie das Menü Tools. Wählen Sie dann im Abschnitt Cloud Services den Eintrag Ältere Cloud Services aus.
-
Scrollen Sie nach unten zu Adobe Target und wählen Sie Jetzt konfigurieren aus.
Das Dialogfeld Konfiguration erstellen wird geöffnet.
-
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).
-
Bestätigen Sie mit Erstellen.
Das Dialogfeld Komponente bearbeiten wird geöffnet.
-
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 ). -
-
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.
-
Wählen Sie in der Meldung OK und anschließend im Dialogfeld ebenfalls OK aus, um die Konfiguration zu bestätigen.
-
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:
- 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.
- 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.
- Geben Sie die Mandanten-ID erneut ein.
- Stellen Sie zu Target eine neue Verbindung her.
- Speichern Sie die Konfiguration.