Personyze Wiki Personyze Wiki docs
Français
Open Personyze
Docs/ Campagnes e-mail/ Obtenir le code pour insérer des recommandations dans des e-mails tiers
Campagnes e-mail

Obtenir le code pour insérer des recommandations dans des e-mails tiers

Des recommandations de produits calculées à l’ouverture de chaque e-mail : catalogue, suivi, création du widget, insertion dans Mailchimp, Klaviyo, HubSpot et autres ESP, QA et rapports.

18 min read Updated 10 minutes ago

Votre plateforme e-mail excelle dans l’envoi. Mais si les recommandations de produits de chaque e-mail se mettaient à jour d’elles-mêmes en temps réel — en montrant à chaque destinataire exactement ce qu’il est le plus susceptible d’acheter, d’après son comportement le plus récent, au moment où il ouvre l’e-mail ?

C’est ce que fait la personnalisation des e-mails à l’ouverture de Personyze. Elle fonctionne en insérant un simple extrait HTML dans n’importe quel modèle de campagne — quel que soit votre ESP. Ce guide vous accompagne tout au long du processus pour Mailchimp, Klaviyo, HubSpot, ActiveCampaign, Brevo et Constant Contact.

Comment fonctionne la personnalisation à l’ouverture

Les blocs produits traditionnels des e-mails figent le contenu au moment de l’envoi — tous les destinataires reçoivent la même chose. L’approche de Personyze est différente : vous intégrez un extrait HTML une seule fois dans votre modèle de campagne. Chaque fois qu’un client ouvre cet e-mail, l’extrait appelle Personyze en direct, identifie le destinataire et génère à cet instant une image de recommandations personnalisée.

De l’achat à l’e-mail personnalisé — le déroulement

  1. Personyze suit l’achat en direct — votre site envoie à Personyze un événement purchase avec les détails de la commande.
  2. Votre ESP envoie la confirmation de commande avec l’extrait Personyze intégré sous forme de balises image.
  3. Le client ouvre l’e-mail — son client de messagerie demande les URL des images à Personyze.
  4. Personyze génère les images personnalisées à la volée — à partir du profil comportemental de chaque destinataire et de votre catalogue de produits en direct.

Compatible avec tous les ESP.L’extrait se compose de simples balises HTML <img> qui pointent vers des URL Personyze. Toute plateforme e-mail qui permet d’insérer du HTML personnalisé fonctionne — Mailchimp, Klaviyo, HubSpot, ActiveCampaign, Brevo, Constant Contact, Campaign Monitor, Salesforce Marketing Cloud, et d’autres.

Prérequis

  • Un compte Personyze actif, avec les recommandations par e-mail activées dans votre formule
  • Un accès à votre plateforme e-mail avec l’autorisation de modifier le HTML des campagnes
  • Un catalogue de produits prêt à être importé — ou déjà synchronisé dans Personyze
  • Le script de suivi Personyze installé sur votre site web pour les données comportementales

Vous utilisez déjà Personyze sur votre site ?Si vous avez des recommandations sur le site en service, votre catalogue est chargé et le suivi des interactions est actif. Passez les étapes 1 et 2 et allez directement à la création de votre widget e-mail.

Étape 1 — Importer votre catalogue de produits

Personyze utilise une base de produits unique. Si vous avez déjà importé vos produits pour les recommandations sur le site, passez entièrement cette étape. Sinon, allez dans Settings → Product Catalog et choisissez l’une des trois méthodes de synchronisation :

Import CSVExportez votre flux de produits depuis Shopify, WooCommerce ou Magento et importez-le directement. Obligatoire : product_id, name, price, image_url, product_url. Recommandé : category, brand, availability.
Flux XML / JSON (synchronisation automatique)Fournissez l’URL d’un flux — le format XML de Google Shopping fonctionne nativement. Personyze se synchronise automatiquement toutes les heures, tous les jours ou toutes les semaines. Indispensable pour que la disponibilité et les prix soient à jour au moment de l’ouverture de l’e-mail.
Intégration par APIEnvoyez les produits par programme depuis votre back-end via l’API Catalogue de Personyze. Idéal pour les gros catalogues ou pour un stock exact en temps réel.

