TNK Designs — Measurement Plan

Measurement Plan

TNK Designs — Analytics implementation overview

Author

Guillermo García

Site URL

https://tnkproject.com/

Stack

Static HTML · Tailwind CSS · Vanilla JS

Analytics layer

Google Tag Manager + GA4

GTM Container

GTM-KW97DTMV · Account: tnk-project (6343762712)

GA4 Measurement ID

G-25V933JKJD

GA4 Stream

tnk-analytics-design-website · Stream ID: 13893341764 · https://tnkproject.com

Data layer library

analytics.js (shared, all pages)

Privacy

PII filtered · email SHA-256 hashed · no raw textarea

Pages instrumented

14 pages (8 with engagement)

Last updated

2026-03-24

Events implemented

01

page_view
Fires on every page load (DOMContentLoaded). Reads window.TNK_PAGE defined per page. Sends page name, category, type, content group, and author.
02

select_content
Fires on all navigational clicks — nav links, hero CTAs, project/blog cards, filter pills, social links. Uses delegated click listener on a[data-track] and tnkNavigate() helper.
03

generate_lead
Fires on contact form submit. Dynamically collects non-PII fields. Skips password/tel/hidden and PII name patterns. Textarea → word_count + char_count. Email hashed via SHA-256 (crypto.subtle).
04

orbit_interaction
Fires on hover of the orbiting skills section on the Home page. Sends orbit_pause (boolean, animation state) when entering/leaving the stage, and skill_hover (tooltip text) per icon hover.
05

search
Fires 500 ms after user stops typing in the Blog search bar (min 2 chars). Sends search term, results count, has-results flag, term length, section, and active filter pill.
06

post_engagement
Fires on blog post pages when a visitor likes, unlikes, or submits a comment. Sends content_id (post slug), content_name (post title), and action ("like" | "unlike" | "comment"). Like state is persisted per browser via localStorage UUID + Supabase.

All Parameters

Full parameter registry across all events

#	Parameter	Type	Events	Example value	Notes

page_view

Fires on DOMContentLoaded on every page — reads window.TNK_PAGE · one row per unique page_category + page_type combination (6 of 11 pages shown)

select_content

Fires on all navigational clicks across the site

generate_lead

Fires on contact form submit — non-PII fields + SHA-256 hashed email

orbit_interaction

Fires on hover of the orbiting skills section on the Home page

search

Fires 500 ms after user stops typing in blog search (min 2 chars)

post_engagement

Single event — fires on blog post pages for likes and comments. action distinguishes the interaction type.

GTM & GA4 Setup

Naming conventions and configuration reference for GTM-KW97DTMV · G-25V933JKJD

GTM Container

GTM-KW97DTMV

GTM Account

tnk-project · 6343762712

GA4 Measurement ID

G-25V933JKJD

GA4 Stream

tnk-analytics-design-website · 13893341764

Google Tag Manager

Variables, Triggers & Tags — exact names as configured in the container

Variables (27 Data Layer Variables)

#	Variable Name	Data Layer Variable Name	Used In Event(s)
page_view
01	dlv - page_name	page_name	page_view
02	dlv - page_category	page_category	page_view
03	dlv - page_type	page_type	page_view
04	dlv - content_group	content_group	page_view
05	dlv - page_author	page_author	page_view
select_content
06	dlv - content_type	content_type	select_content
07	dlv - content_id	content_id	select_content · post_engagement
08	dlv - content_name	content_name	select_content · post_engagement
09	dlv - item_list_name	item_list_name	select_content
10	dlv - destination_url	destination_url	select_content
generate_lead
11	dlv - form_name	form_name	generate_lead
12	dlv - form_id	form_id	generate_lead
13	dlv - subject	subject	generate_lead
14	dlv - budget	budget	generate_lead
15	dlv - message_word_count	message_word_count	generate_lead
16	dlv - message_char_count	message_char_count	generate_lead
17	dlv - message_filled	message_filled	generate_lead
18	dlv - email_sha256	email_sha256	generate_lead
orbit_interaction
19	dlv - orbit_pause	orbit_pause	orbit_interaction
20	dlv - skill_hover	skill_hover	orbit_interaction
search
21	dlv - search_term	search_term	search
22	dlv - search_results_count	search_results_count	search
23	dlv - search_has_results	search_has_results	search
24	dlv - search_term_length	search_term_length	search
25	dlv - search_section	search_section	search
26	dlv - search_active_filter	search_active_filter	search
post_engagement
27	dlv - action	action	post_engagement

