Integrieren mit Adobe Campaign Classic integrating-with-adobe-campaign-classic
Mit Adobe Campaign können Sie Inhalte und Formulare für den E-Mail-Versand direkt in Adobe Experience Manager verwalten.
Um beide Lösungen gleichzeitig zu verwenden, müssen Sie sie zunächst so konfigurieren, dass eine Verbindung zueinander hergestellt wird. Dies umfasst Konfigurationsschritte sowohl in Adobe Campaign als auch in Adobe Experience Manager. Diese Schritte werden in diesem Dokument ausführlich beschrieben.
Das Arbeiten mit Adobe Campaign in AEM bietet die Möglichkeit, E-Mails über Adobe Campaign zu versenden. Eine Beschreibung finden Sie unter Arbeiten mit Adobe Campaign. Dazu gehört auch die Verwendung von Formularen auf AEM Seiten zur Bearbeitung von Daten.
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:
Integrations-Workflow für AEM und Adobe Campaign aem-and-adobe-campaign-integration-workflow
In diesem Abschnitt wird ein typischer Workflow zwischen AEM und Adobe Campaign bei der Erstellung von Kampagnen und der Bereitstellung von Inhalten beschrieben.
Der typische Workflow umfasst Folgendes und wird detailliert beschrieben:
- Beginnen Sie mit der Erstellung Ihrer Kampagne (sowohl in Adobe Campaign als auch AEM).
- Bevor Sie Inhalt und Versand verknüpfen, personalisieren Sie Ihre Inhalte in AEM und erstellen Sie einen Versand in Adobe Campaign.
- Verknüpfen Sie Inhalt und Bereitstellung in Adobe Campaign.
Kampagnenerstellung starten start-building-your-campaign
Sie beginnen jederzeit mit der Erstellung einer Kampagne. Bevor Sie den Inhalt verknüpfen, sind AEM und Benutzerkontensteuerung unabhängig. Dies bedeutet, dass Marketingexperten ihre Kampagnen und Targeting in Adobe Campaign erstellen können, während Inhaltsersteller an dem Design in AEM arbeiten.
Vor der Verknüpfung von Inhalt und Versand before-linking-content-and-delivery
Bevor Sie den Inhalt verknüpfen und einen Bereitstellungsmechanismus erstellen, müssen Sie Folgendes tun:
In AEM
- Personalisieren Sie mithilfe der Personalisierungsfelder im Text und Personalisierung component
**In Adobe Campaign **
- Versand erstellen aemContent
Inhalt verknüpfen und Bereitstellung festlegen linking-content-and-setting-delivery
Nachdem Sie den Inhalt für die Verknüpfung und Bereitstellung vorbereitet haben, bestimmen Sie genau, wie und wo Inhalte verknüpft werden sollen.
Alle diese Schritte werden in Adobe Campaign ausgeführt.
- Geben Sie an, welche AEM Instanz verwendet werden soll.
- Synchronisieren Sie den Inhalt, indem Sie auf die Schaltfläche Synchronisieren klicken.
- Öffnen Sie die Inhaltsauswahl, um Ihren Inhalt auszuwählen.
Wenn Sie neu bei AEM sind if-you-are-new-to-aem
Wenn Sie AEM sind, sind die folgenden Links hilfreich, um AEM zu verstehen:
Konfigurieren von Adobe Campaign configuring-adobe-campaign
Die Konfiguration von Adobe Campaign umfasst Folgendes:
- Installieren des AEM Integrationspakets in Adobe Campaign.
- Konfiguration eines externen Kontos.
- Überprüfen, ob der AEMResourceTypeFilter richtig konfiguriert ist.
Darüber hinaus können Sie erweiterte Konfigurationen vornehmen, darunter:
- Inhaltsbausteine verwalten
- Verwalten von Personalisierungsfeldern
Siehe Erweiterte Konfigurationen.
Voraussetzungen prerequisites
Stellen Sie sicher, dass Sie zuvor die folgenden Elemente haben:
- 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 installing-the-aem-integration-package
Sie müssen das AEM-Integrationspaket in Adobe Campaign installieren. Gehen Sie hierfür wie folgt vor:
-
Wechseln Sie zur Adobe Campaign-Instanz, mit der Sie eine Verknüpfung herstellen möchten.
-
Wählen Sie Tools > Erweitert > Paket importieren… aus.
-
Klicken Sie auf Standardpaket installieren. Wählen Sie dann das AEM-Integrationspaket aus.
-
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.
note caution CAUTION Standardmäßig ist keine Sicherheitszone für diesen Operator konfiguriert. Um über AEM eine Verbindung zu Adobe Campaign herzustellen, müssen Sie eine 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. 
Externes AEM-Konto konfigurieren configuring-an-aem-external-account
Sie müssen ein externes Konto konfigurieren, über das Sie Adobe Campaign mit Ihrer AEM verbinden können.
- Beim Installieren des AEM-Integrationspakets wird ein externes AEM-Konto angelegt. Sie können die Verbindung zu Ihrer AEM-Instanz daraus konfigurieren oder eine neue erstellen.
- 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 verbinden. Melden Sie sich als Administrator an und suchen Sie in der Benutzerverwaltungskonsole nach dem Benutzer campaign-remote und klicken Sie auf Kennwort festlegen.
So konfigurieren Sie ein externes AEM:
-
Wechseln Sie zum Knoten Administration > Plattform > Externe Konten.
-
Erstellen Sie ein neues externes Konto und wählen Sie den AEM-Typ 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 Campaign-API-Benutzerkonto entspricht dem für den Campaign-Remote-Benutzer, für den Sie in AEM ein Kennwort festlegen.
note note NOTE Stellen Sie sicher, dass die Serveradresse nicht in einem Schrägstrich endet. Geben Sie beispielsweise https://yourserver:4502anstatthttps://yourserver:4502/ein.
-
Stellen Sie sicher, dass das Kontrollkästchen Aktiviert aktiviert ist.
Überprüfen der Option „AEMResourceTypeFilter“ verifying-the-aemresourcetypefilter-option
Die Option AEMResourceTypeFilter wird verwendet, um Typen von AEM-Ressourcen zu filtern, die in Adobe Campaign verwendet werden können. Dadurch kann Adobe Campaign AEM Inhalte abrufen, die speziell für die Verwendung in Adobe Campaign entwickelt wurden.
Diese Option sollte vorkonfiguriert sein. Wenn Sie diese Option jedoch ändern, kann dies zu einer nicht funktionierenden Integration führen.
Überprüfen Sie wie folgt, ob die Option AEMResourceTypeFilter konfiguriert ist:
-
Navigieren Sie zu Plattform > Optionen.
-
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 configuring-adobe-experience-manager
Gehen Sie wie folgt vor, um AEM zu konfigurieren:
- 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 configuring-replication-between-aem-instances
Inhalte, die aus der AEM Authoring-Instanz erstellt wurden, werden zunächst an die Veröffentlichungsinstanz gesendet. Sie müssen eine Veröffentlichung vornehmen, damit die Bilder im Newsletter in der Veröffentlichungsinstanz verfügbar sind und den Newsletter-Empfängern zur Verfügung stehen. Der Replikationsagent muss daher so konfiguriert sein, dass er von der AEM-Autoreninstanz zur AEM-Veröffentlichungsinstanz repliziert.
Ö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 auf der Autoreninstanz AEM-Logo > Tools-Symbol > Bereitstellung > Replikation > Agenten für Autor aus und klicken Sie dann auf Standardagent.
note note NOTE 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.
AEM mit Adobe Campaign verbinden connecting-aem-to-adobe-campaign
Bevor Sie AEM und Adobe Campaign gemeinsam verwenden können, müssen Sie die Verknüpfung zwischen beiden Lösungen herstellen, damit diese kommunizieren können.
-
Stellen Sie eine Verbindung zu Ihrer AEM Authoring-Instanz her.
-
Wählen Sie AEM-Logo > Tools-Symbol > Bereitstellung > Cloud-Services und dann im Adobe Campaign-Abschnitt Jetzt konfigurieren aus.
-
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.
-
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.
- Passwort: Kennwort des Adobe Campaign-aemserver-Operators. Möglicherweise müssen Sie das Kennwort für diesen Benutzer direkt in Adobe Campaign neu angeben.
- API-Endpunkt: Adobe Campaign-Instanz-URL.
-
Wählen Sie Verbindung mit Adobe Campaign herstellen aus und klicken Sie auf OK.
note note NOTE Nachdem Sie die E-Mail erstellt und veröffentlicht haben, müssen Sie die Konfiguration auf der Veröffentlichungsinstanz erneut veröffentlichen. 
- Bei Verwendung einer sicheren Verbindung zu einer Adobe Campaign-Instanz (https) tritt möglicherweise ein Zertifikatproblem auf. Sie müssen das Zertifikat der Adobe Campaign-Instanz der Datei cacerts des JDK der AEM-Instanz hinzufügen.
- Für den aemserver-Operator muss eine Sicherheitszone in Adobe Campaign konfiguriert werden. Darüber hinaus muss das Attribut allowUserPassword der Sicherheitszone in der Datei serverConf.xml auf true festgelegt sein, um die AEM-Verbindung mit Adobe Campaign unter Verwendung des Anmelde-/Kennwortmodus zu autorisieren.
Konfigurieren des Externalizers configuring-the-externalizer
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, um diese externen URLs zu konfigurieren und zu erstellen.
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 advanced-configurations
Sie können auch einige erweiterte Konfigurationen durchführen:
- Verwalten Sie Personalisierungsfelder und -bausteine.
- Gestaltungsbausteine deaktivieren.
- Verwalten von Zielerweiterungsdaten.
Verwalten von Personalisierungsfeldern und -bausteinen managing-personalization-fields-and-blocks
Die Felder und Bausteine, die zum Hinzufügen von Personalisierung zu E-Mail-Inhalten in AEM verfügbar sind, werden von Adobe Campaign verwaltet.
Eine Standardliste wird bereitgestellt, kann jedoch geändert werden. Sie können auch Personalisierungsfelder und -bausteine hinzufügen oder ausblenden.
Personalisierungsfeld hinzufügen adding-a-personalization-field
Zum Hinzufügen eines neuen Personalisierungsfelds zu den bereits verfügbaren Personalisierungsfeldern müssen Sie das Adobe Campaign-Schema nms:seedMember folgendermaßen erweitern:
-
Wechseln Sie zum Knoten Administration > Konfiguration > Datenschemata in der Adobe Campaign-Navigation.
-
Wählen Sie Neu aus.
-
Wählen Sie im Popup-Fenster die Option Daten in der Tabelle mithilfe eines Erweiterungsschemas erweitern aus. Klicken Sie dann auf Weiter.
-
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: den Namespace des erweiterten Schemas personalisieren.
-
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.
-
Speichern Sie das Schema und aktualisieren Sie dann die Adobe Campaign-Datenbankstruktur im Menü Tools > Erweitert > Datenbankstruktur aktualisieren der Konsole.
-
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 example
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 hiding-a-personalization-field
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:
-
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 Weitere Vornamen auszublenden, muss das Schema cud:seedMember das folgende Element beinhalten:
code language-xml <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>
Gestaltungsbaustein deaktivieren deactivating-a-personalization-block
So deaktivieren Sie einen Gestaltungsbaustein unter den verfügbaren:
-
Wechseln Sie zum Knoten Ressourcen > Kampagnen-Management > Personalisierungsblöcke in der Adobe Campaign-Navigation.
-
Wählen Sie den Personalisierungsblock aus, den Sie in AEM deaktivieren möchten.
-
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 managing-target-extension-data
Sie können auch Zielerweiterungsdaten zur Personalisierung einfügen. Target-Erweiterungsdaten (auch "Zieldaten"genannt) stammen beispielsweise aus der Anreicherung oder dem Hinzufügen von Daten in einer Abfrage in einem Kampagnen-Workflow. Weitere Informationen entnehmen Sie den Abschnitten Erstellen von Abfragen und Erweitern von Daten.