Gardez votre catalogue à jour.Les recommandations sont générées à l’ouverture. Un produit affiché comme disponible alors qu’il est en rupture de stock est une expérience frustrante — mettez en place une synchronisation programmée du flux chaque fois que possible.

Étape 2 — Configurer le suivi des interactions avec les produits

Personyze recueille les données comportementales via les événements d’interaction avec les produits — vues, ajouts au panier et achats — envoyés depuis votre site. Si Personyze fonctionne déjà sur votre site, c’est déjà fait.

Installer la balise Personyze

Ajoutez le script de suivi Personyze dans le <head>de votre site. Vous trouverez votre extrait unique dans Settings → Tracking Code. Il ressemble à ceci :

<script>
window._S_T || function(s) {
  s.async = true;
  s.src = '//counter.personyze.com/stat-track-lib.js';
  s.onload = function() {
    _S_T.async = true;
    _S_T.setup(YOUR_ACCOUNT_ID, "your-domain.com");
  };
  (document.querySelector('head') || document.documentElement).appendChild(s);
}(document.createElement('script'))
</script>

Envoyer les événements de vue produit

Sur chaque page de détail produit, envoyez un événement product_view pour que Personyze puisse construire les profils comportementaux. C’est ce qui alimente l’algorithme de recommandations personnalisées dans les e-mails :

window.personyze = window.personyze || [];
window.personyze.push(['trackEvent', 'product_view', {
  product_id:   'SKU-1234',
  product_name: 'Blue Running Shoe',
  category:     'Footwear > Running',
  price:        89.99,
  currency:     'USD'
}]);

Suivre les ajouts au panier et les achats

Pour les meilleures recommandations, envoyez aussi les événements add_to_cart et purchase sur les pages concernées :

// On add-to-cart
window.personyze.push(['trackEvent', 'add_to_cart', {
  product_id: 'SKU-1234', price: 89.99, currency: 'USD'
}]);

// On purchase confirmation
window.personyze.push(['trackEvent', 'purchase', {
  order_id: 'ORD-9876',
  products: [
    { product_id: 'SKU-1234', price: 89.99, quantity: 1 }
  ],
  total: 89.99, currency: 'USD'
}]);

Relier les événements suivis aux destinataires des e-mails.Pour que Personyze relie le comportement sur le site à un destinataire d’e-mail, il doit connaître son identité. Transmettez l’e-mail ou l’identifiant CRM de l’utilisateur à Personyze après la connexion ou depuis une session connue. Consultez le guide du suivi des interactions avec les produits pour tous les détails sur l’identification des utilisateurs.

Étape 3 — Créer votre widget dans Personyze

Allez dans Email Recommendations → Get Code Wizard. L’assistant vous fait passer par trois sous-étapes : algorithme, modèle et personnalisation.

Options d’algorithme

🎯 Recommandations personnaliséesD’après l’historique individuel de navigation et d’achat de chaque destinataire. Le plus efficace pour les audiences chaudes qui ont déjà visité votre site.
🔥 Meilleures ventes / les plus populairesLes produits actuellement populaires d’après le comportement global. Idéal pour les nouveaux abonnés ou les audiences froides. Une excellente solution de secours pour toute campagne.
🛒 D’après le dernier achatRecommande des produits liés ou complémentaires à ce que le destinataire a acheté en dernier. Parfait pour les séquences de suivi après achat.
👁 D’après les produits vus récemmentFait remonter les produits que le destinataire a consultés le plus récemment. Idéal pour les campagnes de réengagement ou de navigation abandonnée.
🏷 Bannière promotionnelleUne bannière promotionnelle entièrement conçue, ciblée par segment ou selon l’heure, ou personnalisée avec le nom ou la localisation du destinataire — à la place des cartes produit.

Modèle et personnalisation

Après avoir choisi un algorithme, sélectionnez une mise en page dans la bibliothèque de modèles, puis utilisez le panneau de gauche pour personnaliser les couleurs, les badges, le texte des boutons, la taille des images et les espacements. L’aperçu en direct se met à jour en temps réel.

Les modèles disponibles comprennent Row Card, Gradient Overlay, Minimal Elegant, Dark Showcase et Horizontal Rows :

Modèle Row Card Modèle Gradient Overlay Modèle Minimal Elegant Modèle Dark Showcase Modèle Horizontal Rows