Triggers (7 triggers)

#	Trigger Name	Type	Event Name / Fires On
01	All Pages	Page View – Window Loaded	All Pages
02	CE - page_view	Custom Event	page_view
03	CE - select_content	Custom Event	select_content
04	CE - generate_lead	Custom Event	generate_lead
05	CE - orbit_interaction	Custom Event	orbit_interaction
06	CE - search	Custom Event	search
07	CE - post_engagement	Custom Event	post_engagement

Tags (7 tags)

#	Tag Name	Tag Type	GA4 Event Name	Trigger	Key Parameters / Notes
01	GA4 - Configuration	Google Tag	—	All Pages	`send_page_view: false` · Tag ID: `G-25V933JKJD`
02	GA4 - page_view	GA4 Event	page_view	CE - page_view	page_name · page_category · page_type · content_group · page_author
03	GA4 - select_content	GA4 Event	select_content	CE - select_content	content_type · content_id · content_name · item_list_name · destination_url
04	GA4 - generate_lead	GA4 Event	generate_lead	CE - generate_lead	form_name · form_id · subject · budget · message_word_count · message_char_count · message_filled · email_sha256
05	GA4 - orbit_interaction	GA4 Event	orbit_interaction	CE - orbit_interaction	orbit_pause · skill_hover
06	GA4 - search	GA4 Event	search	CE - search	search_term · search_results_count · search_has_results · search_term_length · search_section · search_active_filter
07	GA4 - post_engagement	GA4 Event	post_engagement	CE - post_engagement	content_id · content_name · action

Google Analytics 4

Custom Dimensions, Metrics & Conversions — Admin → Data Display

Custom Dimensions (22 event-scoped)

#	Display Name	Event Parameter	Scope
Page
01	Page Name	page_name	Event
02	Page Category	page_category	Event
03	Page Type	page_type	Event
04	Content Group	content_group	Event
05	Page Author	page_author	Event
Navigation / Clicks
06	Content Type	content_type	Event
07	Content ID	content_id	Event
08	Content Name	content_name	Event
09	Item List Name	item_list_name	Event
10	Destination URL	destination_url	Event
Lead Form
11	Form Name	form_name	Event
12	Form ID	form_id	Event
13	Subject	subject	Event
14	Budget	budget	Event
15	Message Filled	message_filled	Event
16	Email SHA-256	email_sha256	Event
Skills / Orbit
17	Orbit Pause	orbit_pause	Event
18	Skill Hover	skill_hover	Event
Search
19	Search Has Results	search_has_results	Event
20	Search Section	search_section	Event
21	Search Active Filter	search_active_filter	Event
Post Engagement
22	Engagement Action	action	Event

Custom Metrics (4 event-scoped)

#	Display Name	Event Parameter	Unit
01	Message Word Count	message_word_count	Standard (integer)
02	Message Char Count	message_char_count	Standard (integer)
03	Search Results Count	search_results_count	Standard (integer)
04	Search Term Length	search_term_length	Standard (integer)

Conversions

Conversion Event

generate_lead

Admin → Data Display → Events → toggle Mark as conversion
Or: Admin → Conversions → New Conversion Event → type generate_lead

Version History

Changelog — every major update to this measurement plan

v5.0 2026-03-24 Domain update

Updated all site URL references from the Vercel staging domain to the new custom domain tnkproject.com. No tracking changes — documentation update only.

Site URL updated: https://tnk-project.vercel.app/ → https://tnkproject.com/
GA4 Stream URL updated to match new domain

v4.1 2026-03-17 New blog post

