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.

Weitere Informationen hierzu finden Sie in der Dokumentation zu Vorlagen.

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.

HINWEIS

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. Erstellen Sie eine Seite, wählen Sie Adobe Campaign Classic Profil oder Adobe Campaign Standard Profil und klicken Sie auf Weiter.

    chlimage_1-43

    HINWEIS

    Wenn die gewünschte Vorlage nicht verfügbar ist, finden Sie weitere Informationen unter Vorlagenverfügbarkeit.

  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.

    chlimage_1-44

  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.

HINWEIS

Wenn die gewünschte Vorlage nicht verfügbar ist, finden Sie weitere Informationen unter Verfügbarmachen einer Vorlage.

In diesem Abschnitt werden nur für Adobe Campaign spezifische Verknüpfungen behandelt. Weitere Informationen zur Verwendung von Formularen in Adobe Experience Manager finden Sie unter 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.

    chlimage_1-45

  2. Klicken Sie auf der Seite in der Komponente Form Beginn auf das Konfigurationssymbol.

    chlimage_1-46

  3. Klicken Sie auf die Registerkarte Erweitert und wählen Sie den Formulartyp aus: Abonnieren, Abmelden, oder Profil speichern und klicken Sie auf 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. Ziehen Sie die Komponente Verschlüsselter Primär-Schlüssel in das Formular (an einer beliebigen Stelle) und klicken oder tippen Sie auf das Symbol Konfiguration. 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).

    chlimage_1-47

  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. Ä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. 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).

    chlimage_1-48

    HINWEIS

    Sie können in der Tabelle "Empfänger"angezeigte Felder wie folgt hinzufügen/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 zur AEM-Veröffentlichungsinstanz navigieren. Sie können zudem Formulare testen.

    VORSICHT

    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.

HINWEIS

Für jedes Formular muss eine Komponente Enkryted Primär Key vorhanden sein. 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.

Um diesen Link zu erstellen, verwenden Sie die Variable Hauptkennung der Ressource(Adobe Campaign Standard) oder Verschlüsselte Kennung (Adobe Campaign Classic) (z. B. in einer Komponente Text und Personalisierung (Kampagne)), die mit dem epk in Adobe Campaign verknüpft ist.

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 - Navigieren Sie zu Profile und Audiencen > Profil, mit denen die vorhandenen Profil Liste werden. Vergewissern Sie sich, dass in der Tabelle das Feld Hauptressourcen-ID in einer Spalte angezeigt wird (dies kann durch Klicken/Tippen auf Liste konfigurieren konfiguriert werden). Kopieren Sie die Hauptressourcenkennung des gewünschten Profils.
    • Wechseln Sie in Adobe Campaign Classic zu Profile und Zielgruppen > Empfänger, mit denen die vorhandenen Profil Liste werden. Vergewissern Sie sich, dass in der Tabelle das Feld Verschlüsselte Kennung in einer Spalte angezeigt wird (Dies kann konfiguriert werden, indem Sie mit der rechten Maustaste auf einen Eintrag klicken und Liste konfigurieren… auswählen.). Kopieren Sie die verschlüsselte Kennung des gewünschten Profils.
  2. Öffnen Sie AEM die Formularseite in der Veröffentlichungsinstanz und hängen Sie das EPK aus Schritt 1 als URL-Parameter an: beim Authoring des Formulars denselben Namen verwenden, den Sie zuvor in der EPK-Komponente definiert haben (z. B.: ?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