Feldfunktionen

Dieses Kapitel beschreibt, wie Sie mit Feldfunktionen arbeiten, um Mailing-Inhalte zu personalisieren und anzupassen. Optimizely Campaign verwendet die Template-Engines Dynamic rendering (ODR) und Velocity, mit denen Sie Feldfunktionen definieren können.

ODR ist eine XML-basierte Beschreibung von Feldfunktionen. Velocity ist eine Java-basierte Sprache. Kenntnisse in HTML/XML oder Java sind hilfreich für das Arbeiten mit Feldfunktionen, da diese Dokumentation nur Grundlagen zur Verwendung von ODR und Velocity enthält. Für die häufigsten Anwendungsfälle können Sie außerdem die Feldfunktionsvorlagen verwenden.

Feldfunktionen in Mailings einfügen

Feldfunktionen werden im Mailing-Kontext (Paragraph, Betreff und so weiter) mittels eines Platzhalters in geschweiften Klammern { } eingefügt. Um beim Bearbeiten eines Mailings den Platzhalter für eine Feldfunktion aufzurufen, führen Sie die folgenden Schritte aus:

1. Klicken Sie im Editor auf Feldfunktion einfügen .
2. Klicken Sie in der Liste auf die gewünschte Feldfunktion.
3. Klicken Sie anschließend auf OK.

Anwendungsbeispiele für Feldfunktionen

Feldfunktionen ersetzen oder personalisieren Inhalte. Beim Versenden der E-Mail wird mittels der Feldfunktion ein Ausdruck (Text) erzeugt und in die E-Mail eingefügt. Es gibt Feldfunktionen, die lediglich eine einfache Ersetzung vornehmen und Algorithmen, die verschiedene Fälle unterscheiden und den Text entsprechend anpassen. Feldfunktionen können auch über Zielgruppen Teilgruppe von Empfängern. Sie besteht aus einer oder mehreren Regeln und Bedingungen, die durch logische Verknüpfungen kombiniert werden. Z. B. alle Empfänger in Großbritannien. definiert werden und beispielsweise einen Text nur dann ausgeben, wenn der Empfänger zur Zielgruppe gehört. Die folgende Liste enthält einige typische Beispiele für Feldfunktionen:

• Datum. Beim Versenden findet eine Ersetzung durch das aktuelle Datum statt.
• Anrede. Ein Anrede-Algorithmus enthält meist eine Anredeform für Männer, Frauen und eine allgemeine Form für den Fall, dass Name oder Geschlecht nicht bekannt sind.
• Betreffzeile. Eine Feldfunktion kann beispielsweise den Namen in eine Betreffzeile setzen oder andere Personalisierungen vornehmen.

Feldfunktionen bearbeiten

Um eine Feldfunktion zu bearbeiten, wählen Verwaltung > Feldfunktionen. In der Übersicht finden Sie Feldfunktionen, die Sie bearbeiten können. Wenn Sie in einem Untermandanten arbeiten, werden in der Liste der verfügbaren Feldfunktionen auch vom Hauptmandanten vererbte Feldfunktionen angezeigt. Diese können nicht bearbeitet werden. Wählen Sie eine Funktion aus der Liste aus und klicken Sie auf Bearbeiten…, um die Funktion zu bearbeiten.

Um eine neue Feldfunktion zu erstellen, klicken Sie auf Erstellen…. Wenn Sie Feldfunktionen entfernen, vergewissern Sie sich, dass die Feldfunktion nicht in einem aktiven Mailing verwendet wird.

• Vererbbar. Wählen Sie diese Option, wenn Ihnen die Feldfunktion, die Sie bearbeiten, auch in Untermandanten zur Verfügung stehen soll. Benutzer in den Untermandanten können diese Feldfunktion benutzen, aber nicht bearbeiten.
• Typ. Wählen Sie aus, nach welchen Regeln die Feldfunktion gelesen beziehungsweise validiert wird.

  Ändern Sie den Typ nur, wenn Sie sich sicher sind.

  • JSPX. Dieser Typ akzeptiert nur validen XML-Code.
  • Velocity. Dieser Typ akzeptiert nur validen Velocity-Code.
