Skip to content

feat(data-warehouse): attribute deep-link handoffs to the wizard#230

Merged
Gilbert09 merged 1 commit into
mainfrom
tom/warehouse-deeplink-attribution
Jul 13, 2026
Merged

feat(data-warehouse): attribute deep-link handoffs to the wizard#230
Gilbert09 merged 1 commit into
mainfrom
tom/warehouse-deeplink-attribution

Conversation

@Gilbert09

Copy link
Copy Markdown
Member

Problem

When the warehouse-source skill routes a user to the browser (deep-link sources, declined credentials, or non-interactive runs), the handoff URL carries no attribution. Sources finished in the app after a wizard handoff are indistinguishable from organic web creations, so the handoff conversion rate is unmeasurable — and production traces show the deep-link path is taken in the majority of runs.

Changes

Append utm_source=wizard&utm_campaign=warehouse-source to the deep-link URL template in the data-warehouse-source skill. posthog-js captures utm_* on the resulting pageviews/session, so web-completed sources can be tied back to wizard handoffs without any app changes.

Testing

pnpm test:skills — 85 passed.

@Gilbert09
Gilbert09 requested a review from a team as a code owner July 11, 2026 17:20
@github-actions

Copy link
Copy Markdown

🧙 Wizard CI

Run the Wizard CI and test your changes against wizard-workbench example apps by replying with a GitHub comment using one of the following commands:

Test all apps:

  • /wizard-ci all

Test all apps in a directory:

  • /wizard-ci basic-integration
  • /wizard-ci mcp-analytics
  • /wizard-ci revenue

Test an individual app:

  • /wizard-ci basic-integration/android
  • /wizard-ci basic-integration/angular
  • /wizard-ci basic-integration/astro
Show more apps
  • /wizard-ci basic-integration/django
  • /wizard-ci basic-integration/fastapi
  • /wizard-ci basic-integration/flask
  • /wizard-ci basic-integration/javascript-node
  • /wizard-ci basic-integration/javascript-web
  • /wizard-ci basic-integration/laravel
  • /wizard-ci basic-integration/next-js
  • /wizard-ci basic-integration/nuxt
  • /wizard-ci basic-integration/python
  • /wizard-ci basic-integration/rails
  • /wizard-ci basic-integration/react-native
  • /wizard-ci basic-integration/react-router
  • /wizard-ci basic-integration/sveltekit
  • /wizard-ci basic-integration/swift
  • /wizard-ci basic-integration/tanstack-router
  • /wizard-ci basic-integration/tanstack-start
  • /wizard-ci basic-integration/vue
  • /wizard-ci mcp-analytics/custom-dispatcher
  • /wizard-ci mcp-analytics/typescript-sdk
  • /wizard-ci revenue/stripe

Results will be posted here when complete.

@estefaniarabadan estefaniarabadan left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Doc/skill-instruction only — adds utm attribution params to the handoff deep-link, no code paths touched, skill tests pass. LGTM 👍

@Gilbert09
Gilbert09 merged commit 4a802cf into main Jul 13, 2026
15 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants