Weekly user behavior analytics for a Cape Town tech startup - South Africa & Egypt user event data with automated README sync
# User Behaviour Analytics
This repository powers the weekly user behaviour analytics for our technology
internet startup based in **Cape Town, South Africa**. Our small data team
(7 members) analyses product event data to keep the whole company up to date
with the key product metrics.
The data covers users from **South Africa** and **Egypt** and is exported weekly
from our internal data platform into `data/weekly_events.csv`. A small Python
script (`scripts/weekly_analytics.py`) turns that file into a summary stored in
`metrics/weekly_summary.json`, which is then mirrored into the **Weekly
Analytics** section below.
## Project structure
| Path | Description |
|------|-------------|
| `data/weekly_events.csv` | Weekly user behaviour events exported from the data platform |
| `scripts/weekly_analytics.py` | Analysis script that computes the weekly metrics |
| `metrics/weekly_summary.json` | Machine-readable weekly metrics summary |
| `README.md` | Human-readable overview, incl. the Weekly Analytics section |
## How to refresh the weekly numbers
```bash
python scripts/weekly_analytics.py \
--input data/weekly_events.csv \
--output metrics/weekly_summary.json
```
After the script has run, copy the summary into the **Weekly Analytics** section
below, then commit and push:
```bash
git add README.md metrics/weekly_summary.json
git commit -m "docs: update weekly analytics for YYYY-MM-DD"
git push origin main
```
---
## Weekly Analytics
### Week of 2026-08-10 to 2026-08-13
| Metric | Value |
|--------|-------|
| Total events | 500 |
| Active users | 128 |
| Avg session duration | 321.7s |
| Conversion rate | 31.25% |
#### Events by country
| Country | Events | Share |
|---------|--------|-------|
| South Africa | 262 | 52.4% |
| Egypt | 238 | 47.6% |
| **Total** | **500** | **100.0%** |