Skip to content

Balise de commande ​

La balise de commande signale à Humind chaque commande passée sur votre boutique, depuis votre page de confirmation de commande. Humind sait alors quelles commandes l'assistant a aidé à conclure, et pour quel montant : c'est l'équivalent de la balise de transaction des autres outils conversationnels, posée de la même façon dans votre gestionnaire de balises.

Vous en avez besoin si votre boutique n'a aucune source de commandes côté serveur reliée à Humind. Les boutiques Shopify (les commandes viennent de l'app Humind), PrestaShop (les commandes viennent du module Humind) et celles qui envoient leurs commandes par l'API Commandes depuis un back-office sur mesure n'en ont pas besoin : la balise y est ignorée, pour qu'une commande ne soit jamais comptée deux fois.

Ce que Humind fait d'une commande ​

Pour chaque commande, Humind décide si l'assistant y a contribué, d'après ce que le widget a laissé dans le navigateur de l'acheteur :

VerdictSignification
Ajouté via Humind (direct)Au moins un produit de la commande a été ajouté au panier depuis l'assistant.
Recommandé (recommended)L'acheteur l'a ajouté lui-même, mais l'assistant avait montré ou cité ce produit dans sa conversation.
Conversation (cart)L'acheteur a parlé à l'assistant, puis a acheté des produits que la conversation n'a jamais montrés.
AucunPas de conversation dans ce navigateur. La commande compte quand même dans le total de votre boutique.

Le chiffre d'affaires attribué ne compte que les produits auxquels Humind a contribué (ajoutés via Humind ou recommandés), jamais le reste du panier.

Mise en place dans Google Tag Manager ​

Il vous faut l'identifiant de votre company Humind : copiez-le depuis la page Developer Credentials de votre dashboard. Avec plusieurs marchés, prenez l'identifiant du marché auquel appartient la page de confirmation.

  1. Variables : créez des variables de couche de données pour votre événement d'achat, en général ecommerce.transaction_id, ecommerce.value, ecommerce.currency et ecommerce.items (le format e-commerce de GA4).
  2. Déclencheur : l'événement qui se déclenche sur votre page de confirmation de commande, en général votre événement purchase.
  3. Balise : une balise HTML personnalisé déclenchée par ce déclencheur :
html
<script>
  window.humindOrder = {
    company: 'YOUR_COMPANY_ID',
    orderId: {{DLV - ecommerce.transaction_id}},
    total: {{DLV - ecommerce.value}},
    currency: {{DLV - ecommerce.currency}},
    items: {{DLV - ecommerce.items}}
  };
</script>
<script async src="https://embed.thehumind.com/order.js"></script>

Remplacez les noms de variables par les vôtres. Autres gestionnaires de balises : posez le même objet window.humindOrder, puis chargez le même script.

ChampObligatoireContenu
companyouiL'identifiant de votre company Humind.
orderIdouiLe numéro de commande tel que votre boutique le numérote (128 caractères au plus).
totalouiTotal payé pour la commande, en unités (129.90), entre 0 et 1 000 000. Un nombre, ou une chaîne aux formats usuels (89,90, 1 234,56, 1,234.56). Un point seul est toujours le séparateur décimal : écrivez 1.234,00 ou 1234, pas 1.234, pour mille deux cent trente-quatre.
currencynonCode ISO 4217 (EUR). Ignoré s'il ne fait pas trois lettres.
itemsnon, recommandéLes produits commandés, au format GA4 : item_id, price, quantity, item_name, item_variant. 200 au plus. Une ligne sans item_id est ignorée, un prix illisible est laissé vide : la commande est quand même enregistrée.

Sans items, Humind sait quand même que l'acheteur a parlé à l'assistant, mais pas quels produits en viennent : la commande ne peut obtenir que le verdict Conversation.

item_id doit être la référence de votre flux catalogue

Humind reconnaît un produit à la référence que votre flux catalogue lui envoie (l'identifiant produit, ou la référence de variante que vous envoyez comme identifiant externe). Si votre couche de données met un autre identifiant dans item_id, les produits ne sont pas reconnus : la commande est enregistrée, mais ni Ajouté via Humind ni Recommandé.

Tester ​

  1. Sur votre site, ouvrez l'assistant et ajoutez un produit au panier depuis celui-ci.
  2. Passez une commande de test.
  3. Sur la page de confirmation, ouvrez l'onglet réseau du navigateur : une requête vers api.thehumind.com/integrations/order-tag (type ping) répond 201. Quand le navigateur affiche son contenu, on y lit {"recorded": true, "attribution": "direct"}.

Autres réponses :

StatutreasonSignification
200already_recordedCe numéro de commande est déjà enregistré (page de confirmation rechargée). Rien n'a changé.
202server_ordersVotre boutique envoie déjà ses commandes depuis son serveur (Shopify, PrestaShop, API Commandes) : la balise est ignorée.
400invalid_payloadUn champ obligatoire manque ou est mal formé.
403origin_not_verifiedLa page n'est pas sur un domaine vérifié de votre company. Vérifiez-le sur la page URL whitelist de votre dashboard.
404unknown_companycompany n'est pas un identifiant de company Humind.
413too_largeLe corps dépasse 64 Ko. order.js n'en envoie jamais : il retire les noms des produits, puis les dernières lignes, pour que le numéro de commande et le total partent toujours.
429rate_limitedPlus de 5 000 nouvelles commandes par heure depuis la même connexion : un plafond contre les scripts, qu'aucun vrai acheteur n'atteint. Le total de votre boutique n'a aucune limite.

Sur localhost, la balise ne fonctionne que pendant que la fenêtre de test localhost de votre company est ouverte, et la commande est enregistrée comme test, hors de tous les chiffres.

Bon à savoir ​

  • La page doit être sur un domaine vérifié de votre company : une balise envoyée depuis un autre site est refusée.
  • Une commande est enregistrée une seule fois. Une page de confirmation rechargée ou une balise déclenchée deux fois ne change rien. Si votre serveur envoie plus tard le même numéro de commande par l'API Commandes, cet envoi la remplace.
  • Les annulations et les retours ne sont pas connus par la balise : elle ne voit que la page de confirmation. Une boutique qui en a besoin envoie ses commandes depuis son serveur par l'API Commandes à la place de la balise (la balise est alors ignorée).
  • La trace vit dans le navigateur de l'acheteur : un autre appareil, des cookies effacés ou une conversation de plus de 30 jours, et la commande est enregistrée sans attribution.
  • Consentement : le widget note toujours dans son cookie humind_attribution les produits ajoutés depuis l'assistant, qui n'identifient personne. Les identifiants du visiteur et de la conversation n'y entrent que lorsque la mesure d'usage est permise, et sont effacés quand l'acheteur refuse. Si vous exigez le consentement dans Humind, une commande passée sans lui peut quand même être Ajouté via Humind, mais ni Recommandé ni Conversation. Sur PrestaShop, les identifiants sont toujours écrits, car le module Humind en a besoin. Détails : Confidentialité et stockage navigateur.

Released under the proprietary Humind license.