Integrieren mit Adobe Campaign Standard

HINWEIS

In dieser Dokumentation wird beschrieben, wie Sie AEM mit Adobe Campaign Standard, der abonnementbasierten Lösung, integrieren. Wenn Sie Adobe Campaign 6.1 verwenden, finden Sie die entsprechenden Anweisungen in Integrieren mit Adobe Campaign 6.1.

Adobe Campaign ermöglicht die Verwaltung von Inhalten und Formularen für die Übermittlung per E-Mail direkt in Adobe Experience Manager.

Damit Sie beide Lösungen gleichzeitig verwenden können, müssen Sie sie zunächst miteinander verknüpfen. Dies umfasst Konfigurationsschritte in Adobe Campaign und Adobe Experience Manager. Diese Schritte werden in diesem Dokument detailliert beschrieben.

Die Arbeit mit Adobe Campaign in AEM bietet die Möglichkeit, über Adobe Campaign E-Mails und Formulare zu versenden. Dies wird beschrieben in Arbeiten mit Adobe Campaign.

Des Weiteren sind unter Umständen die folgenden Themen relevant, wenn Sie AEM mit Adobe Campaign integrieren:

Hinsichtlich der Erweiterung einer Adobe Campaign-Integration sind folgende Seiten empfehlenswert:

Konfigurieren von Adobe Campaign

Die Konfiguration von Adobe Campaign umfasst Folgendes:

  1. Konfiguration des Benutzers aemserver
  2. Erstellung eines dedizierten externen Kontos
  3. Überprüfung der Option „AEMResourceTypeFilter“
  4. Erstellung einer dedizierten Bereitstellungsvorlage
HINWEIS

Um diese Vorgänge auszuführen, muss die Rolle administration in Adobe Campaign vorhanden sein.

Voraussetzungen

Stellen Sie im Voraus sicher, dass Sie über die folgenden Elemente verfügen:

VORSICHT

Vorgänge, die in den Abschnitten Adobe Campaign und Konfigurieren von Adobe Experience Manager beschrieben sind, sind erforderlich, damit die Integrationsfunktionen zwischen AEM und Adobe Campaign ordnungsgemäß funktionieren.

Konfigurieren des Benutzers „aemserver“

Der aemserver-Benutzer muss in Adobe Campaign konfiguriert werden. Der aemserver ist ein technischer Benutzer, der verwendet wird, um den AEM mit dem Adobe Campaign zu verbinden.

Gehen Sie zu Administration > Benutzer und Sicherheit > Benutzer und wählen Sie den Benutzer aemserver aus. Klicken Sie darauf, um die Benutzereinstellungen zu öffnen.

  • Sie müssen für diesen Benutzer ein Kennwort festlegen. Dies kann nicht über die Benutzeroberfläche erledigt werden. Diese Konfiguration muss von einem technischen Administrator in REST erledigt werden.
  • Sie können diesem Benutzer bestimmte Rollen zuweisen, z. B. deliveryPrepare, wodurch der Benutzer Versand erstellen und bearbeiten kann.

Konfigurieren eines externen Adobe Experience Manager-Kontos

Sie müssen ein externes Konto konfigurieren, das es Ihnen ermöglicht, Adobe Campaign mit Ihrer AEM-Instanz zu verknüpfen.

HINWEIS

Stellen Sie in AEM sicher, dass Sie das Kennwort für den Benutzer „campaign-remote“ festlegen. Sie müssen dieses Kennwort festlegen, um Adobe Campaign mit AEM zu verknüpfen. Melden Sie sich als Administrator an und wählen Sie an der Benutzeradministrationskonsole den Benutzer „campaign-remote“. Klicken Sie dann auf Kennwort festlegen.

Konfigurieren Sie ein externes AEM-Konto wie folgt:

  1. Gehen Sie zu Administration > Anwendungseinstellungen > Externe Konti.

    chlimage_1-124

  2. Wählen Sie das standardmäßige Externe Konto aemInstance oder erstellen Sie ein neues, indem Sie auf die Schaltfläche Erstellen klicken.

  3. Wählen Sie Adobe Experience Manager i im Feld Typ und geben Sie die Zugriffsparameter ein, die für Ihre AEM Authoring-Instanz verwendet werden: Serveradresse, Kontoname und Kennwort.

    HINWEIS

    Hängen Sie an die URL keinen abschließenden Schrägstrich / an, sonst funktioniert die Verknüpfung nicht.

  4. Vergewissern Sie sich, dass das Kontrollkästchen Aktiviert aktiviert ist, und klicken Sie dann auf Speichern, um Ihre Änderungen zu speichern.

