Integration mit Adobe Campaign Classic

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

Um beide Lösungen gleichzeitig nutzen zu können, müssen Sie sie zunächst so konfigurieren, dass sie miteinander verbunden sind. Dies umfasst Konfigurationsschritte in Adobe Campaign und Adobe Experience Manager. Diese Schritte werden in diesem Dokument detailliert beschrieben.

Das Arbeiten mit Adobe Campaign in AEM bietet die Möglichkeit, E-Mails über Adobe Campaign zu versenden, und wird näher im Abschnitt Arbeiten mit Adobe Campaign beschrieben. Dies bezieht sich auch auf die Verwendung von Formularen auf AEM-Seiten, um so Daten zu bearbeiten.

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

• Best Practices für E-Mail-Vorlagen
• Fehlerbehebung bei der Adobe Campaign-Integration

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

• Erstellen benutzerspezifischer Erweiterungen
• Erstellen benutzerdefinierter Formularzuordnungen

Workflow für die Integration von AEM und Adobe Campaign

Dieser Abschnitt beschreibt einen typischen Workflow zwischen AEM und Adobe Campaign beim Erstellen von Kampagnen und dem Bereitstellen von Inhalten.

Der typische Workflow umfasst Folgendes und ist hier näher beschrieben:

1. Beginnen Sie mit dem Erstellen der Kampagne (sowohl in Adobe Campaign als auch in AEM).
2. Bevor Sie die Inhalte und die Bereitstellung verknüpfen, personalisieren Sie die Inhalte in AEM und erstellen Sie eine Bereitstellung in Adobe Campaign.
3. Verknüpfen Sie die Inhalte und die Bereitstellung in Adobe Campaign.

Beginnen Sie mit dem Erstellen der Kampagne

Sie können jederzeit mit dem Erstellen einer Kampagne beginnen. Bevor Sie den Inhalt verknüpfen, sollten Sie wissen, dass AEM und AC unabhängig sind. Dies bedeutet, dass Vermarkter mit dem Erstellen ihrer Kampagnen und dem Targeting in Adobe Campaign beginnen können, während die Ersteller von Inhalten in AEM am Design arbeiten.

Vor dem Verknüpfen von Inhalten und der Bereitstellung

Bevor Sie die Inhalte verknüpfen und einen Bereitstellungsmechanismus erstellen, müssen Sie folgende Schritte ausführen:

In AEM

• Personalisieren Sie mithilfe der Personalisierungsfelder in der Komponente Text & Personalisierung.

**In Adobe Campaign **

• Erstellen Sie eine Bereitstellung vom Typ aemContent.

Verknüpfen von Inhalten und Einstellungsbereitstellung

Nachdem Sie den Inhalt für die Verknüpfung und Bereitstellung vorbereitet haben, legen Sie genau fest, wie und wo die Inhalte verknüpft werden sollen.

All diese Schritte werden in Adobe Campaign ausgeführt.

1. Legen Sie fest, welche AEM-Instanz verwendet werden soll.
2. Synchronisieren Sie die Inhalte durch Klicken auf die Schaltfläche „Synchronisieren“.
3. Öffnen Sie die Inhaltsauswahl zur Auswahl des Inhalts.

Wenn Sie zum ersten Mal mit AEM arbeiten

Wenn Sie zum ersten Mal mit AEM arbeiten, finden Sie die folgenden Links möglicherweise für das Verständnis von AEM hilfreich:

• Starten von AEM
• Verstehen von Replikationsagenten
• Suchen von und Arbeiten mit Protokolldateien
• Einführung in die AEM-Plattform

Konfigurieren von Adobe Campaign

Die Konfiguration von Adobe Campaign umfasst Folgendes:

1. Installieren des AEM-Integrationspakets in Adobe Campaign
2. Konfigurieren eines externen Kontos
3. Sicherstellen, dass der AEMResourceTypeFilter korrekt konfiguriert ist

Darüber hinaus gibt es erweiterte Konfigurationen, die Sie definieren können, z. B.:

• Verwalten von Inhaltsblöcken
• Verwalten von Personalisierungsfeldern

Siehe Erweiterte Konfigurationen.

Voraussetzungen

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

• Eine AEM-Autoreninstanz
• Eine AEM-Veröffentlichungsinstanz
• Eine Instanz von Adobe Campaign Classic – einschließlich eines Clients und eines Servers
• Internet Explorer 11

Installieren von AEM-Integrationspaketen

Sie müssen das AEM-Integrationspaket in Adobe Campaign installieren. Gehen Sie hierfür wie folgt vor:

1. Wechseln Sie zu der Adobe Campaign-Instanz, die Sie gern mit AEM verknüpfen möchten.

2. Wählen Sie Tools > Erweitert > Paket importieren… aus.

   

3. Klicken Sie auf Standardpaket installieren. Wählen Sie dann das AEM-Integrationspaket aus.

   

