Saltar al contenido principal

Anuncios y Reparto de Ingresos

Closegram muestra anuncios en los perfiles elegibles de creadores y reparte el ingreso publicitario entre el creador y la plataforma. Los anuncios solo se ejecutan para creadores incluidos en una lista beta permitida por usuario, de modo que la funcionalidad se pueda desplegar de forma gradual.

El ingreso puede liquidarse de dos maneras: a partir de una estimación del lado del servidor (valores de CPM/clic que tú configuras) o a partir de un reporte real de Google Ad Manager importado por creador. La participación del creador se paga en monedas, reutilizando el flujo existente de billetera y retiro (cashout).

Cada propiedad tiene su propio checkbox que indica si esa pieza específica está completamente implementada y funcional de punta a punta (frontend + backend) — actualiza estas casillas tú mismo conforme avance el trabajo; esta página no las sobrescribirá.

  • Espacio de anuncio en el perfil en perfiles elegibles — renderiza AdSense o Google Ad Manager (GPT), o un placeholder propio de la casa; reporta impresiones (con validación de visibilidad) y clics
  • Lista beta permitida por usuario (ads_enabled en el usuario) que controla qué perfiles muestran anuncios y generan ingresos
  • Estimación de ingresos del lado del servidor — las impresiones nunca declaran su propio ingreso; el servidor lo calcula a partir de un CPM / valor de clic configurable
  • Liquidación mensual — agrega los eventos, aplica el reparto creador/plataforma, y acredita a los creadores como monedas por encima de un umbral mínimo (idempotente por período)
  • Importación de ingresos reales — liquida a partir de un reporte de Google Ad Manager (clave-valor creator por creador) mediante pegado de CSV o una importación de un clic desde GAM
  • Panel de administración /ads (super_admin) — configuración, lista beta permitida (búsqueda por nombre de usuario), ubicaciones de anuncios, vista de ingresos, liquidación, importación de ingresos reales, y transferencias manuales de monedas
  • Transferencias manuales de monedas — acreditar/ajustar monedas para cualquier usuario, o la participación calculada de un creador (monto editable)
  • Cliente de la API de Reportes de Google Ad Manager conectado (implementado en esta sesión: llamadas REST reales vía GoogleAuth de googleapis, ya no un stub — todavía necesita credenciales reales de GAM_SERVICE_ACCOUNT_KEY/GAM_NETWORK_CODE para funcionar en producción; ver la referencia técnica para la salvedad de la API en Beta)
  • Script de verificación de AdSense a nivel de todo el sitio — el loader que el flujo de configuración de AdSense de Google pide pegar en el <head> de cada página, conectado en el layout raíz de la app (independiente de la lista beta / reparto de ingresos de arriba)

Cómo funciona el reparto​

Los anuncios solo se ejecutan en perfiles cuyo dueño está en la lista beta permitida. Cuando un visitante ve dicho perfil, el espacio de anuncio se renderiza y reporta una impresión (y un clic, si lo hay); las vistas propias nunca generan ingresos. El servidor atribuye un ingreso estimado al dueño del perfil usando el CPM de impresión y el valor de clic configurados (todo el dinero se almacena en micros — 1,000,000 = 1 unidad de moneda — para evitar problemas de punto flotante).

Al final de un período (YYYY-MM), la liquidación agrega el ingreso de cada creador, calcula creatorShare = floor(gross × creatorSharePercent / 100), lo convierte a monedas con coinsPerCurrencyUnit, y — si supera minCreditCoins — acredita al creador como una reward en monedas. Los creadores que ya fueron acreditados se omiten, por lo que volver a ejecutar un período es seguro.

Para liquidar a partir de dinero real en lugar de la estimación, importa un reporte de Google Ad Manager (consulta la referencia técnica): el ingreso bruto real por creador reemplaza la estimación en el libro contable, y se ejecuta el mismo reparto/acreditación.

Nota de cumplimiento​

Compartir directamente las ganancias de AdSense con terceros va en contra de la política de AdSense. Los dos modelos compatibles y conformes son: (1) el fondo para creadores — estimar el ingreso y pagar a los creadores en monedas desde la plataforma (funciona hoy, sin dependencia externa), y (2) Google Ad Manager + MCM (Multiple Customer Management) — los creadores se integran como publishers hijos y Google atribuye el ingreso por creador mediante la clave-valor creator, que luego la importación de ingresos reales liquida.

Consulta la referencia técnica para ver los esquemas de GraphQL, enlaces a los archivos fuente, el estado de conexión campo por campo, y la guía completa de configuración y operación (cuenta de Google, variables de entorno, ejecución de la liquidación).