Tracking Shopify

Use this skill as the Shopify-specific branch contract after platform detection.

When To Use

Use this skill when:

• site-analysis.json reports platform.type: "shopify"
• the user says the target is a Shopify storefront
• sync or verification must produce Shopify custom pixel artifacts
• the shared discovery / grouping flow has already established that the run is on the Shopify branch

Shared Early Stages

Shopify still uses the same early workflow as generic sites:

• analysis
• page grouping
• page-group approval

Use tracking-discover and tracking-group for those phases.

Shopify-Specific Rules

Schema phase:

• run prepare-schema
• read shopify-schema-template.json
• read shopify-bootstrap-review.md
• keep ecommerce funnel events primarily as triggerType: "custom"
• validate selector-based CTA events, but do not expect selector checking to validate Shopify ecommerce custom events

Sync phase:

• sync also generates shopify-custom-pixel.js
• sync also generates shopify-install.md

Verification phase:

• do not expect standard automated GTM preview to be the source of truth
• install the Shopify custom pixel first
• validate with GA4 Realtime and Shopify pixel debugging tools

Required Output

Expect some or all of:

• <artifact-dir>/shopify-schema-template.json
• <artifact-dir>/shopify-bootstrap-review.md
• <artifact-dir>/shopify-custom-pixel.js
• <artifact-dir>/shopify-install.md
• updated <artifact-dir>/workflow-state.json

Stop Boundary

Stop after the Shopify-specific artifact or manual verification plan the user asked for.

Do not force the generic preview path on a Shopify run.

References

• ../../references/shopify-workflow.md
• ../../references/event-schema-guide.md
• ../../references/output-contract.md