Skip to content

Commit 4be1e47

Browse files
committed
docs(analytics): update portfolio URL to saadshahd.github.io
Fix LinkedIn sharing URLs in setup guide: - Homepage: https://saadshahd.github.io - Case study: https://saadshahd.github.io/portfolio/statsbomb - About: https://saadshahd.github.io/about Reflects actual GitHub Pages deployment URL.
1 parent e360a37 commit 4be1e47

File tree

1 file changed

+28
-6
lines changed

1 file changed

+28
-6
lines changed

docs/umami-setup-guide.md

Lines changed: 28 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -22,6 +22,7 @@ Visit your Umami dashboard at https://cloud.umami.is and set up custom views:
2222
**Path:** Dashboard → Reports → Create Custom Report
2323

2424
**Configuration:**
25+
2526
- **Name:** "LinkedIn Traffic"
2627
- **Filter:** `utm_source = linkedin` OR `referrer contains linkedin.com`
2728
- **Metrics:** Visitors, pageviews, bounce rate, avg time on page
@@ -36,19 +37,21 @@ Visit your Umami dashboard at https://cloud.umami.is and set up custom views:
3637
**Path:** Dashboard → Events → Filter
3738

3839
**Configuration:**
40+
3941
- **Event name:** `scroll-depth`
4042
- **Filter:** `page = statsbomb-case-study`
4143
- **Group by:** `depth` field
4244
- **Visualization:** Bar chart or table
4345

4446
**What this shows:**
47+
4548
- How many readers reach 25% (Origins section)
4649
- How many reach 50% (Architecture section)
4750
- How many reach 75% (Lessons section)
4851
- How many reach 100% (End of page)
4952

5053
**Example insight:** "500 visitors, 400 reached 25%, 300 reached 50%, 150 reached 75%, 80 reached 100%"
51-
*50% drop-off between Architecture and Lessons sections*
54+
_50% drop-off between Architecture and Lessons sections_
5255

5356
---
5457

@@ -57,17 +60,19 @@ Visit your Umami dashboard at https://cloud.umami.is and set up custom views:
5760
**Path:** Dashboard → Events → Filter
5861

5962
**Configuration:**
63+
6064
- **Event name:** `cta-click`
6165
- **Group by:** `location` field (shows hero, case-study-end, etc.)
6266
- **Secondary group:** `text` field (shows button text)
6367

6468
**What this shows:**
69+
6570
- Which CTAs get clicked most ("Explore My Work" vs "Start a Conversation")
6671
- Click-through rates by location (hero vs case study end)
6772
- Which button copy resonates
6873

6974
**Example insight:** "Hero CTAs: 50 clicks (15% CTR), Case study end: 12 clicks (3% CTR)"
70-
*Most conversions happen on homepage hero*
75+
_Most conversions happen on homepage hero_
7176

7277
---
7378

@@ -76,11 +81,13 @@ Visit your Umami dashboard at https://cloud.umami.is and set up custom views:
7681
**Path:** Dashboard → Events → Filter
7782

7883
**Configuration:**
84+
7985
- **Event name:** `outbound-link`
8086
- **Group by:** `destination` field
8187
- **Sort by:** Count (descending)
8288

8389
**What this shows:**
90+
8491
- Which external links get clicked (LinkedIn profile, GitHub, resume PDF)
8592
- Where users navigate after reading content
8693

@@ -94,6 +101,7 @@ Visit your Umami dashboard at https://cloud.umami.is and set up custom views:
94101

95102
1. Go to Events → `scroll-depth` → Filter `page = statsbomb-case-study`
96103
2. Note counts for each depth:
104+
97105
- 25%: X visitors
98106
- 50%: Y visitors
99107
- 75%: Z visitors
@@ -105,11 +113,12 @@ Visit your Umami dashboard at https://cloud.umami.is and set up custom views:
105113
- **75% → 100% retention:** (W / Z) × 100%
106114

107115
**Example:**
116+
108117
- 500 → 400 (80% retention, 20% drop-off after Origins)
109118
- 400 → 300 (75% retention, 25% drop-off after Architecture)
110119
- 300 → 80 (27% retention, 73% drop-off after Lessons!)
111120

112-
*Need to improve Lessons section or move key insights earlier*
121+
_Need to improve Lessons section or move key insights earlier_
113122

