Traffic & Conversion Mapping for Technical Site Migrations
Context
Technical site migrations disrupt indexation, session continuity, and revenue attribution if executed without precise mapping. This playbook delivers a structured approach to traffic and conversion mapping for webmasters, SEO engineers, site architects, and technical project managers. Execute every step to preserve organic equity, prevent data loss, and maintain conversion tracking across architecture changes.
Pre-flight Checks
Capture current indexation, traffic, and conversion states before modifying site architecture. Precise delta tracking requires quantitative baselines.
- Execute a full crawl using Crawl Baseline Generation protocols to document HTTP status codes, internal link equity distribution, and render-blocking resources.
- Map GA4 conversion events to current URL paths via BigQuery exports and custom dimension tagging.
- Document DNS TTL values, CDN cache headers, and WAF rule sets to prevent stale content delivery during propagation.
- Complete foundational readiness scoring with a comprehensive Pre-Migration Auditing & Risk Assessment before freezing CMS content.
- Verify database snapshot integrity and establish strict content freeze protocols across all environments.
Execution Steps
Align historical performance data with the new information architecture. Preserve session continuity and revenue tracking across domain boundaries.
- Implement Mapping Legacy Traffic to New URL Structures to preserve UTM parameters, referral paths, and session IDs during the transition.
- Configure GA4 data streams with cross-domain linker parameters. Deploy server-side GTM containers to prevent attribution fragmentation.
- Validate tracking endpoints and conversion pixels in staging environments using browser network inspectors and tag assistant debuggers before DNS cutover.
- Maintain dual-domain GA4 data streams until global DNS propagation completes and
_gacookies stabilize.
Configs/Commands
Deploy these exact configurations to enforce redirect rules, optimize DNS propagation, and purge stale assets.
- Nginx 301 Redirect Block:
rewrite ^/legacy-category/(.*)$ /new-structure/$1 permanent;withmapdirective for query string preservation. - DNS TTL Pre-Migration Reduction: Lower to 300s 48h prior via registrar API. Verify propagation with
dig @ns1.example.com SOA +short. - GA4 Cross-Domain Tracking:
gtag('set', 'linker', {domains: ['old-domain.com', 'new-domain.com']});in GTM container initialization. - Headless CMS Cache Purge:
curl -X PURGE https://cdn.example.com/* -H 'X-Cache-Purge: true'to invalidate stale assets before DNS swap. - Log Analysis Command:
awk '$9 ~ /^[45]/ {print $7}' access.log | sort | uniq -c | sort -rn > migration_errors.csvfor post-launch error triage.
Validation
Execute systematic checks to verify technical integrity, redirect accuracy, and SEO preservation prior to production traffic routing.
- Run staging environment checklists to verify canonical tags, hreflang implementations, and
robots.txtdirectives. - Test redirect chains using
curl -I -Lbatch scripts and Screaming Frog list mode. Eliminate 301 loops and orphaned paths immediately. - Validate JavaScript hydration delays, structured data parity, and sitemap submission readiness using Google Search Console URL Inspection API.
- Synchronize engineering, marketing, and support teams using Stakeholder Communication Plans during the final validation window.
- Avoid these deployment failures:
- Regex redirect over-matching causing 310/301 redirect chains and crawl budget waste.
- GA4 session fragmentation due to missing
_gacookie preservation across subdomains. - CDN cache invalidation failures serving legacy
robots.txtor blocked assets to Googlebot. - Headless CMS hydration delays blocking server-side rendering and delaying indexation.
- Incorrect
rel="canonical"pointing to legacy domains post-migration, triggering duplicate content penalties.
Rollback Triggers
Define automated rollback triggers and monitoring thresholds to mitigate migration downtime and data loss.
- Establish automated alert thresholds for 4xx/5xx spikes, crawl budget exhaustion, and conversion rate drops using Datadog or New Relic synthetic monitors.
- Trigger immediate rollback if 5xx error rates exceed 2%.
- Trigger immediate rollback if organic traffic drops >30% within 2 hours of cutover.
- Trigger immediate rollback if critical conversion endpoints return non-200 status codes.
- Document automated rollback scripts and assign technical ownership for rapid execution.
FAQ
How do I preserve conversion attribution during DNS propagation?
Implement cross-domain linker tracking in GTM, maintain dual-domain GA4 data streams until propagation completes, and verify _ga cookie persistence using browser developer tools.
What is the optimal TTL reduction timeline for a domain migration?
Lower TTL to 300 seconds 48 hours prior to cutover, verify global propagation with dig or nslookup, execute DNS record swap during low-traffic windows, and monitor resolver latency.
How can I validate redirect mapping without crawling the live site?
Use staging environment curl -I -L batch scripts and Screaming Frog list mode against a pre-exported URL inventory to verify 301 accuracy, chain length, and destination parity.
What triggers an immediate migration rollback? Automated rollback should trigger if 5xx error rates exceed 2%, organic traffic drops >30% within 2 hours, or critical conversion endpoints return non-200 status codes.