Video-Tutorial: Deine E-Mails zu Salesforce Marketing Cloud hochladen
Dieses Video zeigt, wie du HTML-E-Mails aus dem Figma-Plugin Emailify zu Salesforce Marketing Cloud hochlädst.
Wenn du in deinen Textabsätzen AMPscript-Links brauchst (zum Beispiel %%=v(@url)=%%), blockiert das native Linkfeld von Figma sie als ungültige URLs. Um das zu umgehen, kannst du stattdessen das spezielle AMPscript-Linkformat von Emailify verwenden, https://ampscript.invalid/?%%=v(@url)=%%. Emailify gibt dann im exportierten HTML das unveränderte AMPscript-Tag aus.
Wähle im Export-Panel von Emailify die Option Marketing Cloud (API) aus der Dropdown-Liste und folge dann diesen Schritten, um deine Zugangsdaten zu erhalten:
- Melde dich bei deinem Salesforce-Marketing-Cloud-Konto an.
- Geh zu Marketing Cloud -> Setup -> Platform Tools ("Apps") -> Installed Packages.
- Klick auf New.
- Gib dem Paket einen Namen und eine Beschreibung.
- Wähle, dass das Paket mit erweiterter Funktionalität angelegt wird.
- Speichere das Paket mit Save.
- Klick unter „Components“ auf Add Component.
- Wähle API Integration (eine API-Integrationskomponente lässt sich nach dem Hinzufügen nicht mehr entfernen).
- Wähle den Typ Server-to-server integration.
- Leg die Eigenschaften der Komponente fest. Du musst die Berechtigungen Read und Write für Emails (unter Channels) sowie für Documents and Images und Saved Content (unter Assets) erlauben.
- Klick auf Save, um die Komponente zu speichern.
Danach kannst du die folgenden Pflichtangaben aus deiner eben angelegten Integration in die Exporteinstellungen von Emailify kopieren:
- Client ID (zum Beispiel 3e8poc4erkli6ghjavq8kuio)
- Client Secret (zum Beispiel EOjPb4HPWwtyUkcb5CnCpo5C)
- REST Base URL (zum Beispiel https://mcvb5-qrzy845tggex49976pmz38.rest.marketingcloudapis.com/)
Wenn du so weit bist, wähle im Dropdown Upload As entweder Template oder HTML Email und klick dann auf den Button Upload To Marketing Cloud, um die ausgewählten Figma-E-Mails zu Marketing Cloud zu exportieren. Die Standardoption Template behält das bisherige vorlagenbasierte Verhalten bei. Wähle HTML Email, wenn sich das hochgeladene Asset in Content Builder als bearbeitbare HTML-E-Mail öffnen soll.
Wenn Emailify die hochgeladene Salesforce-E-Mail oder -Vorlage in einem bestimmten Content-Builder-Ordner statt im Standard-Stammverzeichnis ablegen soll, verbinde vor dem Upload dein Salesforce-Konto und wähle im Export-Panel von Emailify einen Template Folder. Wenn du die Einstellung auf Content Builder (Default) lässt, bleibt das bisherige Verhalten erhalten.
Bilder in Salesforce Content Builder hochladen
Wenn Salesforce Marketing Cloud auch die Bilder deiner E-Mail hosten soll, kannst du jetzt im Dropdown CDN von Emailify die Option Salesforce Content Builder verwenden.
- Wähle im Export-Panel von Emailify entweder Marketing Cloud (API) oder Marketing Cloud (oAuth) und verbinde zuerst dein Salesforce-Marketing-Cloud-Konto.
- Öffne das Dropdown CDN und wähle Salesforce Content Builder.
- Wähle den Content Builder-Ordner, in den Emailify die Bilder hochladen soll.
- Exportiere deine E-Mail wie gewohnt.
Emailify lädt die Bilder der E-Mail automatisch in den gewählten Ordner in Salesforce Content Builder hoch und ersetzt dann im exportierten HTML die Bild-URLs durch die veröffentlichten Salesforce-Asset-URLs, bevor die E-Mail oder Vorlage hochgeladen wird.
Der Template Folder und der Content Builder-Ordner für Bilder können unterschiedlich sein. Das ist praktisch, wenn dein Team HTML-E-Mails, Vorlagen und Bild-Assets in getrennten Ordnern verwaltet.
Wenn du dieselbe E-Mail erneut in denselben Content-Builder-Ordner exportierst, verwendet Emailify nach Möglichkeit passende vorhandene Bild-Assets wieder, statt abzubrechen, wenn Salesforce meldet, dass der Bildname bereits vergeben ist.
Weitere Optionen für Salesforce Marketing Cloud
Für deine Exporte zu Salesforce Marketing Cloud kannst du optional noch einige weitere Optionen aktivieren:
Content Slot hinzufügen
Wenn du den Schalter Slot aktivierst, fügt Emailify automatisch ein Tag <div data-type="slot" data-key="uniqueKeyHere" data-label="Drop Blocks or Content Here"></div> in dein exportiertes HTML ein. So kannst du im Editor von Marketing Cloud weitere Inhalte per Drag-and-drop in deine E-Mail ziehen. Diese Option ist beim Upload als Template verfügbar; bei Uploads als HTML Email wird der Slot-Container weggelassen.
Alias-Tags hinzufügen
Wenn du den Schalter Aliases aktivierst, fügt Emailify automatisch ein Attribut alias="Your Figma layer name" zu allen Links von Buttons, Bildern, Social-Icons und Navigationsleisten in deinem Figma-Design hinzu. Der Wert wird automatisch mit dem jeweiligen Namen der Figma-Ebene aus deinem Ebenen-Panel befüllt.
So kannst du den <a>-Links in deinem exportierten HTML Aliasse geben, die zum Design passen (zum Beispiel „Hero CTA Button“), und damit die Auswertung der Tracking-Daten erleichtern.
Conversion-Tags hinzufügen
Wenn du den Schalter Conversions aktivierst, fügt Emailify automatisch ein Attribut conversion="true" zu allen <a>-Link-Tags in deinem exportierten HTML hinzu.
RedirectTo-AMPscript hinzufügen
Aktiviere RedirectTo, damit absolute Linkziele mit http:// und https:// beim Export zu Salesforce Marketing Cloud automatisch in AMPscript eingebettet werden. Dein Team kann in Emailify normale Web-URLs eingeben, ohne in jeder Komponente AMPscript zu schreiben:
<a href="%%=RedirectTo('https://example.com/page')=%%">Read more</a>Diese Option ist standardmäßig ausgeschaltet und für ZIP- und API-Exporte zu Marketing Cloud verfügbar, einschließlich Vorlagen und HTML-E-Mails. Sie gilt auch für einzelne HTML-Blockdateien und Outlook-Button-Links. Vorhandene Aliasse und Conversion-Attribute bleiben erhalten.
Vorhandene AMPscript-Links und URLs mit dynamischem Vorlagencode bleiben unverändert, ebenso Salesforce-Tokens für Abmeldung und Profil, E-Mail-Adressen, Telefonlinks, relative URLs und Seitenanker. Anderes AMPscript in deiner E-Mail ist nicht betroffen. Vorschaulinks und die Nur-Text-Version behalten ihre normalen URLs.
Schick nach dem Import oder Upload deiner E-Mail eine Testmail aus Salesforce Marketing Cloud und prüfe, ob die Links die erwarteten Ziele erreichen, einschließlich aller Query-Parameter.
Impression-Tags hinzufügen
Wenn du den Schalter Impressions aktivierst, umschließt Emailify im exportierten HTML automatisch alle Row-, Wrapper- und Hero-Ebenen mit einem öffnenden %%=BeginImpressionRegion("your_figma_layer_name")=%% und einem schließenden %%=EndImpressionRegion()=%% als Impression-Tags von Salesforce Marketing Cloud.
HTML-Blockdateien
Aktiviere Blocks, um zusätzliche .html-Dateien in die ZIP-Datei aufzunehmen. Emailify exportiert jede Zeile als separate HTML-Datei, damit du sie als wiederverwendbares Modul in Salesforce Marketing Cloud nutzen kannst.
Beachte, dass der HTML-Code jedes Blocks weiterhin die CSS-/style-Tags und andere Elemente aus dem <head></head>-Tag braucht. Wenn du diesen Weg gehst, musst du also etwas Zeit einplanen, um diese herauszulösen.
Hinweis: Dieser Schalter ist nur verfügbar, wenn in den Exporteinstellungen von Emailify die Plattformoption Marketing Cloud (Zip) ausgewählt ist, und wird bei ausgewählter API-Option nicht angezeigt.