• Beispiel. Zeigt einen Beispieltext, durch den der Platzhalter beim Versenden des Mailings ersetzt werden soll. Sie können hier ein Beispiel oder auch eine Beschreibung der Feldfunktion einfügen.
• Inhalte. Geben Sie hier die eigentliche Feldfunktion ein. Sie können für den entsprechenden Mailing-Typ, Medientyp (Marketing-Kanal Kanal, über den Werbebotschaften oder Informationen an Kunden und Interessenten übermittelt werden. Zum Beispiel E-Mail, SMS, Print oder Push.) oder das entsprechende Element eine eigene Feldfunktion definieren. Das kann statischer Text sein, dynamisch erzeugter Text oder eine Mischung aus beidem. Um dynamische Inhalte zu erzeugen, müssen Befehle und Abfragen eingefügt werden, die beim Versenden auf Empfängerdaten zugreifen und diese verarbeiten können:
  • Standard-Ersetzung. Dieses Feld enthält ein Fallback, das immer dann greift, wenn eine der unten stehenden spezifischen Feldfunktionen nicht definiert ist. Wenn Sie keine unterschiedlichen Feldfunktionen für jeden E-Mail-Typ, Medientyp und Elementtyp benötigen, nutzen Sie dieses Feld und lassen Sie die anderen leer.
  • Text. Schreiben Sie den Code und Text der Feldfunktion in dieses Feld für die Text-Version eines Mailings.
  • HTML. Schreiben Sie den Code und Text der Feldfunktion in dieses Feld für die HTML-Version eines Mailings.
  • SMS. Schreiben Sie den Code und Text der Feldfunktion in dieses Feld für SMS-Mailings.
  • Betreff. Schreiben Sie den Code und Text der Feldfunktion in dieses Feld für die Betreffzeile eines Mailings.

Template-Engines

Template-Engines bearbeiten die im Mailing enthaltenen Feldfunktionen unmittelbar beim Versenden, d.h. sie folgen den in den Feldfunktionen definierten Arbeitsanweisungen und lesen die dort angegebenen Daten aus. In Optimizely Campaign stehen Ihnen die Template-Engines ODR und Velocity zur Verfügung. Der folgende Abschnitt gibt Ihnen eine Einführung in beide und listet die verfügbaren Klassen und Funktionen auf.

ODR – Dynamic rendering

Wenn Ihnen XML und HTML bereits vertraut sind, können Sie Feldfunktionen am einfachsten in der ODR-Sprache beschreiben. Das nachfolgende Beispiel zeigt eine Anredelogik in ODR:

Beispiel-Code

<odr:choose>
<odr:when test="%{not empty user.data.firstname and not empty user.data.lastname and user.data.salutation == 'Frau'}">
<odr:out value="Liebe %{user.data.firstname} %{user.data.lastname}," /> 
</odr:when>
<odr:when test="%{not empty user.data.firstname and not empty user.data.lastname and user.data.salutation == 'Herr'}">
<odr:out value="Lieber %{user.data.firstname} %{user.data.lastname}," /> 
</odr:when>
<odr:otherwise>
<odr:out value="Sehr geehrte Damen und Herren," />
</odr:otherwise>
</odr:choose>

Umbrüche, Leerzeichen und Formatierungen in ODR

Zeilenumbrüche und Leerzeichen zwischen ODR-Tags werden beim Rendern entfernt. Leerzeichen können an den entsprechenden Stellen jedoch eingefügt werden, etwa im Fließtext zwischen den Anführungszeichen. HTML-Tags innerhalb von ODR-Ausdrücken – z. B. Zeilenumbrüche und Schriftformatierungen – müssen als Entities geschrieben werden. Verwenden Sie folgende Entities zur Umschreibung der Tags und Sonderzeichen:

• „<“ wird als „&lt;“ geschrieben.
• „>“ wird als „&gt;“ geschrieben.
• „"“ wird als „&quot;“ geschrieben.
• „&“ wird als „&amp;“ geschrieben.

Velocity

Velocity ist eine Java-basierte Template-Engine. Velocity Algorithmen können direkt in den HTML-Code von Mailings oder Webseiten eingefügt werden. In einem Algorithmus können Bedingungen und Fallbacks enthalten sein, die je nachdem, ob sie erfüllt sind oder nicht, einen anderen Text oder gar keinen Text ausgeben.

Velocity Referenzen werden durch ein Dollarzeichen $ markiert, gefolgt von der entsprechenden Klasse und Funktion. Zwei einfache Beispiele zeigen Ihnen, wie Sie mit Velocity arbeiten.

Beispiel: Vor- und Zunamen des Empfängers in die Anrede einfügen

Liebe(r) ${user.data.firstname} ${user.data.lastname}!

Mit dem Ausdruck ${user.data.[feldbezeichnung]} können alle Felder der Empfängerliste angesprochen werden, wobei der in eckigen Klammern stehende Ausdruck durch den Namen des entsprechenden Empfängerlistenfeldes ersetzt werden muss.

Wenn Sie in Ihrer Empfängerliste auch Empfänger haben, deren Vorname nicht bekannt ist, etwa weil das Feld Vorname bei der Anmeldung kein Pflichtfeld ist, dann ist der oben beschriebene Weg nicht ausreichend. Sie werden keinen Ihrer Empfänger mit „Liebe(r) Schmidt!“ anreden wollen. Mit Velocity können Sie für diesen Fall eine Alternative formulieren mit der jeweils richtigen Form für Männer und Frauen.

