Deine E-Mails zu Pardot hochladen

Emailify hat eine integrierte Anbindung an Pardot, mit der du HTML-E-Mails direkt aus dem Figma-Plugin in deine Pardot-Vorlagen hochlädst.

Pardot heißt in Salesforce Marketing Cloud inzwischen Account Engagement.

Video-Tutorial: Deine E-Mails zu Pardot hochladen

Dieses Video zeigt, wie du HTML-E-Mails aus dem Figma-Plugin Emailify zu Pardot 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.

1. Connected App in Pardot anlegen ​

Falls du noch keine eingerichtet hast, musst du in Pardot eine neue Connected App anlegen. Sie liefert dir den Consumer Key und das Consumer Secret, die du in Schritt 3 (Bei Pardot authentifizieren) in das Plugin einfügst.

  1. Klick oben rechts in deinem Pardot-Admin auf das Settings Icon und dann auf Setup.
  2. Such in der Suchleiste der Einstellungen nach „App Manager“ und klick auf das Ergebnis App Manager.
  3. Klick auf den Button New Connected App.
  4. Gib einen Namen für deine Connected App ein (zum Beispiel Emailify Integration).
  5. Gib die Kontaktdaten der Person ein, der die Connected App gehört.
  6. Aktiviere das Kontrollkästchen Enable OAuth Flows.
  7. Gib https://figma.com/ als Callback-URL ein.
  8. Füge unter Selected OAuth Scopes die folgenden Scopes hinzu, über die die App auf Pardot zugreifen und sich authentifizieren kann:
  • Access content resources (content)
  • Access the identity URL service (id, profile, email, address, phone)
  • Manage Pardot services (pardot_api)
  • Perform requests at any time (refresh _token, offline_access)
  1. Aktiviere das Kontrollkästchen Require Secret for Web Server Flow.
  2. Falls angezeigt, stell sicher, dass Require Proof Key for Code Exchange (PKCE) Extension for Supported Authorization Flows nicht aktiviert ist.
  3. Klick auf Save.

2. Business Unit ID von Pardot finden ​

Deine Business Unit ID ist eine 18-stellige ID, die mit „0Uv“ beginnt. So findest du deine Pardot Business Unit ID:

  1. Melde dich bei Salesforce mit demselben Konto an, mit dem du dich bei Pardot anmeldest.
  2. Klick auf den Tab Setup.
  3. Such das Dropdown Pardot und klick auf Pardot Account Setup.
  4. Möglicherweise hast du mehrere Pardot Business Units. Wähle die Business Unit ID derjenigen, die du mit Emailify verwenden möchtest.

3. Bei Pardot authentifizieren ​

Wähle im Export-Panel von Emailify die Option Pardot (API) oder eine Option für ein Pardot-Testkonto aus der Dropdown-Liste und kopiere dann die folgenden Pardot-Zugangsdaten und -Angaben in die Eingabefelder der Exporteinstellungen von Emailify:

Sobald du alle Angaben eingefügt hast, authentifiziert sich Emailify bei deiner Pardot-Instanz.

Verschiedene Optionen für Pardot-API-Endpunkte in Emailify ​

Wenn du eine Test- oder Sandbox-Instanz verwendest, kannst du in den Exportoptionen von Emailify verschiedene Pardot-API-Exportoptionen wählen. Unten siehst du, welche Endpunkte jede Option aufruft:

Emailify-OptionAutorisierungsdomainInhaltsdomain
Pardot APIlogin.salesforce.com/services/oauth2/token?grant_type=passwordpi.pardot.com
Pardot Test APItest.salesforce.com/services/oauth2/token?grant_type=passwordpi.demo.pardot.com
Pardot Dev APIlogin.salesforce.com/services/oauth2/token?grant_type=passwordpi.demo.pardot.com

Probleme bei der Authentifizierung mit Pardot beheben ​

Wenn die Authentifizierung mit deinem Pardot-Benutzernamen und -Passwort nicht klappt, liegt das meistens daran, dass die Multi-Faktor-Authentifizierung (MFA) von Salesforce für den Salesforce-Nutzer aktiviert ist, auf den sich deine Integration stützt.