114123
---
115124

@@ -120,13 +129,15 @@ Visit your Umami dashboard at https://cloud.umami.is and set up custom views:
120129
#### How to Share on LinkedIn
121130

122131
Simply post clean URLs:
123-
- Homepage: `https://saad-shahd.dev`
124-
- Case study: `https://saad-shahd.dev/portfolio/statsbomb`
125-
- About: `https://saad-shahd.dev/about`
132+
133+
- Homepage: `https://saadshahd.github.io`
134+
- Case study: `https://saadshahd.github.io/portfolio/statsbomb`
135+
- About: `https://saadshahd.github.io/about`
126136

127137
#### What You'll Track
128138

129139
Umami automatically captures LinkedIn traffic via **referrer headers**:
140+
130141
- **Referrer:** `linkedin.com` (or `lnkd.in` for shortened links)
131142
- **Total visitors:** Count of all LinkedIn-referred traffic
132143
- **Landing pages:** Which pages LinkedIn users visit first
@@ -137,6 +148,7 @@ Umami automatically captures LinkedIn traffic via **referrer headers**:
137148
**Path:** Dashboard → Referrers → Look for `linkedin.com`
138149

139150
You'll see:
151+
140152
- **Total visitors** from LinkedIn
141153
- **Bounce rate** (do they stay or leave immediately?)
142154
- **Top landing pages** (homepage vs. case study direct links)
@@ -145,14 +157,17 @@ You'll see:
145157
#### What You Give Up (and why it's okay)
146158

147159
**Can't differentiate between posts:**
160+
148161
- ❌ "Was it the launch post or the case study highlight that drove traffic?"
149162
-**But you can infer:** Post on Monday → check traffic Tuesday → see spike
150163

151164
**Can't track campaigns:**
165+
152166
- ❌ "Which post format works best?"
153167
-**But you'll know:** Total LinkedIn impact, engagement quality, conversion rates
154168

155169
**When to reconsider:**
170+
156171
- If LinkedIn becomes your #1 traffic source (>40% of visitors)
157172
- If you're A/B testing different post formats and need per-post data
158173
- If you start running LinkedIn ads (then use UTM for paid vs organic)
@@ -199,30 +214,35 @@ You'll see:
199214
### Week 1: Traffic Validation
200215

201216
**Questions:**
217+
202218
- Is LinkedIn driving visitors? (Check Referrers → linkedin.com)
203219
- Are people clicking CTAs? (Check Events → cta-click)
204220
- Do visitors read the full case study? (Check Events → scroll-depth)
205221

206222
**Actions based on data:**
223+
207224
- **Low LinkedIn traffic?** → Share more on LinkedIn, try different post formats
208225
- **Low CTA clicks?** → Test different button copy or placement
209226
- **High drop-off at 50%?** → Architecture section too dense, needs simplification
210227

211228
### Week 2-4: Optimization
212229

213230
**Questions:**
231+
214232
- Which LinkedIn posts drive the most traffic? (UTM campaigns)
215233
- Where do visitors drop off in the case study? (Scroll depth funnel)
216234
- Do visitors who read 100% convert more? (Cross-reference scroll-depth + cta-click)
217235

218236
**Actions:**
237+
219238
- Double down on high-performing LinkedIn content types
220239
- Refactor sections with high drop-off rates
221240
- Add more CTAs near high-engagement sections
222241

223242
### Month 1+: Pattern Recognition
224243

225244
**Questions:**
245+
226246
- What's the visitor-to-contact conversion rate?
227247
- Which pages drive the most conversions?
228248
- Are recruiters reading case studies or just browsing?
@@ -234,11 +254,13 @@ You'll see:
234254
### Events Not Showing in Dashboard
235255

236256
**Check:**
257+
237258
1. Is Umami script loading? (DevTools → Network → `script.js` from `cloud.umami.is`)
238259
2. Are console warnings showing? (Look for `[Analytics] Umami not loaded`)
239260
3. Is `window.umami` defined? (DevTools → Console → type `window.umami`)
240261

241262
**Fix:**
263+
242264
- If script not loading → Check Layout.astro has correct website ID
243265
- If console warnings → Script blocked by ad blocker, disable for your domain
244266
- If window.umami undefined → Script failed to load, check network logs

0 commit comments

Comments
 (0)