Erstellen von Adobe Campaign-Formularen in AEM

Mit AEM können Sie Formulare erstellen und bearbeiten, mit denen Sie auf Ihrer Website mit Adobe Campaign interagieren können. Sie können bestimmte Felder in Ihre Formulare einfügen und sie mit der Adobe Campaign-Datenbank verknüpfen.

Zudem können Sie Abonnements neuer Kontakte, Abmeldungen aus Abonnements und Benutzerprofildaten verwalten und diese zeitgleich in die Adobe Campaign-Datenbank integrieren.

Möchten Sie Adobe Campaign-Formulare in AEM nutzen, folgen Sie den in diesem Dokument beschriebenen Schritten:

  1. Stellen Sie eine Vorlage bereit.
  2. Erstellen Sie ein Formular.
  3. Bearbeiten Sie den Formularinhalt.

Drei Formulartypen, die speziell für Adobe Campaign erstellt wurden, sind standardmäßig verfügbar:

  • Profil speichern
  • Service abonnieren
  • Serviceabonnements beenden

Mit diesen Formularen wird ein URL-Parameter definiert, der den verschlüsselten Primärschlüssel eines Adobe Campaign-Profils akzeptiert. Basierend auf diesem URL-Parameter werden die Daten des zugehörigen Adobe Campaign-Profils aktualisiert.

Sie erstellen diese Formulare zwar einzeln, doch werden in typischen Anwendungsfällen personalisierte Verknüpfungen mit einer Formularseite im Newsletterinhalt generiert, sodass Benutzer den Link öffnen und Anpassungen an den Profildaten vornehmen können (beispielsweise Aktualisierung des Benutzerprofils, Abschließen oder Kündigen eines Abonnements).

Das Formular aktualisiert sich, basierend auf dem Benutzer, selbstständig. Weitere Informationen hierzu finden Sie unter Bearbeiten von Formularinhalt.

Verfügbarmachen von Vorlagen

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

To do this, see the Templates documentation.

Zunächst müssen Sie prüfen, ob die Verbindung zwischen Autoren- und Veröffentlichungsinstanz in Adobe Campaign funktioniert. Weitere Informationen hierzu finden Sie unter Integration mit Adobe Campaign Standard und Integration mit Adobe Campaign 6.1.

Hinweis

Stellen Sie sicher, dass die Eigenschaft acMapping im Knoten jcr:content der Seite auf den Wert mapRecipient bzw. Profil eingestellt ist, wenn Sie mit Adobe Campaign 6.1.x oder Adobe Campaign Standard arbeiten.

Erstellen von Formularen

  1. Starten Sie „siteadmin“.

  2. Durchsuchen Sie die Baumstruktur so lange, bis Sie den Ort finden, an dem Sie das Formular auf der gewünschten Website erstellen möchten.

  3. Wählen Sie Neu > Neue Seite… .

  4. Select either Adobe Campaign Profile (AC 6.1) or Adobe Campaign Profile (ACS) template and enter the page properties.

    Hinweis

    If the template is not available, refer to the Making a template available section.

  5. Click Create to create the form.

    chlimage_1-187

    Sie können den Inhalt des Formulars nun bearbeiten und konfigurieren.

Bearbeiten von Formularinhalt

Für Adobe Campaign erstellte Formulare verfügen über bestimmte Komponenten. Diese Komponenten ermöglichen es Ihnen, jedes Formularfeld mit einem Feld der Adobe Campaign-Datenbank zu verknüpfen.

Hinweis

If the desired template is not available, see Making a template available.

