INTERMÉDIAIRE

Docs

Liens de campagne et sub-IDs

Une campagne vit rarement à un seul endroit - elle passe par une newsletter, deux ou trois partenaires, peut-être un prospectus imprimé. Ce guide câble ces emplacements pour que chaque source réponde d’elle-même : combien de clics, combien d’humains parmi eux, et quand la campagne doit s’arrêter.

Une campagne, plusieurs emplacements

La question inconfortable de tout achat de trafic n’est pas « combien de clics avons-nous eus » - c’est « lesquels de ces clics étaient des personnes, et qui a envoyé le reste ». Un total unique ne peut pas y répondre : la newsletter, les partenaires et le prospectus se déversent dans le même chiffre, et la pire source se cache derrière la meilleure.

Kilo y répond avec trois pièces qui travaillent ensemble. Une campagne groupe les liens et porte les contrôles partagés - une fenêtre de temps, un objectif de scans, un seul endroit pour tout terminer. Les sub-IDs étiquettent chaque emplacement pour qu’il rapporte séparément. Et la classification de qualité des clics étiquette chaque clic au moment où il se produit - centre de données, VPN ou proxy, humain probable - pour que la répartition de chaque source tienne debout toute seule.

Créez la campagne

Dans le tableau de bord, ouvrez Campagnes et choisissez Nouvelle campagne. Trois décisions font l’essentiel du travail :

  • La fenêtre. Un début et une fin optionnels. Hors de la fenêtre, les liens cessent de renvoyer vers leurs destinations normales et prennent la fin que vous avez choisie.
  • L’objectif de scans. Fixez un nombre et choisissez ce qu’il signifie : suivre comme objectif ne montre que la progression - les liens continuent de fonctionner au-delà - tandis que s’arrêter à l’objectif ferme la campagne automatiquement dès que les ouvertures humaines atteignent le nombre, vérifié toutes les quelques minutes.
  • La fin. Quand la campagne est terminée, les liens peuvent reprendre leurs propres destinations, envoyer les visiteurs vers une URL de fin de campagne - ou une page de marque « terminée » si vous n’en avez pas fixé - ou renvoyer un 410 permanent.

Deux détails sont délibérés. Le plafond ne compte que les ouvertures humaines - le même chiffre que montre le titre de l’analyse - si bien que le trafic de bots ne peut jamais fermer votre campagne en avance. Et une URL de fin de campagne posée sur la campagne l’emporte sur le repli propre de chaque lien, de sorte qu’un seul champ re-pointe toute la fin. Vous pouvez aussi fermer ou rouvrir une campagne à la main à tout moment. L’objectif de scans comme simple but est gratuit sur toutes les offres ; l’application du plafond, l’URL de fin de campagne et la fermeture manuelle font partie des contrôles de campagne payants.

Étiquetez chaque emplacement avec un sub-ID

Les sub-IDs ne demandent aucune configuration. Prenez le lien de la campagne et donnez à chaque emplacement sa propre variante étiquetée - le même lien avec un paramètre de requête en plus :

One link, three placements
https://qr2r.com/aA3k9?sub_id=newsletter
https://qr2r.com/aA3k9?sub_id=partner-42
https://qr2r.com/aA3k9?s1=flyer-april

Kilo capture l’étiquette au moment de la redirection, et l’analyse gagne une ligne par valeur. Les noms de paramètres sont ceux que les plateformes publicitaires émettent déjà - subid, sub_id, s1 à s5, aff_sub à aff_sub5 - si bien que le trafic arrivant d’un réseau d’affiliation est souvent étiqueté avant que vous n’ayez rien fait. Une étiquette est conservée par clic, les valeurs sont plafonnées à 80 caractères, et les clics non étiquetés comptent partout ailleurs - ils n’ont simplement pas de ligne de source.

Ou pilotez tout via l’API

Le même montage tient en deux appels avec une clé en écriture. Créez la campagne - les horodatages sont en millisecondes epoch :

POST /api/groups
curl https://qr2r.com/api/groups \
  -H "Authorization: Bearer $KILO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Spring launch",
    "ends_at": 1735689600000,
    "target_scans": 10000,
    "enforce_target_scans": true,
    "campaign_fallback_url": "https://example.com/spring-recap"
  }'

Créez ensuite le lien de chaque emplacement à l’intérieur. Sur une offre avec filtrage du trafic, vous pouvez aussi activer le blocage du lien dès la création :

POST /api/links
curl https://qr2r.com/api/links \
  -H "Authorization: Bearer $KILO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "default_target": "https://example.com/spring",
    "name": "Spring - newsletter",
    "group_id": 51,
    "traffic_filter_enabled": true
  }'

Les barrières correspondent exactement au tableau de bord : enforce_target_scans et campaign_fallback_url demandent les contrôles de campagne payants, et traffic_filter_enabled demande une offre qui porte le filtrage du trafic - une requête au-delà de votre offre est refusée avec 402 plan_required, jamais dégradée en silence. Fixer target_scans seul, comme objectif, est gratuit sur toutes les offres.

Lisez la répartition, puis agissez

Quand le trafic arrive, ouvrez l’analyse du lien - ou de la campagne entière. Le panneau Qualité des clics montre la répartition centre de données / VPN-ou-proxy / humain-probable, et en dessous le tableau des sources de trafic par sub-ID donne à chaque emplacement sa propre ligne : clics et qualité, côte à côte. Un coup d’œil vous dit que la newsletter est presque entièrement des personnes tandis que partner-42 est aux deux tiers du centre de données.

Puis agissez. Mettez en pause le mauvais emplacement, apportez sa ligne dans la conversation sur la facture, déplacez la dépense vers les sources qui envoient des humains. Si une source persiste à envoyer des machines, vous pouvez activer Filtrer le trafic de bots et de centres de données sur ce lien - désactivé par défaut, opt-in par lien, sur les offres qui le portent. Une fois activé, les réseaux de centres de données connus et les bots déclarés reçoivent une page « vérifiez que vous êtes humain » au lieu de votre destination, et les visites bloquées restent comptées, pour que vous voyiez exactement ce qui a été refusé.

Limites honnêtes

Le blocage couvre ce qui peut être prouvé : les réseaux de centres de données et les bots déclarés. Le trafic VPN et proxy est étiqueté mais jamais bloqué - une bonne partie, ce sont des gens ordinaires qui protègent leur vie privée - et un bot qui imite assez bien un navigateur normal peut échapper à la classification. Le guide de la qualité des clics couvre ce que signifient les étiquettes et où sont leurs limites.

Voilà la boucle : groupez les liens, étiquetez les emplacements, lisez la répartition de chaque source et laissez la campagne se terminer d’elle-même à l’objectif. Chaque chiffre en provient de la même analyse agrégée que le reste de Kilo - construite sans jamais stocker d’IP brute.

Ouvrir vos campagnes
SuivantRouter par paysImprimez un code et envoyez chaque marché vers sa propre page - dans le tableau de bord ou en deux appels d’API.Lire le guide