Erstellen von Adobe Campaign-Formularen in AEM

Mit AEM können Sie Formulare erstellen und bearbeiten, die auf Ihrer Website mit Adobe Campaign interagieren. Bestimmte Felder können in Ihre Formulare eingefügt und der Adobe Campaign-Datenbank zugeordnet werden.

Sie können neue Kontaktanmeldungen, -abmeldungen und Benutzerprofildaten verwalten und gleichzeitig deren Daten in Ihre Adobe Campaign-Datenbank integrieren.

Um Adobe Campaign-Formulare in AEM zu verwenden, müssen Sie die folgenden Schritte ausführen, die in diesem Dokument beschrieben werden:

1. Stellen Sie eine Vorlage zur Verfügung.
2. Erstellen Sie ein Formular.
3. Bearbeiten Sie den Formularinhalt.

Standardmäßig sind drei Formulartypen für Adobe Campaign verfügbar:

• Profil speichern
• Service abonnieren
• Von einem Service abmelden

Diese Formulare definieren einen URL-Parameter, der den verschlüsselten Primärschlüssel eines Adobe Campaign-Profils akzeptiert. Basierend auf diesem URL-Parameter aktualisiert das Formular die Daten des zugehörigen Adobe Campaign-Profils.

Obwohl Sie diese Formulare unabhängig voneinander erstellen, generieren Sie in einem typischen Anwendungsfall einen personalisierten Link zu einer Formularseite innerhalb des Newsletter-Inhalts, damit Empfängerinnen und Empfänger den Link öffnen und Anpassungen an ihren Profildaten vornehmen können (unabhängig davon, ob sie sich abmelden, abonnieren oder ihr Profil aktualisieren).

Das Formular wird basierend auf der Benutzerin bzw. dem Benutzer automatisch aktualisiert. Siehe Formularinhalt bearbeiten, um weitere Informationen zu erhalten.

Verfügbarmachen von Vorlagen

Damit Sie für Adobe Campaign spezifische Formulare erstellen können, müssen Sie die verschiedenen Vorlagen in Ihrer AEM-Anwendung verfügbar machen.

Weitere Informationen hierzu finden Sie in der Vorlagendokumentation.

Erstellen von Formularen

Überprüfen Sie zunächst, ob die Verbindung zwischen der Authoring- und der Publishing-Instanz und Adobe Campaign funktioniert. Siehe Integration mit Adobe Campaign Standard bzw. Integration mit Adobe Campaign Classic.

1. Navigieren Sie in AEM in Sites an die Stelle, an der Sie eine Seite erstellen möchten.

2. Erstellen Sie eine Seite, wählen Sie Adobe Campaign Classic-Profil oder Adobe Campaign Standard-Profil aus und klicken Sie auf Weiter.

   

   HINWEIS

   Ist die gewünschte Vorlage nicht verfügbar, finden Sie weitere Informationen hierzu unter Verfügbarmachen von Vorlagen.

3. Fügen Sie im Feld Name den Namen der Seite hinzu. Es muss ein gültiger JCR-Name sein.

4. Geben Sie im Feld Titel den Titel ein und klicken Sie auf Erstellen.

5. Öffnen Sie die Seite und wählen Sie Eigenschaften öffnen aus. Fügen Sie in Cloud Services die Adobe Campaign-Konfiguration hinzu und klicken Sie auf das Häkchen, um die Änderungen zu speichern.

   

6. Wählen Sie auf der Seite in der Komponente Formularstart den Formulartyp aus – Abonnieren, Abmelden oder Profil speichern. Pro Formular kann nur ein Typ gewählt werden. Sie können den Inhalt des Formulars nun bearbeiten.

Bearbeiten von Formularinhalten

Eigens für Adobe Campaign erstellte Formulare haben bestimmte Komponenten. Diese Komponenten bieten die Möglichkeit, jedes Formularfeld mit einem Feld in der Adobe Campaign-Datenbank zu verknüpfen.

In diesem Abschnitt werden nur für Adobe Campaign spezifische Verknüpfungen behandelt. Weitere Informationen und einen allgemeineren Überblick darüber, wie Sie Formulare in Adobe Experience Manager verwenden, finden Sie unter Komponenten des Bearbeitungsmodus.

1. Wählen Sie Eigenschaften öffnen aus. Fügen Sie den Cloud-Services die Adobe Campaign-Konfiguration hinzu und klicken Sie auf das Häkchen, um die Änderungen zu übernehmen.

   

2. Klicken Sie auf der Seite in der Komponente Formular-Start auf das Symbol für die Konfiguration.

   

3. Klicken Sie auf die Registerkarte Erweitert, wählen Sie den Formulartyp (Abonnieren, Abonnement kündigen oder Profil speichern) aus und klicken Sie auf OK. Pro Formular kann nur ein Typ gewählt werden.

   • Adobe Campaign: Profil speichern: ermöglicht das Erstellen oder Aktualisieren einer Empfängerin oder eines Empfängers in Adobe Campaign (Standardwert).
   • Adobe Campaign: Abonnieren von Diensten: ermöglicht das Verwalten der Abonnements einer Empfängerin oder eines Empfängers in Adobe Campaign.
   • Adobe Campaign: Abmeldung von Diensten: ermöglicht Ihnen, die Abonnements einer Empfängerin oder eines Empfängers in Adobe Campaign zu stornieren.

