shopify-admin-discount-ab-analysis
Compare redemption rates and revenue performance across two or more discount codes over a specified date range.
40RTY-ai · 已有 AI 审核记录
安装与使用
运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。
npx skills add 40RTY-ai/shopify-admin-skills --skill shopify-admin-discount-ab-analysis技能说明
name: shopify-admin-discount-ab-analysis role: conversion-optimization description: "Compare redemption rates and revenue performance across two or more discount codes over a specified date range." toolkit: shopify-admin, shopify-admin-execution api_version: "2025-01" graphql_operations:
- discountNodes:query
- orders:query status: stable compatibility: Claude Code, Cursor, Codex, Gemini CLI
Purpose
Compares how different discount codes perform against each other by redemption count and revenue generated. Useful for A/B testing promotional offers without a dedicated analytics app — provide two or more codes and a date range, and the skill queries Shopify for discount metadata and order revenue, then produces a side-by-side comparison table. Read-only: no mutations are executed.
Prerequisites
- Authenticated Shopify CLI session:
shopify auth login --store <domain> - API scopes:
read_discounts,read_orders
Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| store | string | yes | — | Store domain (e.g., mystore.myshopify.com) |
| format | string | no | human | Output format: human or json |
| dry_run | bool | no | false | Preview operations without executing mutations |
| discount_codes | array | yes | — | Array of 2 or more discount code strings to compare (e.g., ["SAVE10", "WELCOME15"]) |
| date_range_start | string | yes | — | Start date in ISO 8601 (e.g., 2025-01-01) |
| date_range_end | string | yes | — | End date in ISO 8601 (e.g., 2025-01-31) |
Workflow Steps
-
OPERATION:
discountNodes— query Inputs:first: 50,query: "code:<code>"(one query per code indiscount_codes) Expected output: Discount metadata: title, code strings,asyncUsageCount, status,startsAt,endsAtper code -
OPERATION:
orders— query (one paginated query per discount code) Inputs:first: 250,query: "discount_code:<code> created_at:>='<date_range_start>' created_at:<='<date_range_end>'", pagination cursor Expected output: Orders containing the discount code withtotalPriceSet; paginate untilhasNextPage: false; aggregate: count, sum revenue, compute avg order value
GraphQL Operations
# discountNodes:query — validated against api_version 2025-01
query DiscountNodes($first: Int!, $query: String) {
discountNodes(first: $first, query: $query) {
edges {
node {
id
discount {
... on DiscountCodeBasic {
title
codes(first: 10) {
edges {
node {
code
asyncUsageCount
}
}
}
usageLimit
status
startsAt
endsAt
}
... on DiscountCodeBxgy {
title
codes(first: 10) {
edges {
node {
code
asyncUsageCount
}
}
}
status
}
... on DiscountCodeFreeShipping {
title
codes(first: 10) {
edges {
node {
code
asyncUsageCount
}
}
}
status
}
}
}
}
}
}
# orders:query (by discount code) — validated against api_version 2025-01
query OrdersByDiscountCode($first: Int!, $after: String, $query: String) {
orders(first: $first, after: $after, query: $query) {
edges {
node {
id
createdAt
totalPriceSet {
shopMoney { amount currencyCode }
}
discountCodes
}
}
pageInfo {
hasNextPage
endCursor
}
}
}
Session Tracking
Claude MUST emit the following output at each stage. This is mandatory.
On start, emit:
╔══════════════════════════════════════════════╗
║ SKILL: discount-ab-analysis ║
║ Store: <store domain> ║
║ Started: <YYYY-MM-DD HH:MM UTC> ║
╚══════════════════════════════════════════════╝
After each step, emit:
[N/TOTAL] <QUERY|MUTATION> <OperationName>
→ Params: <brief summary of key inputs>
→ Result: <count or outcome>
On completion, emit:
For format: human (default):
══════════════════════════════════════════════
OUTCOME SUMMARY
Codes analyzed: <n>
Date range: <start> to <end>
Errors: 0
Output: none
══════════════════════════════════════════════
For format: json, emit:
{
"skill": "discount-ab-analysis",
"store": "<domain>",
"started_at": "<ISO8601>",
"completed_at": "<ISO8601>",
"dry_run": false,
"steps": [
{ "step": 1, "operation": "DiscountNodes", "type": "query", "params_summary": "<n> codes queried", "result_summary": "<n> discount nodes found", "skipped": false },
{ "step": 2, "operation": "OrdersByDiscountCode", "type": "query", "params_summary": "date range <start> to <end>", "result_summary": "<n> orders aggregated", "skipped": false }
],
"outcome": {
"codes_analyzed": 0,
"date_range_start": "<start>",
"date_range_end": "<end>",
"results": [
{
"code": "SAVE10",
"async_usage_count": 0,
"orders_in_range": 0,
"total_revenue": "0.00",
"avg_order_value": "0.00",
"revenue_per_use": "0.00"
}
],
"errors": 0,
"output_file": null
}
}
Output Format
A comparison table per code (displayed inline):
| Code | Uses (asyncUsageCount) | Orders in Range | Total Revenue | Avg Order Value | Revenue per Use |
|---|---|---|---|---|---|
| SAVE10 | ... | ... | ... | ... | ... |
| WELCOME15 | ... | ... | ... | ... | ... |
For `format: json
阅读完整来源 ↗