Ir al contenido

Fuentes y actualización

Automáticas (GitHub Actions, lunes 08:00 UTC)

Sección titulada «Automáticas (GitHub Actions, lunes 08:00 UTC)»
Métrica Fuente Qué es Secreto necesario
YouTube · suscriptores Data API channels.list Suscriptores del canal (YouTube redondea en público) YOUTUBE_API_KEY
YouTube · vistas totales Data API channels.list Vistas acumuladas del canal YOUTUBE_API_KEY
YouTube · videos Data API channels.list Cantidad de videos públicos YOUTUBE_API_KEY
YouTube · vistas 28 días Suma de vistas de episodios publicados en los últimos 28 días Aproximación: son vistas acumuladas de esos videos, no vistas del período YOUTUBE_API_KEY
YouTube · vistas por episodio Data API videos.list Se guarda en stats de cada episodio YOUTUBE_API_KEY
Instagram · seguidores Graph API followers_count Seguidores de la cuenta profesional IG_USER_ID, IG_ACCESS_TOKEN
Instagram · alcance 28 días Graph API insights?metric=reach&period=days_28 Cuentas únicas alcanzadas IG_USER_ID, IG_ACCESS_TOKEN
Instagram · publicaciones Graph API media_count Posts publicados IG_USER_ID, IG_ACCESS_TOKEN

Si falta un secreto, ese job se salta sin fallar y las demás fuentes siguen. Cada corrida deja un commit chore(metrics): sync YYYY-MM-DD en main.

Métrica Cómo
Spotify · reproducciones 28 días, oyentes diarios promedio, reproducciones totales Spotify for Creators → Rendimiento → exportar CSV (“desde siempre”) → npm run import:spotify -- archivo.csv. Guarda el diario en data/spotify/daily.json y deriva las series semanales.
Spotify · seguidores Spotify for Creators → Audiencia → anotar en manual.yaml.
Métrica Dónde mirar
Apple · seguidores Apple Podcasts Connect → Analytics
WhatsApp · True Fans Info del grupo
Circle · miembros Panel de administración
Newsletter Beehiiv → Audience

Editar data/metrics/manual.yaml: value, date y confirmed: true.

  • Retención dentro de cada video (YouTube Analytics, requiere OAuth).
  • Descargas por episodio en Spotify/Apple (solo vía exportación).
  • Aporte del podcast a Nauta (ver Animales ↔ Nauta).