Der häufigste Grund für eine fehlgeschlagene Authentifizierung bei Pardot sind 2FA-Probleme. Oft lässt sich das in Pardot so lösen:

  • Setz die Einstellung IP Relaxation auf Relax IP Restrictions
  • Setz die Einstellung Permitted Users auf All users may self-authorize
  • Aktiviere den Schalter Allow OAuth Username-Password Flows unter OAuth and OpenID Connect Settings
  • Passwörter dürfen keine Sonderzeichen enthalten (zum Beispiel # % & usw.), sondern nur Buchstaben und Zahlen (zum Beispiel mypa55word1234)

Sicherstellen, dass API-Integrationsnutzer mit Salesforce-MFA funktionieren ​

Salesforce erzwingt MFA vor allem bei interaktiven Anmeldungen über die Benutzeroberfläche. API-basierte Integrationen funktionieren meist weiterhin ohne interaktive MFA-Abfragen, dein Salesforce-Admin muss den Integrationsnutzer aber richtig konfigurieren.

Für den Pardot-API-Upload von Emailify empfiehlt es sich, ein eigenes Salesforce-Konto als Integrationsnutzer zu verwenden statt eines gemeinsam genutzten persönlichen Logins.

Wenn deine Salesforce-Edition Benutzerlizenzen vom Typ Salesforce Integration enthält, weise eine dieser Lizenzen dem eigenen Integrationsnutzer zu, den Emailify verwendet.

Vorteile:

  • Diese Nutzer sind für reinen API-Zugriff gedacht.
  • Sie können sich nicht in der Salesforce-Oberfläche anmelden und sind daher grundsätzlich von MFA-Abfragen in der Oberfläche ausgenommen.
  • Sie helfen dabei, deine Integration von normalen Benutzerkonten zu trennen.
  • In ihrem reinen API-Profil ist API Enabled in der Regel standardmäßig aktiviert.

So prüfst du, ob diese Lizenzen verfügbar sind:

  1. Öffne in Salesforce Setup.
  2. Such nach Company Information.
  3. Öffne Company Information.
  4. Such in der Liste User Licenses nach Salesforce Integration.
Alternative: MFA in der Oberfläche für einen Standard-Salesforce-Nutzer aussetzen ​

Wenn du keine Salesforce-Integration-Benutzerlizenz nutzen kannst und deine Integration einen Standard-Salesforce-Nutzer verwendet, kann dein Salesforce-Admin diesen eigenen Integrationsnutzer von MFA in der Oberfläche ausnehmen. Dazu weist er ihm ein Permission Set mit der Systemberechtigung Waive Multi-Factor Authentication for Exempt Users zu.

So richtest du das ein:

  1. Öffne in Salesforce Setup.
  2. Such nach Permission Sets.
  3. Leg ein neues Permission Set für deinen Integrationsnutzer an.
  4. Öffne System Permissions und klick auf Edit.
  5. Aktiviere Waive Multi-Factor Authentication for Exempt Users.
  6. Speichere das Permission Set.
  7. Weise dieses Permission Set dem eigenen Integrationsnutzer zu.

Wenn du für die Integration eine Standard-Salesforce-Benutzerlizenz verwendest, stell außerdem sicher, dass im Profil des Nutzers unter System Permissions weiterhin API Enabled aktiviert ist.

Weitere Empfehlungen ​
  • Verwende lieber einen eigenen Integrationsnutzer statt eines persönlichen Benutzerkontos.
  • Wenn du die Authentifizierung per Benutzername und Passwort nutzt, bewahre diese Zugangsdaten und ein eventuelles Sicherheitstoken sicher auf.
  • Teste deine Pardot-Verbindung in einer Sandbox, bevor du MFA-bezogene Änderungen in der Produktivumgebung aktivierst.
  • Wenn die Authentifizierung nach einer MFA-Einführung fehlschlägt, prüf in der Login History des Salesforce-Nutzers den genauen Grund.
Salesforce-Referenzen ​

4. E-Mail-Vorlagen zu Pardot hochladen ​

Sobald deine Pardot-API-Verbindung erfolgreich authentifiziert ist, kannst du über die eingeblendeten Eingabefelder und Dropdowns die folgenden Pflichtfelder ausfüllen:

  • Sender Name

  • Sender Address

  • Campaign Name

  • Folder Name

  • Domain Tracking Name

Optional kannst du der exportierten Vorlage Pardot-Tags für Inhaltsbereiche hinzufügen:

  • Editable Regions erlaubt Nutzern, Texte, Bilder und Buttons zu bearbeiten.
  • Repeatable Regions erlaubt Nutzern, nicht gesperrte Inhaltsblöcke der obersten Ebene zu kopieren oder zu verschieben. Diese Blöcke teilen sich einen gemeinsamen Namen für den wiederholbaren Bereich (body_content), sodass verschiedene Blöcke aneinander vorbei verschoben werden können.
  • Removable Regions erlaubt Nutzern, nicht gesperrte Inhaltsblöcke der obersten Ebene zu entfernen.

Aktiviere vor dem Hochladen oder Exportieren der Vorlage eine beliebige Kombination dieser Optionen. Wenn Repeatable Regions und Removable Regions beide aktiviert sind, setzt Emailify beide Attribute für jeden nicht gesperrten Block auf denselben Wrapper. Die wiederholbaren Wrapper teilen sich den Namen body_content und liegen nebeneinander, sodass verschiedene Blöcke innerhalb der Gruppe verschoben werden können. Es gibt keinen separaten entfernbaren Wrapper um jeden wiederholbaren Block.

Header und Footer fixieren ​

Sperre in Figma vor dem Export den Header, den Footer oder eine andere übergeordnete Ebene direkt in deinem Emailify-E-Mail-Frame. Emailify exportiert gesperrte Ebenen der obersten Ebene ohne Tags für wiederholbare oder entfernbare Bereiche, einschließlich aller Blöcke, die aus einer gesperrten übergeordneten Gruppe erzeugt werden. Lass die Ebenen im Body entsperrt, damit Nutzer sie bei aktivierten Repeatable Regions neu anordnen können.

Sperre die Ebene der obersten Ebene selbst; wenn du nur eine verschachtelte Text- oder Bildebene sperrst, wird ihr übergeordneter Block nicht gesperrt. Das steuert das Kopieren, Verschieben und Entfernen ganzer Blöcke. Editable Regions steuert weiterhin das Bearbeiten von Texten, Bildern und Buttons darin. Entsperre die übergeordnete Ebene und exportiere erneut, damit der Block wieder wiederholbar oder entfernbar wird.

Wenn du die gewünschten Optionen oben gewählt hast und so weit bist, klick auf den Button Upload To Pardot, um die in Figma ausgewählten E-Mails als HTML zu exportieren und automatisch in deine E-Mail-Vorlagen in Pardot hochzuladen.