@friedbotstudio/create-baseline 0.1.0 → 0.2.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (32) hide show
  1. package/README.md +5 -0
  2. package/bin/cli.js +8 -2
  3. package/obj/template/.claude/skills/audit-baseline/audit.sh +11 -5
  4. package/obj/template/.claude/skills/google-analytics/SKILL.md +129 -0
  5. package/obj/template/.claude/skills/google-analytics/references/audiences.md +389 -0
  6. package/obj/template/.claude/skills/google-analytics/references/bigquery.md +470 -0
  7. package/obj/template/.claude/skills/google-analytics/references/custom-dimensions.md +355 -0
  8. package/obj/template/.claude/skills/google-analytics/references/custom-events.md +383 -0
  9. package/obj/template/.claude/skills/google-analytics/references/data-management.md +416 -0
  10. package/obj/template/.claude/skills/google-analytics/references/debugview.md +364 -0
  11. package/obj/template/.claude/skills/google-analytics/references/events-fundamentals.md +398 -0
  12. package/obj/template/.claude/skills/google-analytics/references/gtag.md +502 -0
  13. package/obj/template/.claude/skills/google-analytics/references/gtm-integration.md +483 -0
  14. package/obj/template/.claude/skills/google-analytics/references/measurement-protocol.md +519 -0
  15. package/obj/template/.claude/skills/google-analytics/references/privacy.md +441 -0
  16. package/obj/template/.claude/skills/google-analytics/references/recommended-events.md +464 -0
  17. package/obj/template/.claude/skills/google-analytics/references/reporting.md +397 -0
  18. package/obj/template/.claude/skills/google-analytics/references/setup.md +344 -0
  19. package/obj/template/.claude/skills/google-analytics/references/user-tracking.md +417 -0
  20. package/obj/template/.claude/skills/optimize-seo/SKILL.md +313 -0
  21. package/obj/template/.claude/skills/optimize-seo/scripts/pagespeed.mjs +197 -0
  22. package/obj/template/.claude/skills/pagespeed-insights/LICENSE.md +37 -0
  23. package/obj/template/.claude/skills/pagespeed-insights/SKILL.md +446 -0
  24. package/obj/template/.claude/skills/pagespeed-insights/reference.md +50 -0
  25. package/obj/template/CLAUDE.md +3 -3
  26. package/obj/template/docs/init/seed.md +2 -2
  27. package/obj/template/manifest.json +27 -6
  28. package/package.json +7 -2
  29. package/src/CLAUDE.template.md +3 -3
  30. package/src/cli/install.js +14 -4
  31. package/src/seed.template.md +2 -2
  32. package/obj/template/.claude/hooks/lib/__pycache__/resume_writer.cpython-314.pyc +0 -0
