Créer et utiliser les tags

Les tags permettent d’identifier la provenance d’un prospect ou d’un client. Vous pouvez transmettre une valeur dans un lien Kooneo, la conserver pendant le parcours d’achat, puis la retrouver dans Kooneo et dans les webhooks concernés.

  1. Créez le tag
  • Dans le menu principal, cliquez sur Outils.
  • Dans le menu de gauche, cliquez sur Tags.
  • Cliquez sur le bouton PLUS.
  1. Nommez le tag
  • Choisissez un nom court qui décrit l’information suivie, par exemple origin.
  • Le tag doit être créé dans Kooneo avant son utilisation dans un lien.

⚠️ Un tag qui n’a pas été créé au préalable dans Kooneo est ignoré.

  1. Ajoutez la valeur au lien Kooneo
  • Ajoutez un paramètre composé de tag_, suivi du nom du tag.
  • Pour un tag nommé origin, utilisez la forme suivante :
?tag_origin=a24f66771
  • Ajoutez ce paramètre à l’URL du formulaire de commande ou de la page Kooneo :
https://votre-site.kneo.me/form/votre-formulaire.html?tag_origin=a24f66771
  • La partie située après le signe égal est libre et peut changer selon la source, la campagne ou le partenaire suivi.

💡 Si votre URL contient déjà un paramètre commençant par ?, ajoutez le tag avec & au lieu d’ajouter un second point d’interrogation.

  1. Vérifiez le tag dans les ventes
  • Dans le menu principal, cliquez sur Ventes.
  • Dans le menu de gauche, cliquez sur Ventes validées.
  • Utilisez la fonction de recherche.
  1. Recherchez une valeur précise
  • Dans la partie Tags, saisissez le nom du tag et sa valeur.
  • Avec un tag nommé origin et une valeur a24f66771, recherchez :
origin=a24f66771

Utiliser un tag pour suivre l’origine d’une vente

Votre site peut conserver son propre identifiant pendant la navigation, puis l’ajouter au lien Kooneo au moment où le visiteur accède au paiement. Kooneo conserve alors cette valeur pendant le parcours sur ses pages et jusqu’à la validation du paiement.

⚠️ Les tags sont attachés au client, pas à une commande précise. Une nouvelle valeur peut donc remplacer la précédente pour ce client.

  • Enregistrez la valeur dès la réception du webhook si vous avez besoin d’un historique fiable par vente.
  • Envoyez toujours le paramètre, même lorsqu’aucune source particulière n’est connue.
  • Vous pouvez utiliser une valeur explicite comme direct pour éviter qu’une ancienne provenance reste associée au client.

Retrouver le tag dans un webhook

Pour un tag nommé origin, la valeur est disponible dans le bloc invoice.tags du webhook :

{
  "invoice": {
    "tags": {
      "origin": "a24f66771"
    }
  }
}

La documentation complète des événements, des données et des contrôles à effectuer se trouve dans l’article Utiliser les webhooks Kooneo.

Les derniers tutoriels