Ajouter et importer des dons
Les gens demandent cela comme
- comment ajouter un don arrivé par carte ou en espèces
- un spectateur m'a envoyé de l'argent directement sur ma carte, est-ce que ça peut compter dans mon top donateurs
- puis-je importer mon historique de dons depuis un fichier
- il manque les dons donatepay d'avant la connexion
- comment charger un export donationalerts
- j'ai ajouté un don à la main et aucune alerte n'a joué
- l'import dit que ce n'est pas un export de dons
Fourni avec strAImer : ce module s'installe avec l'application, il n'y a donc rien à télécharger. Il figure dans Catalogue de modules → Intégrés.
Ce que c'est
L'argent ne passe pas toujours par un service connecté : un spectateur vous l'envoie directement, vous le donne en espèces, ou le service perd un don. Ajouter un don inscrit un tel don à la main dans les Statistiques, et Importer un fichier fait entrer un historique de dons exporté depuis DonationAlerts ou DonatePay. Les deux boutons se trouvent dans l'onglet Données des Statistiques, à côté des puces de filtre.
Comment le configurer
- Ajouter un don ouvre la fenêtre Ajouter un don. Elle demande le Service (vos services de dons installés, ou Autre : carte, espèces, virement), le Donateur (laissé vide, il devient Anonyme), le Montant et la Devise (votre devise de base vient en premier), la Date et heure (maintenant, sauf si vous la changez ; une date dans le futur est refusée) et un Message facultatif. Ajouter l'enregistre, et dans Données sa ligne indique "ajouté à la main". Le don arrive sur la carte du stream qui était en cours à ce moment-là ; en dehors de tout stream, il n'est sur aucune carte mais compte quand même dans les classements.
- Sous les champs se trouve Compter comme un don en direct, décoché. Case décochée, l'aide indique "Va seulement dans les statistiques et les classements des donateurs. Les alertes restent muettes." Case cochée, le don part comme s'il venait d'arriver : "Compte comme un nouveau don : l’alerte, la voix et les scénarios réagissent, le chat bot répond dans le chat, et les objectifs, le carrousel, la vente aux enchères et le minuteur le comptent." Cochez-le pour l'argent qui doit passer à l'écran maintenant, et laissez-le décoché pour l'historique.
- La même fenêtre s'ouvre avec le + dans l'en-tête de la tuile Stream : Événements du Panneau de contrôle, pour ajouter un don en plein stream sans quitter le panneau. Le bouton est là tant que cette tuile affiche les dons.
- Importer un fichier prend un export de DonationAlerts (un fichier .xls) ou de DonatePay (un fichier .xlsx) ; l'aide du bouton dit la même chose. Téléchargez d'abord l'export depuis le tableau de bord du service lui-même, puis appuyez sur le bouton et choisissez le fichier dans la fenêtre qui s'ouvre. Rien n'est encore écrit : Import depuis {service} montre le nom du fichier, combien de dons sont nouveaux avec les premiers d'entre eux, combien sont déjà dans les statistiques et les lignes ignorées avec la raison, par exemple un paiement non finalisé. Importer écrit les nouveaux et annonce "Dons ajoutés : {count}." ; Annuler n'écrit rien. Un long historique prend quelques minutes, et la fenêtre reste ouverte jusqu'à la fin.
- Les dons importés entrent dans les totaux des streams, dans Top donateurs et dans les listes des meilleurs donateurs dans OBS. Ils ne jouent pas d'alerte et ne touchent ni aux objectifs, ni au carrousel, ni à la vente aux enchères : c'est de l'historique, pas de l'argent nouveau. Importer deux fois le même fichier n'ajoute rien la seconde fois. Un don que l'application a déjà capté en direct est reconnu et n'est pas compté en double, tout comme un don que vous avez ajouté à la main sous ce service avec le même donateur, le même montant et la même devise à moins d'un jour d'écart : l'import le reprend au lieu d'ajouter une seconde copie.
- Un don ajouté à la main ou importé se supprime comme n'importe quel enregistrement : pointez sur sa ligne dans Données et appuyez sur ✕. Un don importé, ou ajouté sans Compter comme un don en direct, n'a jamais compté pour les objectifs, le carrousel ou la vente aux enchères, donc le supprimer ne leur retire rien. Un don ajouté avec Compter comme un don en direct rend ce qu'il a donné.
Ce qu'il ne peut pas faire
- Importer un fichier ne lit que les exports de DonationAlerts et de DonatePay. Tout autre fichier, y compris l'export d'un autre service, est refusé avec "Ce fichier n'est pas un export de dons DonationAlerts ou DonatePay. Les autres services ne peuvent pas encore être importés." Il n'y a pas d'import d'abonnements, de bits ni de chat.
- L'application ne télécharge pas l'export pour vous : il se fait dans le tableau de bord du service, et l'application ne fait que lire le fichier.
- Un don importé ne peut pas être amené après coup à jouer une alerte ou à compter pour un objectif. Pour l'argent qui doit le faire, utilisez Ajouter un don avec Compter comme un don en direct.
- Un don ne peut pas être modifié. Pour le corriger, supprimez-le et ajoutez-le à nouveau. À la main, on n'ajoute que des dons : pas un stream, un abonnement ni aucun autre événement.
- Un service décoché dans Compter les dons de, dans l'onglet Paramètres des Statistiques, ne peut pas être utilisé ici, ni à la main ni par fichier. La fenêtre le signale ; cochez d'abord le service.
- DonatePay ne transmet pas son historique à l'application, un fichier est donc le seul moyen de faire entrer ses anciens dons. DonationAlerts et DonateX chargent leur historique eux-mêmes ; le guide "Statistiques de stream" explique Reconstruire l'historique des dons.