店铺连接指南
将您的市场店铺连接到 Revenuealot，解锁强大的分析、自动化和优化工具。本指南涵盖连接 Takealot 和 Makro 店铺。
开始之前
重要: 您必须拥有有效的订阅计划才能连接店铺。如需要，请访问计划页面进行升级。
您需要准备：
- 访问您的 Takealot 卖家中心的权限
- 您的 Takealot API 凭证
- 对于 Makro：您的 Makro 卖家登录凭证
- 店铺管理员权限
连接 Takealot 店铺
概述
连接您的 Takealot 店铺后，Revenuealot 将通过 API 和智能采集技术同步：
- 📦 产品数据和库存：实时同步您的 Listing 详情和库存水平。
- 💰 销售和收入指标：全面的销售仪表盘和收入分析。
- 📊 订单和退货信息：自动拉取历史和实时订单及退货状态。
- 🎯 广告活动数据：追踪广告支出回报率 (ROAS) 和活动表现。
- ⭐ 产品评论和评分：监控客户反馈和产品评分趋势。
步骤 1：获取您的 Takealot API 凭证
-
访问 API 密钥管理页面
- 访问 Takealot 卖家 API 密钥管理
- 如需要，使用您的卖家凭证登录
-
生成 API 密钥
- 点击 “生成新 API 密钥” 或创建新密钥
- 复制 API 密钥（您将无法再次看到它！）
专业提示: 将您的 API 密钥存储在安全的密码管理器中。下一步您会需要它。
步骤 2：在 Revenuealot 中添加店铺
-
导航到店铺设置
- 前往 仪表板 → 设置 → 店铺
- 点击 “添加 Takealot 店铺”
-
输入店铺信息
填写必填字段：
- 店铺名称: 给您的店铺一个易识别的名称（例如：“主要 Takealot 店铺”）
- 卖家 ID: 粘贴您的 Takealot 卖家 ID
- API 密钥: 粘贴步骤 1 中的 API 密钥
- API 密钥: 粘贴您的 API Secret（如果提供）
-
测试连接
- 点击 “测试连接” 验证凭证
- 您应该看到 ✅ 成功消息
-
保存店铺
- 点击 “保存并连接”
- 等待初始数据同步（可能需要 5-15 分钟）
首次同步: 初始数据同步可能需要长达 30 分钟，具体取决于您的店铺规模。完成后您将收到电子邮件通知。
步骤 3：验证数据同步
-
检查仪表板
- 导航到仪表板
- 您应该看到您的 Takealot 店铺已列出
- 验证基本指标正在显示
-
查看产品
- 前往产品
- 确认您的产品可见
- 检查价格和库存水平是否正确
-
查看店铺指标
- 访问店铺指标
- 验证销售数据正在填充
✅ 成功！ 您的 Takealot 店铺现已连接并正在同步。探索仪表板查看您的数据。
连接 Shopify 店铺
概述
Shopify 店铺的连接使用 OAuth 授权流程。我们只需要您的店铺的永久 Shopify 域名（即原始的 *.myshopify.com 域名）。如果您为店铺配置了自定义域名（例如 www.example.com），请使用 your-store.myshopify.com 这一永久域名进行连接 —— 即使您日后添加或更改自定义域名，myshopify 域名仍然有效。
只需填写店铺前缀：在 Revenuealot 中添加 Shopify 店铺时，仅填写 .myshopify.com 之前的部分（例如，对于 your-store.myshopify.com，请输入 your-store）。界面会自动补充 .myshopify.com 后缀。
步骤 1：查找您的永久 Shopify 域名
-
登录 Shopify 管理后台
- 使用您的 Shopify 管理员账号登录。
-
前往域名设置
- 导航到 Online Store → Domains（或在部分管理界面为 Settings → Domains）。
- 查找以
.myshopify.com结尾的域名，这就是您的永久 Shopify 域名（例如：your-store.myshopify.com）。
-
如果只看到自定义域名
- 点击域名管理或查看商店链接，Domains 面板通常会列出原始的
*.myshopify.com域名。
- 点击域名管理或查看商店链接，Domains 面板通常会列出原始的
有时 Domains 面板会列出多个以 *.myshopify.com 结尾的域名（例如商店历史上更改过 myshopify 域名）。标有 Primary 的项是当前的 myshopify 域名；旧的 *.myshopify.com 域名通常会被保留并重定向到主域名。任一列出的 *.myshopify.com 条目都能用于识别您的店铺，但如果不确定建议优先使用标有 Primary 的条目。
步骤 2：在 Revenuealot 中添加 Shopify 店铺
- 进入店铺设置
- 前往 仪表板 → 设置 → 店铺
- 点击 “添加店铺” 并选择 Shopify
- 输入店铺前缀
- 在店铺域名字段中仅输入前缀（即
.myshopify.com之前的部分）。示例：对于your-store.myshopify.com，请输入your-store。
- 在店铺域名字段中仅输入前缀（即
- 点击连接
- 系统会跳转到 Shopify 页面，请在 Shopify 页面上确认授权以完成连接流程。
常见错误：不要包含 https://、www. 或尾部斜杠。只需输入店铺前缀（不要包含 .myshopify.com）。
连接 Makro 店铺
概述
Makro 集成采用混合模式（凭证 + 邮件转发）提供：
- 🏪 产品列表管理：使用您的卖家凭证直接管理产品上架和更新。
- 📈 性能跟踪：基于解析的数据追踪店铺整体表现。
步骤 1：在 Revenuealot 中添加店铺
-
导航到店铺设置
- 前往 仪表板 → 设置 → 店铺
- 点击 “添加店铺” 并选择 Makro
-
输入店铺凭证
- 在下拉列表中选择 Makro
- 输入您的登录凭证
步骤 2：配置邮件自动转发
为了确保与您的 Makro 账户不间断集成，您必须设置永久邮件自动转发，将所有来自 Makro 关联账户的邮件转发到 RD@revenuealot.com。这是必需的，因为 Makro 没有提供足够的 API 访问权限来实现自动化，所以我们的系统依赖于直接接收账户相关邮件。
-
配置自动转发
-
登录与您的 Makro 卖家账户关联的电子邮箱。
-
设置规则将所有来自 Makro 的邮件自动转发到：
RD@revenuealot.com
-
-
常用邮件提供商设置指南：
- Gmail: 自动转发邮件
- Outlook: Microsoft 365: 设置收件箱转发规则
- Lark: 设置邮件转发
- 其他: 在您的邮件应用中搜索”自动转发”。
多店铺管理
添加多个店铺
您的订阅计划决定了您可以连接多少个店铺：
| 计划 | 店铺限制 |
|---|---|
| Starter | 1 个店铺 |
| Business | 3 个店铺 |
| Enterprise | 10 个店铺 |
添加更多店铺：
- 前往设置 → 店铺
- 点击 “添加店铺”
- 选择市场（Takealot/Makro）
- 按照上述连接步骤操作
在店铺之间切换
在您的店铺之间导航：
- 使用顶部导航中的店铺选择器下拉菜单
- 或访问仪表板并点击店铺卡片
管理店铺访问权限
控制团队成员对特定店铺的访问权限：
- 前往 设置 → 团队
- 点击团队成员
- 在 店铺访问权限 下，选择他们可以查看的店铺
- 保存更改
故障排查
Takealot 连接问题
问题: “验证失败” 或 “无效的 API 凭证”
可能原因：
- API Key 与 User ID 不匹配。
- API Key 已过期或被撤销。
- 输入了错误的 User ID（请确保是 User ID 而不是 Seller ID）。
解决方案：
- 登录 Takealot Seller Portal 重新生成 API Key。
- 确保复制的是完整的 API Key 字符串。
- 确认 User ID 正确无误（通常在 API Key 生成页面可见）。
Makro 连接问题
问题: “Makro 账号验证失败”
原因：
- 用户名或密码错误。
- Makro 门户正在进行维护。
解决方案：
- 尝试直接登录 Makro Seller Portal 确认凭证有效。
- 确保没有输入多余的空格。
- 如果更改了 Makro 密码，请在 Revenuealot 中更新凭证。
一般连接提示
✅ 最佳实践：
- 连接店铺时使用稳定的互联网连接
- 初始同步期间不要刷新页面
- 保持 API 凭证安全，切勿分享
- 如果更改密码，请重新测试连接
❌ 避免这些错误：
- 公开分享 API 密钥或与团队成员分享
- 在多个平台上使用相同的 API 密钥
- 忽略”连接丢失”警告
安全与数据隐私
我们如何处理您的数据
您的数据安全是我们的首要任务。所有店铺凭证和数据都经过加密并安全存储。
- 🔒 加密: 所有数据在传输（TLS 1.3）和静止（AES-256）时都经过加密
- 🔑 凭证: API 密钥使用行业标准加密存储
- 🛡️ 访问控制: 只有授权的团队成员才能查看店铺数据
- 📊 数据使用: 您的数据永远不会与第三方共享
- 🗑️ 数据删除: 您可以随时断开店铺连接并删除数据
撤销访问权限
断开店铺连接并撤销 Revenuealot 的访问权限：
- 前往 设置 → 店铺
- 点击要断开连接的店铺
- 点击 “断开店铺连接”
- 确认操作
警告: 断开店铺连接将停止所有数据同步。历史数据将保留但不会更新。
常见问题
初始同步需要多长时间？
初始同步通常需要 5-30 分钟，具体取决于：
- 产品数量（100 个产品 ≈ 5 分钟，1000+ 产品 ≈ 30 分钟）
- 历史数据量（最近 12 个月）
- 当前 API 负载
- 您的订阅计划（更高计划获得更快同步）
我可以连接同一店铺两次吗？
不可以，每个店铺在每个组织中只能连接一次。但是，多个团队成员可以访问同一个已连接的店铺。
如果达到店铺限制会怎样？
如果达到计划的店铺限制：
- 尝试添加新店铺时会看到消息
- 选项：升级计划或购买额外的店铺附加服务
- 现有店铺继续正常工作
连接会影响我的 Takealot/Makro 账户吗？
不会。Revenuealot 仅从您的店铺读取数据（经您许可）。我们从不：
- 未经您明确操作而修改您的列表
- 进行未经授权的购买或更改
- 与竞争对手共享您的数据
- 访问授予权限之外的任何内容
下一步
🎉 店铺已连接！ 您的市场数据现在正在流入 Revenuealot。开始探索您的分析！
需要帮助？
我们的支持团队随时准备协助您进行店铺连接：
- 📧 电子邮件：support@revenuealot.com
- 💬 在线聊天：仪表板中可用（右下角）
- 📚 文档：您正在阅读它！