Définissez le nombre de produits à afficher — généralement 3 ou 4 pour les e-mails transactionnels, jusqu’à 6 pour les campagnes dédiées aux recommandations.

Étape 4 — Comprendre le code d’intégration

Comment ça marche vraiment — des URL uniques par destinataire

L’extrait généré par Personyze n’est pas une image générique. Chaque <img src> est une URL unique qui encode l’identité du destinataire. Quand un abonné ouvre l’e-mail, son client de messagerie demande cette URL à Personyze. Personyze alors :

  1. Recherche le profil comportemental de l’abonné (historique de navigation, achats, catégories consultées)
  2. Applique à ce profil l’algorithme de recommandation choisi
  3. Vérifie les prix et la disponibilité actuels dans votre catalogue de produits en direct
  4. Génère et renvoie une image de produits personnalisée — en direct, à ce moment-là

Chaque emplacement de produit du widget a sa propre URL (se terminant par /k=...v, /k=...w, etc.) pour que Personyze puisse optimiser indépendamment le contenu de chaque emplacement.

L’extrait généré

<table>
  <tr>
    <td>
      <a href="https://pic.personyze.com/href/k=8qy0zs2vbzcv/email={INSERT EMAIL HERE}">
        <img src="https://pic.personyze.com/png/k=8qy0zs2vbzcv/email={INSERT EMAIL HERE}" alt="Recommended"/>
      </a>
    </td>
    <td>
      <a href="https://pic.personyze.com/href/k=8qy0zs2vbzcw/email={INSERT EMAIL HERE}">
        <img src="https://pic.personyze.com/png/k=8qy0zs2vbzcw/email={INSERT EMAIL HERE}" alt="Recommended"/>
      </a>
    </td>
  </tr>
</table>

La solution de secours — pourquoi vous obtenez toujours quelque chose d’utile

Au moment de l’envoi d’une campagne, Personyze n’a jamais vu votre liste de destinataires — il ne sait pas qui figure dans votre audience Mailchimp ou Klaviyo tant que l’e-mail n’est pas ouvert. Personyze est donc conçu avec une solution de secours intelligente :

  • Si l’e-mail d’un destinataire est connu de Personyze (il a visité votre site avec le suivi actif et son identité a été recueillie) — il reçoit des recommandations entièrement personnalisées.
  • Si l’e-mail d’un destinataire n’est pas encore dans Personyze (nouvel abonné, ou suivi pas encore relié) — le widget se rabat sur l’algorithme de secours configuré, généralement Les plus populaires ou Meilleures ventes : l’e-mail affiche donc toujours des suggestions pertinentes plutôt qu’une image cassée.

Configurez votre solution de secours à l’étape Recommandation, sous Fallback recommendation if no results.

Recommandations non personnelles (sans suivi)

Vous n’avez pas encore mis en place le suivi comportemental ? Vous pouvez quand même utiliser Personyze pour les recommandations par e-mail avec des approches basées sur le contexte :

  • Transmettre un identifiant de produit dans l’URL — par exemple, dans un e-mail après l’achat de la commande n° XYZ, transmettez l’identifiant du produit et Personyze fera remonter les articles achetés ou consultés avec ce produit, d’après le comportement global.
  • Meilleures ventes du site — sans contexte individuel ni produit, Personyze fait remonter vos produits les plus performants du moment d’après l’activité de tous les visiteurs. Une base solide qui reste meilleure que des sélections éditoriales figées.

Remplacez chaque occurrence de l’espace réservé.Chaque emplacement de produit contient deux occurrences de {INSERT EMAIL HERE} — l’une dans le href (suivi des clics) et l’autre dans le src (affichage de l’image). Remplacez toutes les occurrences, pas seulement la première.

Étape 5 — Insérer dans votre plateforme e-mail

La procédure est la même pour tous les ESP : ajoutez l’extrait HTML de Personyze à votre campagne, puis remplacez l’espace réservé par la balise de fusion de la plateforme pour l’adresse e-mail de l’abonné. La balise exacte varie selon la plateforme — les sections ci-dessous couvrent les principales.

