Syntax der E-Mail-Vorlage email-template-syntax

In Marketos neuem E-Mail 2.0-Erlebnis bestehen E-Mail-Vorlagen aus einer beliebigen Kombination von Elementen, Variablen, Modulen oder Containern. Jede wird definiert, indem Sie Ihrer HTML eine Marketo-spezifische Syntax hinzufügen. Alte (v1.0) E-Mail-Vorlagen werden in E-Mail-Editor 2.0 unterstützt. Sie enthalten jedoch nicht alle neuen Editor-Funktionen.

Die E-Mail-Syntax von Marketo funktioniert nur in Vorlagen und E-Mails. not funktionieren, wenn sie in Snippets oder Rich-Text-Token eingebettet sind.

NOTE
Der Marketo-Support ist nicht für CSS/HTML eingerichtet. Wenn Sie nicht mit CSS/HTML vertraut sind, wenden Sie sich an Ihren Entwickler.
CAUTION
Bei Klassenwerten mit Marketo-Syntax (d. h. mktoModule, mktoContainer, mktoText) wird zwischen Groß- und Kleinschreibung unterschieden. Benutzerdefinierte Attributnamen (d. h. mktoimgwidth, mktoname) sind nicht vorhanden.

Elemente elements

Elemente sind Inhaltsbereiche, die Sie in Ihrer E-Mail-Vorlage als bearbeitbar definieren. Das Bearbeitungserlebnis eines Elements ist seinem Typ eindeutig und bietet eine einfache Möglichkeit, mit Inhalten zu arbeiten. Folgende Elemente können in eine E-Mail-Vorlage aufgenommen werden:

  • RTF
  • Bilder
  • Ausschnitte
  • Videos

RTF rich-text

Wenn Sie eine Region als Rich-Text definieren, können Benutzer den Inhalt bearbeiten Verwenden des Rich-Text-Editors von Marketo. Es gibt zwei Möglichkeiten, ein Rich-Text-Element innerhalb einer E-Mail-Vorlage zu definieren: mktEditable und mktoText. Beachten Sie, dass ein Rich-Text-Element im E-Mail-Editor immer in einen Ausschnitt konvertiert werden kann.

Option 1: mktEditable option-mkteditable

Da Email Editor 2.0 abwärtskompatibel ist, können einige alte E-Mail-Vorlagen Rich-Text-Elemente spezifizieren, indem class="mktEditable" für beliebige HTML-Elemente hinzugefügt wird. Dies wird weiterhin unterstützt und die ID des Elements wird als Anzeigename im E-Mail-Editor verwendet.

Erforderliche Attribute

  • class: "mktEditable".
  • id: ID-Zeichenfolge. Enthält nur Buchstaben, Zahlen, Bindestriche "-"und Unterstriche "_". Leerzeichen sind nicht zulässig. Muss eindeutig sein.

Optionale Attribute

  • mktoName : Zeichenfolge. Dies ist der Anzeigename, der in Email Editor 2.0 angezeigt wird. Es empfiehlt sich, einen beschreibenden Namen zu verwenden.

Standardwert

Der Inhalt im HTML-Element (sofern vorhanden) mit class="mktEditable" wird als Standardwert für das Rich-Text-Element verwendet.

Beispiel:

<pre data-theme="Confluence"><div class="mktEditable" id="exampleText" mktoName="Main Body Text"> Optionally add default text for the editable text area. </div></pre>

Option 2: mktoText option-mktotext

Es wird empfohlen, Rich-Text-Elemente mithilfe der Syntax class="mktoText" anzugeben. Dadurch wird sichergestellt, dass für das Element immer ein richtiger Anzeigename vorhanden ist.

Erforderliche Attribute

  • class: "mktoText"
  • id: ID-Zeichenfolge. Enthält nur Buchstaben, Zahlen, Bindestriche "-"und Unterstriche "_". Leerzeichen sind nicht zulässig. Muss eindeutig sein.
  • mktoName : Zeichenfolge. Dies ist der Anzeigename, der in Email Editor 2.0 angezeigt wird. Es empfiehlt sich, einen beschreibenden Namen zu verwenden.