Überprüfen der Option „AEMResourceTypeFilter“

Die Option AEMResourceTypeFilter wird zum Filtern von Typen AEM Ressourcen verwendet, die in Adobe Campaign verwendet werden können. Dies ermöglicht Adobe Campaign das Abrufen von AEM-Inhalten, die speziell für die ausschließliche Verwendung in Adobe Campaign entwickelt wurden.

Diese Option ist vorkonfiguriert. Falls Sie an dieser Option Änderungen vornehmen, funktioniert die Integration unter Umständen nicht.

Überprüfen Sie wie folgt, ob die Option AEMResourceTypeFilter konfiguriert ist:

  1. Wechseln Sie zu Administration > Anwendungseinstellungen > Optionen.
  2. In der Liste können Sie sicherstellen, dass die Option AEMResourceTypeFilter aufgelistet ist und die Pfade korrekt sind.

Erstellen einer AEM-spezifischen E-Mail-Bereitstellungsvorlage

Die AEM-Funktion ist in den E-Mail-Vorlagen von Adobe Campaign standardmäßig deaktiviert. Sie haben die Möglichkeit, eine neue E-Mail-Bereitstellungsvorlage für die Erstellung von E-Mails mit AEM-Inhalten zu konfigurieren.

Erstellen Sie AEM-spezifische E-Mail-Bereitstellungsvorlagen wie folgt:

  1. Wechseln Sie zu Ressourcen > Vorlagen > Bereitstellungsvorlagen.

  2. Aktivieren Sie die Auswahl, indem Sie auf das Kontrollkästchen in der Aktionsleiste klicken und die vorhandene Standard-E-Mail- Standardvorlage auswählen. Anschließend können Sie sie durch Klicken auf das ​Symbol Kopieren und Klicken auf Bestätigen Duplikat erstellen.

  3. Deaktivieren Sie den Auswahlmodus, indem Sie auf die Vorlage x klicken und die neu erstellte Kopie der Standard-E-Mail (mail)-Vorlage öffnen. Wählen Sie dann Eigenschaften bearbeiten in der Aktionsleiste des Vorlagenmodells aus.

    Sie können die Beschriftung der Vorlage ändern.

  4. Legen Sie im Abschnitt Inhalt der Eigenschaften Adobe Experience Manager als Inhaltsquelle fest. Wählen Sie dann das zuvor erstellte externe Konto aus und klicken Sie auf Bestätigen.

    Speichern Sie Ihre Änderungen, indem Sie auf Bestätigen und anschließend auf Speichern klicken.

    Für die aus dieser Vorlage erstellten E-Mail-Bereitstellungen ist die AEM-Inhaltsfunktion aktiviert.

    chlimage_1-125

Konfigurieren von Adobe Experience Manager

Zum Konfigurieren von AEM müssen Sie folgende Schritte ausführen:

  • die Replikation zwischen Instanzen konfigurieren
  • AEM mit Adobe Campaign verknüpfen
  • den Externalizer konfigurieren

Konfigurieren der Replikation zwischen AEM-Instanzen

Inhalte, die in der AEM-Autoreninstanz erstellt werden, werden zunächst an die Veröffentlichungsinstanz übermittelt. Diese Veröffentlichungsinstanz übermittelt die Inhalte dann an Adobe Campaign. Der Replikationsagent muss deshalb so konfiguriert werden, dass er aus der AEM-Autoreninstanz in die AEM-Veröffentlichungsinstanz repliziert.

HINWEIS

Möchten Sie nicht die Replikations-URL sondern stattdessen die öffentlich zugängliche URL verwenden, so haben Sie die Möglichkeit, die Öffentliche URL in der folgenden Konfigurationseinstellung in OSGi festzulegen (Tools > Web-Konsole > OSGi-Konfiguration > AEM-Kampagnenintegration – Konfiguration):
Öffentliche URL: com.day.cq.mcm.Kampagne.impl.IntegrationConfigImpl#aem.mcm.Kampagne.publicUrl

