Donaciones: siete servicios, un solo flujo de eventos

Todo lo que cuenta como dinero, en una sola lista

Una donación es una donación. Todo lo que viene después — la alerta, la barra de meta, la puja en la subasta, la línea que se lee en voz alta — reacciona al evento, no al servicio que lo entregó.

• DonationAlerts, DonatePay, DonateX, Streamlabs y StreamElements traen las donaciones a medida que llegan.
• StreamEngine trae efectos pagados en pantalla y pedidos de medios pagados, además de las donaciones comunes.
• Trula trae donaciones, incluidas las que un espectador paga para poner una canción en la fila.
• Los bits de Twitch, los Super Chats de YouTube y los stickers pagados de YouTube también llegan como donaciones, así que cuentan para la misma meta.
• Varios servicios funcionan a la vez sin conflictos, y agregar uno más tarde no cambia nada de lo que ya tienes configurado.

Cuando un espectador paga por una acción, no por una transferencia

No todos los servicios venden transferencias. En StreamEngine el espectador compra algo que ocurre en tu pantalla — voltearla durante diez segundos, desenfocar la cámara, romper la tarjeta de video — y en Trula pone una canción en la fila. El dinero llega como cualquier otra donación, pero el monto por sí solo no dice qué está por pasar.

• Donde el servicio lo informa, la alerta nombra la compra: “Pantalla volteada ×6 · 10 s” junto al espectador.
• El feed de eventos en el Panel muestra la misma línea, en vivo y en el historial.
• Las estadísticas la guardan, así que dos compras al mismo precio siguen distinguiéndose después.
• Las metas, la subasta y el carrusel la ignoran a propósito: trabajan con el monto.
• StreamEngine nombra el efecto que vendió; Trula no envía el título de la canción, así que sus pedidos de música llegan como donaciones comunes.

Lo que pasa sin que toques nada

No escribes una regla para una donación. Llega, y todo lo que ya está escuchando reacciona a ella.

• La alerta se dispara en la superposición — el nombre, el monto y el mensaje.
• La barra de meta avanza, la subasta cuenta la puja y la donación cae en el bote del carrusel — el giro, y detrás de él el contador de desafíos, llegan cuando el bote alcanza el monto que fijaste.
• La voz en off lee el mensaje en voz alta, por encima del umbral que fijaste.
• Las estadísticas la escriben en los totales de esa transmisión y en el top de donadores.
• Se ejecutan tus propios escenarios, si escribiste alguno.

Lo que no va a hacer

Traer el dinero es todo su trabajo. Todo lo que podría inflar un número en silencio queda afuera.

• Solo recibe: los pagos, los reembolsos y la página donde paga el espectador se quedan del lado del servicio.
• Las donaciones que llegaron con la aplicación cerrada no se repiten como alertas — un arranque por la mañana reproduciría la noche entera de golpe.
• El feed de StreamEngine trae también eventos de Twitch, DonationAlerts y Trovo. Se omiten a propósito, o una misma donación se contaría dos veces.
• Una vista previa lanzada desde el panel de StreamEngine, y un pedido sin costo, nunca llegan a la barra de meta: el dinero que no existe no tiene nada que hacer ahí.
• Una donación de prueba desde el panel de DonateX sí llega a las alertas — para eso está — y llega marcada como prueba, para que todo lo que no debe contarla, la subasta ante todo, la deje afuera.

Una sola moneda, o los números dejan de significar algo

Los espectadores pagan en la moneda que les dan su plataforma y su tarjeta, mientras que una barra de meta tiene que mostrar un solo número. Esa conversión es un módulo aparte, porque equivocarse ahí corrompe en silencio todos los totales que mires después.

• Tres fuentes de tipos de cambio en línea con respaldo, así que la caída de una no detiene el conteo.
• Tipos de cambio que fijas a mano para lo que ninguna fuente conoce — los bits de Twitch ante todo, al precio que realmente te pagan por ellos.
• La moneda base se establece una sola vez, en Configuración → Localización, y todo lo demás la sigue.
• La barra de meta, la subasta, el carrusel y el umbral de la voz en off leen el monto ya convertido, así que un umbral que fijas significa lo mismo sin importar en qué pagó el espectador.

Un historial sin huecos

La aplicación no funciona las veinticuatro horas, y las donaciones no la esperan.

• Todo el historial de DonationAlerts se importa una vez, en la primera conexión; después las donaciones recientes se contrastan con el servicio — veinte segundos después de conectar y cada quince minutos — así que una noche con la aplicación cerrada no deja un hueco en las estadísticas.
• Esa importación va directo a las estadísticas en lugar de pasar por las alertas: los totales quedan completos sin volver a reproducir lo de anoche en pantalla.
• Los pagos de StreamEngine hechos con la aplicación cerrada llegan a las estadísticas de la misma forma en el siguiente inicio, sin alerta. El feed de StreamEngine solo entrega sus últimos 25 eventos de cualquier tipo, así que una pausa larga o con mucha actividad todavía puede dejar un hueco. Las metas, el carrusel y la subasta no cuentan esos pagos.
• Las dos importaciones omiten cualquier servicio que hayas desmarcado en “Contar donaciones de”, en la pestaña “Configuración” de Estadísticas, igual que el conteo en vivo.
• Si el socket se queda callado mientras la conexión todavía figura como activa, la conciliación lo demuestra: la tarjeta dice “Sin recepción” y ofrece Reconectar.

De qué está hecho

Cada parte es un módulo separado: instalas solo los que necesitas, y cualquiera de ellos se puede eliminar sin romper el resto.

Cómo empezar

1. Establece tu moneda base en Configuración → Localización.
2. Abre Conexiones → Monetización y conecta los servicios que realmente usas.
3. Si aceptas bits de Twitch, dales un tipo de cambio en Configuración → Tipos de Cambio.
4. Envía una donación de prueba y comprueba que llega a la superposición de alertas.
5. Dirige las metas, la subasta y la voz en off hacia ese flujo — ya lo están escuchando.

Siete servicios hoy, y la lista crece desde el mismo lugar: uno nuevo es un conector más, y todo lo que viene después ya está escuchando.

Funciona junto con