Ce que fait le mappage en masse
Alva Digital Downloads lie les fichiers déjà présents dans le stockage à des produits Shopify à partir d'un seul CSV. Ouvrez la page Produits et cliquez sur l'action secondaire Bulk Product-File Mapping. L'écran n'est disponible que sur les forfaits payants — il est désactivé sur le forfait gratuit.
Ce dont le CSV a besoin
Le parseur lit la ligne d'en-tête et fait correspondre les colonnes par nom, sans tenir compte de la casse. Il requiert une colonne PRODUCT_ID et au moins une colonne FILE_1 ou LINK_1. Les colonnes de variante sont facultatives. L'ordre des colonnes n'a pas d'importance, et vous pouvez ajouter autant de colonnes FILE_, LINK_ et VARIANT_ que nécessaire.
- PRODUCT_ID — l'ID du produit Shopify. Utilisez le numéro brut (
1234567890) ou la forme complètegid://shopify/Product/1234567890. - FILE_1, FILE_2, … — chacune contient le titre d'un fichier dans le stockage Alva, éventuellement préfixé par
@(le@est retiré). - VARIANT_1, VARIANT_2, … — IDs de variante Shopify facultatifs. Laissez-les vides pour mapper sur la variante par défaut de l'ensemble du produit.
- LINK_1, LINK_2, … — chacune contient le titre d'un lien enregistré, avec le même préfixe
@facultatif. Les titres de liens doivent être uniques : si deux de vos liens portent le même titre, la ligne est rejetée plutôt que de deviner lequel vous vouliez.
Chaque ligne a besoin d'au moins un fichier ou un lien. Une ligne peut ne porter que des colonnes LINK_, ce qui crée un produit uniquement en liens, sans aucun fichier rattaché — exactement ce que vous obtenez avec le sélecteur Links sur un produit individuel.
Comment mapper des fichiers en masse
1. Ouvrez l'écran de mappage en masse
Sur la page Produits, cliquez sur Bulk Product-File Mapping. La page s'ouvre avec une carte d'instructions — incluant un exemple de CSV travaillé — et un outil de téléversement par glisser-déposer. Il n'y a pas de modèle téléchargeable ; copiez la disposition de l'exemple dans votre feuille de calcul.
2. Construisez et enregistrez le CSV
Mettez un produit par ligne. Remplissez PRODUCT_ID avec l'ID Shopify et chaque colonne FILE_ avec un titre de fichier. Une ligne brute 123456789,,,,@User Manual,, mappe un fichier sur la variante par défaut d'un produit ; laisser les colonnes de fichier vides et remplir LINK_1 à la place mappe un lien seul. Enregistrez la feuille au format .csv.
La table d'aperçu Bulk Product-File Mapping après un téléversement de CSV. Montrer les cinq colonnes — File, Links, Product, Variants, Status — avec 3 à 4 lignes d'exemple : badges verts « success », une ligne rouge « error », une ligne uniquement en liens avec un tiret cadratin dans la colonne File, et un produit portant un badge « Existing ». Utiliser des noms de produits fictifs, aucune donnée client réelle.
3. Téléversez et examinez l'aperçu
Déposez le fichier dans l'outil de téléversement. Alva vérifie chaque titre de fichier dans le stockage et valide les IDs de produit et de variante face à Shopify. L'aperçu liste chaque ligne avec un badge Status — success, error ou pending — et signale les produits qui ont déjà des mappages avec un badge Existing.
4. Traitez les mappages
Cliquez sur Process CSV. Les lignes valides sont enregistrées comme mappages de produits et les lignes en erreur sont ignorées. Si plus de 30 % des lignes sont invalides, Alva bloque l'exécution. En dessous de ce seuil, une boîte de dialogue de confirmation vous indique combien de lignes seront ignorées avant de poursuivre.
5. Vérifiez la couverture
Après une exécution réussie, cliquez sur View Products pour revenir à la liste des produits. Chaque produit affiche son nombre de pièces jointes, vous pouvez donc repérer tout produit affichant encore zéro fichier. Corrigez ces lignes et relancez-les avec Retry failed mappings.
Questions fréquentes
Ouvrez le produit dans l'admin Shopify et copiez l'ID numérique à la fin de l'URL, comme 1234567890. Alva accepte ce numéro brut ou la forme complète gid://shopify/Product/1234567890 dans la colonne PRODUCT_ID.
Non. L'écran de mappage en masse affiche un exemple de CSV travaillé à l'intérieur de la carte d'instructions. Copiez cette disposition dans votre feuille de calcul — une colonne PRODUCT_ID plus des colonnes FILE_1, FILE_2 et LINK_1 — plutôt que de télécharger un fichier modèle.
Par le titre du fichier dans le stockage Alva, sans tenir compte de la casse. Vous pouvez préfixer le titre par un symbole @, qu'Alva retire. Le fichier doit déjà être téléversé — le mappage en masse lie des fichiers existants, il ne les téléverse pas.
Les lignes en erreur sont ignorées et les lignes valides sont quand même enregistrées. Si plus de 30 pour cent des lignes sont invalides, Alva bloque toute l'exécution. En dessous, une fenêtre de confirmation vous avertit quelles lignes seront ignorées avant le traitement.
Ajoutez des colonnes VARIANT_1, VARIANT_2 et mettez un ID de variante Shopify dans chacune. Les lignes sans colonne de variante se mappent sur la variante par défaut et s'appliquent à l'ensemble du produit. Il n'y a aucune limite au nombre de colonnes de variante.
Voir aussi
Cet article vous a-t-il été utile ?
Dernière mise à jour 2026-06-01