🐒 Mailchimp
  1. Ouvrez votre modèle de campagne. Allez dans Campaigns → Email Templates (ou ouvrez un brouillon et cliquez sur Edit Design) pour lancer l’éditeur par glisser-déposer.
  2. Ajoutez un bloc de contenu Code. Faites glisser un bloc Code depuis la barre latérale dans votre modèle — généralement sous le visuel principal, au-dessus du pied de page.
  3. Collez l’extrait et remplacez l’espace réservé. Cliquez dans le bloc Code, collez tout le HTML, puis remplacez {INSERT EMAIL HERE} par la balise de fusion de Mailchimp : *|EMAIL|*
  4. Envoyez un e-mail de test pour vérifier. Utilisez Preview & Test → Send a Test Email — l’aperçu visuel ne remplace pas les balises de fusion. Ouvrez le test dans votre boîte de réception pour confirmer que l’image se charge avec de vraies recommandations.

Limite de l’aperçu visuel.L’aperçu par glisser-déposer de Mailchimp ne remplace pas les balises de fusion — il affiche le texte littéral *|EMAIL|* dans l’URL. Envoyez toujours un vrai e-mail de test pour vérifier.
🎯 Klaviyo
  1. Ouvrez l’éditeur de modèle d’e-mail. Allez dans Content → Templates ou ouvrez l’e-mail de votre Flow/Campaign et cliquez sur Edit.
  2. Ajoutez un bloc Text ou HTML. Faites glisser un bloc Text et passez en mode HTML, ou utilisez un bloc HTML si votre modèle le permet. Collez l’extrait Personyze.
  3. Remplacez l’espace réservé. Klaviyo utilise des gabarits de style Django avec des doubles accolades. Remplacez {INSERT EMAIL HERE} par : {{ email }}
  4. Prévisualisez avec un vrai profil. Utilisez la fonction Preview as Person de Klaviyo, sélectionnez un vrai abonné et vérifiez que l’image se charge avec des recommandations personnalisées.

Astuce pour les flows Klaviyo.Les flows Klaviyo sont particulièrement efficaces combinés aux algorithmes Vus récemment ou Navigation abandonnée — les déclencheurs comportementaux de Klaviyo, associés à l’affichage à l’ouverture de Personyze, produisent des e-mails très pertinents et au bon moment.
🟠 HubSpot
  1. Ouvrez l’éditeur d’e-mails. Allez dans Marketing → Email et ouvrez ou créez une campagne. Cliquez sur Edit pour lancer l’éditeur par glisser-déposer.
  2. Ajoutez un module Rich Text ou Custom HTML. Faites glisser un module Rich Text dans votre modèle. Cliquez sur l’icône </> Source Code de la barre d’outils pour passer en mode HTML. Collez l’extrait Personyze.
  3. Remplacez l’espace réservé. HubSpot utilise HubL (le langage de gabarits de HubSpot). Remplacez {INSERT EMAIL HERE} par : {{ contact.email }}
  4. Envoyez un test et prévisualisez. Utilisez Send Test Email de HubSpot avec une vraie fiche contact pour confirmer que la balise de fusion se résout et que les recommandations se chargent.

Workflows HubSpot.Cela se combine particulièrement bien avec les workflows de cycle de vie des contacts de HubSpot. Déclenchez un e-mail alimenté par Personyze aux moments clés — après une démo, après un achat ou pour un réengagement — là où des recommandations de produits personnalisées apportent une vraie valeur.
⚡ ActiveCampaign
  1. Ouvrez le concepteur d’e-mails. Allez dans Campaigns → Create a Campaign ou ouvrez un e-mail d’automatisation existant. Utilisez le New Email Designer.
  2. Ajoutez un bloc HTML. Faites glisser un bloc de contenu HTML dans votre modèle. Cliquez pour le modifier et collez l’extrait Personyze.
  3. Remplacez l’espace réservé. ActiveCampaign utilise des balises entourées de signes pourcentage. Remplacez {INSERT EMAIL HERE} par : %EMAIL%
  4. Testez via une automatisation. Ajoutez un contact de test à l’automatisation ou utilisez Send Preview Email avec un vrai contact pour vérifier que la balise se résout et que les recommandations apparaissent.