In diesem Abschnitt werden nur für Adobe Campaign spezifische Verknüpfungen behandelt. For more information on a more general overview of how to use forms in Adobe Experience Manager, see Editmode components.

  1. Navigieren Sie zu dem Formular, das Sie bearbeiten möchten.

  2. Wählen Sie in der Toolbox Seite > Seiteneigenschaften… gehen Sie dann im Popup-Fenster zur Registerkarte " Cloud-Dienste ".

  3. Add the Adobe Campaign service by clicking Add service, and then selecting the configuration that corresponds to your Adobe Campaign instance in the service's drop down list. Diese Konfiguration wird bei der Einrichtung der Verbindung zwischen den Instanzen durchgeführt. For more information, see Connecting AEM to Adobe Campaign.

    Hinweis

    Entsperren Sie (falls nötig) die Konfiguration, indem Sie auf das Schloss klicken. Der Adobe Campaign-Service kann nun hinzugefügt werden.

  4. Access the form's general parameters using the Edit button found at the start of the form. The Form tab allows you to select a thank you page to which the user will be redirected after having validated the form.

    The Advanced form allows you to select the type of form. The Post Options field gives you the choice between three types of Adobe Campaign forms:

    • Adobe Campaign: Profil speichern: Mit dieser Option können Sie Empfänger in Adobe Campaign erstellen oder aktualisieren (Standardeinstellung).
    • Adobe Campaign: Services abonnieren: Mit dieser Option können Sie Abonnements eines Empfängers in Adobe Campaign verwalten.
    • Adobe Campaign: Abonnement von Services beenden: Mit dieser Einstellung können Sie die Abonnements eines Empfängers in Adobe Campaign beenden.

    The Action Configuration field lets you specify whether or not you would like to create the recipient profile in the Adobe Campaign database if it does not yet exist. To do this, check the Create user if not existing option.

  5. Fügen Sie die ausgewählten Komponenten hinzu, indem Sie sie von der Toolbox in das Formular ziehen. Weitere Informationen über die verschiedenen Adobe Campaign-spezifischen Komponenten finden Sie unter Adobe-Formular-Komponenten.

    chlimage_1-188

  6. Konfigurieren Sie die hinzugefügten Felder, indem Sie doppelt darauf klicken. The Adobe Campaign tab lets you link the field to a field in the Adobe Campaign recipient table. Sie können zudem ebenfalls festlegen, ob das Feld Teil des Abstimmschlüssels ist, mit dessen Hilfe bereits in der Adobe Campaign-Datenbank erfasste Empfänger identifiziert werden können.

    ACHTUNG

    The Element Name must be different for each form field. Ändern Sie ihn bei Bedarf.

    Each form must contain an Encrypted Primary Key component in order to correctly manage recipients in the Adobe Campaign database.

  7. Activate the page by selecting Page > Activate Page in the toolbox. Die Seite wird auf Ihrer Site aktiviert. Sie können sie anzeigen, indem Sie zur AEM-Veröffentlichungsinstanz navigieren. Die Daten der Adobe Campaign-Datenbank werden nach Validierung eines Formulars aktualisiert.

Testen von Formularen

Nach der Erstellung und Bearbeitung eines Formulars möchten Sie dieses möglicherweise manuell prüfen, um sicherzustellen, dass es wie gewünscht funktioniert.

Hinweis

You must have an Encryted Primary Key component on each form. Wählen Sie aus den Komponenten Adobe Campaign aus, sodass nur die entsprechenden Komponenten angezeigt werden.

Obwohl Sie bei diesem Verfahren die EPK-Nummer manuell eingeben, würden Benutzer in der Praxis im Newsletter einen Link zur Seite erhalten (auf der sie Abonnements abschließen oder beenden und ihr Profil aktualisieren können). Der EPK wird – basierend auf dem Benutzer – automatisch aktualisiert.

To create that link, you use the variable Main resource identifier(Adobe Campaign Standard) or Encrypted identifier (Adobe Campaign 6.1) (for example, in a Text & Personalization (Campaign) component), which links to the epk in Adobe Campaign.

Hierfür müssen Sie den EPK 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:

    • In Adobe Campaign Standard - Navigate to Profiles and Audiences > Profiles, which lists the existing profiles. Make sure the table displays the Main Resource Identifier field in a column (This can be configured by clicking/tapping Configure list). Kopieren Sie die Hauptressourcenkennung des gewünschten Profils.
    • In Adobe Campaign 6.11, go to Profiles and Targets > Recipients, which lists the existing profiles. Make sure the table displays the Encrypted identifier field in a column (This can be configured by right-clicking on an entry and selecting Configure list…). Kopieren Sie die verschlüsselte Kennung des gewünschten Profils.
  2. In AEM, open the form page on the publish instance and append the EPK from step 1 as a URL parameter: use the same name that you previously defined in the EPK component when authoring the form (for example: ?epk=...)

  3. Das Formular kann jetzt verwendet werden, um die Daten und Abonnements zu ändern, die dem verknüpften Adobe Campaign-Profil zugeordnet sind. Nach der Bearbeitung einiger Felder und dem Absenden des Formulars können Sie in Adobe Campaign prüfen, ob die Daten entsprechend aktualisiert wurden.

Die Daten der Adobe Campaign-Datenbank werden nach Validierung eines Formulars aktualisiert.

Auf dieser Seite