Dons : sept services, un seul flux d'événements

Tout ce qui compte comme de l'argent, dans une seule liste

Un don est un don. Tout ce qui vient ensuite — l'alerte, la barre d'objectif, l'offre dans les enchères, la ligne lue à voix haute — réagit à l'événement, pas au service qui l'a livré.

• DonationAlerts, DonatePay, DonateX, Streamlabs et StreamElements font entrer les dons au fur et à mesure qu'ils arrivent.
• StreamEngine apporte des effets payants à l'écran et des demandes de médias payantes, en plus des dons ordinaires.
• Trula apporte des dons, y compris ceux avec lesquels un spectateur paie pour mettre un morceau dans la file.
• Les bits Twitch, les Super Chats YouTube et les stickers payants YouTube arrivent eux aussi comme des dons, et comptent donc pour le même objectif.
• Plusieurs services tournent en même temps sans conflit, et en ajouter un plus tard ne change rien à ce que vous avez déjà réglé.

Quand un spectateur paie pour une action, pas pour un virement

Tous les services ne vendent pas des virements. Sur StreamEngine, un spectateur achète quelque chose qui se produit sur votre écran — le retourner pendant dix secondes, flouter la caméra, faire lâcher la carte graphique — et sur Trula, il met un morceau dans la file. L'argent arrive comme n'importe quel autre don, mais le montant seul ne dit pas ce qui va se passer.

• Là où le service le signale, l'alerte nomme l'achat : « Écran retourné ×6 · 10 s » à côté du spectateur.
• Le flux d'événements du Tableau de bord affiche la même ligne, en direct et dans l'historique.
• Les statistiques la conservent, si bien que deux achats au même prix restent distinguables plus tard.
• Les objectifs, les enchères et le carrousel l'ignorent volontairement : ils travaillent avec le montant.
• StreamEngine nomme l'effet qu'il a vendu ; Trula n'envoie pas le titre du morceau, ses commandes de musique arrivent donc comme des dons ordinaires.

Ce qui se passe sans que vous touchiez à quoi que ce soit

Vous n'écrivez pas de règle pour un don. Il arrive, et tout ce qui écoute déjà y réagit.

• L'alerte se déclenche dans la superposition — le nom, le montant et le message.
• La barre d'objectif avance, les enchères comptent l'offre, et le don tombe dans la cagnotte du carrousel — le tour, et derrière lui le compteur de défis, arrivent dès que la cagnotte atteint le montant que vous avez fixé.
• La voix off lit le message à voix haute, au-dessus du seuil que vous avez fixé.
• Les statistiques l'inscrivent dans les totaux de ce stream et dans le classement des donateurs.
• Vos propres scénarios se déclenchent, si vous en avez écrit.

Ce qu'il ne fera pas

Faire entrer l'argent, c'est tout son travail. Tout ce qui pourrait gonfler un chiffre en silence est laissé de côté.

• Il ne fait que recevoir : les versements, les remboursements et la page sur laquelle le spectateur paie restent du côté du service.
• Les dons arrivés pendant que l'appli était fermée ne sont pas rejoués en alertes — un démarrage le matin passerait toute la nuit d'un coup.
• Le flux de StreamEngine transporte aussi des événements Twitch, DonationAlerts et Trovo. Ils sont écartés volontairement, sinon un même don serait compté deux fois.
• Un aperçu déclenché depuis l'espace StreamEngine, et une demande sans paiement, n'atteignent jamais la barre d'objectif : l'argent qui n'existe pas n'a rien à y faire.
• Un don de test envoyé depuis l'espace DonateX atteint bien les alertes — c'est à cela qu'il sert — et il arrive marqué comme test, pour que tout ce qui ne doit pas le compter, les enchères avant tout, le laisse de côté.

Une seule devise, ou les chiffres ne veulent plus rien dire

Les spectateurs paient dans la devise que leur donnent leur plateforme et leur carte, alors qu'une barre d'objectif doit afficher un seul chiffre. Cette conversion est un module à part entière, car s'y tromper corrompt en silence chaque total que vous regardez ensuite.

• Trois sources de taux en ligne avec repli, pour que la panne de l'une d'elles n'arrête pas le comptage.
• Des taux que vous fixez à la main pour ce qu'aucune source ne connaît — les bits Twitch avant tout, au prix qui vous est réellement versé pour eux.
• La devise de base se règle une fois, dans Paramètres → Localisation, et tout le reste s'y conforme.
• La barre d'objectif, les enchères, le carrousel et le seuil de la voix off lisent tous le montant déjà converti : un seuil que vous fixez veut donc dire la même chose, quelle qu'ait été la devise du spectateur.

Un historique sans trous

L'appli ne tourne pas vingt-quatre heures sur vingt-quatre, et les dons ne l'attendent pas.

• Tout l'historique DonationAlerts est importé une fois, à la première connexion ; ensuite les dons récents sont recoupés avec le service — vingt secondes après la connexion et toutes les quinze minutes —, pour qu'une nuit avec l'appli fermée ne laisse pas de trou dans les statistiques.
• Cet import va directement dans les statistiques plutôt que de passer par les alertes : les totaux sont complétés sans rejouer la veille au soir à l'écran.
• Les paiements StreamEngine faits pendant que l'appli était fermée arrivent de la même façon dans les statistiques au démarrage suivant, sans alerte. Le flux de StreamEngine ne transmet que ses 25 derniers événements, tous types confondus : une absence longue ou chargée peut donc quand même laisser un trou. Les objectifs, le carrousel et les enchères ne comptent pas ces paiements.
• Les deux imports ignorent tout service que vous avez décoché sous « Compter les dons de », dans l'onglet « Paramètres » de Statistiques, comme le fait déjà le décompte en direct.
• Si le socket se tait alors que la connexion s'affiche encore comme active, le recoupement le prouve : la carte indique « Pas de réception » et propose Reconnecter.

De quoi il est fait

Chaque partie est un module séparé : vous installez uniquement ceux dont vous avez besoin, et chacun peut être supprimé sans affecter les autres.

Pour commencer

1. Réglez votre devise de base dans Paramètres → Localisation.
2. Ouvrez Connexions → Monétisation et connectez les services que vous utilisez vraiment.
3. Si vous acceptez les bits Twitch, donnez-leur un taux dans Paramètres → Taux de change.
4. Envoyez un don de test et vérifiez qu'il atteint la superposition d'alertes.
5. Dirigez les objectifs, les enchères et la voix off vers ce flux — ils écoutent déjà.

Sept services aujourd'hui, et la liste grandit depuis le même endroit : un nouveau service, c'est un connecteur de plus, et tout ce qui vient ensuite écoute déjà.

Fonctionne avec