💙 Brevo (anciennement Sendinblue)
  1. Ouvrez l’éditeur de modèles. Allez dans Email → Templates et ouvrez ou créez un modèle.
  2. Passez à l’éditeur HTML. Cliquez sur le bouton </> HTML en haut à droite pour accéder au HTML brut. Collez l’extrait Personyze là où vous voulez que les recommandations apparaissent.
  3. Remplacez l’espace réservé. Brevo utilise une syntaxe à doubles accolades. Remplacez {INSERT EMAIL HERE} par : {{ contact.EMAIL }} (en majuscules).
  4. Envoyez un test. Utilisez Preview & Test → Send Test Email avec un vrai contact pour confirmer que la personnalisation s’affiche correctement.
📮 Constant Contact
  1. Ouvrez le modèle d’e-mail. Allez dans Campaigns → Create an Email, choisissez votre modèle et ouvrez l’éditeur.
  2. Ajoutez un bloc Custom Code. Cliquez sur Insert → More → Custom Code pour ajouter un bloc HTML brut. Collez l’extrait Personyze.
  3. Remplacez l’espace réservé. Constant Contact utilise un format de balise plus ancien. Remplacez {INSERT EMAIL HERE} par : $[LN:EMAIL:$]
  4. Prévisualisez et testez. Utilisez Preview → Preview As Subscriber et sélectionnez un vrai abonné pour vérifier que la balise de personnalisation se résout correctement avant l’envoi.

Référence rapide — balises de fusion e-mail

Récapitulatif de la balise de fusion exacte à utiliser pour chaque plateforme en remplaçant {INSERT EMAIL HERE}:

Plateforme e-mail Remplacer {INSERT EMAIL HERE} par Remarques
Mailchimp *|EMAIL|* Balise de fusion Mailchimp standard
Klaviyo {{ email }} Variable de gabarit de style Django
HubSpot {{ contact.email }} Propriété de contact HubL
ActiveCampaign %EMAIL% Balise de personnalisation entre signes pourcentage
Brevo {{ contact.EMAIL }} Nom de champ en majuscules
Constant Contact $[LN:EMAIL:$] Balise de substitution
Campaign Monitor [email] Balise de fusion entre crochets
Salesforce Marketing Cloud %%emailaddr%% Chaîne de substitution AMPscript
Tout autre ESP La balise de fusion e-mail de votre plateforme Consultez la documentation de votre plateforme

Vous préférez l’identifiant CRM à l’adresse e-mail ?Si vos profils Personyze sont indexés par identifiant utilisateur interne plutôt que par e-mail, utilisez la variante {INSERT USER ID HERE} de l’espace réservé dans l’extrait et remplacez-la par la balise de fusion de votre plateforme pour ce champ. Cela évite aussi de faire passer des adresses e-mail dans les paramètres d’URL.

Étape 6 — QA et aperçu de vos recommandations

Avant d’envoyer à toute votre liste, utilisez l’outil de QA intégré de Personyze (l’étape QA de l’assistant) pour vérifier que les recommandations fonctionnent et sont correctement personnalisées.

Rechercher n’importe quel abonné par e-mail

À l’étape QA, saisissez l’adresse e-mail de n’importe quel abonné dans le champ Find user. Personyze affiche instantanément les images de produits exactes que cet utilisateur verrait en ouvrant son e-mail — d’après son profil comportemental actuel, en temps réel.

Sous les recommandations affichées, dépliez la ligne de l’utilisateur pour voir tout son historique d’interactions avec les produits : chaque produit consulté, ajouté au panier ou acheté, avec l’horodatage et les données de session. Utile pour confirmer que le suivi fonctionne correctement et que l’algorithme capte les bons signaux.

Et si l’utilisateur n’est pas encore dans Personyze ?Si l’e-mail saisi n’a aucun historique dans Personyze, l’outil de QA affiche les recommandations de secours configurées (Les plus populaires / Meilleures ventes). C’est exactement ce que cet abonné recevrait dans le vrai e-mail — cela confirme donc aussi que la solution de secours fonctionne.

