在 Shopify 应用商店上发布您的应用

本指南提供了完整的提交手册：技术要求、设计标准、列表优化以及将应用程序从零安装转变为稳定的每月经常性收入的增长策略。

要点

• Shopify 的审核流程平均需要 10-15 个工作日 - 相应地规划您的发布时间表
• 对于嵌入式应用程序部分，Polaris 设计系统合规性是不容协商的
• 应用列表质量直接影响从搜索结果到安装的转化 - 对其进行投资
• 入职流程质量是一项审核标准 - 首次运行体验必须直观，无需 Shopify 员工帮助
• 定价透明度要求：所有费用必须使用 Shopify Billing API，不得进行平台外付款
• 隐私合规性（GDPR、CCPA）文档必须准确且完整
• 前 6 个月的 4.0+ 评论评级对于持续的 App Store 知名度至关重要
• 合作伙伴仪表板分析准确揭示商家放弃安装渠道的位置

---

合作伙伴帐户和应用程序设置先决条件

提交之前，您的 Shopify 合作伙伴帐户和应用程序配置必须完成。

合作伙伴帐户要求：

1. 已验证 Shopify 合作伙伴帐户（partners.shopify.com）
2. 用于收入支付的银行账户 3.启用双因素身份验证
3. 接受合作伙伴协议（包括收入分成：Shopify 收取 20% 的订阅费，永久免费的应用程序收取 0% 或在收入分成重组下年收入超过 100 万美元）

合作伙伴仪表板中的应用程序配置：

导航到应用程序 > 创建应用程序。配置：

• 应用程序名称：独特、描述性、名称中不含“Shopify”（商标政策）
• 应用程序 URL：您的生产应用程序 URL（必须使用 HTTPS）
• 允许的重定向 URL：包括 OAuth 流程中使用的所有回调 URL
• 范围：仅请求最低限度的必要范围 - 过多的范围请求会触发审核拒绝
• 应用程序代理（如果适用）：配置 URL 路径和目标 URL

GDPR 合规性 Webhook（所有应用程序都需要）：

# shopify.app.toml
[[webhooks.subscriptions]]
topics = ["customers/data_request"]
uri = "/webhooks/gdpr/customers-data-request"

[[webhooks.subscriptions]]
topics = ["customers/redact"]
uri = "/webhooks/gdpr/customers-redact"

[[webhooks.subscriptions]]
topics = ["shop/redact"]
uri = "/webhooks/gdpr/shop-redact"

这三个端点必须在5秒内返回200并实际处理数据删除/导出请求。审核小组测试这些端点。在未实现功能的情况下返回 200 会导致批准后删除。

---

技术审查要求

Shopify 的审核团队执行手动和自动技术检查。在提交之前通过所有这些。

身份验证和安全性：

API使用要求：

• 切勿使用已弃用的 API 版本 — 始终使用过去 12 个月的版本
• 妥善处理 API 速率限制（429 响应必须触发重试，而不是向商家显示错误）
• 卸载后切勿代表商户进行API调用
• 收到 shop/redact webhook 后 48 小时内清理所有商家数据

应用程序性能基准：

• 嵌入式应用程序初始加载：平均商用硬件不到 3 秒
• 正常使用期间浏览器控制台中没有 JavaScript 错误
• 所有页面在 Chrome、Firefox、Safari 和 Edge 上都能正确呈现
• 如果您的应用程序有任何面向客户的组件，则具有移动响应能力

入职流程审核：

审核团队会安装您的应用程序并在没有文档的情况下评估首次运行体验。您的入职必须：

1. 在第一个屏幕中清楚地解释应用程序的功能
2. 指导新用户完成所需的设置步骤
3. 无需联系支持人员即可完成初始配置
4. 使用 Polaris CalloutCard 或 Banner 组件进行入门提示

---

设计和用户体验标准

Shopify 的设计要求得到严格执行，因为整个管理员的商家体验一致性是平台的核心价值。

强制使用北极星：

嵌入式应用程序中的所有 UI 元素（在 Shopify 管理 iframe 中呈现）必须使用 Polaris 组件。特别禁止：

• 与 Polaris Button 样式不匹配的自定义按钮组件
• 自定义表单输入与 Polaris TextField、Select、Checkbox 样式不匹配
• 偏离北极星设计令牌的自定义配色方案
• 不使用 Polaris Spinner 或 SkeletonPage 的自定义加载状态

应用桥导航：

嵌入式应用程序必须使用 App Bridge 进行导航操作。使用 window.location.href 或 <a> 标签在嵌入式上下文中进行导航会破坏商家体验。用途：

import { useNavigate } from "@remix-run/react";

// For in-app navigation
const navigate = useNavigate();
navigate("/app/settings");

// For external links (opens in new tab, respecting embedded context)
import { useAppBridge } from "@shopify/app-bridge-react";
const app = useAppBridge();
// Use Redirect action for external URLs

错误状态：

审核小组专门测试错误情况。每个表单必须处理：

• 网络错误（显示 Banner 和错误消息，而不是空白页）
• 验证错误（内联，位于相关字段旁边）
• 空状态（使用带有操作的 Polaris EmptyState 组件）
• 加载状态（使用 SkeletonPage 进行初始加载，使用 Spinner 进行操作）

无障碍要求：

• 所有图像必须有描述性替代文本
• 交互元素必须是键盘可导航的
• 颜色对比度必须符合 WCAG AA 标准（如果使用正确，则由 Polaris 处理）
• 所有仅图标按钮上的屏幕阅读器标签

---

应用商店发现的列表优化

您的应用程序列表是一个销售页面。通过搜索或类别浏览找到您的应用程序的商家会在几秒钟内根据您的列表质量做出安装决定。

应用名称优化：

您的应用名称出现在搜索结果中，并且应传达主要优势。 “电子邮件营销自动化”的相关搜索排名高于“MailBooster Pro”。将名称控制在 30 个字符以内，以便在搜索结果中清晰显示。

应用标语：

一句话，最多 60 个字符。以利益而非功能为主导。 “恢复多 15% 的废弃购物车”优于“自动购物车恢复电子邮件”。

应用程序描述结构：

Paragraph 1 (above the fold): Core value proposition and primary use case.
What problem does your app solve? For whom? What is the primary outcome?

Paragraph 2: Key features and how they deliver the benefit.

Paragraph 3: Social proof — merchants using the app, notable results, reviews.

Feature list (bullet points): 5-8 specific features with brief descriptions.

Paragraph 4: Integration information, compatibility notes.

Paragraph 5: Support and documentation resources.

截图要求：

• 最少 3 张屏幕截图，最多 8 张
• 分辨率：最小 1600x900 像素
• 显示您的应用程序正在使用中 - 而不是营销图形或功能图
• 第一个屏幕截图是最重要的 - 它出现在搜索结果中
• 对屏幕截图进行注释以突出显示关键功能
• 包含视频演练（30-90 秒）——带有视频的应用程序转换效果提高 40%

类别和关键词选择：

选择能够准确描述您的应用程序的最具体的类别。错误分类的应用程序会在搜索排名中受到惩罚。对于关键词：包括同义词、用例描述以及商家实际搜索的问题陈述。不要在描述中填充关键字 - Shopify 的算法非常复杂，会惩罚不自然的密度。

---

定价页面策略

定价架构会显着影响安装转化率和流失率。

免费增值模式性能：

具有免费套餐的应用程序的安装率比纯付费应用程序高 3-5 倍。免费套餐创建了一个转化渠道：商家免费安装 → 体验价值 → 高级功能升级。将您的免费套餐设计为真正有用，但以一种使升级自然的方式受到限制（使用限制、功能门、商家数量上限）。

定价页面最佳实践：

• 通过清晰的功能比较表显示所有计划
• 突出显示推荐的计划（大多数应用程序使中间层“流行”）
• 如果提供付费计划，请提供退款保证
• 即使提供年度定价，也使用每月定价作为主要显示
• 绝不显示与 Billing API 收费不同的定价 - 审核会自动拒绝

Shopify 计费 API 实施：

所有费用都必须通过 Shopify 的计费 API 进行。应用内功能禁止使用平台外支付链接（Stripe、PayPal）。您可以为专业服务进行平台外付款，但应用程序功能必须受计费 API 计划的限制。

// billing configuration example for tiered pricing
billing: {
  "Starter": {
    amount: 9.99,
    currencyCode: "USD",
    interval: BillingInterval.Every30Days,
    trialDays: 14,
  },
  "Professional": {
    amount: 29.99,
    currencyCode: "USD",
    interval: BillingInterval.Every30Days,
    trialDays: 14,
  },
  "Enterprise": {
    amount: 99.99,
    currencyCode: "USD",
    interval: BillingInterval.Every30Days,
  }
}

---

评论提交流程

预提交清单：

• 应用程序干净地安装在新开发的商店上
• OAuth 流程完成且没有错误
• 所有 GDPR Webhooks 返回 200 并正确处理
• 应用程序卸载干净（会话已删除，没有孤立数据）
• 入门流程指导新用户完成设置，无需外部帮助
• 所有用于嵌入式 UI 的 Polaris 组件
• 应用程序在受限制的连接上加载时间不到 3 秒
• 隐私政策 URL 是实时且准确的
• 应用程序列表屏幕截图显示真实的应用程序 UI
• 定价页面完整且符合计费 API 配置
• 应用程序正常运行期间没有控制台错误
• 优雅地处理速率限制
• 在多个浏览器上测试（Chrome、Firefox、Safari、Edge）

提交审核：

在合作伙伴仪表板中，导航至您的应用程序 > 分发 > 提交以供审核。提供：

