Bryce Watson
Back to projects
•
3 min read
Shopify TYOS Migrator

An automation tool that migrates Shopify tracking pixels from legacy Thank-You and Order-Status page scripts to the modern Customer Events API. Supports 8 major advertising platforms with 100% automation and pixel parity validation.

Problem

Shopify is sunsetting legacy tracking scripts on Thank-You and Order-Status pages, with hard deadlines for merchants (August 2025 for Plus plans, August 2026 for non-Plus). Every merchant running tracking pixels (Google Ads, Meta, TikTok, and others) needs to migrate to the Customer Events API or lose conversion tracking entirely. Agencies currently charge $1,300–$2,500 per migration.

Approach

The migrator scans a store’s legacy tracking code, identifies which vendors are present, and generates the equivalent Customer Events API implementation for each one. A vendor adapter pattern handles the differences between platforms; each of the 8 supported vendors has its own adapter that maps legacy pixel behavior to the new API surface. Playwright end-to-end tests validate pixel parity between the legacy implementation and the migrated output.

The tool handles Consent Mode v2 compliance and server-side event deduplication, which are the two areas where manual migrations most commonly break.

Supported Platforms

Google Ads, GA4, Meta, TikTok, Pinterest, Snap, Klaviyo, and Bing UET, covering the vast majority of e-commerce tracking setups.

What’s Implemented

  • Automated scanning of legacy tracking scripts with vendor identification
  • Vendor adapter pattern: 8 platform-specific adapters mapping legacy pixels to Customer Events API
  • Pixel parity validation: Playwright E2E tests confirming migrated code produces identical tracking behavior
  • Consent Mode v2 compliance with server-side event deduplication
  • Shopify OAuth 2.0 integration for store access
  • Production infrastructure: Docker containers on Fly.io, Redis-backed sessions, SQLite with Litestream backups, Prometheus metrics, Pino structured logging

Architecture

Built as a pnpm monorepo with separated concerns: a core migration engine, vendor-specific adapters, an OAuth flow for Shopify store access, and a validation layer powered by Playwright. The deployment runs on Fly.io with Docker, using Redis for session management and SQLite (with Litestream continuous backups) for persistence.

What This Demonstrates

Multi-platform integration engineering across 8 distinct ad network APIs, Shopify OAuth and API integration, automated testing strategies for migration correctness (pixel parity validation), and production deployment with observability (Prometheus, structured logging, error tracking).