Connecter votre boutique

Une boutique envoie deux types de données à Emailit : le catalogue et les commandes depuis son backend, avec l’API, et ce que font les visiteurs sur le site, avec le script de suivi, qui fait partie du suivi des événements. Utilisez les deux pour avoir une vue complète : l’API est la source fiable des commandes, et le script ajoute les consultations de produit, les paniers et les visiteurs qui arrivent depuis vos e-mails.

Avant de commencer

• Une clé API pour les appels depuis le backend. Une clé Events Only peut envoyer les produits, les commandes et les paniers : c’est la même clé que celle qui envoie les événements depuis votre backend. Elle ne peut rien relire : ses réponses ne contiennent donc que object, id et external_id. Utilisez une clé Full Access pour aussi lire des données, gérer les coupons ou modifier les paramètres.
• Pour le script de suivi, l’autorisation d’ajouter un script aux pages de votre boutique.

Envoyer les données depuis votre backend

Produits

Envoyez votre catalogue avec Créer ou mettre à jour des produits par lots, puis de nouveau chaque fois que des produits changent. Chaque produit est identifié par l’ID de produit de votre boutique : le renvoyer le met donc à jour.

curl https://api.emailit.com/v2/products/batch \
  -X POST \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "products": [{
      "id": "1234",
      "title": "Trail Runner GTX",
      "url": "https://shop.example.com/products/trail-runner",
      "image_url": "https://shop.example.com/images/trail-runner.jpg",
      "price": 139,
      "compare_at_price": 169,
      "currency": "EUR",
      "categories": ["Shoes", "Running"],
      "inventory_quantity": 40
    }]
  }'

Les flux de produits des e-mails excluent les produits archivés et ceux dont le stock est à 0 : tenez donc status et inventory_quantity à jour.

Commandes

Quand une commande est passée, envoyez-la avec Créer ou mettre à jour une commande :

curl https://api.emailit.com/v2/orders \
  -X POST \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "id": "1001",
    "email": "jane@example.com",
    "currency": "EUR",
    "total": 125,
    "shipping": 5,
    "coupon_codes": ["WLC-8K2M4P"],
    "cart_id": "cart_789",
    "items": [{ "product_id": "1234", "title": "Trail Runner GTX", "quantity": 1, "price": 120 }]
  }'

• id est le numéro de commande de votre boutique. Renvoyer le même id met à jour la commande au lieu d’en ajouter une autre.
• Emailit attribue la commande à l’e-mail sur lequel l’acheteur a cliqué ou qu’il a ouvert en dernier. Consultez Attribution des commandes.
• L’acheteur devient un contact s’il ne l’est pas déjà. Ajoutez "accepts_marketing": true et un audience_id pour l’abonner aussi, par exemple quand il a coché une case d’inscription à la newsletter lors du paiement. "create_contact": false évite de créer un contact. L’appel purchase du script de suivi ne crée ni n’inscrit jamais de contact.
• cart_id marque ce panier comme converti.

Quand la commande est payée, expédiée, annulée ou remboursée, envoyez la modification avec Mettre à jour une commande, ou renvoyez la commande avec son nouveau status. Les commandes annulées ne comptent pas dans le chiffre d’affaires, et les remboursements en sont déduits.

Commandes passées

Importez votre historique de commandes avec Importer des commandes par lots, jusqu’à 1 000 commandes par requête. Les imports sont historiques par défaut : ils alimentent l’historique d’achat, les métriques et les recommandations, mais ne sont pas attribués aux e-mails et ne démarrent pas d’automatisation.

Le script de suivi

Le script de suivi enregistre ce que font les visiteurs sur votre site : consultations de produit, panier, achats et visites. Il reconnaît aussi les visiteurs qui arrivent depuis vos e-mails, pour que leur activité soit rattachée à leur contact.

Ajouter le script