Ce qu’il faut vérifier avant l’envoi

  • Les recommandations semblent personnalisées. Les produits de l’aperçu QA doivent correspondre aux centres d’intérêt connus de cet utilisateur — pas au hasard. S’ils semblent génériques, vérifiez que les événements de suivi comportemental se déclenchent et que l’e-mail de l’utilisateur est correctement transmis depuis votre site.
  • La solution de secours s’affiche proprement. Testez avec une adresse e-mail toute neuve, sans historique. Vous devriez voir Meilleures ventes ou Les plus populaires — pas un widget vide ou cassé.
  • Envoyez un vrai test depuis votre ESP. Envoyez toujours un e-mail de test depuis votre véritable ESP (pas seulement l’aperçu visuel, qui ne résout pas les balises de fusion). Ouvrez-le dans votre vraie boîte de réception.
  • La destination du clic est correcte. Cliquez sur chaque image de produit dans votre e-mail de test. Vérifiez qu’elle mène à la bonne page produit et que le suivi des clics de Personyze se déclenche pour une attribution exacte.

Ne vous fiez jamais au seul aperçu visuel.Les aperçus visuels par glisser-déposer de tous les grands ESP ne remplacent pas les balises de fusion — ils affichent l’espace réservé brut dans l’URL, ce qui fait échouer la requête d’image. Faites toujours un vrai envoi de test.

Étape 7 — Rapports de performance

Une fois votre campagne en ligne, l’onglet Performance de Personyze fournit des indicateurs d’attribution détaillés qui vont au-delà de ce que les statistiques natives de votre ESP fournissent pour le bloc de recommandations.

Indicateurs au niveau de la campagne

📊 VuesNombre total d’affichages du widget de recommandations — c’est-à-dire d’ouvertures de l’e-mail avec le chargement des images activé. Votre nombre d’impressions pour la couche de personnalisation.
🖱 ClicsPourcentage de lecteurs qui ont cliqué sur au moins un produit, plus le total des clics sur les produits et la moyenne de clics par utilisateur. Indique à quel point la sélection de recommandations est engageante.
🛒 Ajouts au panierLes utilisateurs qui ont cliqué puis ajouté un produit recommandé au panier, suivis via le suivi d’événements Personyze de votre site.
💰 Achats et revenusTotal des transactions, des revenus et du taux de contribution attribués au widget de recommandations par e-mail. Le retour sur investissement direct de la couche de personnalisation.

Détail par utilisateur

Passez à l’onglet Users de Performance pour voir le détail par abonné — quelles adresses e-mail précises ont cliqué, ajouté au panier ou acheté, et exactement avec quels produits elles ont interagi. Utile pour :

  • Vérifier que les utilisateurs à forte intention reçoivent les recommandations les plus pertinentes
  • Identifier les segments d’utilisateurs qui génèrent le plus de conversions d’achat depuis les e-mails
  • Réinjecter ces enseignements dans vos choix d’algorithme ou de segments pour les campagnes futures

Périodes des rapports.Utilisez le sélecteur de période (From start, From last edit, Last 7 days, plage de dates personnalisée) pour isoler les performances d’un envoi de campagne ou d’une période de test précise. Les données de performance se mettent à jour environ 1 heure après la fin des sessions des visiteurs.

Conseils pour de meilleurs résultats

  • Gardez votre catalogue à jour. Programmez des synchronisations de flux quotidiennes ou horaires. Des prix périmés et des produits en rupture de stock érodent instantanément la confiance.
  • Un placement au milieu de l’e-mail fait mieux qu’en haut ou en bas. Sous la bannière principale, au-dessus du pied de page, génère systématiquement un meilleur taux de clics que les autres positions.
  • 3 à 4 produits pour les e-mails transactionnels, 4 à 6 pour les envois dédiés aux recommandations. Plus de produits signifie plus de défilement — testez pour trouver le bon équilibre.
  • Définissez une solution de secours pertinente. Pour les nouveaux abonnés sans historique comportemental, rabattez-vous sur Meilleures ventes ou Les mieux notés — pas sur des produits au hasard.
  • Accordez l’objet de l’e-mail à la personnalisation. Si votre objet annonce « Sélectionné rien que pour vous », les recommandations doivent vraiment paraître personnelles. Assurez-vous que les données comportementales se remplissent avant un déploiement à grande échelle.
  • N’oubliez pas le texte alternatif. Un attribut alt descriptif sur l’image de recommandations garantit que les utilisateurs d’Outlook en entreprise, qui bloquent les images par défaut, voient quand même un appel à l’action clair.
Did this page answer your question?
Thank you — that goes to whoever maintains this page.