astro-website/openspec/changes/archive/2026-02-10-better-tracking/specs/interaction-tracking-taxonomy/spec.md

MODIFIED Requirements

Requirement: Minimum required properties

Every tracked click event MUST include, at minimum:

• target_id
• placement

For links, the event MUST also include:

• target_url (or a stable target identifier that can be mapped to a URL)

For content-related links (clickables representing a specific piece of content), the event MUST also include:

• title (human-readable content title)
• type (content type identifier)

The type value MUST be one of:

• video
• podcast_episode
• blog_post
• blog_page

Scenario: Tracking a content card click

• WHEN a user clicks a content card link
• THEN the emitted event includes target_id, placement, and target_url

Scenario: Tracking a content link includes title and type

• WHEN a user clicks a content-related link that represents a specific content item
• THEN the emitted event includes target_id, placement, target_url, title, and type