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 Authentifizierungmit Benutzeranmeldeinformationen.

Die API-Auswahl wird von der Authentifizierungsmethode gesteuert, die für die AEM/Zielgruppe-Integration verwendet wird.

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 das Menü Extras .

  2. Wählen Sie im Abschnitt Sicherheit die Option Adobe IMS-Konfigurationen.

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

  4. Wählen Sie in der Dropdown-Liste unter Cloud-Konfiguration die Option Adobe Target.

  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 bei der Konfiguration der E/A-Adobe für die Adobe Target-Integration mit AEMverwendet werden kann.

    ACHTUNG

    Lassen Sie diese Konfiguration geöffnet, wird sie beim Abschluss der IMS-Konfiguration in AEMerneut benötigt.

Konfigurieren der Adobe-E/A für die Adobe Target-Integration mit AEM

Sie müssen das Adoben-E/A-Projekt (Integration) mit Adobe Target erstellen, das AEM verwenden wird, und dann die erforderlichen Berechtigungen zuweisen.

Erstellen des Projekts

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

Hinweis

Siehe auch die Adoben-E/A-Tutorials.

  1. Öffnen Sie die Adoben-E/A-Konsole für Projekte:

    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 Folgendem ab:

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

      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 aufgelistet sehen, sollten Sie die 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 der Save-konfigurierten API fort:

    Hinweis

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

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

  8. Die Erstellung wird bestätigt.

Berechtigungen der Integration zuweisen

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

  1. Öffnen Sie die Admin Console Adobe:

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

  3. Wählen Sie Product Profils und dann Ihren gewünschten Arbeitsbereich aus der präsentierten Liste. Beispiel: Standard-Arbeitsbereich.

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

  5. Wählen Sie Editor als Produktrolle aus; anstatt Beobachter.

Für das E/A-Integrationsprojekt der Adobe gespeicherte Details

In der Konsole "Adobe-E/A-Projekte"sehen Sie eine Liste aller Integrationsprojekte:

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 zur 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 Adoben-E/A-Integration für die Zielgruppe hinzufügen:

  1. Kehren Sie zur IMS-Konfiguration zurück, die in AEMgeöffnet ist.

  2. Wählen Sie Weiter aus.

  3. Hier können Sie die Angaben aus der Adobe I/Overwenden:

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

  4. Bestätigen Sie mit Erstellen.

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

IMS-Konfiguration bestätigen

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 in der Symbolleiste die Option " Prüfstatus "und anschließend " Prüfung"aus.

  4. Bei erfolgreichem Abschluss wird folgende Meldung angezeigt:

Adobe Target Cloud Service konfigurieren

Auf die Konfiguration kann nun verwiesen werden, damit ein Cloud Service die Target Standard-API verwenden kann:

  1. Open the Tools menu. Wählen Sie dann im Abschnitt Cloud Services die Option Legacy-Cloud Services.

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

    The Create Configuration dialog will open.

  3. Geben Sie einen Titel und, falls gewünscht, einen Namen ein (leer gelassen, wird dieser 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

    • Mandant-ID: die Adobe IMS Tenant ID

      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 es benutzen yourtenantid.

    • 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. If you do not see your cloud configuration, see note in Configuring A4T Analytics Cloud Configuration.

    • 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").

    Beispiel:

  6. Click Connect to Target to initialize the connection with Adobe Target.

    If the connection is successful, the message Connection successful is displayed.

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

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

Auf dieser Seite