Importer des titres et produits
Importez ou mettez à jour en masse des produits avec ISBN, métadonnées et détails de publication via téléversement CSV.
Cette page vous guidera à travers les étapes pour importer vos titres, que ce soit pour importer de nouveaux produits ou importer des mises à jour de produits existants.
Si vous souhaitez ajouter seulement un ou deux nouveaux titres, vous préférerez peut-être le faire via l’interface utilisateur. Cependant, si vous cherchez à importer des titres et des données en masse, vous êtes au bon endroit.
Veuillez noter que les produits sont des éditions spécifiques d’un titre. Par exemple, un titre peut s’appeler « Mon livre » et avoir plusieurs formats : broché, cartonné, ebook et livre audio. Chacune de ces éditions/formats est connue dans Royalties HQ comme un produit, et chacun aura son propre identifiant de produit (par exemple ISBN).
Les produits peuvent être importés en masse en utilisant la fonction de téléversement CSV. Un modèle est disponible en téléchargement depuis la page Ayants droit > Importer.
Télécharger le modèle d’importation de titres
- Allez dans le menu principal, en haut à gauche, et cliquez sur Titres, puis Produits.
- Sur la page de liste des Produits, cliquez sur le bouton Importer.
- Sous « Qu’est-ce que vous téléversez ? », choisissez « Produits ».
- En dessous, cliquez sur « Télécharger le fichier modèle Produits ».
- Le fichier modèle CSV sera téléchargé sur votre appareil.
Formater vos données de titres
- Ouvrez le modèle CSV d’importation de Produits téléchargé à l’étape précédente (voir ci-dessus) – nous recommandons d’utiliser Google Sheets.
- Chaque ligne est un produit (dans Royalties HQ, un titre est le « parent » et il peut avoir plusieurs formats – nous les appelons des produits).
- Chaque produit doit avoir au moins un identifiant de produit tel que ISBN, ASIN, ou autre identifiant de produit (et ceux-ci doivent être uniques).
- Tous les autres champs sont optionnels.
- Lorsque vos données sont prêtes, enregistrez au format CSV. Dans Google Sheets, c’est Fichier > Télécharger > CSV.
Lors du formatage de vos données, vous devez respecter ces exigences :
- Vous devez formater les nombres en tant que texte
- Les dates doivent être dans ce format : AAAA-MM-JJ (par exemple « 30 décembre 2020 » doit être saisi comme « 2020-12-30 »)
- Le type de calcul de palier (colonne tier-type) doit être soit units-sold soit total-net-receipts (Plus d’informations sur les paliers et le type de calcul de palier ici).
| Nom de colonne | Description | Obligatoire | Format/Valeurs |
|---|---|---|---|
| name | Titre complet du livre | Oui | Chaîne de texte |
| title-code | Identifiant unique pour le titre (enregistrement parent) | Oui | Alphanumérique (par ex. T000047). Doit faire 7 caractères. Sera créé automatiquement si laissé vide. |
| royalty-period-start-month | Mois de début pour les calculs de redevances | Oui | Un mois soit écrit en entier soit abrégé (par ex. « Jan » ou « Janvier ») |
| royalty-period-length | Durée de la période de redevances | Oui | monthly, two-monthly, quarterly, six-monthly, annual |
| product-type | Type de format de cette édition | Oui | softcover, hardcover, ebook, audiobook, wire-bound |
| status | Statut de publication | Oui | active, inactive, withdrawn |
| imprint | Nom du label de l’éditeur | Non | Chaîne de texte |
| isbn | ISBN-13 pour les formats physiques | Conditionnel* | ISBN à 13 chiffres sans tirets |
| asin | Amazon Standard Identification Number | Conditionnel* | 10 caractères alphanumériques |
| number-pages | Nombre de pages pour les livres physiques | Non | Entier (par ex. 300) |
| legacy-units-sold | Unités vendues historiques avant d’utiliser Royalties HQ | Non | Entier (par ex. 250) |
| legacy-earned-royalties | Redevances gagnées historiques avant d’utiliser Royalties HQ | Non | Décimal (par ex. 16.95) |
| date-first-published | Date de première publication | Non | Format AAAA-MM-JJ |
| date-withdrawn | Date de retrait du format de la vente | Non | Format AAAA-MM-JJ |
*Au moins un identifiant de produit (ISBN, ASIN, ou autre) est requis pour chaque produit
Autres données
Codes titre
- Sur Royalties HQ, chaque titre reçoit un identifiant unique – un code titre. Remarque : un titre n’est PAS un ISBN.
- Tous les formats du même livre partagent le même code titre.
- Un code titre sera généré automatiquement lorsque vous créez un nouveau titre – que ce soit via l’interface utilisateur ou via l’importation. Vous pouvez spécifier un code titre à l’importation. C’est important pour regrouper les produits sous un même titre. Par exemple, si vous importez une nouvelle édition d’un titre, vous devriez l’importer avec le code titre correspondant.
- Si vous ne spécifiez pas de code titre à l’importation, tout nouveau produit sera généré sous de nouveaux titres.
Ayants droit
- Doivent correspondre aux codes d’ayants droit existants dans Royalties HQ.
- Importez d’abord les ayants droit s’ils n’existent pas encore dans Royalties HQ.
- Laissez vide si aucun ayant droit n’est encore assigné.
Données historiques
- Optionnel.
- Utilisez les champs historiques pour enregistrer les ventes passées avant que vous n’utilisiez Royalties HQ.
- Ces montants sont essentiels lorsqu’un contrat utilise le total des unités vendues pour déterminer le taux de redevances actuel d’un ayant droit pour un produit (ISBN).
Identifiants de produit supplémentaires
- Les Identifiants de produit supplémentaires incluent ACX, Google Play, et plus – ce sont des champs optionnels pour stocker des identifiants de produit alternatifs
- Utilisez-les pour les codes propriétaires, SKU internes, ou identifiants personnalisés qui ne sont pas des ISBN ou ASIN
- Les identifiants de produit doivent être uniques pour tous les produits
- Ce champ est utile pour suivre les titres dans plusieurs systèmes
Langue
- Langue est un champ optionnel pour indiquer la langue du produit
- Utilisez les codes à trois lettres ISO 639-3 (par ex. « fra » pour français, « deu » pour allemand, etc.), ou des libellés en anglais (« French », « German », etc.)
- Laissez vide si non applicable ou si la langue n’est pas pertinente
- Ceci peut être automatiquement rempli via la récupération des métadonnées Google Books pour les nouveaux produits
Support des formats de mois et période
royalty-period-start-month prend en charge des descripteurs de mois flexibles :
- Noms de mois complets : « January », « February », « March », etc.
- Abréviations à trois lettres : « Jan », « Feb », « Mar », etc.
- Format numérique : 1-12 (par ex. 3 pour Mars)
Téléverser votre CSV de produits
Lorsque vous avez vérifié vos données de produits, vous pouvez les importer dans Royalties HQ. Voici comment procéder :
- Allez dans le menu principal, en haut à gauche, et cliquez sur Importer.
- Pour le type, sélectionnez « Titres ».
- Sous « Choisir votre fichier » cliquez sur « Parcourir » et naviguez jusqu’à votre fichier CSV.
- Cliquez sur « Suivant »
- Le fichier sera téléversé et validé (vérifié pour les problèmes). Vous verrez les résultats sur une page d’aperçu.
- Si les résultats semblent bons, cliquez sur « Continuer » et les produits seront importés (ou, si l’étape d’aperçu met en évidence des problèmes, vous devrez corriger les données – lisez le message d’erreur et vérifiez les exigences ci-dessous).
Mettre à jour des produits en masse
Vous pouvez également utiliser le processus ci-dessus pour mettre à jour des produits en masse.
L’importation CSV fera correspondre les produits existants sur ISBN ou ASIN. Les champs vides seront ignorés ; ils n’écraseront pas les données existantes.
Notez que tout nouvel identifiant de produit (y compris les ISBN ou ASIN) dans votre CSV qui ne se trouve pas sur une ligne avec un identifiant de produit reconnu entraînera un nouveau produit.