4. Klicken Sie auf Weiter und dann auf Starten.

   Dieses Paket enthält den Operator aemserver, der zum Verbinden des AEM-Servers mit Adobe Campaign dienen wird.

   VORSICHT

   Standardmäßig ist für diesen Operator keine Sicherheitszone konfiguriert. Um die Verknüpfung über AEM mit Adobe Campaign herzustellen, müssen Sie eine Option auswählen.

   In der Datei serverConf.xml muss das Attribut allowUserPassword der ausgewählten Sicherheitszone auf true festgelegt werden, um AEM zur Herstellung einer Verbindung mit Adobe Campaign per Anmeldung/Kennwort zu autorisieren.

   Wir empfehlen Ihnen dringend, eine speziell AEM zugewiesene Sicherheitszone zu erstellen, um jegliche Sicherheitsprobleme zu vermeiden. Weitere Informationen dazu finden Sie im Installationshandbuch.

   

Konfigurieren von externen AEM-Konten

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

So konfigurieren Sie externe AEM-Konten:

1. Wechseln Sie zum Knoten Administration > Plattform > Externe Konten.

2. Erstellen Sie ein neues externes Konto und wählen Sie den AEM-Typ aus.

3. Geben Sie die Zugangsparameter für die AEM-Autoreninstanz ein: die Serveradresse sowie die ID und das Kennwort für die Verbindung mit dieser Instanz. Das Kennwort für das Benutzerkonto „campaign-api“ ist dasselbe wie für den Benutzer „campaign-remote“, für den Sie in AEM ein Kennwort festgelegt haben.

   HINWEIS

   Stellen Sie sicher, dass die Serveradresse nicht in einem Schrägstrich endet. Geben Sie beispielsweise https://yourserver:4502 anstatt https://yourserver:4502/ ein.

   

4. Stellen Sie sicher, dass das Kontrollkästchen Aktiviert aktiviert ist.

Überprüfen der Option „AEMResourceTypeFilter“

Die Option AEMResourceTypeFilter wird verwendet, um Typen von AEM-Ressourcen zu filtern, 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 sollte vorkonfiguriert sein. Wenn Sie diese Option jedoch ändern, kann es sein, dass die Integration am Ende nicht funktioniert.

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

1. Navigieren Sie zu Plattform > Optionen.

2. Stellen Sie in der Option AEMResourceTypeFilter sicher, dass die Pfade korrekt sind. Dieses Feld muss den Wert enthalten:

   mcm/campaign/components/newsletter,mcm/campaign/components/campaign_newsletterpage,mcm/neolane/components/newsletter

   In einigen Fällen ist der Wert wie folgt:

   mcm/campaign/components/newsletter

   

Konfigurieren von Adobe Experience Manager

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

• Konfigurieren Sie die Replikation zwischen Instanzen.
• Verbinden Sie AEM über Cloud-Services mit Adobe Campaign.
• Konfigurieren Sie den Externalizer.

Konfigurieren der Replikation zwischen AEM-Instanzen

Inhalte, die in der AEM-Autoreninstanz erstellt werden, werden zunächst zur Veröffentlichungsinstanz gesendet. Sie müssen so veröffentlichen, dass die Bilder im Newsletter auf der Veröffentlichungsinstanz und für Newsletter-Empfänger verfügbar sind. Der Replikationsagent muss deshalb so konfiguriert werden, dass er aus der AEM-Autoreninstanz in die AEM-Veröffentlichungsinstanz repliziert.

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 auf der Autoreninstanz AEM-Logo > Tools-Symbol > Bereitstellung > Replikation > Agenten für Autor aus und klicken Sie dann auf Standardagent.

   

   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. Tippen oder klicken Sie auf Bearbeiten und wählen Sie dann die Registerkarte Transport aus.

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

   

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 AEM-Logo > Tools-Symbol > Bereitstellung > Cloud-Services und dann im Adobe Campaign-Abschnitt Jetzt konfigurieren aus.

   

3. Erstellen Sie eine neue Konfiguration, indem Sie einen Titel eingeben und auf Erstellen klicken, oder wählen Sie die vorhandene Konfiguration aus, 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-Integrationspaketoperator, mit dem die Verknüpfung der beiden Lösungen durchgeführt 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 Verbindung mit Adobe Campaign herstellen aus und klicken Sie auf OK.

   

   HINWEIS

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

   

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. Für die Adobe Campaign-Integration muss der Veröffentlichungsserver unter https://<host>:<port>/system/console/configMgr/com.day.cq.commons.impl.ExternalizerImpl so konfiguriert werden, dass er nicht auf localhost:4503 verweist, sondern auf einen Server, der von der 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.

Erweiterte Konfigurationen

Sie können zudem einige erweiterte Konfigurationen vornehmen, wie:

• Das Verwalten von Personalisierungsfeldern und -blöcken.
• Das Deaktivieren eines Personalisierungsblocks.
• Das Verwalten von Zielerweiterungsdaten.

Verwalten von Personalisierungsfeldern und -blöcken

Die zum Hinzufügen einer Personalisierung zu Ihrem E-Mail-Inhalt in AEM verfügbaren Felder und Blöcke werden von Adobe Campaign verwaltet.

Eine Standardliste wird bereitgestellt, kann jedoch geändert werden. Sie können Personalisierungsfelder und -blöcke auch hinzufügen oder ausblenden.

