Anpassbare Fragmente customizable-fragments
Wenn Fragmente in einer E-Mail oder E-Mail-Vorlage verwendet werden, sind sie aufgrund der Vererbung standardmäßig gesperrt, d. h. alle Änderungen, die an einem Fragment vorgenommen werden, werden automatisch an alle Assets weitergegeben, in denen es verwendet wird. Mit anpassbaren Fragmenten können bestimmte Felder innerhalb eines Fragments als bearbeitbar definiert werden, wenn das Fragment zu einer E-Mail oder E-Mail-Vorlage hinzugefügt wird. Wenn Sie beispielsweise über ein Fragment mit einem Banner, etwas Text und einer Schaltfläche verfügen, können Sie bestimmte Felder, z. B. die Bild- oder Schaltflächen-Ziel-URL, als bearbeitbar festlegen.
Mit anpassbaren Fragmenten können Sie Inhalte verwalten und personalisieren, ohne völlig neue Inhaltsbausteine zu erstellen oder die Fragmentvererbung zu unterbrechen. Änderungen, die auf Fragmentebene vorgenommen werden, werden weiterhin weitergegeben und ermöglichen die Anpassung auf E-Mail- oder E-Mail-Vorlagenebene.
Sowohl visuelle Fragmente als auch Ausdrucksfragmente können als anpassbar markiert werden.
Hinzufügen bearbeitbarer Felder in visuellen Fragmenten visual
Gehen Sie wie folgt vor, um Teile eines visuellen Fragments als bearbeitbar festzulegen:
-
Öffnen Sie den Bildschirm zur Inhaltsbearbeitung von Fragmenten.
-
Wählen Sie die Komponente in Ihrem Fragment aus, für die Sie bearbeitbare Felder konfigurieren möchten.
-
Der Bereich der Komponenteneigenschaften wird auf der rechten Seite geöffnet. Wählen Sie die Registerkarte Bearbeitbare Felder aus und aktivieren Sie die Option Bearbeitung aktivieren.
-
Alle Felder, die für die ausgewählte Komponente bearbeitet werden können, werden im Bereich aufgelistet. Welche Felder zur Bearbeitung verfügbar sind, hängt vom ausgewählten Komponententyp ab.
Im folgenden Beispiel ist die URL der Schaltfläche „Hier klicken“ als bearbeitbar konfiguriert.
{width="800" modal="regular"}
-
Klicken Sie Übersicht, um alle bearbeitbaren Felder und ihre Standardwerte zu überprüfen.
In diesem Beispiel wird das Feld für die Schaltflächen-URL mit dem in der Komponente definierten Standardwert angezeigt. Benutzende können diesen Wert anpassen, nachdem sie das Fragment zu ihrem Inhalt hinzugefügt haben.
{width="800" modal="regular"}
-
Speichern Sie abschließend Ihre Änderungen.
Nachdem Sie das Fragment zu einer E-Mail hinzugefügt haben, können Benutzer alle bearbeitbaren Felder anpassen, die im Fragment konfiguriert sind.
Bearbeitbare HTML-Komponenten in Fragmenten editable-html
Innerhalb einer HTML-Komponente können die folgenden Elementtypen bearbeitbar gemacht werden:
- Ein Teil des Textinhalts (z. B. eine Überschrift oder eine CTA-Kennzeichnung).
- Eine vollständige URL, die als Link-Ziel oder Bildquelle verwendet wird. Partielle URLs werden nicht unterstützt. Die Variable muss den gesamten URL-Wert darstellen.
- Ein vollständiger CSS-Eigenschaftswert (z. B. ein voller Farbwert, ein voller Abstand oder ein voller Breitenwert). Partielle CSS-Eigenschaftswerte werden nicht unterstützt.
Jeder parametrisierte CSS-Eigenschaftswert muss genau {{{varName}}} sein: keine Suffixe, kein zusätzlicher Text, keine mehreren Variablen und keine Verkettung innerhalb einer einzelnen Eigenschaft.
Um mehrseitige Eigenschaften wie den Abstand zu parametrisieren, gehen Sie wie folgt vor:
- jede Seite als separate Eigenschaft deklarieren (empfohlen) oder
- Deklarieren Sie eine einzelne Variable, die den vollständigen Kurzschreibwert enthält.
Funktionsweise von bearbeitbaren Feldern in HTML-Komponenten components
Bearbeitbare Felder in einer HTML-Komponente werden erstellt, indem Inline-Variablen direkt im Quellcode der Komponente deklariert werden. Jede Variable hat eine eindeutige ID und einen Standardwert. Die Variable wird dann dort referenziert, wo der bearbeitbare Wert im Markup angezeigt werden soll.
Nach dem Speichern und Veröffentlichen des Fragments wird jede in der HTML-Komponente deklarierte Variable automatisch als bearbeitbarer Parameter angezeigt, wenn das Fragment zu einer E-Mail hinzugefügt wird.
Der E-Mail-Autor kann dann den Standardwert einer beliebigen Variablen aus der E-Mail-Designer überschreiben (z. B. eine Hintergrundfarbe ändern, eine CTA-URL austauschen oder eine Überschrift aktualisieren), ohne die zugrunde liegende HTML zu ändern.
Syntaxverweis syntax
Bearbeitbare Felder werden anhand von zwei Mustern definiert und referenziert:
Deklarieren einer Variablen declaring
Verwenden Sie die Inline-Deklaration, um eine Variable mit einer eindeutigen ID und einem Standardwert zu definieren:
Ersetzen Sie variableID durch eine eindeutige Kennung für das bearbeitbare Feld. Die ID muss innerhalb der Komponente eindeutig sein und darf keine Leerzeichen enthalten.
Ersetzen Sie default_value durch den Wert, der verwendet werden soll, wenn der E-Mail-Autor ihn nicht überschreibt.
Verweisen auf eine Variable referencing
Verwenden Sie dreifache geschweifte Klammern, um auf die Variable an der Stelle zu verweisen, an der ihr Wert im Markup angezeigt werden soll:
Dieselbe Variablenkennung kann innerhalb der HTML beliebig oft referenziert werden. Alle Verweise werden auf den Wert aufgelöst, den der E-Mail-Autor festlegt (oder auf den Standardwert, wenn keine Überschreibung bereitgestellt wird).
Optionale Parameter optional
Die Inline-Deklaration unterstützt optionale Parameter, die die Darstellung oder Verarbeitung des bearbeitbaren Felds ändern:
{{#inline "editableFieldID"}}default_value{{/inline}}name="title"{{#inline "editableFieldID" name="title"}}default_value{{/inline}}assetType="image"{{#inline "editableFieldID" assetType="image"}}default_value{{/inline}}assetType="url"{{#inline "editableFieldID" assetType="url"}}default_value{{/inline}}Hinzufügen bearbeitbarer Felder zu einer HTML-Komponente adding-editable-fields
Gehen Sie wie folgt vor, um Teile einer HTML-Komponente in einem visuellen Fragment bearbeitbar zu machen:
- Öffnen Sie das visuelle Fragment zur Bearbeitung in der E-Mail-Designer.
- Fügen Sie eine HTML- zum Fragment im Bedienfeld „Komponenten“ hinzu oder wählen Sie eine bestehende HTML-Komponente aus.
- Klicken Sie bei ausgewählter HTML-Komponente Quellcode anzeigen, um die HTML-Quellansicht im Personalisierungseditor zu öffnen.
- Deklarieren Sie im Personalisierungseditor jede bearbeitbare Variable mithilfe der Inline-Deklarationssyntax. Platzieren Sie alle Variablendeklarationen zur besseren Lesbarkeit am Anfang der Komponente und weisen Sie jeder Variablen eine eindeutige ID zu.
- Referenzieren Sie jede Variable im HTML-Markup mithilfe der
{{{variableID}}}, wo immer der bearbeitbare Wert angezeigt werden soll. Dieselbe Variable kann mehrmals in derselben Komponente referenziert werden. - Speichern Sie die HTML-Komponente und speichern Sie dann das Fragment.
- Veröffentlichen Sie das Fragment, um es für die Verwendung in E-Mails verfügbar zu machen.
Fragment in einer E-Mail verwenden using-fragment
Nachdem das Fragment veröffentlicht wurde, werden alle in den HTML-Komponenten deklarierten Variablen als bearbeitbare Parameter in der E-Mail-Designer angezeigt.
So passen Sie sie bei Verwendung des Fragments in einer E-Mail an:
- Öffnen oder erstellen Sie eine E-Mail in der Marketo Engage Email Designer.
- Fügen Sie das veröffentlichte Fragment zur E-Mail-Arbeitsfläche hinzu.
- Wählen Sie das Fragment aus, um seinen Eigenschaftenbereich zu öffnen. Die Liste der bearbeitbaren Felder wird im Abschnitt Bearbeitbare Felder angezeigt, wobei jedes Feld durch seine Variable ID (oder durch die im Parameter
nameangegebene benutzerfreundliche Beschriftung) gekennzeichnet ist. - Aktualisieren Sie den Wert eines beliebigen bearbeitbaren Felds direkt im Bereich Eigenschaften . Die Änderung gilt nur für die aktuelle E-Mail. Das veröffentlichte Fragment und andere E-Mails, die darauf verweisen, sind davon nicht betroffen.
- Speichern Sie die E-Mail.
Das Fragment wird mit den angepassten Werten gerendert, während weiterhin alle zukünftigen strukturellen Aktualisierungen am veröffentlichten Fragment übernommen werden.
Beispiel: einfaches Fragment mit bearbeitbarem Text, Farbe und URL example
Im folgenden Beispiel wird ein kleines Werbebanner mit vier bearbeitbaren Feldern erstellt:
- Eine Hintergrundfarbe
- Ein Überschrifttext
- Ein CTA-Label
- eine CTA-URL
Nach der Veröffentlichung des Fragments kann ein E-Mail-Autor diese Werte überschreiben, wenn er das Fragment zu einer E-Mail hinzufügt.
Einfaches bearbeitbares Banner
<!-- Define editable variables -->
{{#inline "bgColor"}}#0057FF{{/inline}}
{{#inline "headlineText"}}Example Headline{{/inline}}
{{#inline "ctaText"}}Learn More{{/inline}}
{{#inline "ctaUrl" assetType="url"}}https://www.example.com{{/inline}}
<!-- Use the variables in the HTML -->
<table width="100%" cellpadding="0" cellspacing="0"
style="background-color:{{{bgColor}}}; border-radius:8px;" >
<tr>
<td style="padding:30px; text-align:center; font-family:Arial,sans-serif;">
<h2 style="color:#ffffff; font-size:24px; margin:0;">
{{{headlineText}}}
</h2>
<a href="{{{ctaUrl}}}"
style="display:inline-block; margin-top:16px; padding:12px 28px;
background:#ffffff; color:{{{bgColor}}};
font-weight:bold; border-radius:4px; text-decoration:none;">
{{{ctaText}}}
</a>
</td>
</tr>
</table>
In diesem Beispiel:
bgColorwird zweimal referenziert: einmal für die Hintergrundfarbe der Tabelle und einmal für die Textfarbe von CTA. Beide Verweise werden auf denselben Wert aufgelöst, sodass eine einzelne Bearbeitung an beide Speicherorte übertragen wird.ctaUrlwird mitassetType="url"deklariert, was signalisiert, dass der Wert als getrackte URL verarbeitet werden soll.
Best Practices best-practices
- Schließen Sie Einheiten (
px,em,%) in den Standardwert der Variablen ein, sodass die Variable einen vollständigen CSS-Wert darstellt. Dadurch wird eine Verkettung vermieden, die nicht unterstützt wird. - CSS-Eigenschaften pro Seite (
padding-top,padding-right,padding-bottom,padding-left) werden den Kurzbezeichnungen vorgezogen, wenn jede Seite unabhängig bearbeitet werden muss. - Wenn eine URL getrackt werden muss, deklarieren Sie sie mit
assetType="url". - Wenn ein bearbeitbares Feld eine Bildquelle enthält, deklarieren Sie es mit
assetType="image". - Testen Sie das Fragment, indem Sie es zu einem E-Mail-Entwurf hinzufügen und überprüfen, ob alle bearbeitbaren Felder im Eigenschaftenbereich angezeigt werden und beim Überschreiben korrekt aufgelöst werden.
Was Sie wissen sollten things-to-know
- Bearbeitbare Felder in HTML-Komponenten unterstützen Volltextinhalte, vollständige URLs und vollständige CSS-Eigenschaftswerte. Partielle URLs und partielle CSS-Eigenschaftswerte können nicht parametrisiert werden.
- Ein einzelner CSS-Eigenschaftswert kann eine Variable nicht mit zusätzlichem statischem Text oder mit einer anderen Variablen kombinieren. Jeder parametrisierte Eigenschaftswert muss genau ein Variablenverweis sein.
- Variablen-IDs müssen innerhalb einer HTML-Komponente eindeutig sein und dürfen keine Leerzeichen enthalten.
- Vorkonfigurierte Systemlinks wie der Abmelde-Link und die Mirrorseiten-URL können nicht in bearbeitbare Felder umgewandelt werden.