Integration mit Adobe Target mithilfe von 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 Console.

Voraussetzungen

Bevor Sie mit diesem Verfahren beginnen:

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

  • Adobe Console
  • Adobe Developer Console
  • 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 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 Target.

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 Target-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 Target-Integration mit AEM konfigurieren

Mithilfe der Adobe Developer Console müssen Sie ein Projekt (Integration) mit Adobe Target erstellen, das AEM verwenden wird, und dann die erforderlichen Berechtigungen zuweisen.

Erstellen des Projekts

Öffnen Sie die Adobe Developer Console, um ein Projekt mit Adobe Target 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.

     

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

     

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

   

4. Auswählen Adobe Target, dann Nächste:

   HINWEIS

   Wenn Sie Adobe Target abonniert haben, es jedoch nicht aufgeführt sehen, sollten Sie die Option Voraussetzungen.

   

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

   

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

   

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

   HINWEIS

   Welche Produktprofile mit angezeigt werden, hängt davon ab, ob Sie über Folgendes verfügen:

   • Adobe Target Standard - nur Standardarbeitsbereich ist verfügbar
   • Adobe Target Premium - alle verfügbaren Arbeitsbereiche werden aufgelistet, wie unten dargestellt

   

8. Die Erstellung wird bestätigt.

Zuweisen von Berechtigungen zur Integration

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

1. Adobe öffnen Admin Console:

   • https://adminconsole.adobe.com

2. Navigieren Sie zu Produkte (obere Symbolleiste) und wählen Sie Adobe Target - <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 Console - Projekte können Sie eine Liste aller Integrationsprojekte anzeigen:

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

Auswählen Ansicht (rechts neben einem bestimmten Projekteintrag), um weitere Details zur Konfiguration anzuzeigen. Dazu gehören:

• Projektübersicht
• Insights
• Berechtigungen
  • Dienstkonto (JWT)
    • Details zu Berechtigungen
    • JWT generieren
• APIS
  • Beispiel: Adobe Target

Einige davon müssen Sie die Integration von Adobe Target in AEM basierend auf IMS 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 der Adobe Developer Console-Integration für Target hinzufügen:

1. Kehren Sie zu IMS-Konfiguration geöffnet in AEM.

2. Wählen Sie Weiter aus.

3. Hier können Sie die Details aus der Projektkonfiguration in der Adobe Developer Console:

   • Titel: Ihr Text.
   • Autorisierungsserver: Kopieren/Einfügen Sie dies aus dem aud der Nutzlast unten, z. B. https://ims-na1.adobelogin.com im Beispiel unten
   • API-Schlüssel: Kopieren Sie dies aus dem Übersicht Abschnitt
   • Client Secret: Generieren Sie dies im Übersicht und kopieren
   • Nutzlast: Kopieren Sie dies aus dem JWT generieren Abschnitt

   

4. Bestätigen Sie mit Erstellen.

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

   

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.

   

4. Bei erfolgreicher Ausführung wird die Meldung angezeigt:

   

Konfigurieren des Adobe Target-Cloud Service

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

   • Authentifizierung: IMS

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

     HINWEIS

     Für IMS muss dieser Wert aus Target selbst übernommen werden. Sie können sich bei Target anmelden und die Mandantenkennung aus der URL extrahieren.

     Wenn die URL beispielsweise:

     https://experience.adobe.com/#/@yourtenantid/target/activities

     Dann würden Sie yourtenantid.

   • Clientcode: Siehe Mandanten-ID und Client-Code Abschnitt.

   • IMS-Konfiguration: den Namen der IMS-Konfiguration auswählen

   • API-Typ: REST

   • A4T-Analyse-Cloud-Konfiguration: Wählen Sie die Analyse-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 die Berichterstellung für bestimmte Inhalte verwenden. Wenn Ihre Cloud-Konfiguration nicht angezeigt wird, finden Sie weitere Informationen unter Konfigurieren der A4T-Analytics Cloud-Konfiguration.

   • Verwenden des präzisen Targetings: Standardmäßig ist dieses Kontrollkästchen aktiviert. Bei Aktivierung dieser Option wird für die Cloud Service-Konfiguration gewartet, bis das Laden des Kontexts erfolgt ist, bevor der Inhalt geladen wird. Siehe Hinweis unten.

   • Segmente aus Adobe Target synchronisieren: Wählen Sie diese Option aus, um in Target definierte Segmente herunterzuladen und in AEM zu verwenden. Sie müssen diese Option auswählen, 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. (Beachten Sie, dass der AEM-Begriff „Segment“ hier dem Target-Begriff „Zielgruppe“ entspricht.)

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

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

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

   HINWEIS

   Konfiguration eines Cloud Service zur Verwendung der Target Classic-API ist veraltet (verwendet die Registerkarte Adobe Recommendations-Einstellungen ).

6. Klicken Verbindung mit Target herstellen , um die Verbindung mit Adobe Target zu initialisieren.

   Wenn die Verbindung erfolgreich hergestellt wurde, wird die Meldung Verbindung erfolgreich angezeigt.

7. Auswählen OK auf die Nachricht, gefolgt von OK im Dialogfeld, um die Konfiguration zu bestätigen.

8. Sie können jetzt fortfahren Hinzufügen eines Target-Frameworks zum Konfigurieren von ContextHub- oder ClientContext-Parametern, die an Target gesendet werden. Beachten Sie, dass dies möglicherweise nicht für den Export AEM Experience Fragments in Target erforderlich ist.

Mandanten-ID und Client-Code

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

Beachten Sie beim Konfigurieren der Felder Mandanten-ID und Client-Code 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 haben die Möglichkeit, den Standardwert für die Mandanten-ID zu ändern.
• Dementsprechend basieren die Backend-Target-Aufrufe auf der Mandanten-ID und die Client-seitigen Target-Aufrufe auf dem Clientcode.

Wie bereits erwähnt, ist der erste Fall der häufigste Fall für AEM 6.5. Achten Sie in beiden Fällen darauf, both -Felder enthalten die richtigen Informationen entsprechend Ihren Anforderungen.

Business.Adobe.com - Ressourcen