222 lines
5.4 KiB
Markdown
222 lines
5.4 KiB
Markdown
---
|
|
name: agency-analytics
|
|
description: "Generare report settimanali KPI e identificare azioni per social e YouTube. Usare quando: (1) report settimanale, (2) analisi performance content, (3) pianificare azioni basate su dati. Output: Weekly report con KPI snapshot, highlights, lowlights, max 5 actions."
|
|
---
|
|
|
|
# Agency Analyst/KPI — Report Settimanali
|
|
|
|
Report KPI settimanali e azioni misurabili per social e YouTube.
|
|
|
|
## Quando Usare
|
|
|
|
- **Weekly check:** Report prestazioni settimana
|
|
- **Post-campaign:** Analisi campagna specifica
|
|
- **Monthly review:** Sintesi mensile (aggrega weekly)
|
|
- **Strategy adjust:** Identificare cosa cambiare
|
|
|
|
---
|
|
|
|
## Input
|
|
|
|
| Input | Tipo | Validazione |
|
|
|-------|------|-------------|
|
|
| `project_path` | string | Percorso progetto (cartella di lavoro) |
|
|
| `kpi_definitions` | object | KPI da tracciare |
|
|
| `dashboards_links` | array | Link a analytics (se disponibili) |
|
|
| `week_number` | string | Numero settimana (es. "2026-W10") |
|
|
| `published_content` | array | Content pubblicato nella settimana |
|
|
|
|
---
|
|
|
|
## Processo
|
|
|
|
### Fase 1: Raccolta Dati
|
|
|
|
**Obiettivo:** Raccogliere KPI della settimana.
|
|
|
|
**Azioni:**
|
|
|
|
1. Identifica fonti dati:
|
|
- **Social:** LinkedIn Analytics, Instagram Insights, X Analytics
|
|
- **YouTube:** YouTube Studio
|
|
- **Website:** Google Analytics (se applicabile)
|
|
|
|
2. Per ogni piattaforma, raccogli:
|
|
- Views / Impressions
|
|
- Engagement (likes, comments, shares)
|
|
- Clicks / CTR
|
|
- Follower/Subscribers growth
|
|
- Top content della settimana
|
|
|
|
3. Se dati NON disponibili:
|
|
- Documenta mancanza
|
|
- Proponi setup tracking
|
|
- Usa stime basate su published log
|
|
|
|
**Template Raccolta:**
|
|
|
|
```markdown
|
|
# Dati Settimana {WW}
|
|
|
|
## LinkedIn
|
|
- Posts published: {N}
|
|
- Total impressions: {N}
|
|
- Total engagement: {N}
|
|
- Engagement rate: {N}%
|
|
- Top post: {titolo} ({impressions})
|
|
|
|
## Instagram
|
|
- Posts published: {N}
|
|
- Reach: {N}
|
|
- Engagement: {N}
|
|
- Saves: {N}
|
|
- Top post: {titolo}
|
|
|
|
## YouTube
|
|
- Videos published: {N}
|
|
- Views: {N}
|
|
- Watch time: {N} ore
|
|
- Avg retention: {N}%
|
|
- Top video: {titolo}
|
|
```
|
|
|
|
---
|
|
|
|
### Fase 2: KPI Snapshot
|
|
|
|
**Obiettivo:** Sintetizzare metriche chiave.
|
|
|
|
**Azioni:**
|
|
|
|
1. Crea snapshot conciso (max 10 metriche totali)
|
|
2. Includi:
|
|
- Metriche di volume (views, impressions)
|
|
- Metriche di engagement (rate, clicks)
|
|
- Growth (follower, subscribers)
|
|
3. Evidenzia trend (vs settimana precedente, se disponibile)
|
|
|
|
**Template:**
|
|
|
|
```markdown
|
|
## KPI Snapshot — Week {WW}
|
|
|
|
| Metrica | Valore | vs Week Precedente |
|
|
|---------|--------|-------------------|
|
|
| Total Impressions | 12,450 | +15% |
|
|
| Engagement Rate | 4.2% | +0.3% |
|
|
| New Followers | +34 | +12% |
|
|
| YouTube Views | 2,340 | -5% |
|
|
| Avg Retention | 45% | stabile |
|
|
```
|
|
|
|
---
|
|
|
|
### Fase 3: Highlights e Lowlights
|
|
|
|
**Obiettivo:** Identificare cosa ha funzionato e cosa no.
|
|
|
|
**Azioni:**
|
|
|
|
1. **Highlights (2-3):**
|
|
- Top content della settimana
|
|
- Record battuti
|
|
- Insight positivi
|
|
|
|
2. **Lowlights (1-2):**
|
|
- Content underperforming
|
|
- Metriche in calo
|
|
- Problemi identificati
|
|
|
|
**Template:**
|
|
|
|
```markdown
|
|
## Highlights
|
|
|
|
1. **Post LinkedIn "3 errori comuni"** — 5,200 impressions, 8.4% engagement rate (2x media)
|
|
2. **YouTube video "Case Study X"** — 62% retention a 30s (record)
|
|
3. **+50 followers** — crescita più alta del mese
|
|
|
|
## Lowlights
|
|
|
|
1. **Instagram carousel** — 40% reach in meno vs media (algoritmo?)
|
|
2. **YouTube CTR thumbnail** — 3.2% (target: 5%+)
|
|
```
|
|
|
|
---
|
|
|
|
### Fase 4: Actions Next Week
|
|
|
|
**Obiettivo:** Definire max 5 azioni concrete.
|
|
|
|
**Azioni:**
|
|
|
|
1. Basa azioni su highlights/lowlights
|
|
2. Prioritizza impatto alto / sforzo basso
|
|
3. Specifica:
|
|
- Cosa fare
|
|
- Perché (data-driven)
|
|
- Come misurare successo
|
|
|
|
**Template:**
|
|
|
|
```markdown
|
|
## Actions Next Week (max 5)
|
|
|
|
1. **Raddoppiare su formato "errori comuni"** — Engagement 2x media, produrre variante per Instagram
|
|
2. **Test nuove thumbnail YouTube** — CTR basso, A/B test 2 varianti
|
|
3. **Analizzare calo reach Instagram** — Check algoritmo, valuta posting times alternativi
|
|
4. **Pianificare case study Q2** — Top performing format, iniziare produzione
|
|
5. **Setup UTM tracking** — Migliorare attribution clicks → website
|
|
```
|
|
|
|
---
|
|
|
|
### Fase 5: Weekly Report
|
|
|
|
**Obiettivo:** Compilare report finale.
|
|
|
|
**Azioni:**
|
|
|
|
1. Usa template da `../agency-shared-references/references/weekly_report_template.md`
|
|
2. Compila tutte le sezioni
|
|
3. Salva in `{project}/analytics/weekly_reports/{YYYY-WW}.md`
|
|
4. Documenta azioni nel run log del progetto se richiedono follow-up
|
|
|
|
**Output:**
|
|
- `{project}/analytics/weekly_reports/YYYY-WW.md`
|
|
|
|
---
|
|
|
|
## Output
|
|
|
|
| File | Formato | Descrizione |
|
|
|------|---------|-------------|
|
|
| `{project}/analytics/weekly_reports/YYYY-WW.md` | Markdown | Report settimanale |
|
|
| `{project}/ops/run_log.md` | Markdown | Azioni e follow-up (se necessario) |
|
|
|
|
---
|
|
|
|
## References
|
|
|
|
- [weekly_report_template.md](../agency-shared-references/references/weekly_report_template.md) — Template report
|
|
- [quality_bar.md](../agency-shared-references/references/quality_bar.md) — Standard di qualità
|
|
|
|
---
|
|
|
|
## Note
|
|
|
|
**Edge Cases:**
|
|
|
|
- **Nessun dato disponibile:** Documenta mancanza, proponi setup tracking, usa published log come proxy
|
|
- **Dati parziali:** Riporta cosa disponibile, segnala gap
|
|
- **Settimana corta (festività):** Nota contesto, non confrontare con settimane normali
|
|
|
|
**Limitazioni:**
|
|
|
|
- Richiede accesso a dashboard analytics (o export manuali)
|
|
- Alcuni dati potrebbero avere delay (24-48h)
|
|
- Attribution website → social richiede UTM setup
|
|
|
|
---
|
|
|
|
_Skill generata da framework-translator_
|