# TikTok Dashboard - Quick Start Guide
## 30-Second Setup
```bash
# 1. Set your API key
export LARK_API_KEY="your-api-key-here"
# 2. Analyze your data
npm run tiktok:analyze
# 3. Create dashboard
npm run tiktok:create
# 4. Open the link shown in output
```
## Files You Need
| File | Purpose |
|------|---------|
| `TIKTOK_DASHBOARD_CONFIG.md` | Complete manual configuration guide |
| `scripts/analyze-tiktok-data.ts` | Data analysis script |
| `scripts/create-tiktok-dashboard.ts` | Dashboard creation script |
| `IMPLEMENTATION_SUMMARY.md` | Full implementation details |
## Dashboard Components
### KPI Cards (Top Row)
1. Total Views - `SUM of Total video views`
2. Total Engagement - `SUM of Total number of likes`
3. Total Videos - `COUNT of records`
4. Avg Watch Rate - `AVG of Percentage watched completely`
### Charts
1. **Line Chart**: Views & Likes over time
2. **Bar Chart**: Top 10 videos by views
3. **Pie Chart**: Engagement distribution (Likes, Comments, Shares)
4. **Scatter Plot**: Watch rate vs Views (shows quality correlation)
5. **Histogram**: Video duration distribution
6. **Data Table**: Full sortable/filterable list
## NPM Scripts
```bash
npm run tiktok:analyze # Analyze data, show summary
npm run tiktok:analyze:export # Analyze + export JSON
npm run tiktok:copy # Copy existing dashboard
npm run tiktok:create # Create new dashboard with blocks
```
## Configuration
- **App Token**: `C8kmbTsqoa6rBesTKRpl8nV8gHd`
- **Table ID**: `tblG4uuUvbwfvI9Z`
- **Dashboard ID**: `blkxYx6MmEeujy0v`
- **Records**: 150 TikTok videos
## Field Names Reference
```typescript
const FIELDS = {
VIDEO_ID: 'Unique identifier of the video',
DATE_PUBLISHED: 'Date and time the video was published',
VIEWS: 'Total video views',
LIKES: 'Total number of likes the video received',
COMMENTS: 'Total number of comments the video received',
SHARES: 'Total number of times the video was shared',
WATCH_RATE: 'Percentage of video watched completely',
DESCRIPTION: 'Video description',
DURATION: 'Duration of the video in seconds',
};
```
## Color Palette
- Primary Blue: `#1890ff` (Views, primary metrics)
- Success Green: `#52c41a` (Shares, positive)
- Error Red: `#ff4d4f` (Likes, engagement)
- Warning Orange: `#fa8c16` (Comments)
- Purple: `#722ed1` (Duration, special metrics)
## Troubleshooting
| Issue | Solution |
|-------|----------|
| Authentication error | Check `LARK_API_KEY` is set correctly |
| No dashboards found | Create one empty dashboard in Lark UI first |
| Field not found | Verify field names match exactly (case-sensitive) |
| Charts show no data | Check data source and aggregation type |
## Next Steps
1. Run `npm run tiktok:analyze` to see insights
2. Run `npm run tiktok:create` to build dashboard
3. Open dashboard in Lark
4. Customize layout and add filters
5. Share with team
## Key Insights to Track
1. **Watch Rate Trends** - Content quality indicator
2. **Engagement Rate** - Audience interaction level
3. **Top Performers** - What works best
4. **Duration Sweet Spot** - Optimal video length
5. **Posting Frequency** - Consistency impact
## Recommendations
- Set auto-refresh to 1 hour
- Add date range filter (last 30/60/90 days)
- Create weekly summary reports
- Monitor top performers for patterns
- Track engagement rate as primary KPI
## Resources
- Full Guide: `TIKTOK_DASHBOARD_CONFIG.md`
- Scripts Doc: `scripts/README.md`
- Implementation: `IMPLEMENTATION_SUMMARY.md`
- Lark Base: https://hypelive.sg.larksuite.com/base/C8kmbTsqoa6rBesTKRpl8nV8gHd