Dieser Schritt ist auch erforderlich, um bestimmte Autoreninstanzkonfigurationen in die Veröffentlichungsinstanz zu replizieren.

So konfigurieren Sie die Replikation zwischen AEM-Instanzen:

  1. Wählen Sie in der Autoreninstanz AEM Logo Tools > Bereitstellung > Replikation > Agenten unter Autor und klicken Sie dann auf Standardagent.

    chlimage_1-126

    HINWEIS

    Verwenden Sie nach Möglichkeit nicht localhost (eine lokale Kopie von AEM), wenn Sie die Integration mit Adobe Campaign konfigurieren, außer die Veröffentlichungs- und Autoreninstanz befinden sich auf demselben Computer.

  2. Klicken Sie auf Bearbeiten und wählen Sie dann die Registerkarte Transport.

  3. Konfigurieren Sie den URI, indem Sie localhost durch die IP-Adresse oder die Adresse der AEM-Veröffentlichungsinstanz ersetzen.

    chlimage_1-127

Verknüpfen von AEM mit Adobe Campaign

Bevor Sie AEM und Adobe Campaign zusammen verwenden können, müssen Sie die beiden Lösungen verknüpfen, damit sie miteinander kommunizieren können.

  1. Stellen Sie eine Verbindung mit Ihrer AEM-Autoreninstanz her.

  2. Wählen Sie Tools > Vorgänge > Cloud > Cloud Services und Jetzt konfigurieren im Abschnitt Adobe Campaign.

    chlimage_1-128

  3. Erstellen Sie eine neue Konfiguration, indem Sie einen title eingeben und auf Create klicken oder die vorhandene Konfiguration auswählen, die Sie mit Ihrer Adobe Campaign-Instanz verknüpfen möchten.

  4. Passen Sie die Konfiguration so an, dass sie den Parametern Ihrer Adobe Campaign-Instanz entspricht.

    • Benutzername: aemserver, der Adobe Campaign AEM Integration Package Operator, der zum Herstellen der Verbindung zwischen den beiden Lösungen verwendet wird.
    • Kennwort: Das Adobe Campaign-Kennwort des aemserver-Operators. Unter Umständen müssen Sie das Kennwort für diesen Operator direkt in Adobe Campaign erneut angeben.
    • API-Endpunkt: URL der Adobe Campaign-Instanz.
  5. Wählen Sie Mit Adobe Campaign verbinden und klicken Sie auf OK.

    chlimage_1-129

    HINWEIS

    Nachdem Sie die E-Mail erstellt und veröffentlicht haben, müssen Sie die Konfiguration auf der Veröffentlichungsinstanz erneut veröffentlichen.

    chlimage_1-130

HINWEIS

Prüfen Sie Folgendes, falls die Verbindung nicht hergestellt werden kann:

  • Möglicherweise tritt ein Zertifikatfehler auf, wenn Sie eine sichere Verbindung (https) mit einer Adobe Campaign-Instanz herstellen. Sie müssen das Adobe Campaign-Instanzzertifikat der cacerts Datei Ihres JDK hinzufügen.
  • Weitere Informationen finden Sie in Fehlerbehebung bei der AEM/Adobe Campaign-Integration.

Konfigurieren des Externalizers

Sie müssen den Externalizer in AEM auf der Autoreninstanz konfigurieren. Der Externalizer ist ein OSGi-Dienst, der es Ihnen ermöglicht, Ressourcenpfade in externe, absolute URLs umzuwandeln. Dieser Dienst bietet einen zentralen Ort für die Konfiguration und Erstellung von externen URLs.

Allgemeine Anweisungen finden Sie unter Konfigurieren des Externalizers. Stellen Sie bei der Adobe Campaign-Integration sicher, dass Sie den Veröffentlichungsserver unter https://<host>:<port>/system/console/configMgr/com.day.cq.commons.impl.ExternalizerImpl nicht auf localhost:4503, sondern auf einen Server konfigurieren, der über die Adobe Campaign-Konsole erreichbar ist.

Wenn er auf localhost:4503 oder einen anderen Server, den Adobe Campaign nicht erreichen kann, verweist, werden Ihre Bilder auf der Adobe Campaign-Konsole nicht angezeigt.

chlimage_1-131

Auf dieser Seite