Beispiel: Vollständige Anrede für Männer und Frauen sowie Fallback:

Um in der Anrede alle Fälle zu berücksichtigen, wird ein Wenn-Dann-Algorithmus formuliert. Ein solcher Algorithmus wird mit einem Rautezeichen # gefolgt von dem Befehl if eingeleitet. Es folgen die Definition der verschiedenen Fälle und einer Alternative (else), falls keiner der Fälle zutrifft. Der Algorithmus wird mit #end abgeschlossen:

#if("$!{user.data.firstname}" != "" && "$!{user.data.lastname}" != "" &&"$!{user.data.salutation}" != "")
	Liebe
		#if($!user.data.salutation.startsWith("Herr"))r#end
		$user.data.firstname $user.data.lastname,
		#else Sehr$!{null}geehrte Damen und Herren#end$!{null}

Velocity-Klassen und -Funktionen

Optimizely Campaign stellt Ihnen ein Reihe von Klassen und Funktionen zur Verfügung, mit denen Sie Feldfunktionen definieren können:

• $user.data
• $bmFormat
• $bmMimeType
• $filter

$user.data

Mit dieser Funktion können Sie alle Felder einer Empfängerliste ansprechen. Die Funktion kann verwendet werden, um den entsprechenden Wert des Feldes in ein Mailing einzufügen (Platzhalter) oder um den Inhalt des Feldes mit einem gesetzten Wert zu vergleichen (Wenn-Dann-Funktion).

$user.data.[feldbezeichnung] == "string"

$user.data.[feldbezeichnung] == X

$user.data.[feldbezeichnung] != "string"

$user.data.[feldbezeichnung].startsWith ("string")

$user.data.[feldbezeichnung] != X

$user.data.[feldbezeichnung] <= X

$user.data.[feldbezeichnung] >= X

$user.data.[feldbezeichnung] > X

$user.data.bmIsOnlineVersion

Mit der Funktion Ist Online-Version können Sie beispielsweise abfragen, ob die Online-Version eines Newsletters angezeigt wird. Der Rückgabewert ist in diesem Fall true. Damit kann der Link zur Online-Version („Klicken Sie auf folgenden Link, wenn die Email nicht korrekt dargestellt wird.“ ausgeblendet werden, wenn diese angezeigt wird. Der entsprechende Code lautet wie folgt:

#if($user.data.bmIsOnlineVersion)Bitte <a href="{Online-Version-Link}" 
	target="_blank">hier</a> klicken, 
	um eine Online-Version dieses Newsletters zu lesen.

$bmFormat

Diese Klasse formatiert den eingeschlossenen Ausdruck. Sie können nur Datumsfelder oder Zahlenwerte formatieren. Optional können Sie eine Formatvorlage (pattern) und die Anzahl der Nachkommastellen (precision) angeben. Der folgende Code zeigt ein Beispiel mit $bmFormat:

Sie sind seit dem $bmFormat.formatDate($user.data.created) bei uns registriert.

$bmFormat.formatPercentage

$bmFormat.formatCurrency

$bmFormat.formatDate

$bmFormat.formatDateTime

$bmFormat.formatTime

Attribute zur Formatierung von Zahlenwerten

$bmMimeType

Mit dieser Klasse können Sie den Mime Steht für „Multi-purpose Internet Mail Extensions“. Ein Standard zur Klassifizierung von Dateitypen im Internet. Internetprogramme wie Web Server und Browser verfügen über eine Liste mit MIME-Typen, um systemunabhängig Dateien desselben Typs auf dieselbe Weise übermitteln zu können.-Type abfragen, der gerade gerendert wird.

$bmMimeType == "text/plain"

$bmMimeType == "text/html"

$filter

Diese Klasse ermöglicht es, Zielgruppen aufzurufen. Der übergebene String muss einer Zielgruppen-ID Ihres Optimizely Campaign Mandanten Arbeitsumgebung von Optimizely Campaign. Ein Mandant ist ein eigenständiges und in sich geschlossenes System zur Organisation Ihrer Mailings. Sie können einen oder mehrere Mandanten verwenden. entsprechen. Um die IDs für Ihre Zielgruppen zu erhalten, wenden Sie sich an die Kundenbetreuung Verwenden Sie keine IDs, bei denen Sie sich nicht sicher sind, dass sie den Zielgruppen in Ihrem Mandanten entsprechen, andernfalls könnte das die Funktion Ihrer Vorlage und Ihres Mailing-Versandes beeinträchtigen. Der Velocity-Code dieser Funktion lautet:

$filter.filterByRevisionedFilter

Feldfunktionsvorlagen

In den folgenden Kapiteln finden Sie Velocity- und ODR-Vorlagen, mit denen Sie Ihre eigenen Feldfunktionen erstellen können: