Router par pays

Disons que le même emballage part vers l’Allemagne, l’Autriche et le reste du monde. Un scan allemand devrait atterrir sur la boutique allemande ; tous les autres appartiennent à la page internationale. Imprimer un code QR différent par marché multiplie vos tirages - et une boîte mal étiquetée envoie la mauvaise audience vers la mauvaise page pour toute la vie de cette boîte.

Un lien Kilo dissout le problème, parce que le code n’encode jamais votre destination - il encode le lien, et le lien décide. Les règles géo sont évaluées à la périphérie, dans la même redirection d’environ 50 millisecondes qui fait suivre le visiteur, si bien que personne n’attend pendant que la décision se prend. Et comme les règles vivent sur le lien plutôt que sur le papier, vous pouvez ajouter des marchés, les fusionner ou en re-pointer n’importe lequel des années après l’impression. Imprimez une fois ; re-pointez pour toujours.

Toute la configuration tient en un lien et une règle par marché. Dans le tableau de bord :

• Créez le lien avec votre page internationale comme destination. Cette destination par défaut est le filet de sécurité - chaque visiteur qu’aucune règle n’attrape atterrit là, alors faites-en une page qui fonctionne pour tout le monde.
• Ouvrez les règles de routage du lien et choisissez Ajouter une règle.
• Ajoutez une règle géo par marché : choisissez le pays - ou plusieurs pays qui partagent une destination - et fixez l’URL que ces visiteurs doivent recevoir. Une règle géo peut aussi cibler une région ou une ville quand un pays entier est trop grossier.

Les règles s’évaluent dans un ordre fixe - la première correspondance l’emporte, géo avant appareil et A/B, la destination par défaut attrapant tous les autres - et une modification prend effet au scan suivant. La mécanique, y compris la façon dont les règles s’empilent, est dans le guide des règles de routage. Une note honnête avant de construire : les règles de ciblage sont une fonctionnalité payante, appliquée à l’API comme dans le tableau de bord.

Kilo est API-first - le tableau de bord que vous venez d’utiliser est un client de la même API HTTP. Le montage de l’affiche imprimée tient en deux appels avec une clé en écriture. D’abord, créez le lien avec la destination mondiale par défaut :

curl https://qr2r.com/api/links \
  -H "Authorization: Bearer $KILO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "default_target": "https://example.com/global", "name": "Trade-fair poster" }'

La réponse porte le slug permanent du lien. Attachez ensuite une règle géo par marché - les pays sont des codes ISO-2, et la création renvoie 201 avec la règle stockée :

curl https://qr2r.com/api/links/aA3k9/rules \
  -H "Authorization: Bearer $KILO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "type": "geo", "condition": { "countries": ["DE", "AT"] }, "target_url": "https://example.com/de" }'

Répétez le second appel pour chaque marché, et utilisez PUT /api/links/aA3k9 chaque fois qu’une destination déménage - le code imprimé ne change jamais. Le parcours complet des endpoints, y compris lister, réordonner et supprimer des règles, est dans analyse et règles via l’API. Comme le tableau de bord, l’API applique la barrière d’offre : une règle géo sur une offre sans règles de ciblage est refusée avec 402, jamais acceptée en silence.

Ouvrez l’analyse du lien et lisez la ventilation par pays contre vos règles. Si l’affiche est accrochée à Vienne mais qu’un tiers des scans ne vient ni d’Allemagne ni d’Autriche, soit l’histoire de l’emplacement est plus grande que vous ne le pensiez, soit le trafic n’est pas ce qu’il semble - deux choses qui valent d’être sues avant le prochain tirage.

Pour un code imprimé, il existe un outil plus affûté : épinglez l’emplacement du lien - le pays ou la région où le code vit physiquement - et le panneau géo ajoute une ligne dans-la-zone / hors-zone, comptée uniquement sur le trafic classé humain. Elle répond à la question de l’adéquation d’un coup d’œil : les scans viennent-ils de là où le papier se trouve vraiment ?