Tutoriel vidéo : importer vos emails dans Salesforce Marketing Cloud
Cette vidéo explique comment importer des emails HTML dans Salesforce Marketing Cloud depuis le plugin Figma Emailify.
Si vous avez besoin de liens AMPscript (par exemple %%=v(@url)=%%) dans vos paragraphes de texte, le champ de lien natif de Figma les bloque comme URL non valides. Pour contourner ce problème, utilisez plutôt le format de lien AMPscript spécial d’Emailify, https://ampscript.invalid/?%%=v(@url)=%% : Emailify écrira la balise AMPscript brute dans le HTML exporté.
Dans le panneau d’export d’Emailify, sélectionnez l’option Marketing Cloud (API) dans la liste déroulante, puis suivez les étapes ci-dessous pour obtenir vos identifiants d’authentification :
- Connectez-vous à votre compte Salesforce Marketing Cloud.
- Accédez à Marketing Cloud -> Setup -> Platform Tools ("Apps") -> Installed Packages.
- Cliquez sur New.
- Donnez un nom et une description au package.
- Choisissez de créer le package avec les fonctionnalités avancées (enhanced functionality).
- Enregistrez le package avec Save.
- Sous Components, cliquez sur Add Component.
- Sélectionnez API Integration (une fois ajouté, un composant d’intégration API ne peut plus être supprimé).
- Sélectionnez le type Server-to-server integration.
- Définissez les propriétés du composant : vous devez accorder les autorisations Read et Write pour Emails (sous Channels), ainsi que pour Documents and Images et Saved Content (sous Assets).
- Cliquez sur Save pour enregistrer le composant.
Une fois l’intégration créée, copiez-collez les informations obligatoires suivantes dans les réglages d’export d’Emailify :
- Client ID (par exemple, 3e8poc4erkli6ghjavq8kuio)
- Client Secret (par exemple, EOjPb4HPWwtyUkcb5CnCpo5C)
- REST Base URL (par exemple, https://mcvb5-qrzy845tggex49976pmz38.rest.marketingcloudapis.com/)
Lorsque tout est prêt, choisissez Template ou HTML Email dans la liste déroulante Upload As, puis cliquez sur le bouton Upload To Marketing Cloud pour exporter les emails Figma sélectionnés vers Marketing Cloud. L’option par défaut, Template, conserve le comportement précédent, basé sur des modèles. Choisissez HTML Email si vous voulez que l’asset importé s’ouvre comme un email HTML modifiable dans Content Builder.
Si vous préférez qu’Emailify place l’email ou le modèle Salesforce importé dans un dossier Content Builder précis plutôt qu’à la racine par défaut, connectez votre compte Salesforce et choisissez un Template Folder dans le panneau d’export d’Emailify avant l’import. Si vous laissez Content Builder (Default), le comportement précédent est conservé.
Importer les images dans Salesforce Content Builder
Si vous voulez aussi que Salesforce Marketing Cloud héberge les images de votre email, vous pouvez désormais utiliser l’option Salesforce Content Builder de la liste déroulante CDN d’Emailify.
- Dans le panneau d’export d’Emailify, sélectionnez Marketing Cloud (API) ou Marketing Cloud (oAuth) et commencez par connecter votre compte Salesforce Marketing Cloud.
- Ouvrez la liste déroulante CDN et choisissez Salesforce Content Builder.
- Choisissez le dossier Content Builder dans lequel Emailify doit importer les images.
- Exportez votre email comme d’habitude.
Emailify importe automatiquement les images de l’email dans le dossier Salesforce Content Builder sélectionné, puis remplace les URL des images du HTML exporté par les URL des assets Salesforce publiés avant d’importer l’email ou le modèle.
Le Template Folder et le dossier Content Builder des images peuvent être différents, ce qui est utile si votre équipe range les emails HTML, les modèles et les images dans des dossiers distincts.
Si vous exportez de nouveau le même email dans le même dossier Content Builder, Emailify réutilise autant que possible les images existantes correspondantes au lieu d’échouer lorsque Salesforce signale que le nom de l’image est déjà pris.
Options supplémentaires pour Salesforce Marketing Cloud
Vous pouvez activer quelques autres options facultatives pour vos exports Salesforce Marketing Cloud :
Ajouter un emplacement de contenu (Content Slot)
L’option Slot ajoute automatiquement une balise <div data-type="slot" data-key="uniqueKeyHere" data-label="Drop Blocks or Content Here"></div> dans le HTML exporté, ce qui vous permet de glisser-déposer d’autres contenus dans votre email depuis l’éditeur Marketing Cloud. Cette option est disponible pour les imports en tant que Template ; les imports HTML Email omettent le conteneur de slot.
Ajouter des tags d’alias
L’option Aliases ajoute automatiquement un attribut alias="Your Figma layer name" aux liens de vos boutons, images, icônes de réseaux sociaux ou barres de navigation dans votre design Figma. Cet attribut reprend automatiquement le nom de chaque calque Figma tel qu’il apparaît dans le panneau des calques.
Vous pouvez ainsi attribuer aux liens <a> du HTML exporté des alias qui facilitent le suivi des données, en leur donnant un nom parlant lié au design (par exemple, « Bouton CTA du hero »).
Ajouter des tags de conversion
L’option Conversions ajoute automatiquement un attribut conversion="true" à toutes les balises de lien <a> du HTML exporté.
Ajouter l’AMPscript RedirectTo
Activez RedirectTo pour encapsuler automatiquement dans de l’AMPscript les destinations de liens absolues en http:// et https:// lors de l’export vers Salesforce Marketing Cloud. Votre équipe peut saisir des URL web classiques dans Emailify sans écrire d’AMPscript dans chaque composant :
<a href="%%=RedirectTo('https://example.com/page')=%%">Read more</a>Cette option est désactivée par défaut. Elle est disponible pour les exports ZIP et API vers Marketing Cloud, modèles et emails HTML compris. Elle s’applique aussi aux fichiers HTML de blocs individuels et aux liens des boutons Outlook. Les alias et les attributs de conversion existants sont conservés.
Les liens AMPscript existants et les URL contenant du code de modèle dynamique restent inchangés, de même que les tokens de désinscription et de profil Salesforce, les adresses email, les liens téléphoniques, les URL relatives et les ancres de page. Le reste de l’AMPscript de votre email n’est pas affecté. Les liens d’aperçu et la version en texte brut conservent leurs URL ordinaires.
Après avoir importé ou importé votre email, envoyez un test depuis Salesforce Marketing Cloud et vérifiez que les liens mènent aux destinations attendues, paramètres de requête compris.
Ajouter des tags d’impression
L’option Impressions encadre automatiquement tous les calques Row, Wrapper ou Hero du HTML exporté avec les tags d’impression Salesforce Marketing Cloud %%=BeginImpressionRegion("your_figma_layer_name")=%% (ouverture) et %%=EndImpressionRegion()=%% (fermeture).
Fichiers HTML de blocs
Activez Blocks pour inclure des fichiers .html supplémentaires dans le ZIP. Emailify exporte chaque rangée dans un fichier HTML distinct, que vous pouvez utiliser comme module réutilisable dans Salesforce Marketing Cloud.
Gardez aussi à l’esprit que le code HTML de chaque bloc a toujours besoin des balises CSS/style et des autres éléments de la balise <head></head> : si vous choisissez cette approche, prévoyez un peu de temps pour les extraire.
Remarque : cette option n’est disponible que si l’option de plateforme Marketing Cloud (Zip) est sélectionnée dans le panneau de réglages d’export d’Emailify. Elle n’apparaît pas si l’option API est sélectionnée.