Show Menu
THEMEN×

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 .

Erstellen von Formularen

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 Integrieren mit Adobe Campaign Standard und Integrieren mit Adobe Campaign Classic .
Stellen Sie sicher, dass die Eigenschaft acMapping im Knoten jcr:content der Seite auf den Wert mapRecipient bzw. profile eingestellt ist, wenn Sie mit Adobe Campaign Classic oder Adobe Campaign Standard arbeiten.
  1. Navigieren Sie in AEM unter „Sites“ an den Ort, an dem Sie eine neue Seite erstellen möchten.
  2. Create a page and select Adobe Campaign Classic Profile or Adobe Campaign Standard Profile and click Next .
    If the desired template is not available, see Template Availability .
  3. Fügen Sie im Feld Name den Namen der Seite ein. Sie müssen einen gültigen JCR-Namen verwenden.
  4. Geben Sie in das Feld Titel einen Titel ein und klicken Sie auf Erstellen .
  5. Öffnen Sie die Seite und wählen Sie Eigenschaften öffnen aus. Fügen Sie in den Cloud-Services die Adobe Campaign-Konfiguration hinzu und klicken Sie auf das Häkchen, um die Änderungen zu übernehmen.
  6. Klicken Sie auf der Seite auf die Komponente Formular-Start und wählen Sie den Formulartyp ( abonnieren, Abonnement kündigen oder Profil speichern ) aus. Pro Formular kann nur ein Typ gewählt werden. Sie können den Inhalt des Formulars nun bearbeiten .

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.
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. 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. On the page, in the Form Start component, click the Configuration icon.
  3. Click the Advanced tab and select the type of form it is - Subscribe, Unsubscribe, or Save Profile and click OK. Pro Formular kann nur ein Typ gewählt werden.
    • 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.
  4. Jedes Formular muss über die Komponente Verschlüsselter Primärschlüssel verfügen. Mit dieser Komponente wird festgelegt, welcher URL-Parameter für die Annahme 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. Drag the component Encrypted Primary Key to the form (anywhere) and click or tap the Configuration icon. Geben Sie auf der Registerkarte Adobe Campaign einen Namen für den URL-Parameter an. Klicken oder tippen Sie auf das Häkchen, um die Änderungen zu übernehmen.
    Die generierten Links, die auf dieses Formular verweisen, 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äß für die URL codiert sein (Prozent).
  6. Fügen Sie dem Formular die gewünschten Komponenten hinzu (beispielsweise Text-, Daten-, Kontrollkästchen-, Optionsfeld usw.) hinzu. Weitere Informationen zu den Komponenten finden Sie unter Adobe Campaign-Formular-Komponenten .
  7. Klicken Sie auf das Symbol für die Konfiguration, um die Komponente zu öffnen. For example, in Text Field (Campaign) component, change the title and text.
    Klicken Sie auf Adobe Campaign , um das Formularfeld mit einer Adobe Campaign-Metadatenvariable zu verknüpfen. Beim Senden des Formulars wird das Feld in Adobe Campaign aktualisiert. Es stehen in der Auswahl nur Felder mit entsprechenden Datentypen zur Verfügung (beispielsweise Zeichenfolgenvariablen für Textfelder).
    You can add/remove fields that are displayed in the recipient table by following the instructions here: 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 zur AEM-Veröffentlichungsinstanz navigieren. Sie können zudem Formulare testen .
    Sie müssen dem anonymen Benutzer im Cloud-Service Leserechte zuweisen, damit Sie in der Veröffentlichungsumgebung mit Formularen arbeiten können. Berücksichtigen Sie jedoch die potenziellen Sicherheitsrisiken, die durch die Zuweisung von Leserechten an anonyme Benutzer entstehen, und schränken Sie diese beispielsweise durch Konfiguration des Dispatchers ein.

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.
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 Classic) (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 Classic, 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.