Standardwert

Der Inhalt im HTML-Element (sofern vorhanden) mit class="mktoText" wird als Standardwert für das Rich-Text-Element verwendet.

Beispiel:

<pre data-theme="Confluence"><div class="mktoText" id="exampleText" mktoName="Main Body Text"> Optionally add default text for the editable text area. </div></pre>

Bilder images

Sie haben zwei Optionen zum Definieren bearbeitbarer Bildelemente. Sie können entweder eine <div>, der einen Container angibt, der <img> in oder ein <img> -Tag. Wenn Sie möchten, dass der Endbenutzer einfach ein Bild auswählt, das die Bild-URL zurückgibt (im Gegensatz zum DOM), lesen Sie bitte "Bildvariablen"im folgenden Abschnitt. Mit den folgenden beiden Optionen wird eine HTML eingefügt <img> -Element.

Option 1: Verwenden eines <div> option-use-a-div

Erforderliche Attribute

  • -Klasse: "mktoImg".
  • id: ID-Zeichenfolge. Enthält nur Buchstaben, Zahlen, Bindestriche "-"und Unterstriche "_". Leerzeichen sind nicht zulässig. Muss eindeutig sein.
  • mktoName : Zeichenfolge. Dies ist der Anzeigename, der in Email Editor 2.0 angezeigt wird. Es empfiehlt sich, einen beschreibenden Namen zu verwenden.

Optionale Attribute

  • mktoImgClass: Zeichenfolge. Der Wert hier wird dem class -Attribut der <img> -Element innerhalb des div.
  • mktoImgSrc: Wird als Standardwert für das Bild verwendet, das in diesem div platziert wird. Ein Platzhalter wird verwendet, wenn dies weggelassen wird.
  • mktoImgLink: Geben Sie an, dass die Variable <img> sollte von einer <a> -Tag mit dieser Ziel-URL. Der Benutzer kann dies im E-Mail-Editor ändern.
  • mktoImgLinkTarget: Geben Sie an, dass die Variable <a> -Tag aus dem mktoImgLink -Attribut verwenden, sollte dieses Ziel verwenden. Hat keine Auswirkung, wenn mktoImgLink nicht auch verwendet wird.
  • mktoImgWidth: Wird als Breite auf dem eingeschlossenen <img>.
  • mktoImgHeight: Wird als Höhe auf dem eingeschlossenen <img>.
  • mktoLockImgSize: Wird zum Entsperren des <img> die Eigenschaft height und width des Elements, sodass der Endbenutzer ändern kann (der Standardwert lautet "true", wenn nicht angegeben).
  • mktoLockImgStyle: Wird zum Sperren der <img> die Stileigenschaft des Elements (Standard ist "false").

Standardwert (optional)

<img>: Wird als <img> -Element, in dem das Bild platziert werden soll. Nützlich, wenn Sie dem Bild Inline-Stile hinzufügen möchten. Denken Sie daran, die Umgebung einzubeziehen <a> </a> Tags, sodass der Benutzer einen Link hinzufügt, Ihr Stil nicht entfernt wird!

Beispiel:

<pre data-theme="Confluence"><div class="mktoImg" id="exampleImg" mktoName="Example Image" mktoImgLink="https://www.marketo.com"> <a><img style="border:10px solid red;"></a> </div></pre>

Option 2: Verwenden eines &lt;img> option-use-an-img

NOTE
Diese Option ermöglicht es Endbenutzern nicht, einen Link zu ihrem Bild hinzuzufügen. Verwenden Sie Option 1, wenn dies für Ihre Vorlage wichtig ist.

