Aller au contenu principal
— Guide de configuration

Étiqueter les clés de licence pour limiter quels produits y accèdent

Les tags de clés de licence sont des compartiments dans Alva Digital Downloads. Lorsqu'un client achète un produit étiqueté, Alva réclame la prochaine clé disponible dans le pool de ce tag, pas dans le pool global. Les tags permettent aux marchands de séparer les clés Pro des clés Lite ou de cadrer les clés par région sans avoir à choisir une clé par commande.

Comment fonctionnent les tags

Chaque clé de licence appartient à un ou plusieurs tags via la table de jointure LicenseKeyTagMap. Chaque produit Shopify s'attache à un ou plusieurs tags via ProductLicenseKeyTagMap. Les produits ne sont jamais liés à des clés individuelles — uniquement à des tags.

Lors d'une commande payée, Alva parcourt les tags attachés au produit et réclame la clé disponible la plus ancienne dans chaque pool (FIFO par createdAt). Si un tag est vide, la commande entre dans PendingLicenseKeyAssignment et attend ; les nouvelles clés sont attribuées aux commandes en attente dans l'ordre de la file.

Créer un tag et y lier des clés

1. Ouvrez la page Clés de licence

Dans l'admin Alva, cliquez sur Clés de licence dans la navigation latérale. Les tags existants apparaissent avec leur nombre disponible.

2. Ajoutez un tag

Cliquez sur Ajouter des clés de licence. Saisissez un nom de tag — minuscules, alphanumérique, traits d'union uniquement (par exemple pro-plugin ou eu-region). Enregistrez.

Capture d'écran nécessaire

Page Clés de licence de l'admin Alva. Afficher 3 tags (« pro-plugin », « lite-plugin », « eu-region ») avec leurs comptes Disponible. Mettre en évidence le bouton « Ajouter des clés de licence ». Aucune donnée client réelle.

La page Clés de licence liste chaque tag et son nombre disponible.

3. Importez des clés dans le tag

Ouvrez le tag et cliquez sur Importer. Importez un CSV, collez des clés manuellement, ou activez Génération automatique pour des codes UUID, ULID ou alphanumériques à la demande. Alva enregistre les clés uniquement dans le pool de ce tag.

Mapper des produits à un tag

1. Ouvrez le mapping du produit

Allez dans Produits dans l'admin Alva et ouvrez le produit qui doit puiser dans ce pool.

2. Choisissez Clés de licence

Faites défiler jusqu'à la section Clés de licence sur la page de mapping et cliquez sur Ajouter des clés de licence.

3. Sélectionnez le tag et enregistrez

Choisissez le tag dans la liste et enregistrez. À partir de la prochaine commande payée, Alva réclame une clé du pool de ce tag par produit correspondant.

Capture d'écran nécessaire

Page de mapping produit de l'admin Alva. Afficher la section Clés de licence avec un tag attaché (« pro-plugin · 47 disponibles ») et un second tag en dessous (« eu-region · 12 disponibles »). Mettre en évidence le bouton « Ajouter des clés de licence » utilisé pour attacher d'autres tags. Aucune donnée client réelle visible.

Un mapping de produit avec deux tags attachés — Alva réclame une clé de chaque pool par commande.

What customers see

Comme pour une clé de licence normale. Après l'approbation anti-fraude, l'e-mail de livraison contient une clé valide du bon pool, et la même clé apparaît sur la page des téléchargements du compte client. Les clients ne voient jamais le nom du tag.

Bonnes pratiques

Utilisez un tag par formule tarifaire (pro, lite, trial) ou par région (na, eu, apac). Évitez les tags génériques fourre-tout — ils annulent le cadrage. Combinez les tags avec les alertes de stock faible pour qu'un pool Pro épuisé ne fasse pas silencieusement passer les commandes dans la file d'attente pendant que le pool Lite reste plein.

Questions fréquentes

Un même produit peut-il puiser dans plus d'un tag ?

Oui. Attachez deux tags ou plus sous Clés de licence sur la page de mapping du produit et Alva réclame une clé de chaque tag par commande payée. Utile lorsqu'un produit est livré avec à la fois une licence d'application et une licence de plugin distincte.

La même clé de licence peut-elle vivre dans deux tags différents ?

Oui. Chaque clé de licence peut être liée à plusieurs tags via la table de jointure LicenseKeyTagMap. Dès qu'un produit réclame la clé, elle passe au statut ASSIGNED et disparaît de tous les pools dans lesquels elle se trouvait.

Puis-je déplacer des clés entre tags ultérieurement ?

Oui. Ouvrez le tag source, sélectionnez les clés et utilisez Déplacer vers un tag. Les clés déjà attribuées à un client restent attachées à cette commande, peu importe où vivent les clés inutilisées.

Voir aussi

Cet article vous a-t-il été utile ?

Toujours bloqué ? Écrivez-nous.

Dernière mise à jour 2026-05-06