Integration mit Adobe Target über Adobe I/O

Die Integration von AEM mit Adobe Target über die Target Standard-API erfordert die Konfiguration von Adobe IMS (Identity Management System) und Adobe I/O.

HINWEIS

Die Unterstützung für die Adobe Target Standard-API ist neu in AEM 6.5. 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 Zielgruppe Classic-API verwendet die Benutzeranmeldeauthentifizierung.

Die API-Auswahl wird von der Authentifizierungsmethode gesteuert, die für die AEM/Zielgruppe-Integration verwendet wird.
Siehe auch Abschnitt Mandant-ID und Client-Code.

Voraussetzungen

Bevor Sie mit diesem Verfahren beginnen:

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

    • Adobe Console
    • Adobe I/O
    • Adobe Target und
    • Adobe IMS (Identity Management-System)
  • Der Systemadministrator Ihres Unternehmens sollte die Admin Console verwenden, um die erforderlichen Entwickler in Ihrem Unternehmen zu den entsprechenden Profilen hinzuzufügen.

    • Dadurch erhalten bestimmte Entwickler die Berechtigung, Integrationen in der Adobe I/O zu aktivieren.
    • Weitere Informationen finden Sie unter Entwickler verwalten.

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 Menü Tools.

  2. Wählen Sie im Abschnitt Security Adobe IMS Configurations.

  3. Wählen Sie Create, um die Adobe IMS Technical Account Configuration zu öffnen.

  4. Wählen Sie unter Cloud-Konfiguration Adobe Target aus.

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

  6. Bestätigen Sie mit Zertifikat erstellen.

  7. Wählen Sie Herunterladen (oder Öffentlichen Schlüssel herunterladen), um die Datei auf Ihr lokales Laufwerk herunterzuladen, damit sie einsatzbereit ist, wenn die Adobe I/O für die Adobe Target-Integration mit AEM konfiguriert wird.

    VORSICHT

    Lassen Sie diese Konfiguration geöffnet, wird sie erneut benötigt, wenn die IMS-Konfiguration in AEM abgeschlossen wird.

Adobe I/O für Adobe Target-Integration mit AEM konfigurieren

Sie müssen das Adobe I/O Project (Integration) mit Adobe Target erstellen, das AEM verwenden wird, und dann die erforderlichen Berechtigungen zuweisen.

Erstellen des Projekts

Öffnen Sie die Adobe I/O-Konsole, um ein E/A-Projekt mit Adobe Target zu erstellen, das AEM Folgendes verwenden wird:

HINWEIS

Siehe auch die Adobe I/O-Tutorials.

  1. Öffnen Sie die Projektkonsole für Adoben I/O:

    https://console.adobe.io/projects

  2. Alle Projekte, die Sie haben, werden angezeigt. Wählen Sie Neues Projekt erstellen - der Ort und die Nutzung hängen von:

    • Wenn Sie noch kein Projekt haben, wird Neues Projekt erstellen zentriert, unten.

      Neues Projekt erstellen - Erstes Projekt

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

      Neues Projekt erstellen - Mehrere Projekte

  3. Wählen Sie Hinzufügen zu Projekt, gefolgt von API:

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

    HINWEIS

    Wenn Sie Adobe Target abonniert haben, es aber nicht aufgeführt sehen, sollten Sie Prerequistes überprüfen.

  5. Laden Sie den öffentlichen Schlüssel hoch und fahren Sie nach Abschluss mit Weiter fort:

  6. Überprüfen Sie die Anmeldeinformationen und fahren Sie mit Weiter fort:

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

    HINWEIS

    Die angezeigten Profil hängen davon ab, ob Sie über Folgendes verfügen:

    • Adobe Target Standard - nur Standardarbeitsbereich ist verfügbar
    • Adobe Target Premium - alle verfügbaren Arbeitsflächen werden wie unten dargestellt aufgelistet

  8. Die Erstellung wird bestätigt.

Zuweisen von Berechtigungen zur Integration

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

  1. Öffnen Sie die Adobe Admin Console:

  2. Navigieren Sie zu Produkte (obere Symbolleiste) und wählen Sie Adobe Target - <Ihre-Mandant-ID (aus dem linken Bereich).

  3. Wählen Sie Product Profils und dann Ihren erforderlichen Arbeitsbereich aus der gezeigten Liste. Beispiel: Standard-Arbeitsbereich.

  4. Wählen Sie Integrationen und dann die erforderliche Integrationskonfiguration.

  5. Wählen Sie Editor als Produktrolle aus. anstelle von Beobachter.

Für das Adobe I/O Integration Project gespeicherte Details

In der Adobe I/O Projects Console können Sie eine Liste aller Integrationsprojekte anzeigen:

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

  • Projektübersicht
  • Insights
  • Berechtigungen
    • Dienstkonto (JWT)
      • Berechtigungsdetails
      • JWT generieren
  • APIS
    • Adobe Target

Einige davon müssen Sie für die Zielgruppe in AEM die Adobe I/O-Integration abschließen.

Abschluss der IMS-Konfiguration in AEM

