Aller au contenu principal
— Tutoriel de configuration

Exporter vos données vers Google Sheets

Alva Digital Downloads exporte vos commandes, votre activité de téléchargement et votre catalogue de produits sous forme de fichiers CSV qui s'ouvrent dans Google Sheets. Pour la nouvelle activité, un workflow Shopify Flow que vous construisez vous-même ajoute une ligne à votre feuille chaque fois qu'un fichier est téléchargé ou qu'un achat est livré. Tous les exports fonctionnent sur toutes les formules.

Fonctionnement

Alva Digital Downloads n'a aucune connexion directe à Google. Ses exports CSV couvrent votre historique, et un workflow Shopify Flow que vous construisez ajoute une ligne pour chaque nouveau téléchargement ou livraison. Un CSV est un instantané : exportez à nouveau pour obtenir des chiffres à jour.

Ouvrir un export dans Google Sheets

1. Exportez le CSV

Dans l'admin Alva, cliquez sur un export en haut de la page. Les dates sont au format dd-MM-yyyy HH:mm dans le fuseau horaire de votre boutique.

  • Commandes → Exporter les Commandes : une ligne par achat, avec le client, le produit, le statut d'accès et les clés de licence.
  • Commandes → Exporter l'activité de téléchargement : une ligne par visite de la page de téléchargement ou clic sur un bouton. Dans la boîte de dialogue, les jours Du et Au, facultatifs et dans le fuseau horaire de votre boutique, limitent la plage ; cliquez sur Exporter.
  • Produits → Exporter le catalogue : une ligne par fichier, pack, lien ou pool de clés de licence sur chaque produit.
Capture d'écran nécessaire

Page Commandes d'Alva avec la boîte de dialogue Exporter l'activité de téléchargement ouverte : les champs de date Du et Au remplis avec des dates d'exemple et le bouton Exporter. Garder visible derrière elle l'en-tête de page avec Exporter les Commandes et Exporter l'activité de téléchargement. Aucune donnée client réelle visible.

Les actions d'export sur la page Commandes.

2. Importez-le dans Google Sheets

Choisissez Fichier → Importer → onglet Importer et sélectionnez le CSV. Réglez Emplacement d'importation sur Remplacer la feuille de calcul, ou sur Insérer une ou plusieurs nouvelles feuilles pour conserver vos autres onglets, et Type de séparateur sur Virgule. Cliquez sur Importer les données. Ouvrir le CSV depuis Google Drive fonctionne aussi.

Capture d'écran nécessaire

Boîte de dialogue Importer le fichier de Google Sheets après le choix d'un CSV Alva : Emplacement d'importation réglé sur Remplacer la feuille de calcul, Type de séparateur réglé sur Virgule. Nom de fichier d'exemple uniquement.

Les paramètres d'importation de Google Sheets.

3. Vérifiez les dates

Si le jour et le mois semblent inversés, ou si les dates restent du texte, choisissez des paramètres régionaux où le jour vient en premier, comme France ou Royaume-Uni, dans Fichier → Paramètres, puis importez à nouveau.

Contenu de l'export d'activité de téléchargement

Colonnes (en anglais) : Date, Event, Customer Email, Customer Name, Order Number, IP Address, User Agent et Source. Event vaut Download page opened (une visite de la page de téléchargement) ou File downloaded (un clic sur un bouton de fichier ou de ZIP sur la page de remerciement, la page de statut de commande, le compte client ou la page de téléchargement). Les lignes plus anciennes peuvent aussi indiquer Admin download : vous-même téléchargeant votre propre fichier depuis l'admin Alva, ce qu'Alva n'enregistre plus.

Une ligne est une visite ou un clic, pas un nombre de téléchargements : n'additionnez pas les lignes pour compter les téléchargements.

Contenu de l'export du catalogue