Erforderliche Attribute

  • -Klasse: "mktoImg".
  • id: ID-Zeichenfolge. Enthält nur Buchstaben, Zahlen, Bindestriche "-"und Unterstriche "_". Leerzeichen sind nicht zulässig. Muss eindeutig sein.
  • mktoName: Zeichenfolge. Dies ist der Anzeigename, der in Email Editor 2.0 angezeigt wird. Es empfiehlt sich, einen beschreibenden Namen zu verwenden. Standardwert (optional)
  • src: Wird als Standardwert für das Bild verwendet. Ein Platzhalter wird verwendet, wenn dies weggelassen wird.
  • mktoLockImgSize: Wird zum Entsperren des <img> die Eigenschaft height und width des Elements, sodass der Endbenutzer ändern kann (der Standardwert lautet "true", wenn nicht angegeben).
  • mktoLockImgStyle: Wird zum Sperren der <img> die Stileigenschaft des Elements (Standard ist "false").

Beispiel:
<pre data-theme="Confluence"><img class="mktoImg" id="exampleImg" mktoName="Example Image"></pre>

Ausschnitte snippets

Wenn Sie eine Region als Snippet definieren, können Endbenutzer wählen, welche Region genehmigt wurde Snippetsie möchten in diese Region einfügen. Rich-Text-Elemente können zwar im E-Mail-Editor in Snippets konvertiert werden, aber wenn Sie eine Region spezifisch als Snippet definieren, kann sie nicht in Rich-Text konvertiert werden. Sie können eine Snippet-Region mithilfe einer <div> mit class="mktoSnippet"

Erforderliche Attribute

  • id: ID-Zeichenfolge. Enthält nur Buchstaben, Zahlen, Bindestriche "-"und Unterstriche "_". Leerzeichen sind nicht zulässig. Muss eindeutig sein.
  • mktoName: Zeichenfolge. Dies ist der Anzeigename, der in Email Editor 2.0 angezeigt wird. Es empfiehlt sich, einen beschreibenden Namen zu verwenden.

Standardwert (optional)

mktoDefaultSnippetId: Die numerische ID des Marketo-Snippets, die standardmäßig angezeigt werden soll (funktioniert nur, wenn ein Snippet mit dieser ID vorhanden ist und in diesem Arbeitsbereich genehmigt ist).

Beispiel:

<pre data-theme="Confluence"><div class="mktoSnippet" id="unsubscribeFooter" mktoName="Unsubscribe Footer" mktoDefaultSnippetId="12"></div></pre>

Video video

Wenn Sie eine Region als Video definieren, können Endbenutzer entweder eine YouTube- oder eine Vimeo-URL einfügen, die als Miniaturbild (mit der Schaltfläche "Abspielen") in die E-Mail eingefügt wird. Sie können einen Videobereich mit einer <div> with class="mktoVideo"

Erforderliche Attribute

  • id: ID-Zeichenfolge. Enthält nur Buchstaben, Zahlen, Bindestriche "-"und Unterstriche "_". Leerzeichen sind nicht zulässig. Muss eindeutig sein.
  • mktoName: Zeichenfolge. Dies ist der Anzeigename, der in Email Editor 2.0 angezeigt wird. Es empfiehlt sich, einen beschreibenden Namen zu verwenden.

Optionale Attribute

  • mktoImgClass: Zeichenfolge. Der Wert hier wird dem Klassenattribut der Videominiatur hinzugefügt <img> im div.

Beispiel:

<pre data-theme="Confluence"><div class="mktoVideo" id="productVideo" mktoName="Product Announcement Video"></div></pre>

Variablen variables

Variablen sind wie Token. Definieren Sie sie zunächst im <head> Abschnitt Ihrer E-Mail-Vorlage mit <meta> Tags verwenden, dann so oft, wie Sie möchten, in Ihrer Vorlage verwenden. Da sie in der Vorlage definiert sind, kann der Endbenutzer seine Werte entsprechend seinen Regeln ändern. Beachten Sie, dass Sie eine Variable im Umfang als lokal oder global definieren können. Wenn Sie eine Variable in einem "Modul"verwenden (siehe unten) und ein Endbenutzer dieses Modul dupliziert, verfügen lokale Variablen über unabhängige Werte, während globale Variablen für beide Module gelten.

Zeichenfolge string

Wenn Sie eine Variable als Zeichenfolge angeben, kann der Endbenutzer Text in einem Textfeld im E-Mail-Editor eingeben. Sie geben eine String-Variable an mit <meta> with class="mktoString"

