Diese Dokumentation beschreibt die Integration von AEM mit der On-Premise-Lösung Adobe Campaign Classic. Wenn Sie Adobe Campaign Standard verwenden, lesen Sie sich für diese Anweisungen das Dokument Integration mit Adobe Campaign Standard durch.
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:
Hinsichtlich der Erweiterung einer Adobe Campaign-Integration sind folgende Seiten empfehlenswert:
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:
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.
Bevor Sie die Inhalte verknüpfen und einen Bereitstellungsmechanismus erstellen, müssen Sie folgende Schritte ausführen:
In AEM
**In Adobe Campaign **
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.
Wenn Sie zum ersten Mal mit AEM arbeiten, finden Sie die folgenden Links möglicherweise für das Verständnis von AEM hilfreich:
Die Konfiguration von Adobe Campaign umfasst Folgendes:
Darüber hinaus gibt es erweiterte Konfigurationen, die Sie definieren können, z. B.:
Siehe Erweiterte Konfigurationen.
Um diese Vorgänge auszuführen, müssen Sie in Adobe Campaign über die Rolle administration verfügen.
Stellen Sie im Voraus sicher, dass Sie über die folgenden Elemente verfügen:
Wenn Sie eine frühere Version als Adobe Campaign Classic Build 8640 ausführen, finden Sie weitere Informationen in der Upgrade-Dokumentation. Beachten Sie, dass der Client und die Datenbank auf denselben Build aktualisiert werden müssen.
Vorgänge, die im Abschnitt Konfigurieren von Adobe Campaign und Konfigurieren von Adobe Experience Manager beschrieben werden, sind erforderlich, damit die Integrationsfunktionen zwischen AEM und Adobe Campaign ordnungsgemäß funktionieren.
Sie müssen das Paket AEM Integration in Adobe Campaign installieren. Gehen Sie hierfür wie folgt vor:
Wechseln Sie zu der Adobe Campaign-Instanz, die Sie gern mit AEM verknüpfen möchten.
Wählen Sie Tools > Erweitert > Package importieren….
Klicken Sie auf Installieren Sie ein Standardpaket und wählen Sie dann das Paket AEM Integration aus.
Klicken Sie auf Next und dann auf Start.
Dieses Paket enthält den Operator aemserver , der zum Verbinden des AEM-Servers mit Adobe Campaign verwendet wird.
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 gesetzt werden, um AEM zu autorisieren, Adobe Campaign über Anmeldung/Kennwort zu verbinden.
Wir empfehlen Ihnen dringend, eine speziell AEM zugewiesene Sicherheitszone zu erstellen, um jegliche Sicherheitsprobleme zu vermeiden. Weitere Informationen hierzu finden Sie im Installationshandbuch.
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:
Gehen Sie zum Knoten Administration > Plattform > Externe Konten .
Erstellen Sie ein neues externes Konto und wählen Sie den Typ AEM aus.
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.
Stellen Sie sicher, dass die Serveradresse nicht in einem Schrägstrich endet. Geben Sie beispielsweise https://yourserver:4502
anstelle von https://yourserver:4502/
ein.
Stellen Sie sicher, dass das Kontrollkästchen Aktiviert aktiviert ist.
Die Option AEMResourceTypeFilter wird verwendet, um AEM Ressourcentypen 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:
Navigieren Sie zu Plattform > Optionen.
Überprüfen Sie in der Option AEMResourceTypeFilter , ob 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
Zum Konfigurieren von AEM müssen Sie folgende Schritte ausführen:
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.
Wenn Sie die Replikations-URL nicht verwenden, sondern stattdessen die öffentlich zugängliche URL verwenden möchten, können Sie die Öffentliche URL in der folgenden Konfigurationseinstellung im OSGi festlegen (AEM Logo > Tools Symbol > Vorgänge > Web Console > <a6 10/>OSGi-Konfiguration > AEM Kampagnenintegration - Konfiguration ):
Öffentliche URL: com.day.cq.mcm.campaign.impl.IntegrationConfigImpl#aem.mcm.campaign.publicUrl
Dieser Schritt ist auch erforderlich, um bestimmte Autoreninstanzkonfigurationen in die Veröffentlichungsinstanz zu replizieren.
So konfigurieren Sie die Replikation zwischen AEM-Instanzen:
Wählen Sie in der Autoreninstanz AEM Logo Tools Symbol > Bereitstellung > Replikation > Agenten für Autor und klicken Sie dann auf Standardagent.
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.
Tippen oder klicken Sie auf Bearbeiten und wählen Sie dann die Registerkarte Transport aus.
Konfigurieren Sie den URI, indem Sie localhost durch die IP-Adresse oder die Adresse der AEM-Veröffentlichungsinstanz ersetzen.
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.
Stellen Sie eine Verbindung mit Ihrer AEM-Autoreninstanz her.
Wählen Sie AEM Logo > Tools Symbol > Bereitstellung > Cloud Services und dann Jetzt im Adobe Campaign-Abschnitt konfigurieren.
Erstellen Sie eine neue Konfiguration, indem Sie einen Titel eingeben und auf Erstellen klicken oder die vorhandene Konfiguration auswählen, die Sie mit Ihrer Adobe Campaign-Instanz verknüpfen möchten.
Passen Sie die Konfiguration so an, dass sie den Parametern Ihrer Adobe Campaign-Instanz entspricht.
Wählen Sie Verbindung zu Adobe Campaign und klicken Sie auf OK.
Nachdem Sie die E-Mail erstellt und veröffentlicht haben, müssen Sie die Konfiguration auf der Veröffentlichungsinstanz erneut veröffentlichen.
Prüfen Sie Folgendes, falls die Verbindung nicht hergestellt werden kann:
Weitere Informationen finden Sie in Fehlerbehebung bei der AEM/Adobe Campaign-Integration.
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 für die 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.
Sie können zudem einige erweiterte Konfigurationen vornehmen, wie:
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.
Um ein neues Personalisierungsfeld zu den bereits verfügbaren Feldern hinzuzufügen, müssen Sie das Adobe Campaign-Schema nms:seedMember wie folgt erweitern:
Das Feld, das Sie hinzufügen müssen, muss bereits über eine Empfängerschemaerweiterung hinzugefügt worden sein (nms:recipient). Weitere Informationen finden Sie im Handbuch Konfiguration .
Navigieren Sie zum Knoten Administration > Konfiguration > Datenschemata in der Adobe Campaign-Navigation.
Wählen Sie Neu aus.
Wählen Sie im Popup-Fenster Erweitern Sie die Daten in der Tabelle mit einem Erweiterungsschema und klicken Sie auf Weiter.
Geben Sie die verschiedenen Parameter des erweiterten Schemas ein:
Bearbeiten Sie den XML-Code des Schemas, um das Feld anzugeben, das Sie dort hinzufügen möchten. Weitere Informationen zum Erweitern von Schemas in Adobe Campaign finden Sie im Konfigurationshandbuch.
Speichern Sie Ihr Schema und aktualisieren Sie dann die Adobe Campaign-Datenbankstruktur über das Menü Tools > Erweitert > Datenbankstruktur aktualisieren in der Konsole.
Trennen Sie die Verbindung zur 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.
Um das Feld Registrierungsnummer hinzuzufügen, müssen Sie über die folgenden Elemente verfügen:
<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 Schemaerweiterung nms:seedMember mit dem Namen cus:seedMember enthält:
<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 jetzt Teil der verfügbaren Personalisierungsfelder:
Um ein Personalisierungsfeld unter den bereits verfügbaren auszublenden, müssen Sie das Adobe Campaign-Schema nms:seedMember erweitern, wie im Abschnitt Personalisierungsfeld beschrieben. Führen Sie die folgenden Schritte aus:
Kopieren Sie das Feld, das Sie aus dem Schema nms:seedMember in das erweiterte Schema (beispielsweise cus:seedMember) übernehmen möchten.
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 Middle Name auszublenden, muss das Schema cud:seedMember das folgende Element enthalten:
<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>
So deaktivieren Sie einen Personalisierungsblock unter den vorhandenen Personalisierungsblöcken:
Wechseln Sie zum Knoten Ressourcen > Kampagnenverwaltung > Gestaltungsbausteine in der Adobe Campaign-Navigation.
Wählen Sie den Personalisierungsblock aus, den Sie in AEM deaktivieren möchten.
Deaktivieren Sie das Kontrollkästchen Sichtbar in den Personalisierungsmenüs und speichern Sie Ihre Änderungen. Der Block wird nicht mehr in der Liste der Personalisierungsblöcke, die in Adobe Campaign verfügbar sind, angezeigt.
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 finden Sie in den Abschnitten Abfragen erstellen und Daten anreichern .
Die Zieldaten sind nur verfügbar, wenn die AEM-Inhalte mit einer Adobe Campaign-Bereitstellung synchronisiert sind. Siehe Synchronisieren von in AEM erstellten Inhalten mit einem Versand von Adobe Campaign.