Une ligne par élément de livraison sur chaque produit. Un produit personnalisé (sur commande) reçoit une ligne personalized plus une ligne pour chaque lien qui lui est rattaché ; ses pools de clés de licence ne sont pas listés, car les achats personnalisés ne reçoivent pas de clés. Un produit sans rien de rattaché reçoit une ligne. Les URL des liens ne sont jamais exportées.

  • Product title, Variant titles, Shopify product ID, Shopify variant IDs et Mapping active (en-têtes en anglais). Les titres de produit proviennent de Shopify ; si Shopify est occupé ou si le produit a été supprimé, l'export utilise le dernier titre vu par Alva, ou Unknown product.
  • Item type, Item name, File size (bytes) (un pack affiche le total de ses fichiers) et Content type.
  • Buyers with access : clients distincts dont l'accès est actif, y compris les commandes encore en vérification anti-fraude.
  • Product downloads : clics sur les boutons de téléchargement du produit, répétés sur chacune de ses lignes, pas par fichier. Réinitialiser les limites de téléchargement d'un client fait baisser ce nombre, et les téléchargements effectués depuis la page de remerciement avant la fin de la synchronisation de la commande ne sont pas comptés.

Variant titles liste les variantes pour lesquelles un élément est livré, ou indique (en anglais) :

  • All variants : toutes les variantes du produit.
  • All other variants : toutes les variantes qu'un autre mapping du même produit ne liste pas.
  • No variants (another mapping takes priority) : ce mapping ne livre aucune variante, car un autre mapping du produit l'emporte.
  • Conflict (more than one mapping covers the same variants) : deux mappings ou plus se disputent les mêmes variantes.
  • Blue (conflict) : un autre mapping du produit revendique aussi cette variante, et la cellule commence alors par le libellé Conflict.
  • All other variants; plus: Green : le libellé, puis les variantes que ce mapping liste également. Les parties sont séparées par des points-virgules.

Ajouter automatiquement les nouvelles lignes avec Shopify Flow

Construisez le workflow vous-même dans Shopify Flow : le déclencheur Fichier numérique téléchargé ou Achat numérique livré d'Alva, suivi de l'action Google Sheets Ajouter une ligne à la feuille de calcul. Colonnes suggérées pour les téléchargements : Date, Commande, E-mail client, Produit, Fichier. Pour les livraisons : Date, Commande, E-mail client, Produits, Fichiers (nombre de fichiers).

Fichier est le fichier sur lequel le client a cliqué, ou Multiple files pour un ZIP ou un bouton multi-fichiers, ou Unknown file lorsque le produit n'a aucun fichier. Produits affiche le nom de livraison du ZIP (ou un nom généré), pas le titre du produit Shopify, sauf pour les produits à clés de licence uniquement, qui affichent le titre du produit.

1. Préparez la feuille

Créez d'abord l'onglet, avec une ligne d'en-tête pour vos colonnes, en commençant à la colonne A.

2. Ajoutez le déclencheur et l'action

Dans Shopify Flow, cliquez sur Créer un workflow. Choisissez le déclencheur Fichier numérique téléchargé ou Achat numérique livré d'Alva, puis ajoutez l'action Google Sheets Ajouter une ligne à la feuille de calcul.

3. Connectez Google Sheets dans Flow

Lorsque Flow vous le demande, connectez-vous à votre propre compte Google et autorisez-le à modifier les feuilles de calcul. Alva ne voit jamais ce compte.

4. Remplissez l'action et activez-la

Collez l'URL de la feuille de calcul et saisissez exactement le Nom de l'onglet. Dans Contenu de la ligne (séparé par des virgules), collez la ligne correspondant à votre workflow, sur une seule ligne. Chaque valeur remplit une colonne dans l'ordre de votre ligne d'en-tête, et les virgules sont retirées des valeurs textuelles pour qu'elles ne puissent pas scinder une colonne.

Workflow téléchargements (Date, Commande, E-mail client, Produit, Fichier) :

{{ "now" | date: "%Y-%m-%d %H:%M" }},{{ order.name | replace: ",", " " }},{{ order.email | replace: ",", " " }},{{ product.title | replace: ",", " " }},{{ fileName | replace: ",", " " }}

Workflow livraisons (Date, Commande, E-mail client, Produits, Fichiers) :

{{ "now" | date: "%Y-%m-%d %H:%M" }},{{ order.name | replace: ",", " " }},{{ order.email | replace: ",", " " }},{{ productNames | replace: ",", ";" }},{{ totalFiles | round }}

E-mail client utilise order.email car une commande invité n'a pas de client. Si une valeur commençant par = apparaît comme une formule dans votre feuille, ajoutez | prepend: "'" aux valeurs textuelles, jamais à Date ni à Fichiers. Cliquez sur Activer le workflow.

Capture d'écran nécessaire

Éditeur Shopify Flow : le déclencheur Fichier numérique téléchargé d'Alva connecté à l'action Google Sheets Ajouter une ligne à la feuille de calcul. Afficher les champs URL de la feuille de calcul, Nom de l'onglet et Contenu de la ligne remplis avec des valeurs d'exemple. Aucune donnée client réelle visible.

L'action Google Sheets dans un workflow téléchargements.

Ce que voient vos clients

Rien ne change pour les clients, mais vos feuilles contiennent leurs données personnelles : noms, e-mails et, dans l'export d'activité, adresses IP et navigateurs. Ne les partagez qu'avec les personnes qui en ont besoin.

Limitations

  • Vers l'avant uniquement. Pas de rattrapage : utilisez les CSV pour tout ce qui précède l'activation du workflow, ou s'est produit pendant qu'il était désactivé.
  • Ajout uniquement. Un remboursement ou un accès révoqué ne supprime pas de ligne.
  • Pas de cellules vides en début de ligne. Sheets écrit chaque ligne à partir de la première colonne ayant du contenu.
  • Limites de débit Google. Environ 60 écritures par minute et par compte : une boutique très active peut donc voir des erreurs dans l'historique d'exécution de Flow. Ces lignes peuvent manquer ; les CSV les contiennent.
  • Les renvois ajoutent des lignes ; certaines ventes n'en ajoutent aucune. Un workflow livraisons ajoute une ligne pour chaque e-mail de téléchargement envoyé avec succès, donc en renvoyer un depuis la page de commande, la page de renvoi du client ou Sidekick ajoute une autre ligne pour cette commande. Les produits personnalisés (sur commande), et les commandes dont l'e-mail de téléchargement n'est pas envoyé (e-mails désactivés ou envoi échoué), n'ajoutent aucune ligne de livraison. Les ventes en magasin via le POS sans compte client n'ajoutent aucune ligne du tout.

Dépannage

Symptôme Cause probable Solution
Exporter l'activité de téléchargement affiche « Aucune activité de téléchargement à exporter » Aucune visite ni aucun clic ne tombe entre vos jours Du et Au ou, sans dates définies, il n'y a pas encore d'activité. Élargissez la plage, ou laissez les deux dates vides pour exporter toute l'activité.
Flow affiche une erreur 403 à l'étape Google Sheets Le compte Google connecté dans Flow ne peut pas modifier la feuille. Donnez à ce compte un accès en modification, ou reconnectez-le et autorisez les modifications.
Les lignes atterrissent dans les mauvaises colonnes Des cellules vides en début de ligne, ou une virgule dans une valeur : chaque virgule démarre une colonne. Supprimez les cellules vides, et ajoutez | replace: ",", " " aux valeurs textuelles dans Contenu de la ligne.
Les téléchargements du catalogue ne correspondent pas à l'export d'activité Les lignes d'activité sont des visites et des clics ; Product downloads compte les clics et baisse après une réinitialisation. Comparez uniquement avec les lignes File downloaded.

Questions fréquentes

Alva Digital Downloads se synchronise-t-il automatiquement avec Google Sheets ?

Pas directement. Alva n'a pas de connexion Google propre. Utilisez les exports CSV pour votre historique, et un workflow Shopify Flow que vous construisez vous-même pour les nouveaux téléchargements et livraisons.

Ai-je besoin d'une formule payante pour exporter mes données ?

Non. Les trois exports et les déclencheurs Flow d'Alva fonctionnent sur toutes les formules Alva Digital Downloads, y compris Free.

Pourquoi l'export d'activité contient-il plus de lignes que je n'ai de téléchargements ?

Chaque ligne est une visite de la page de téléchargement ou un clic sur un bouton de téléchargement, donc un même acheteur peut générer plusieurs lignes. Filtrez Event sur File downloaded pour compter les clics.

L'export du catalogue inclut-il les URL des liens ou les clés de licence ?

Non. Les liens et les pools de clés de licence n'apparaissent que par leur nom. Les clés attribuées à chaque commande se trouvent dans l'export des commandes.

Voir aussi

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

Toujours bloqué ? Écrivez-nous.

Dernière mise à jour 2026-10-29