Erforderliche Attribute

  • id: Referenzierung der Variablen in Ihrer E-Mail-Vorlage.
  • mktoName: Zeichenfolge. Dies ist der Anzeigename, der in Email Editor 2.0 angezeigt wird. Es empfiehlt sich, einen beschreibenden Namen zu verwenden.

Optionale Attribute

  • allowHTML: Boolesch. Steuert, ob der Variablenwert durch HTML maskiert ist. Der Standardwert ist "False", wenn weggelassen.
  • default: Standardwert für die Zeichenfolge. Leer, wenn weggelassen.
  • mktoModuleScope: Boolesch. Steuert bei Verwendung in einem Modul, ob die Variable lokal (true) oder global (false) ist. Der Standardwert ist "False", wenn weggelassen.

Beispieldeklaration:

<pre data-theme="Confluence"><meta class="mktoString" id="textHeader" mktoName="Text Header" default="Edit Me"></pre>

Beispielverwendung:

<pre data-theme="Confluence">${textHeader}</pre>

Liste list

Wenn Sie eine Variable als Liste angeben, kann der Endbenutzer aus einem Satz von Werten wählen, die Sie im E-Mail-Editor definieren. Sie legen eine Listenvariable mithilfe von <meta> with class="mktoList"

Erforderliche Attribute

  • id: Referenzierung der Variablen in Ihrer E-Mail-Vorlage.
  • mktoName: Zeichenfolge. Dies ist der Anzeigename, der in Email Editor 2.0 angezeigt wird. Es empfiehlt sich, einen beschreibenden Namen zu verwenden.
  • -Werte: Kommagetrennte Liste von Werten. Muss mindestens eine Zeichenfolge enthalten.

Optionale Attribute

  • default: Standardwert des Dropdown-Menüs Auswahl . Wenn dieser Wert weggelassen wird, wird der erste Wert aus dem Attribut "Werte"verwendet.
  • mktoModuleScope: Boolesch. Steuert bei Verwendung in einem Modul, ob die Variable lokal (true) oder global (false) ist. Der Standardwert ist "False", wenn weggelassen.

Beispieldeklaration:

<pre data-theme="Confluence"><meta class="mktoList" id="textFontFamily" mktoName="Main Text Font Family" values="Arial,Verdana,Times New Roman"></pre>

Beispielverwendung:

<pre data-theme="Confluence">${textFontFamily}</pre>

Zahl number

Wenn Sie eine Variable als Zahl angeben, kann der Endbenutzer eine Zahl im E-Mail-Editor eingeben. Sie geben eine Zahlenvariable mithilfe von <meta> mit class="mktoNumber"

Erforderliche Attribute

  • id: Referenzierung der Variablen in Ihrer E-Mail-Vorlage.
  • mktoName: Zeichenfolge. Dies ist der Anzeigename, der in Email Editor 2.0 angezeigt wird. Es empfiehlt sich, einen beschreibenden Namen zu verwenden.
  • default: Standardwert für numerische Variablen.

Optionale Attribute

  • min: Mindestzulässiger Wert.
  • max: Max. zulässige Wert.
  • Einheiten: Einheiten, die an den Zahlenwert angehängt werden sollen (z. B. px, pt, em usw.) im E-Mail-Editor sowie im resultierenden Code angezeigt werden.
  • step: Wie viele Einheiten die Zahlenvariable um (0,1, 1, 10 usw.) erhöhen/verringern soll. Wenn nicht angegeben, wird standardmäßig 1 verwendet.
  • mktoModuleScope: Boolesch. Steuert bei Verwendung in einem Modul, ob die Variable lokal (true) oder global (false) ist. Der Standardwert ist "False", wenn weggelassen.

Beispieldeklaration:

<pre data-theme="Confluence"><meta class="mktoNumber" id="textFontSize" mktoName="Main Text Font Size" default="12" min="8" max="18" units="px" step="1"> </pre>

Beispielverwendung:

<pre data-theme="Confluence">${textFontSize}</pre>

Farbe color

Wenn Sie eine Variable als Farbe angeben, kann der Endbenutzer einen hexadezimalen Farbwert eingeben oder eine Farbe aus der Farbauswahl im E-Mail-Editor auswählen. Sie legen eine Farbvariable mit <meta> with class="mktoColor"

Erforderliche Attribute

  • id: Referenzierung der Variablen in Ihrer E-Mail-Vorlage.
  • mktoName: Zeichenfolge. Dies ist der Anzeigename, der in Email Editor 2.0 angezeigt wird. Es empfiehlt sich, einen beschreibenden Namen zu verwenden.

Optionale Attribute

  • default: Standardwert für die Farbe. 6-stelliger Hexadezimalfarbcode. Beispiel: #ffffff.
  • mktoModuleScope: Boolesch. Steuert bei Verwendung in einem Modul, ob die Variable lokal (true) oder global (false) ist. Der Standardwert ist "False", wenn weggelassen.

Beispieldeklaration:

<pre data-theme="Confluence"><meta class="mktoColor" id="textColor" mktoName="Main Text Color" default="#FFFFFF"></pre>

Beispielverwendung:

<pre data-theme="Confluence">${textColor}</pre>

Boolesch boolean

Wenn Sie eine Variable als Boolesch angeben, kann der Endbenutzer die Option im E-Mail-Editor aktivieren/deaktivieren. Sie geben eine boolesche Variable an mithilfe von <meta> mit class="mktoBoolean"

Erforderliche Attribute

  • id: Referenzierung der Variablen in Ihrer E-Mail-Vorlage.
  • mktoName: Zeichenfolge. Dies ist der Anzeigename, der in Email Editor 2.0 angezeigt wird. Es empfiehlt sich, einen beschreibenden Namen zu verwenden.

Optionale Attribute

  • default: Boolescher Wert, der den Standardstatus des Umschalters bestimmt. False , wenn weggelassen.
  • false_value: Wert, der eingefügt werden soll, wenn sich der Umschalter in der Stellung "AUS"befindet. False , wenn weggelassen.
  • true_value: Wert, der eingefügt wird, wenn sich der Umschalter an der Position "EIN"befindet. True , wenn weggelassen.
  • false_value_name: Die Benutzeroberfläche wird im Umschalter angezeigt, wenn sie sich in Aus-Position befindet. False , wenn weggelassen.
  • true_value_name: Benutzeroberfläche, die im Umschalter angezeigt wird, wenn sie sich an der Ein-Position befindet. True , wenn weggelassen.
  • mktoModuleScope: Boolesch. Steuert bei Verwendung in einem Modul, ob die Variable lokal (true) oder global (false) ist. Der Standardwert ist "False", wenn weggelassen.

Beispieldeklaration:

<pre data-theme="Confluence"><meta class="mktoBoolean" id="showFooter" mktoName="Show Footer BG?" default="false" false_value="transparent" true_value="black" false_value_name="NO" true_value_name="YES"></pre>

Beispielverwendung:

<pre data-theme="Confluence">${showFooter}</pre>

HTML-Block html-block

Wenn Sie eine Variable als HTML-Block angeben, kann der Endbenutzer im E-Mail-Editor eine wörtliche HTML eingeben. Sie legen eine HTML Block-Variable mithilfe von <meta> with class="mktoHTML"

Erforderliche Attribute

  • id: Referenzierung der Variablen in Ihrer E-Mail-Vorlage.
  • mktoName: Zeichenfolge. Dies ist der Anzeigename, der in Email Editor 2.0 angezeigt wird. Es empfiehlt sich, einen beschreibenden Namen zu verwenden.

Optionale Attribute

  • default: HTML-kodierter Wert, der als Standardinhalt des Blocks dient.
  • mktoModuleScope: Boolesch. Steuert bei Verwendung in einem Modul, ob die Variable lokal (true) oder global (false) ist. Der Standardwert ist "False", wenn weggelassen.

Beispieldeklaration:

<pre data-theme="Confluence"><meta class="mktoHTML" id="trackingPixel" mktoName="Add Tracking Pixel"></pre>

Beispielverwendung:

<pre data-theme="Confluence">${trackingPixel}</pre>

Bildvariable image-variable

Wenn Sie eine Variable als Bild angeben, kann der Endbenutzer ein Bild aus der Bildauswahl im E-Mail-Editor auswählen. Die ausgewählte Bild-URL ist der Wert der -Variablen. Sie geben eine Bildvariable mithilfe von <meta> mit class="mktoImg"

Erforderliche Attribute

  • id: Referenzierung der Variablen in Ihrer E-Mail-Vorlage.
  • mktoName: Zeichenfolge. Dies ist der Anzeigename, der in Email Editor 2.0 angezeigt wird. Es empfiehlt sich, einen beschreibenden Namen zu verwenden.

Optionale Attribute

  • default: Standard-Bild-URL für das Element.
  • mktoModuleScope: Boolesch. Steuert bei Verwendung in einem Modul, ob die Variable lokal (true) oder global (false) ist. Der Standardwert ist "False", wenn weggelassen.

Beispieldeklaration:

<pre data-theme="Confluence"><meta class="mktoImg" id="heroBackgroundImage" mktoName="Hero Background Image" default="https://www.company.com/image.jpg"></pre>

Beispielverwendung:

<pre data-theme="Confluence">${heroBackgroundImage}</pre>

Module modules

Module sind vorlagenbasierte Abschnitte, die auf Vorlagenebene definiert sind und Endbenutzern das Einfügen in ihre E-Mail ermöglichen. Da Sie diese Module vorkonfiguriert haben, können Sie sicherstellen, dass sie mit dem Rest Ihres E-Mail-Inhalts ordnungsgemäß interagieren (auf vollständig responsive Weise). Sie können nur ein Modul in einen Container einfügen.

IMPORTANT
Wenn eine E-Mail aus einer E-Mail-Vorlage generiert wird, die definierte Modulkomponenten enthält, werden alle Änderungen an den Modulen der Vorlage vorgenommen not an diese E-Mail gesendet werden.

Für Container des Typs <table>, <tbody>, <thead>oder <tfoot>:

Wird mit <tr> with class="mktoModule"

Für Container des Typs <td>:

Wird mit <table> with class="mktoModule"

Erforderliche Attribute

  • id: Referenzierung des Moduls in Ihrer E-Mail-Vorlage.
  • mktoName: Zeichenfolge. Dies ist der Anzeigename, der in Email Editor 2.0 angezeigt wird. Es empfiehlt sich, einen beschreibenden Namen zu verwenden.

Optionale Attribute

  • mktoActive: Bestimmt, ob dieses Modul in der Modulliste im E-Mail-Editor angezeigt wird. Der Standardwert ist "true". Bei "false"kann das Modul von einem Endbenutzer nicht zu einer E-Mail hinzugefügt werden.
  • mktoAddByDefault: Bestimmt, ob sich dieses Modul auf der Arbeitsfläche einer neuen E-Mail befindet, die diese Vorlage bei der Erstellung verwendet. Die Standardeinstellung ist "true"(wenn mktoActive "false"ist, wird dieser Wert ignoriert).
NOTE
Bei Klassenwerten mit Marketo-Syntax (d. h. mktoModule, mktoContainer, mktoText) wird zwischen Groß- und Kleinschreibung unterschieden. Benutzerdefinierte Attributnamen (d. h. mktoimgwidth, mktoname) sind nicht vorhanden.

Container containers

Ein Container enthält Module und definiert, wo sie platziert werden können. Wenn Endbenutzer Module neu anordnen und in ihre E-Mail einfügen, steuert der Container, wohin sie gehen können.

Wird entweder mit <table>, <tbody>, <thead>, <tfoot> oder <td> with class="mktoContainer"

Erforderliche Attribute

id: Referenzierung des Moduls in Ihrer E-Mail-Vorlage.

CAUTION
Container können nur Module enthalten. Wenn noch etwas Anderes vorhanden ist, wird der Container als ungültig angesehen! Pro Vorlage ist nur ein Container zulässig.
recommendation-more-help
94ec3174-1d6c-4f51-822d-5424bedeecac