Hinzufügen eines Personalisierungsfelds

Zum Hinzufügen eines neuen Personalisierungsfelds zu den bereits verfügbaren Personalisierungsfeldern müssen Sie das Adobe Campaign-Schema nms:seedMember folgendermaßen erweitern:

1. Wechseln Sie zum Knoten Administration > Konfiguration > Datenschemata in der Adobe Campaign-Navigation.

2. Wählen Sie Neu aus.

   

3. Wählen Sie im Popup-Fenster die Option Daten in der Tabelle mithilfe eines Erweiterungsschemas erweitern aus. Klicken Sie dann auf Weiter.

   

4. Geben Sie die verschiedenen Parameter des erweiterten Schemas ein:

   • Schema: Wählen Sie das Schema nms:seedMember aus. Die anderen Felder im Fenster werden automatisch ausgefüllt.
   • Namespace: Personalisieren Sie den Namespace des erweiterten Schemas.

5. Bearbeiten Sie den XML-Code des Schemas, um das Feld anzugeben, das Sie dort hinzufügen möchten. Weitere Informationen zu Erweiterungsschemata in Adobe Campaign finden Sie im Konfigurationshandbuch.

6. Speichern Sie das Schema und aktualisieren Sie dann die Adobe Campaign-Datenbankstruktur im Menü Tools > Erweitert > Datenbankstruktur aktualisieren der Konsole.

7. Trennen Sie die Verbindung mit der Adobe Campaign-Konsole und stellen Sie die Verbindung wieder her, um die Änderungen zu speichern. Das neue Feld wird nun in der Liste der in AEM verfügbaren Personalisierungsfelder angezeigt.

Beispiel

Zum Hinzufügen eines Felds Registrierungsnummer müssen Sie über die folgenden Elemente verfügen:

• Die Erweiterung cus:recipient des Schemas nms:recipient beinhaltet:

<element desc="Recipient table (profiles)" img="nms:recipient.png" label="Recipients" labelSingular="Recipient" name="recipient">

  <attribute dataPolicy="smartCase" desc="Recipient registration number"
  label="Registration Number"
  length="50" name="registrationNumber" type="string"/>

</element>

Die Erweiterung cus:seedMember des Schemas nms:seedMember beinhaltet:

<element desc="Seed to insert in the export files" img="nms:unknownad.png" label="Seed addresses" labelSingular="Seed" name="seedMember">

  <element name="custom_nms_recipient">
    <attribute name="registrationNumber"
    template="cus:recipient:recipient/@registrationNumber"/>
  </element>

</element>

Das Feld Registrierungsnummer ist nun Bestandteil der verfügbaren Personalisierungsfelder:

Ausblenden eines Personalisierungsfelds

Zum Ausblenden eines Personalisierungsfelds unter den bereits verfügbaren Personalisierungsfeldern müssen Sie das Adobe Campaign-Schema nms:seedMember erweitern, wie im Abschnitt Hinzufügen eines Personalisierungsfelds näher beschrieben. Führen Sie die folgenden Schritte aus:

1. Kopieren Sie das Feld, das Sie aus dem Schema nms:seedMember in das erweiterte Schema (beispielsweise cus:seedMember) übernehmen möchten.

2. Fügen Sie dem Feld das XML-Attribut advanced="true" hinzu. Es wird nicht mehr in der Liste der in AEM verfügbaren Personalisierungsfelder angezeigt.

   Um beispielsweise das Feld Weitere Vornamen auszublenden, muss das Schema cud:seedMember das folgende Element beinhalten:

   <element desc="Seed to insert in the export files" img="nms:unknownad.png" label="Seed addresses" labelSingular="Seed" name="seedMember">
   
     <element name="custom_nms_recipient">
       <attribute advanced="true" name="middleName"/>
     </element>
   
   </element>
   

Deaktivieren eines Personalisierungsblocks

So deaktivieren Sie einen Personalisierungsblock unter den vorhandenen Personalisierungsblöcken:

1. Wechseln Sie zum Knoten Ressourcen > Kampagnen-Management > Personalisierungsblöcke in der Adobe Campaign-Navigation.

2. Wählen Sie den Personalisierungsblock aus, den Sie in AEM deaktivieren möchten.

3. Heben Sie die Auswahl des Kontrollkästchens In den Anpassungsmenüs sichtbar auf und speichern Sie die Änderungen. Der Block wird nicht mehr in der Liste der Personalisierungsblöcke, die in Adobe Campaign verfügbar sind, angezeigt.

   

Verwalten von Zielerweiterungsdaten

Sie können zudem Zielerweiterungsdaten für die Personalisierung eingeben. Zielerweiterungsdaten (auch als „Zieldaten“ bezeichnet) stammen aus dem Erweitern oder Hinzufügen von Daten, beispielsweise bei einer Abfrage in einem Kampagnen-Workflow. Weitere Informationen entnehmen Sie den Abschnitten Erstellen von Abfragen und Erweitern von Daten.

Ressourcen für Business.Adobe.com

Content Insights Automated Onboarding Auto Form Fill Content Intelligence Document Generation Customer Experience Management