# TikTok Analytics Dashboard - README
## What This Is
A complete guide to creating a native TikTok analytics dashboard in Lark Base for analyzing 150 videos.
**Direct Link to Base:** https://hypelive.sg.larksuite.com/base/C8kmbTsqoa6rBesTKRpl8nV8gHd
---
## Quick Start (Choose Your Path)
### 🚀 I want to build it NOW (15 min)
**[→ QUICK_START_CHECKLIST.md](QUICK_START_CHECKLIST.md)**
Step-by-step checklist with exact clicks and configurations.
---
### 📖 I want to understand everything first
**[→ CREATE_DASHBOARD_NOW.md](CREATE_DASHBOARD_NOW.md)**
Complete guide with all details, tips, and best practices.
---
### 🔍 I need field names and technical specs
**[→ FIELD_REFERENCE.md](FIELD_REFERENCE.md)**
All 20 fields with IDs, types, formats, and recommended aggregations.
---
### 🎨 I want to see the design mockup
**[→ DASHBOARD_MOCKUP.md](DASHBOARD_MOCKUP.md)**
Visual blueprint showing layout, colors, and chart configurations.
---
### 📊 I need an executive summary
**[→ DASHBOARD_SUMMARY.md](DASHBOARD_SUMMARY.md)**
High-level overview of capabilities, limitations, and ROI.
---
## File Structure
```
lark-dashboard-sdk/
├── README_DASHBOARD.md ← YOU ARE HERE (start point)
├── NATIVE_DASHBOARD_INDEX.md ← Navigation guide
│
├── QUICK_START_CHECKLIST.md ← 15-min creation guide ⭐
├── CREATE_DASHBOARD_NOW.md ← Complete manual
├── FIELD_REFERENCE.md ← Technical reference
├── DASHBOARD_MOCKUP.md ← Visual design
└── DASHBOARD_SUMMARY.md ← Executive summary
```
---
## Key Information
### The Situation
- You have 150 TikTok videos in a Lark Base
- You want a dashboard to analyze performance
- The Lark API **cannot** create dashboards (must use UI)
- All data is ready and properly formatted
### The Solution
- Follow the provided guides to create dashboard in Lark UI
- Takes 15-20 minutes using QUICK_START_CHECKLIST.md
- Results in a native dashboard with KPIs, charts, and tables
### What You'll Get
- 5 KPI cards (Views, Likes, Comments, Shares, Watch %)
- Trend chart (Views & Engagement over time)
- Top 10 videos chart
- Watch completion analysis
- Recent performance table
- Optional: Additional charts for deeper insights
---
## Documentation Flow
```
┌─────────────────────────────────────────────────────────┐
│ START: README_DASHBOARD.md (You are here) │
└────────────────────┬────────────────────────────────────┘
│
┌──────────┴──────────┐
│ │
Fast Track Deep Dive
│ │
▼ ▼
┌──────────────────┐ ┌──────────────────┐
│ QUICK_START_ │ │ CREATE_DASHBOARD_│
│ CHECKLIST.md │ │ NOW.md │
│ │ │ │
│ • 15-min guide │ │ • Full details │
│ • Step-by-step │ │ • 10 charts │
│ • Checkboxes │ │ • Advanced tips │
└────────┬─────────┘ └────────┬─────────┘
│ │
│ Both reference │
│ ▼ │
│ ┌──────────────┐ │
└──┤ FIELD_ ├───┘
│ REFERENCE.md │
│ │
│ • 20 fields │
│ • Field IDs │
│ • Formats │
└──────────────┘
│
Optional references
│
┌───────────┴───────────┐
▼ ▼
┌──────────────┐ ┌──────────────┐
│ DASHBOARD_ │ │ DASHBOARD_ │
│ MOCKUP.md │ │ SUMMARY.md │
│ │ │ │
│ • Visual │ │ • Executive │
│ layout │ │ overview │
│ • Design │ │ • ROI info │
└──────────────┘ └──────────────┘
```
---
## Recommended Reading Order
### If you have 5 minutes
1. Read this file (README_DASHBOARD.md)
2. Scan DASHBOARD_SUMMARY.md (key points only)
3. Bookmark QUICK_START_CHECKLIST.md for later
### If you have 15 minutes
1. Read this file
2. Skim CREATE_DASHBOARD_NOW.md (steps 1-3)
3. Review FIELD_REFERENCE.md (field names section)
### If you have 30 minutes
1. Read this file completely
2. Read QUICK_START_CHECKLIST.md thoroughly
3. Review FIELD_REFERENCE.md (all sections)
4. Scan DASHBOARD_MOCKUP.md (visual layout)
### If you have 1 hour
1. Read all files in order:
- README_DASHBOARD.md (this file)
- DASHBOARD_SUMMARY.md
- QUICK_START_CHECKLIST.md
- CREATE_DASHBOARD_NOW.md
- FIELD_REFERENCE.md
- DASHBOARD_MOCKUP.md
2. Then create the dashboard
---
## FAQs
### Can I create this via API?
**No.** The Lark API does not support creating dashboard views. You must use the UI. However, the API can be used to fetch data for external dashboards.
### How long does it take?
**15-20 minutes** following QUICK_START_CHECKLIST.md
**30-40 minutes** for the advanced version in CREATE_DASHBOARD_NOW.md
### Do I need coding skills?
**No.** All dashboard creation is done through the Lark UI with point-and-click.
### Will the data update automatically?
**Yes.** The dashboard shows real-time data from your table. No manual refresh needed.
### Can I share the dashboard?
**Yes.** Use Lark's sharing feature to create view-only or edit links.
### Does it work on mobile?
**Yes** for viewing. **No** for creation (use desktop).
### What if I get stuck?
1. Check the troubleshooting section in CREATE_DASHBOARD_NOW.md
2. Verify field names in FIELD_REFERENCE.md
3. Review the mockup in DASHBOARD_MOCKUP.md
4. Contact Lark support: support@larksuite.com
---
## Data Overview
### Your Base
- **URL:** https://hypelive.sg.larksuite.com/base/C8kmbTsqoa6rBesTKRpl8nV8gHd
- **App Token:** C8kmbTsqoa6rBesTKRpl8nV8gHd
- **Table:** TikTok L'AURA - Candle
- **Table ID:** tblG4uuUvbwfvI9Z
- **Records:** 150 TikTok videos
### Available Metrics
- Views, Likes, Comments, Shares
- Video duration
- Watch completion percentage
- Publication date/time
- Unique viewers
- Total/average watch time
- Geographic distribution
- Traffic sources
---
## What's Included
### Core Files (Must Read)
1. **QUICK_START_CHECKLIST.md** (8.6 KB)
- Fastest path to dashboard
- 7-phase checklist
- Verification steps
2. **CREATE_DASHBOARD_NOW.md** (11 KB)
- Complete guide
- 10 chart configurations
- Advanced tips & troubleshooting
3. **FIELD_REFERENCE.md** (8.4 KB)
- All 20 field specifications
- API examples
- Quick copy-paste names
### Supporting Files (Optional)
4. **DASHBOARD_MOCKUP.md** (17 KB)
- Visual layout blueprint
- Design specifications
- Color schemes
5. **DASHBOARD_SUMMARY.md** (10 KB)
- Executive overview
- ROI analysis
- Implementation timeline
6. **NATIVE_DASHBOARD_INDEX.md**
- Navigation guide
- Decision matrix
- File relationships
---
## Success Metrics
Your dashboard is complete when you can:
- [ ] See total views, likes, comments, shares at a glance
- [ ] View performance trends over time
- [ ] Identify top 10 performing videos
- [ ] Analyze watch completion by duration
- [ ] Review recent video performance in table
- [ ] Filter by date range
- [ ] Share link with team
---
## Next Actions
### Immediate (Now)
1. **Click:** https://hypelive.sg.larksuite.com/base/C8kmbTsqoa6rBesTKRpl8nV8gHd
2. **Open:** QUICK_START_CHECKLIST.md
3. **Follow:** The 7-phase checklist
4. **Reference:** FIELD_REFERENCE.md for field names
### Today (20 minutes)
1. Create basic dashboard (5 KPIs + 3 charts)
2. Share with team
3. Gather initial feedback
### This Week (1 hour)
1. Add advanced charts
2. Create calculated fields
3. Set up filters
4. Train team
### This Month (Ongoing)
1. Monitor daily/weekly
2. Analyze trends
3. Optimize content strategy
4. Iterate design
---
## Support
### Documentation
- All guides in: `/Users/mdch/hype-dash/`
- Start with: QUICK_START_CHECKLIST.md
- Reference: FIELD_REFERENCE.md
- Design: DASHBOARD_MOCKUP.md
### External Help
- Lark Help: https://www.larksuite.com/help
- API Docs: https://open.larksuite.com/document/
- Forum: https://forum.larksuite.com/
- Email: support@larksuite.com
---
## License
These guides are provided as-is for creating TikTok analytics dashboards in Lark Base.
---
## Version
**Created:** December 9, 2025
**Files:** 6 comprehensive guides
**Total Documentation:** 2,000+ lines
**Estimated Reading Time:** 30-60 minutes
**Dashboard Creation Time:** 15-20 minutes
---
**Ready to start?**
**→ [QUICK_START_CHECKLIST.md](QUICK_START_CHECKLIST.md)**
Good luck creating your TikTok analytics dashboard!