4. Sie müssen in jedem Formular eine Komponente Verschlüsselter Primärschlüssel haben. Diese Komponente definiert, welcher URL-Parameter zum Akzeptieren des verschlüsselten Primärschlüssels eines Adobe Campaign-Profils verwendet wird. Wählen Sie aus den Komponenten Adobe Campaign aus, sodass nur die entsprechenden Komponenten angezeigt werden.

5. Ziehen Sie die Komponente Verschlüsselter Primärschlüssel an eine beliebige Stelle im Formular und klicken oder tippen Sie auf Sie das Symbol für die Konfiguration. Geben Sie auf der Registerkarte Adobe Campaign einen beliebigen Namen für den URL-Parameter an. Klicken oder tippen Sie auf das Häkchen, um Ihre Änderungen zu speichern.

   Generierte Links zu diesem Formular müssen diesen URL-Parameter verwenden und ihn dem verschlüsselten Primärschlüssel eines Adobe Campaign-Profils zuweisen. Der verschlüsselte Primärschlüssel muss ordnungsgemäß URL-codiert (Prozent) sein.

   

6. Fügen Sie dem Formular nach Bedarf Komponenten hinzu, z. B. ein Textfeld, ein Datumsfeld, ein Kontrollkästchen, ein Optionsfeld usw. Siehe Adobe Campaign-Formularkomponenten, um weitere Informationen zu den einzelnen Komponenten zu erhalten.

7. Klicken Sie auf das Symbol „Konfiguration“, um die Komponente zu öffnen. Ändern Sie beispielsweise in der Komponente Textfeld (Kampagne) den Titel und den Text.

   Klicken Sie auf Adobe Campaign, um das Formularfeld mit einer Adobe Campaign-Metadatenvariable zu verknüpfen. Wenn Sie das Formular senden, wird das zugeordnete Feld in Adobe Campaign aktualisiert. In der Variablenauswahl sind nur Felder mit übereinstimmenden Typen verfügbar (z. B. Zeichenfolgenvariablen für Textfelder).

   

   HINWEIS

   Sie können in der Empfängertabelle aufgeführte Felder wie auf der folgenden Seite beschrieben hinzufügen oder entfernen: https://blogs.adobe.com/experiencedelivers/experience-management/aem-campaign-integration/

8. Klicken Sie auf Seite veröffentlichen. Die Seite wird auf Ihrer Site aktiviert. Sie können sie anzeigen, indem Sie zu Ihrer AEM-Publishing-Instanz wechseln. Sie können auch ein Formular testen.

   VORSICHT

   Sie müssen anonymen Benutzerinnen und Benutzern im Cloud-Service Leseberechtigungen erteilen, um Formulare in der Publishing-Umgebung verwenden zu können. Beachten Sie jedoch die potenziellen Sicherheitsprobleme bei der Gewährung von Leseberechtigungen für anonyme Benutzerinnen und Benutzer und stellen Sie sicher, dass Sie diese abmildern, indem Sie beispielsweise den Dispatcher konfigurieren.

Testen eines Formulars

Nachdem Sie ein Formular erstellt und den Formularinhalt bearbeitet haben, können Sie manuell testen, ob das Formular erwartungsgemäß funktioniert.

Dazu müssen Sie den verschlüsselten Primärschlüssel eines Adobe Campaign-Profils manuell abrufen und an die URL anhängen:

1. So rufen Sie den verschlüsselten Primärschlüssel (EPK) eines Adobe Campaign-Profils ab:

   • Navigieren Sie in Adobe Campaign Standard zu Profile und Zielgruppen > Profile. Hier werden alle vorhandenen Profile aufgeführt. Stellen Sie sicher, dass das Feld Hauptressourcenkennung in einer der Spalten angezeigt wird (dies kann durch Klicken oder Tippen auf Liste konfigurieren eingestellt werden). Kopieren Sie die Hauptressourcenkennung des gewünschten Profils.
   • Navigieren Sie in Adobe Campaign Classic zu Profile und Ziele > Empfänger. Hier sind alle vorhandenen Profile aufgeführt. Stellen Sie sicher, dass das Feld Verschlüsselte Kennung in einer der Spalten angezeigt wird (dies kann durch einen Rechtsklick auf einen Eintrag und die Auswahl von Liste konfigurieren… eingestellt werden). Kopieren Sie die verschlüsselte Kennung des gewünschten Profils.

2. Öffnen Sie in AEM die Formularseite in der Veröffentlichungsinstanz und fügen Sie den EPK aus Schritt 1 als URL-Parameter an: Verwenden Sie den gleichen Namen, den Sie zuvor in der EPK-Komponente beim Erstellen des Formulars verwendet haben (Beispiel: ?epk=...).

3. Mit dem Formular können jetzt die mit dem verknüpften Adobe Campaign-Profil verknüpften Daten und Abonnements geändert werden. Nachdem Sie einige Felder geändert und das Formular übermittelt haben, können Sie in Adobe Campaign überprüfen, ob die entsprechenden Daten aktualisiert wurden.

Die Daten in der Adobe Campaign-Datenbank werden aktualisiert, sobald ein Formular validiert wurde.