Zurück zum AEM können Sie die IMS-Konfiguration abschließen, indem Sie erforderliche Werte aus der Adobe I/O-Integration für die Zielgruppe hinzufügen:

  1. Kehren Sie zur unter AEM🔗 geöffneten IMS-Konfiguration zurück.

  2. Wählen Sie Weiter aus.

  3. Hier können Sie die Details aus Adobe I/O verwenden:

    • Titel: Ihr Text.
    • Autorisierungsserver: Kopieren/fügen Sie dies aus der "aud" Zeile des ​Payloadsection unten ein, z.B. "https://ims-na1.adobelogin.com" im Beispiel unten
    • API-Schlüssel: Kopieren Sie dies aus dem 🔗 Übersichtsabschnitt der Adobe I/O-Integration für Zielgruppe
    • geheim: Generieren Sie dies im 🔗 Übersichtsabschnitt der Adobe I/O-Integration für die Zielgruppe und kopieren Sie
    • Nutzlast: Kopieren Sie dies aus dem Abschnitt Generate JWT in der Adobe I/O-Integration für Zielgruppe

  4. Bestätigen Sie mit Create.

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

Bestätigung der IMS-Konfiguration

So bestätigen Sie, dass 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 Sie Health in der Symbolleiste aus, gefolgt von Check.

  4. Bei erfolgreichem Abschluss wird folgende 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 das Menü Tools. Wählen Sie dann im Abschnitt Cloud Services die Option Ältere Cloud Services.

  2. Blättern Sie nach unten zu Adobe Target und wählen Sie Jetzt konfigurieren.

    Das Dialogfeld Konfiguration erstellen wird geöffnet.

  3. Geben Sie einen Titel und, falls gewünscht, einen Name ein (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 Create.

    Das Dialogfeld Komponente bearbeiten wird geöffnet.

  5. Geben Sie die Details auf der Registerkarte Adobe Target Settings ein:

    • Authentifizierung: IMS

    • Mandant-ID: die Adobe IMS Tenant ID. Siehe auch Abschnitt Mandant-ID und Client-Code.

      HINWEIS

      Für IMS muss dieser Wert der Zielgruppe selbst entnommen werden. Sie können sich bei der Zielgruppe anmelden und die Mandanten-ID aus der URL extrahieren.

      Beispiel:

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

      Dann würden Sie yourtenantid verwenden.

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

    • 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 Sie genaues Targeting: 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, um in der Zielgruppe definierte Segmente herunterzuladen, um sie 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 (nicht mehr unterstützt) verwendet werden soll.

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

    • Benutzerspezifische AT.js: Lassen Sie das Feld Tag-Management leer, wenn Sie das Feld Tag-Management markiert haben oder die standardmäßige Version von AT.js verwenden. Alternativ hierzu können Sie Ihre benutzerdefinierte Datei „AT.js“ hochladen. Sie wird nur angezeigt, wenn Sie „AT.js“ ausgewählt haben.

    HINWEIS

    Die Konfiguration eines Cloud Service zur Verwendung der Zielgruppe Classic API wurde eingestellt (unter Verwendung der Registerkarte "Adobe Recommendations-Einstellungen").

  6. Klicken Sie auf Mit Zielgruppe verbinden, um die Verbindung mit Adobe Target zu initialisieren.

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

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

  8. Sie können jetzt mit Hinzufügen eines Zielgruppe-Frameworks fortfahren, um ContextHub- oder ClientContext-Parameter zu konfigurieren, die an die Zielgruppe gesendet werden. Beachten Sie, dass dies möglicherweise nicht erforderlich ist, um AEM Erlebnisfragmente in die Zielgruppe zu exportieren.

Mandanten-ID und Client-Code

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

Achten Sie bei der Konfiguration der Felder Mandant-ID und Client-Code auf Folgendes:

  1. Für die meisten Kunden sind die Mandant-ID und der Client-Code identisch. Das bedeutet, dass beide Felder die gleichen Informationen enthalten und identisch sind. Vergewissern Sie sich, dass Sie die Mandant-ID in beide Felder eingeben.
  2. Zu älteren Zwecken können Sie auch verschiedene Werte in die Felder "Mandant-ID"und "Client-Code"eingeben.

Beachten Sie in beiden Fällen Folgendes:

  • Standardmäßig wird auch der Client-Code (wenn er zuerst hinzugefügt wird) automatisch in das Feld "Mandant-ID"kopiert.
  • Sie haben die Möglichkeit, den Standardsatz für die Mandant-ID zu ändern.
  • Dementsprechend basieren die Backend-Aufrufe zur Zielgruppe auf der Mandanten-ID und die clientseitigen Aufrufe zur Zielgruppe basieren auf dem Client-Code.

Wie bereits erwähnt, ist der erste Fall der häufigste Fall für AEM 6.5. Stellen Sie in beiden Fällen sicher, dass die Felder beide je nach Bedarf die richtigen Informationen enthalten.

HINWEIS

Wenn Sie eine bestehende Konfiguration der Zielgruppe ändern möchten:

  1. Geben Sie die Tenant-ID erneut ein.
  2. Stellen Sie eine erneute Verbindung zur Zielgruppe her.
  3. Speichern Sie die Konfiguration.

Auf dieser Seite