@@ -0,0 +1,397 @@
1
+ # GA4 Reporting and Data Analysis
2
+
3
+ Comprehensive guide to GA4 standard reports, Explorations, and data analysis techniques.
4
+
5
+ ## Overview
6
+
7
+ GA4 provides standard reports for common metrics and Explorations for advanced analysis. Standard reports offer quick insights while Explorations enable custom, flexible analysis with drag-and-drop interfaces.
8
+
9
+ ## Standard Reports
10
+
11
+ ### Accessing Reports
12
+
13
+ **Path:** Reports (left navigation)
14
+
15
+ ### Report Categories
16
+
17
+ #### Realtime Reports
18
+
19
+ **Path:** Reports -> Realtime
20
+
21
+ | Data | Description |
22
+ |------|-------------|
23
+ | Active users | Users in last 30 minutes |
24
+ | Views by page | Current page activity |
25
+ | Events by name | Real-time event counts |
26
+ | Conversions | Recent conversions |
27
+ | User locations | Geographic map |
28
+
29
+ #### Life Cycle Reports
30
+
31
+ **Acquisition Reports:**
32
+ - User acquisition (first touch)
33
+ - Traffic acquisition (session level)
34
+ - Channels, sources, campaigns
35
+
36
+ **Engagement Reports:**
37
+ - Events (all event activity)
38
+ - Conversions (key events)
39
+ - Pages and screens
40
+ - Landing pages
41
+
42
+ **Monetisation Reports:**
43
+ - E-commerce purchases
44
+ - Publisher ads (AdSense)
45
+ - In-app purchases
46
+ - Revenue metrics
47
+
48
+ **Retention Reports:**
49
+ - User engagement over time
50
+ - Cohort analysis
51
+ - User retention
52
+ - Lifetime value
53
+
54
+ #### User Reports
55
+
56
+ **Demographics:**
57
+ - Age, gender (requires Google Signals)
58
+ - Country, city, language
59
+
60
+ **Tech:**
61
+ - Browser, device, OS
62
+ - Screen resolution
63
+ - App version
64
+
65
+ ### Customising Standard Reports
66
+
67
+ **Add Secondary Dimension:**
68
+ 1. Click "+" next to primary dimension
69
+ 2. Select additional dimension
70
+ 3. View combined breakdown
71
+
72
+ **Apply Filters:**
73
+ 1. Click "Add filter +"
74
+ 2. Choose dimension
75
+ 3. Set condition (equals, contains, etc.)
76
+ 4. Apply
77
+
78
+ **Change Date Range:**
79
+ 1. Top-right date selector
80
+ 2. Choose preset or custom range
81
+ 3. Enable comparison if needed
82
+
83
+ ## Explorations
84
+
85
+ ### Accessing Explorations
86
+
87
+ **Path:** Explore (left navigation)
88
+
89
+ ### Exploration Types
90
+
91
+ #### 1. Free Form Exploration
92
+
93
+ **Purpose:** Flexible custom reports with drag-and-drop interface
94
+
95
+ **Components:**
96
+ - Dimensions: User attributes
97
+ - Metrics: Quantitative measures
98
+ - Rows: Primary dimension
99
+ - Columns: Secondary dimension
100
+ - Values: Metrics to display
101
+ - Filters: Limit data shown
102
+ - Segments: Compare user groups
103
+
104
+ **Use Cases:**
105
+ - Custom traffic source reports
106
+ - Product performance analysis
107
+ - Custom conversion reports
108
+
109
+ #### 2. Funnel Exploration
110
+
111
+ **Purpose:** Analyse conversion funnels and drop-off points
112
+
113
+ **Setup:**
114
+ 1. Add steps (events or page views)
115
+ 2. Configure funnel type:
116
+ - Closed: Must complete in order
117
+ - Open: Can enter at any step
118
+ 3. Analyse results
119
+
120
+ **Example Steps:**
121
+ 1. page_view (homepage)
122
+ 2. view_item
123
+ 3. add_to_cart
124
+ 4. begin_checkout
125
+ 5. purchase
126
+
127
+ **Insights:**
128
+ - Completion rate per step
129
+ - Drop-off percentage
130
+ - Time between steps
131
+
132
+ #### 3. Path Exploration
133
+
134
+ **Purpose:** Visualise user journeys and navigation paths
135
+
136
+ **Types:**
137
+ - Starting point: Paths from specific event/page
138
+ - Ending point: Paths to specific event/page
139
+
140
+ **Visualisation:**
141
+ - Node size = traffic volume
142
+ - Arrows = path direction
143
+ - Numbers = user count
144
+
145
+ #### 4. Segment Overlap
146
+
147
+ **Purpose:** Compare and analyse audience overlap
148
+
149
+ **Setup:**
150
+ 1. Add 2-3 segments
151
+ 2. View Venn diagram
152
+ 3. Analyse:
153
+ - Unique users per segment
154
+ - Overlapping users
155
+ - Total reach
156
+
157
+ #### 5. Cohort Exploration
158
+
159
+ **Purpose:** Analyse user retention over time
160
+
161
+ **Setup:**
162
+ 1. Cohort: User grouping (acquisition date)
163
+ 2. Granularity: Daily, weekly, monthly
164
+ 3. Metrics: Sessions, revenue, events
165
+ 4. Time period: Days/weeks since cohort start
166
+
167
+ **Insights:**
168
+ - Week 1 retention rates
169
+ - Revenue per cohort
170
+ - Long-term engagement patterns
171
+
172
+ #### 6. User Exploration
173
+
174
+ **Purpose:** Analyse individual user behaviour
175
+
176
+ **Setup:**
177
+ 1. Add user identifier
178
+ 2. View user details:
179
+ - All events
180
+ - Event parameters
181
+ - Device, location
182
+ - Session timeline
183
+
184
+ **Use Cases:**
185
+ - Debug specific issues
186
+ - Understand power users
187
+ - Investigate anomalies
188
+
189
+ #### 7. User Lifetime
190
+
191
+ **Purpose:** Analyse user value over lifetime
192
+
193
+ **Dimensions:** Acquisition source, campaign
194
+ **Metrics:** Lifetime value, revenue, sessions
195
+ **Time period:** Lifetime duration
196
+
197
+ ## Creating Segments
198
+
199
+ ### Segment Types
200
+
201
+ | Type | Description |
202
+ |------|-------------|
203
+ | User segment | Users matching conditions |
204
+ | Session segment | Sessions matching conditions |
205
+ | Event segment | Events matching conditions |
206
+
207
+ ### Building Segments
208
+
209
+ **Path:** Explorations -> Create new segment
210
+
211
+ **Conditions:**
212
+ - Demographics (country, age, gender)
213
+ - Technology (device, browser)
214
+ - Acquisition (source, medium, campaign)
215
+ - Behaviour (events, conversions)
216
+ - E-commerce (purchasers, revenue)
217
+ - Custom dimensions/metrics
218
+
219
+ ### Segment Examples
220
+
221
+ **High-Value Purchasers:**
222
+ ```
223
+ Users where:
224
+ - totalRevenue > 500
225
+ - purchaseCount >= 3
226
+ ```
227
+
228
+ **Mobile Converters:**
229
+ ```
230
+ Sessions where:
231
+ - deviceCategory = mobile
232
+ - keyEvent: purchase
233
+ ```
234
+
235
+ **Engaged Users:**
236
+ ```
237
+ Users where:
238
+ - sessionCount >= 5
239
+ - avgEngagementTime > 120 seconds
240
+ ```
241
+
242
+ ## Comparisons
243
+
244
+ ### Creating Comparisons
245
+
246
+ 1. In report, click "Add comparison"
247
+ 2. Choose dimension or segment
248
+ 3. Select values to compare
249
+
250
+ ### Example Comparisons
251
+
252
+ - Desktop vs Mobile
253
+ - UK vs US traffic
254
+ - This month vs last month
255
+ - New vs returning users
256
+
257
+ ### Visualisation
258
+
259
+ - Side-by-side metrics
260
+ - Colour-coded lines in charts
261
+ - Percentage differences
262
+
263
+ ## Key Metrics Reference
264
+
265
+ ### User Metrics
266
+
267
+ | Metric | Description |
268
+ |--------|-------------|
269
+ | Total Users | All users in period |
270
+ | New Users | First-time visitors |
271
+ | Active Users | Users with engagement |
272
+ | DAU/WAU/MAU | Daily/Weekly/Monthly active |
273
+
274
+ ### Engagement Metrics
275
+
276
+ | Metric | Description |
277
+ |--------|-------------|
278
+ | Sessions | Session count |
279
+ | Average Engagement Time | Time actively engaged |
280
+ | Engagement Rate | % of engaged sessions |
281
+ | Events per Session | Average event count |
282
+
283
+ ### Conversion Metrics
284
+
285
+ | Metric | Description |
286
+ |--------|-------------|
287
+ | Conversions | Key event count |
288
+ | Conversion Rate | % with conversion |
289
+ | Total Revenue | Sum of revenue |
290
+ | ARPPU | Revenue per paying user |
291
+
292
+ ### E-commerce Metrics
293
+
294
+ | Metric | Description |
295
+ |--------|-------------|
296
+ | Purchase Revenue | Revenue from purchases |
297
+ | Transactions | Purchase count |
298
+ | Average Purchase Revenue | Revenue per transaction |
299
+ | Items Viewed/Added/Purchased | Item counts |
300
+
301
+ ## Attribution
302
+
303
+ ### Accessing Attribution
304
+
305
+ **Path:** Advertising -> Attribution
306
+
307
+ ### Attribution Models
308
+
309
+ | Model | Description |
310
+ |-------|-------------|
311
+ | Data-driven | ML-based credit assignment |
312
+ | Last click | Full credit to last touch |
313
+ | First click | Full credit to first touch |
314
+ | Linear | Equal credit to all |
315
+ | Time decay | More credit to recent |
316
+ | Position-based | More to first and last |
317
+
318
+ ### Comparing Models
319
+
320
+ - View conversions by channel per model
321
+ - Understand attribution impact
322
+ - Optimise marketing spend
323
+
324
+ ## Analysis Best Practices
325
+
326
+ ### Finding Insights
327
+
328
+ 1. **Start broad:** Review standard reports
329
+ 2. **Identify anomalies:** Look for unusual patterns
330
+ 3. **Drill down:** Add dimensions, apply filters
331
+ 4. **Use Explorations:** Build custom analyses
332
+ 5. **Export and share:** Download or share links
333
+
334
+ ### Common Analyses
335
+
336
+ **Conversion Funnel:**
337
+ - Identify drop-off points
338
+ - Optimise low-performing steps
339
+ - A/B test improvements
340
+
341
+ **Traffic Source Performance:**
342
+ - Which sources drive conversions?
343
+ - Cost per acquisition by channel
344
+ - ROI by campaign
345
+
346
+ **User Retention:**
347
+ - Return rate after first visit
348
+ - Active duration
349
+ - Best retention sources
350
+
351
+ **Product Performance:**
352
+ - Most viewed products
353
+ - Conversion rate by product
354
+ - Revenue by category
355
+
356
+ ## Exporting Data
357
+
358
+ ### Export Options
359
+
360
+ **From Reports:**
361
+ - Download as CSV/PDF
362
+ - Share report link
363
+
364
+ **From Explorations:**
365
+ - Export to Google Sheets
366
+ - Download as CSV/PDF
367
+
368
+ **To BigQuery:**
369
+ - Admin -> BigQuery Links
370
+ - Raw event data export
371
+
372
+ ## Report Limits
373
+
374
+ | Limit | Value |
375
+ |-------|-------|
376
+ | Explorations per property | 200 |
377
+ | Shared Explorations per user | 50 |
378
+ | Segments per Exploration | 100 |
379
+ | Rows per Exploration | 1,000,000 |
380
+
381
+ ## Quick Reference
382
+
383
+ ### Exploration Types
384
+
385
+ - Free Form: Custom flexible reports
386
+ - Funnel: Conversion path analysis
387
+ - Path: User journey visualisation
388
+ - Segment Overlap: Audience comparison
389
+ - Cohort: Retention analysis
390
+ - User: Individual behaviour
391
+ - User Lifetime: LTV analysis
392
+
393
+ ### Segment Scopes
394
+
395
+ - User: Users matching conditions
396
+ - Session: Sessions matching conditions
397
+ - Event: Events matching conditions