1. 测试说明：审核团队安装和使用每个功能的具体步骤
2. 测试凭据：您的应用程序连接到的任何第三方集成的登录详细信息
3. 视频演练（可选，但建议复杂应用程序使用）：2-5 分钟演示
4. 变更日志注释（用于更新）：变更内容及原因

提交后：

• 提交后 3 个工作日内开始审核
• 初步审核反馈通常会在 10-15 个工作日内到达
• 如果被拒绝，您会收到具体反馈 - 在重新提交之前解决所有问题
• 重新提交队列更快（通常 5-7 个工作日）

---

发布后增长策略

批准是第一天，而不是终点线。应用商店的持续增长需要积极的管理。

评论生成：

评论少于 10 条的应用的转化率明显低于评论超过 50 条的应用。在商家实现有意义的里程碑（发送的前 100 封电子邮件、第一个恢复的购物车、第一个同步的订单）后，实施应用内审核请求。使用 Shopify 的本机评论请求流程：

// Trigger in-app review prompt via App Bridge
import { Modal, TitleBar } from "@shopify/app-bridge/actions";

// Display after user achieves milestone
const modal = Modal.create(app, {
  title: "Leave a review",
  url: `https://apps.shopify.com/your-app/reviews`,
});
modal.dispatch(Modal.Action.OPEN);

功能发布节奏：

经常发布更新的应用程序在 Shopify 的“新的和更新的”过滤器中排名较高，并表现出积极的维护——这是商家的关键购买信号。目标是每 4-6 周至少进行一次有意义的更新。

支持质量：

Shopify 监视器支持响应时间和解决率。支持响应时间超过 48 小时的应用的评价分数会下降。使用 Shopify 的内置支持收件箱（可从合作伙伴仪表板访问）获得一级支持，并针对复杂问题升级至电子邮件/Slack。

应用商店优化 (ASO)：

每月跟踪您在 App Store 搜索中的关键字排名。使用合作伙伴仪表板分析来确定哪些搜索词会带来展示次数和安装次数。 A/B 测试您的应用程序列表标题和口号 - 即使转化率方面的微小改进也会在规模上显着地增加。

---

常见问题

Shopify 应用商店审核需要多长时间？

初步审核通常需要 10-15 个工作日（2-3 周）。解决拒绝反馈后重新提交需要 5-7 个工作日。具有第三方集成或异常权限范围的复杂应用程序可能需要更长的时间，因为审核者需要更多时间来验证功能。规划您的发布时间表，从提交到公开可用有 8 周的缓冲时间：2 周用于首次审核，2 周用于处理反馈，1 周用于重新提交审核，3 周缓冲用于处理意外问题。

App Store 拒绝的最常见原因是什么？

五个最常见的拒绝原因是：(1) 嵌入部分未遵循 Polaris 设计标准，(2) GDPR Webhooks 未正确实施，(3) 应用程序功能未证明过多的 API 范围请求，(4) 入门流程需要外部文档才能完成，(5) 定价结构包括应用程序内功能的平台外支付选项。在提交之前主动解决所有五个问题，以显着降低拒绝概率。

我可以将我的应用程序列为免费并稍后添加付费计划吗？

是的，这是推荐的策略。免费推出以建立初始安装量和评论，然后在拥有 50 多个活跃商家和 4 星以上评级后推出付费计划。如果需要，可以使用 Shopify 的 Billing API 祖父功能让现有用户保留免费访问权限。免费发布会产生评论和社会证明，当付费计划上线时，可以显着提高转化率。

如果我的应用在批准后违反政策会怎样？

Shopify 监控已发布应用程序的政策合规性。违规可能会导致：警告并规定补救期限、从 App Store 暂停（现有安装继续，但不再有新安装）或从 App Store 删除（所有安装都失去访问权限）。常见的批准后违规行为包括：通过安全审核发现的 API 凭证硬编码、应用程序 UI 中发现的平台外支付链接以及数据保留违规（卸载后存储商家数据）。

应用程序的可发现性评级有多重要？

评级是 Shopify App Store 排名算法中最重要的因素之一。 4.0 以下的应用程序在搜索结果和类别浏览中受到明显抑制。评分超过 4.7 的应用程序会出现在精选的“首选”部分中。积极监控您的评论，以专业的方式和解决方案回应负面评论，并实施系统的评论请求流程，以随着时间的推移保持健康的评级。

---

后续步骤

构建一款能够通过 Shopify 审核并达到可持续 MRR 的应用需要 Shopify 技术标准、应用商店列表优化和商家获取策略方面的专业知识。

ECOSIRE 的 Shopify 应用开发服务 涵盖从架构到 App Store 审批的完整旅程：技术开发、审核准备、列表优化和发布后增长支持。我们的应用程序首次提交批准率为 92%。

开始使用 ECOSIRE 构建您的 Shopify 应用 — 与我们的开发团队讨论您的应用概念。