Added new blog post "Analytics Documentation That Never Goes Stale" to tracking coverage. New page instrumented with page_view, new blog card tracked via select_content in the blog listing, and full post_engagement coverage (likes & comments via Supabase).

New page blog/analytics-doc-automation.html added to page_view tracking
New blog_card select_content entry for the doc-automation post in the blog listing
post_engagement (like/unlike/comment) instrumented with slug analytics_doc_automation
Pages instrumented count updated: 11 → 12 pages (7 → 8 with engagement)

v4.2 2026-03-17 Complete page inventory

Completed the page_view tab to include all 14 pages currently live on the site. Previously only 5 pages were documented. Also fixed broken screenshot references from v4.1 (pv_blog_doc_automation, sc_blog_card_doc_auto) and added the missing page_view for Portfolio Security Audit.

Added 8 missing pages to page_view tab: TNK Portfolio Web, Design Principles for Data Products, Beautiful Dashboards, Building with Claude Code, DataLayer Medición Robusta, Analytics-First Workflow, Portfolio Security Audit, and fixed Analytics Doc Automation screenshot
Fixed broken image references from v4.1 (pv_blog_doc_automation.png, sc_blog_card_doc_auto.png)
Pages instrumented count updated: 12 → 14 pages
Capture script updated to include all new pages

v4.0 2026-03-12 GTM & GA4 setup

Added GTM & GA4 Setup reference tab documenting the exact naming conventions for all GTM objects and GA4 configuration items. GTM container GTM-KW97DTMV deployed to all 13 site pages. GA4 property G-25V933JKJD connected.

New tab 09 — GTM & GA4 Setup added with full naming convention tables
27 GTM Data Layer Variables documented (dlv - * naming pattern)
7 GTM Triggers documented (CE - * naming pattern for custom events)
7 GTM Tags documented (GA4 - * naming pattern)
22 GA4 Custom Dimensions + 4 Custom Metrics registered
generate_lead marked as GA4 conversion
GTM snippets added to all 13 HTML pages (head + noscript body)
Intro tab updated with real GTM/GA4 IDs and stream details
Archive: measurement_plan_v3.html

v3.0 2026-03-11 Schema refactor

Unified post engagement tracking into a single post_engagement event. Standardised all content_id values across events to use underscores instead of hyphens.

Replaced blog_like + blog_comment with single post_engagement event
action parameter now carries like | unlike | comment
Removed comment_length parameter — no longer sent
All content_id values across select_content and post_engagement now use _ separators (e.g. beautiful_dashboards)
post_engagement tab rebuilt to match standard event-block structure with #NN index, param-tags, code-block, screenshots
Updated all 7 blog HTML files to push post_engagement with underscore slugs
Archive: measurement_plan_v2.html

v2.0 2026-03-11 Post engagement

Added post-level engagement features to all 7 blog post pages: likes (heart button with toggle) and comments (form + listing). Backed by Supabase with Row-Level Security. Two new GA4 events, two new parameters.

2 new events: blog_like, blog_comment
2 new parameters: action (like|unlike), comment_length
Supabase backend: tables post_likes and post_comments
Per-browser like deduplication via localStorage["tnk_browser_id"] (UUID)
New tab 08 — post_engagement added to this document
Archive: measurement_plan_v1.html

v1.0 2026-03-10 Initial release

First complete measurement plan for the TNK Designs portfolio. Covers all 5 events with full parameter documentation, dataLayer push examples, and per-row screenshots with element highlights.

5 events documented: page_view, select_content, generate_lead, orbit_interaction, search
21 shared parameters across events
29 select_content interactions documented (nav, hero, cards, footer, blog listing, filters, projects, contact)
6 page_view rows (one per unique page_category + page_type combination)
70+ automated screenshots via Puppeteer with red-box element highlights
7 CSV exports for Google Sheets import
Archive: measurement_plan_v1.html

Versioning rules

A new version is created for every major update: new event added, existing event removed or renamed, new parameter added/removed, tracking approach changed. Minor fixes (typos, broken links, screenshot refreshes) do not increment the version. Before each version bump, the current file is archived to archive/measurement_plan_vN.html.