Liens courts

Un lien collé dans une newsletter, dans un tweet et sur un flyer imprimé, c'est trois liens du point de vue de vos statistiques. Ou bien un seul lien, dont vous ne pouvez attribuer les clics à aucun des trois. Passer par un raccourcisseur hébergé règle l'attribution, et confie les données de clic, visiteur par visiteur, à la base de données de quelqu'un d'autre.

Le tableau links déclare des liens courts servis par votre application et comptés dans votre propre base de données :

links:
  - slug: promo-printemps
    to: https://example.com/tarifs
    title: Promo printemps — page tarifs
    tags:
      - lancement-t2
    utm:
      source: newsletter
      medium: email
      campaign: printemps
    lifecycle:
      validUntil: '2026-06-30T23:59:59Z'
      maxClicks: 5000

Chaque lien répond sur /l/{slug}, par exemple https://votre-app.com/l/promo-printemps. Le préfixe /l est fixe et non configurable : l'adresse est donc prévisible sur toute instance Sovrium.

Propriétés d'un lien

Un lien court répond 302 Found avec Cache-Control: no-store. C'est délibéré, et c'est la différence avec une redirection : un 301 est mis en cache indéfiniment par les navigateurs et les intermédiaires, ce qui mettrait silencieusement en échec le comptage des clics comme la date d'expiration.

Pourquoi pas une redirection ?

Les deux répondent à une URL avant la résolution des pages ; il vaut donc la peine de dire explicitement lequel choisir :

Aucun des deux ne remplace l'autre. Utilisez redirects pour une migration d'URL, et links pour tout ce que vous allez partager et dont vous voudrez lire les chiffres.

Paramètres de campagne

utm ajoute les paramètres de campagne standard à la destination : vous les écrivez une fois dans la configuration au lieu de coller une chaîne de requête bricolée à la main dans chaque canal.

links:
  - slug: webinaire
    to: https://example.com/inscription
    utm:
      source: linkedin
      medium: social
      campaign: webinaire-t2
      content: banniere-laterale
      term: automatisation

Un visiteur qui suit /l/webinaire arrive sur https://example.com/inscription?utm_source=linkedin&utm_medium=social&utm_campaign=webinaire-t2&utm_content=banniere-laterale&utm_term=automatisation.

Les paramètres déjà présents sur la destination sont conservés : utm n'écrase jamais une valeur que vous avez écrite vous-même. La chaîne de requête avec laquelle arrive le visiteur est elle aussi transmise.

Cycle de vie

Un lien de campagne doit cesser de fonctionner quand la campagne se termine. lifecycle dit quand :

Un lien dont la période de validité n'a pas commencé répond 404. Un lien expiré, désactivé, ou qui a épuisé son maxClicks répond 410 Gone : un « ceci a existé et c'est terminé » explicite, plutôt que de faire comme si le lien n'avait jamais existé.

maxClicks porte deux limites, qu'il vaut mieux énoncer que laisser découvrir. Le total est lu dans vos données analytiques : seuls les clics compris dans votre fenêtre de conservation entrent dans le compte, et un lien plafonné qui survit à votre analytics.retentionDays repart donc avec un budget neuf. Le plafond, lui, est appliqué requête par requête plutôt que sous verrou : une rafale simultanée peut le dépasser légèrement. Les deux sont le prix à payer pour compter les clics à un seul endroit, au lieu de tenir un second décompte qui pourrait contredire le premier.

Répartir le trafic

Donnez plusieurs targets à un lien pour répartir le trafic entre elles, par exemple pour un test A/B ou pour comparer deux pages de destination :

links:
  - slug: test-tarifs
    title: Page tarifs A/B
    targets:
      - to: https://example.com/tarifs-a
        weight: 3
      - to: https://example.com/tarifs-b
        weight: 1

weight est relatif : cet exemple envoie donc trois visiteurs vers A pour un vers B. Une cible sans weight compte pour 1. Chaque clic enregistré porte la cible vers laquelle il a été résolu, si bien que la console d'administration présente chaque variante séparément.

QR codes

Chaque lien dispose d'un QR code sur /l/{slug}.svg, généré par l'application sans service externe ni requête vers un tiers :

https://votre-app.com/l/promo-printemps.svg

Le SVG est prêt à imprimer. Placez-le dans un flyer, une affiche, une carte de visite, ou dans un composant image de l'une de vos pages. Récupérer le SVG n'est pas un clic ; seul un scan en est un.

Un scan est compté séparément du même lien collé dans un message : « est-ce le flyer qui a marché, ou le tweet ? » devient une question qui a une réponse. La console d'administration montre les deux.

Suivi

Les clics arrivent dans le même magasin d'événements que vos vues de page et respectent les mêmes réglages : respectDoNotTrack, excludedPaths et retentionDays s'appliquent tous, et aucun clic n'est enregistré tant que l'analytique n'est pas activée. Les visiteurs sont comptés par le même hachage sans cookie utilisé partout ailleurs : aucun suivi de clic n'écrit de cookie.

Lisez les chiffres dans la console d'administration sur /_admin/links : l'évolution des clics dans le temps, les référents, les appareils, les campagnes et le journal brut des clics, pour tous les liens ensemble ou pour un lien à la fois.

Créer des liens hors configuration

Les liens déclarés en configuration appartiennent à l'application : ils sont livrés et versionnés avec elle. Des liens peuvent aussi être créés dans la console d'administration, pour les campagnes qui vont et viennent plus vite qu'un déploiement.

La configuration l'emporte toujours. Un lien de console ne peut pas masquer un lien de configuration, et un lien déclaré en configuration est en lecture seule dans la console : vous pouvez l'y activer ou le désactiver, mais toute modification ou suppression est refusée. La configuration reste la source de vérité pour tout ce qu'elle déclare.

Validation

Une configuration qui rendrait un lien inatteignable est rejetée au démarrage, plutôt qu'au moment où un visiteur tombe sur l'adresse morte :

• Aucun chemin de pages, forms ou redirects ne peut se trouver sous /l : il masquerait tous les liens courts situés en dessous
• slug doit être unique dans l'application
• Un lien doit déclarer to ou targets, et exactement l'un des deux

Pages connexes

• Redirections d'URL — retirer une URL sans casser les liens entrants
• Analytique — le magasin de clics, ses réglages et sa conservation
• Tableau de bord d'administration — où vivent les rapports de liens