✉️ Utiliser les variables d'Objets personnalisés dans vos e-mails

Dans Webmecanik Automation, vous pouvez insérer dynamiquement les données de vos Éléments personnalisés directement dans vos modèles d'e-mails à l'aide de variables (par exemple pour afficher le nom d'un produit acheté, une référence de commande ou une date d'échéance).

Un contact pouvant posséder plusieurs éléments personnalisés rattachés à son profil (par exemple 3 commandes ou 2 contrats différents), les variables d'objets personnalisés disposent de paramètres avancés pour cibler précisément l'information à afficher.

💡 Rappel indispensable : Pour qu'une variable affiche une valeur dans l'e-mail reçu par votre destinataire, l'élément personnalisé concerné doit impérativement être associé à ce contact.

🧩 Structure et anatomie d'une variable

Une variable d'objet personnalisé se compose d'un mot-clé principal, de l'alias de l'objet et du champ ciblé, complété par des options de tri, de formatage et de repli.

Exemple de variable complète

{custom-object=product:sku | where=segment-filter | order=latest | limit=1 | default=Aucune référence}

Définition des paramètres disponibles

• custom-object : Mot-clé statique obligatoire qui indique au moteur d'envoi qu'il s'agit d'une variable liée à un objet personnalisé.

• product:sku : Correspond à l'alias de l'objet suivi de deux points : et de l'alias du champ souhaité (dans cet exemple : l'objet product et son champ sku).

• where=segment-filter : Condition qui indique au système quel élément récupérer parmi tous ceux liés au contact. segment-filter est l'unique filtre disponible et s'applique par défaut : il reprend les critères de filtrage de votre segment source d'envoi.

• order=latest : Règle de tri appliquée si plusieurs éléments répondent aux critères. L'option latest (par défaut) classe les éléments du plus récent au plus ancien selon leur date d'ajout.

• limit=X : Nombre maximal d'éléments à récupérer (défini sur 1 par défaut). Si vous augmentez ce chiffre, plusieurs éléments pourront être affichés simultanément.

• format=... : Définit la disposition visuelle lorsqu'il y a plusieurs valeurs à afficher (liste à puces, texte séparé par des virgules, etc.).

• default=... : Texte de secours affiché si aucun élément personnalisé correspondant n'est trouvé pour ce contact (ex. default=Non renseigné).

🎨 Gérer l'affichage de valeurs multiples (format)

Si votre paramètre limit est supérieur à 1, vous pouvez formater l'énumération des valeurs pour construire des phrases naturelles (ex. "Vos animaux Rex, Médor et Félix ont rendez-vous demain").

Voici les différents modes d'affichage disponibles via l'attribut format= :

• default : Sépare simplement les éléments par des virgules (Valeur 1, Valeur 2, Valeur 3).

• and-list : Sépare les éléments par des virgules et ajoute la conjonction "et" avant le dernier élément (Valeur 1, Valeur 2 et Valeur 3).

• or-list : Sépare les éléments par des virgules et ajoute "ou" avant le dernier élément (Valeur 1, Valeur 2 ou Valeur 3).

• bullet-list : Présente les éléments sous la forme d'une liste à puces verticale.

• ordered-list : Présente les éléments sous la forme d'une liste numérotée (1., 2., 3.).

⚠️ Règles d'or sur les conditions de sélection (where=segment-filter)

La condition segment-filter analyse automatiquement les filtres d'objets personnalisés définis dans le segment à l'origine de votre envoi (e-mail de segment ou déclencheur de campagne).

Pour garantir que vos variables s'affichent correctement, respectez ces consignes de configuration :

1. Segments sources multiples : Si votre campagne ou votre e-mail cible plusieurs segments en même temps, assurez-vous que chacun possède des filtres strictement identiques pour les objets personnalisés. Seuls les filtres du premier segment sont pris en compte lors de la génération de la variable.

2. Pas de condition "OU" : N'utilisez pas de conditions de type OU (OR) dans les filtres d'objets personnalisés de votre segment source.

3. Pas de segments imbriqués : N'utilisez pas de filtres d'inclusion ou d'exclusion d'autres segments dans votre segment source. L'analyse des variables s'effectue uniquement sur les filtres appliqués au niveau racine.

🛠️ Insérer vos variables dans l'éditeur d'e-mails

Vous pouvez intégrer ces variables de manière intuitive au sein du constructeur d'e-mails de Webmecanik Automation :

1. Dans un bloc de texte de votre e-mail, tapez simplement une accolade ouvrante {.

2. Commencez à saisir l'alias de votre objet (par exemple {produit ou {product).

3. La liste d'autocomplétion s'affiche instantanément avec tous les champs personnalisés disponibles pour cet objet.

4. Cliquez sur le champ souhaité pour insérer la variable dans votre contenu, puis ajoutez si besoin vos options de formatage (default=..., limit=...).

🎨 Personnaliser vos e-mails avec le Contenu dynamique

Le Contenu dynamique vous permet d'adapter des blocs entiers d'un e-mail (textes, bannières, offres promotionnelles) selon le profil de chaque destinataire.

Le moteur de règles du contenu dynamique fonctionne exactement de la même manière que celui des segments :

• Vous retrouvez la table dédiée aux Objets personnalisés directement dans les filtres de variation de votre bloc de contenu.

• Vous pouvez afficher un message spécifique uniquement si le contact possède un élément précis rattaché à son compte (par exemple, afficher un guide d'entretien exclusif si le contact possède un Élément personnalisé dont le champ Produits : SKU correspond à une référence haut de gamme).

• Si le contact ne correspond à aucune condition liée à ses éléments personnalisés, c'est la variante par défaut de votre contenu dynamique qui s'affichera automatiquement.

🔍 Utiliser l'URL de prévisualisation personnalisée

1. Rendez-vous sur la fiche récapitulative de votre e-mail (hors du constructeur de contenu).
2. Dans la colonne latérale droite, repérez l'encart URL de prévisualisation.
3. Dans le champ Afficher un aperçu pour le contact, commencez à taper le nom ou l'adresse e-mail d'un contact de test auquel est bien associé l'élément personnalisé souhaité.
4. Cliquez sur le lien généré ou sur l'icône d'ouverture de lien pour ouvrir l'aperçu dans un nouvel onglet de votre navigateur.

Le message s'affiche alors avec les données réelles du contact sélectionné : l'ensemble des variables d'objets personnalisés sont automatiquement résolues et remplacées par les valeurs de vos champs métiers. C'est l'étape idéale pour valider vos séparateurs de liste (format=), vérifier l'ordre d'affichage (order=latest) ou contrôler le texte de secours défini par défaut (default=).