shopify-admin-referral-source-attribution

Compute first-touch Shopify order attribution from UTM, landing, and referrer URLs.

174|18|Updated Apr 11, 2026
One-click install
npx skills add https://github.com/40RTY-ai/shopify-admin-skills --skill shopify-admin-referral-source-attribution
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: shopify-admin-referral-source-attribution
Source: https://github.com/40RTY-ai/shopify-admin-skills/tree/main/skills/marketing/shopify-admin-referral-source-attribution
Command: npx skills add https://github.com/40RTY-ai/shopify-admin-skills --skill shopify-admin-referral-source-attribution

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Shopify native analytics often fail to break down orders and revenue by the real first-touch source (referrer, landing page, and UTM signals), so you cannot confidently tell which channels are actually converting.

Core Features & Use Cases

  • Order attribution from landing/referrer/UTM: Parses each order’s landingPageUrl, referrerUrl, and embedded UTM parameters to assign an attribution source (direct, organic, paid, social, email, or referral domain).
  • Revenue, AOV, and new-customer visibility: Aggregates orders into a table by category, referrer domain, or UTM value and computes orders, total revenue, AOV, and new-customer percentage.
  • Read-only export-ready analysis: Uses Shopify Admin GraphQL queries to produce attribution data safely for exporting and external modeling.

Quick Start

Run this skill to generate a 30-day attribution report grouped by utm_source with CSV output for your store.

Frequently Asked Questions about shopify-admin-referral-source-attribution

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I track Shopify order revenue by traffic source using UTM parameters?

Yes, you can generate a 30-day Shopify attribution report by configuring a lookback window and grouping dimensions. The skill queries Shopify Admin GraphQL to aggregate orders, total revenue, AOV, and new-customer percentage by referrer domain or UTM value.

Does this attribution analysis require Shopify Admin API access?

First-touch attribution assigns order revenue to the initial traffic source by parsing referrer URLs and UTM parameters. This approach solves the problem of Shopify native analytics failing to accurately break down converting channels for marketing analysis.

What happens if my Shopify orders are missing UTM tracking data?

When UTM tracking data is missing, the attribution analysis applies robust fallbacks by parsing the referrer URL and landing page URL. This ensures orders are still categorized to a traffic source domain rather than being excluded from the revenue report.

Can I export Shopify first-touch attribution data for external modeling?

Yes, you can export Shopify first-touch attribution data as read-only CSV or JSON output. This export-ready format allows you to feed channel-level revenue, AOV, and new-customer metrics directly into external modeling workflows.