1. Créez une clé de suivi. Dans Email API›Events, ouvrez l’onglet Tracking et sélectionnez Create tracking key. Sous Allowed origins, listez les domaines de votre boutique, par exemple shop.example.com ou *.example.com. Laissez vide pour accepter n’importe quel site.

2. Ajoutez l’extrait de code à chaque page, avant </head>. L’onglet Tracking l’affiche avec votre clé déjà renseignée :

   HTML

   <script>window.emailit=window.emailit||function(){(window._emailitq=window._emailitq||[]).push(arguments)};</script>
   <script async src="https://js.emailit.com/track/TRACKING_KEY/events.js"></script>

   Les clés de suivi sont publiques : elles peuvent seulement envoyer des événements, jamais lire des données. Si le script des formulaires Emailit est déjà sur la page, gardez les deux.

Pour enregistrer aussi une page vue sur chaque page, ajoutez data-autotrack="pages" à la balise script. Les pages vues mettent à jour la date de la dernière activité du contact sur votre site et son fuseau horaire ; elles ne sont pas enregistrées comme événements.

Enregistrer l’activité de la boutique

Effectuez ces appels là où l’action a lieu :

// Product page
emailit("product", { id: "1234", title: "Trail Runner GTX", url: location.href,
  image_url: "https://shop.example.com/images/trail-runner.jpg", price: 139, currency: "EUR",
  categories: ["Shoes", "Running"] });

// Every time the cart changes
emailit("cart", { id: "cart_789", currency: "EUR", checkout_url: "https://shop.example.com/checkout",
  items: [{ product_id: "1234", title: "Trail Runner GTX", quantity: 1, price: 139 }] });

// Order confirmation page
emailit("purchase", { id: "1001", total: 125, currency: "EUR",
  items: [{ product_id: "1234", quantity: 1, price: 120 }], coupon_codes: ["WLC-8K2M4P"] });

Identifier les visiteurs

L’activité est rattachée à un contact dès que le script sait qui est le visiteur :

• Depuis un lien d’e-mail. Quand un contact clique, dans un e-mail de campagne ou d’automatisation, sur un lien qui mène à votre site, le lien porte un paramètre _eit signé. Le script l’enregistre et le retire de la barre d’adresse. Les liens le reçoivent quand le suivi des clics est activé et que le lien mène à une origine autorisée d’une clé de suivi ou, pour les clés sans origine autorisée, à votre domaine d’envoi.

• Quand il se connecte ou passe commande, appelez identify avec son adresse e-mail ou son ID de contact :

  JavaScript

  emailit("identify", { email: "jane@example.com" });

• Quand il se déconnecte, appelez emailit("reset") pour l’oublier sur ce navigateur.

Les consultations de produit et les paniers antérieurs à l’identification du visiteur sont rattachés au contact. Le script enregistre aussi le fuseau horaire du navigateur, qu’utilise l’envoi à l’heure locale du destinataire, et la date de la dernière activité du contact sur votre site.

emailit("debug", true) affiche dans la console du navigateur ce que le script envoie.

Où l’activité apparaît

L’activité de la boutique arrive dans le même journal des événements que vos autres événements. Les consultations de produit deviennent des événements product.viewed, les paniers nouveaux ou modifiés des événements cart.updated, et les achats des événements order.placed. Vous les voyez dans Email API›Events et dans l’activité du contact, et les webhooks peuvent s’y abonner. product.viewed et cart.updated ne font pas partie de All events : abonnez-vous-y donc par leur nom. Consultez Événements Commerce.

Vérifier le résultat

• Email Marketing›Commerce affiche vos produits et vos commandes, et Carts affiche les paniers provenant du script.
• Email API›Events liste les événements product.viewed, cart.updated et order.placed au fil des consultations et des achats des visiteurs.
• Ouvrez un contact qui a passé commande : la carte Purchases affiche ses commandes, son total dépensé et les produits qu’il a consultés récemment.
• Après une campagne, les commandes qui lui sont attribuées apparaissent dans son onglet Revenue.

Voir aussi