PPCWISER 琼仁智度 LogoPPCWISER琼仁智度
接入教程 · 中转客户端

安装中转客户端并录入凭证:亚马逊请求从你自己的电脑发出

琼仁智度的计算在云端,但所有发往亚马逊的请求都由你电脑上的中转客户端发出:用你本机保存的凭证、从你自己的宽带出口。这一页带你装好它,并把 Ads API、SP-API 与 AWS 只读密钥录进去。

30 天免费试用¥99/月/店铺起凭证只存你自己的电脑
电脑要求

中转客户端对电脑有什么要求?

项目要求说明
操作系统Windows 10 / 11目前只提供 Windows 版安装程序
权限安装时需要管理员权限安装程序会自动请求提权;装好后以系统服务运行,无需有人登录 Windows
Python预装 Python 3.10 或更高版本从 python.org 下载安装程序,勾选加入 PATH;为所有用户安装需选 Customize installation [1]。不要用 Microsoft Store 版
安装路径建议纯英文路径避免中文或特殊字符路径导致的兼容问题
硬件无特殊要求中转只转发请求、不做计算,安装目录只有几 MB,不含数据库
开机计算与下发时段保持开机联网下发途中关机,这一轮下发会随之中断
网络店铺自己的独立宽带与公网出口只需向外连接,无需任何入站端口;不要与其他店铺共用路由、VPN 或代理出口;中转不使用系统代理设置
杀毒软件允许安装程序处理,或手动加入信任见下文“杀毒软件拦截怎么办”
分步演示

跟着动画装好中转客户端

示例值均为占位。点左侧任一步可单独查看。

示意动画。安装界面与设置页字段以你收到的版本为准。
图文步骤

中转客户端安装:详细步骤

预装 Python 3.10 或更高版本

python.org → Downloads → Windows

用官方完整安装程序,勾选把 Python 加入 PATH;要为所有用户安装,选择 Customize installation,这可能需要管理员授权,并会安装到 Program Files [1]。不要使用 Microsoft Store 版本。

从顾问处取得安装包、云端地址与配对码

开通后由顾问发送

配对码一次性、短时效,只显示一次。过期或丢失请顾问重新生成,旧码随即失效。

双击安装程序(自动请求管理员权限)

中转安装包 → 双击安装程序

填写云端地址与配对码后,安装程序自动完成 6 件事:① 体检(管理员、Python、云端可达,远程地址必须是 HTTPS);② 如果这台电脑装过旧版客户端,先停用旧服务并取消自启(不卸载),避免两套程序同时操作一个账户;③ 安装到本机独立目录并装好依赖;④ 用配对码换取长期身份,只保存在本机;⑤ 注册为系统服务,开机自启、无需登录、崩溃或断网自动恢复、同一台电脑只运行一个;⑥ 打开本机设置页。

在本机设置页录入凭证与账户 ID

本机设置页(只能在这台电脑上打开)

这是录入全部亚马逊凭证的统一入口,字段来源见下表。保存后即时生效,无需重启。设置页能识别并拒绝恶意网页的跨站篡改,见 中转客户端安全设计。

顾问确认中转在线

琼仁智度管理端

中转上线后,顾问会在管理端看到它在线,并做一次链路自检。之后系统通过你的中转同步广告与订单数据,进入 上线接入流程 的下一步。

日常:计算与下发时段保持开机

这台 Windows 电脑

中转以系统服务运行,开机即自动启动。夜间可以关机,但计算与下发时段必须在线,具体时段开通时顾问会告诉你。

字段对照

本机设置页的每一栏,从哪里拿?

区块字段从哪里来
广告 APIClient ID / Client Secret你的 Login with Amazon 安全配置文件,见 创建安全配置文件
广告 APIRefresh Token授权后获得;自同意之日起 365 天到期,需重新授权 [2]
广告 APIProfile ID(必填)调用 GET /v2/profiles 取美国站那一条 [3],见 获取 Profile ID
SP-APIClient ID / Client Secret开发者中心 → 你的应用 → LWA credentials → View [4]
SP-APIRefresh Token私有应用自授权(Authorize app)生成 [5],见 创建应用与自授权
账户标识Marketplace ID(必填)美国站为 ATVPDKIKX0DER [6]
账户标识Seller ID(必填)卖家中心账户信息里的卖家记号(Merchant Token),以卖家中心页面为准
账户标识Advertiser ID 等按设置页提示,视所用功能填写
AWS / S3(强烈建议)区域、4 个桶名与前缀、访问密钥见 AWS 教程第 5 步;秘密访问密钥只在创建时显示一次 [7]

设置页会做成对校验:广告 API 三项要么全填要么全空,SP-API 同理,AWS 两个密钥必须成对填写。已保存的密钥不会回显原文。

离线时

电脑关机、断网,会发生什么?

  1. 云端很快知道:中转离线会被及时标记;离线持续一段时间,系统会同时提醒你和顾问,回线后自动解除。
  2. 不乱来:离线期间需要中转执行的任务会被推迟,而不是反复硬重试把问题放大。
  3. 回线补做:中转回来后,系统自动补做漏掉的读取、同步与下发,补做有次数上限,不会无限重试。
  4. 亚马逊端的设置保留:已经下发的出价、版位与时段规则保存在亚马逊,不会因为系统离线被清空;但离线期间不会有新的调整,例如日内高峰与低谷的切换不会发生。
  5. 小时级数据补回:离线期间的数据文件仍在你的 S3 里,回线后的同步会重新取回。

详见 电脑关机、断网,广告不失控。

杀软、回滚与升级

杀毒软件拦截、想撤下中转、要升级,怎么办?

杀毒软件拦截怎么办

部分杀毒软件可能把中转用来托管系统服务的组件误判拦截。安装程序会尝试为这个单独的文件添加排除并恢复被隔离的文件;仍不行时,自动改用 Windows 计划任务方式运行,功能等效。360、火绒等第三方杀毒软件需要你手动把中转客户端加入信任。

回滚:撤下中转

双击安装包里附带的回滚程序即可停止中转服务。本机已录入的凭证会保留,之后可以再切回。中转一停,云端就无法再操作你的亚马逊账户——总开关在你手里,见 总开关在你手里。

升级

升级不影响已录入的凭证与配对身份。

一台电脑只服务一家店同一台电脑只能运行一个中转、绑定一家店铺;两家店被检测到共用同一个公网出口时,系统会拒绝后接入的那一家。多店铺请各用各的电脑和宽带,见 一店一机一出口。系统只能控制自己发出的 API 请求,不能保证亚马逊不做关联判定。

中转客户端常见问题

能装在 Mac 或 Linux 上吗?
目前不行,安装程序只支持 Windows 10/11。建议用店铺自己的办公电脑和宽带,这样亚马逊看到的就是你自己的网络出口,见 亚马逊只看到你自己的网络。
电脑需要一直开着吗?
不需要全天开机,但计算与下发时段必须在线,具体时段开通时顾问会告诉你。中转以系统服务运行,开机后自动启动,不用登录 Windows。
我的凭证安全吗?你们能看到吗?
凭证只加密保存在这台电脑上,而且与这台电脑绑定,拷到别的电脑上无法解密;云端从不接收、从不存储。云端只拿到 Profile ID、Seller ID、桶名这类账户标识,它们用于计算,不能用来登录或调用接口。详见 凭证永不离开你的电脑。
需要在路由器上开端口或装内网穿透吗?
不需要。中转只主动向外连接,不开放任何入站端口,也不需要内网穿透、组网工具。
配对码过期了怎么办?
配对码是一次性、短时效的。过期或丢失,请顾问重新生成一个新码再安装。
安装时提示找不到 Python?
多半是安装 Python 时没有勾选加入 PATH,或装的是 Microsoft Store 版。用 python.org 的完整安装程序重装,勾选加入 PATH [1],再重新运行中转安装程序。

凭证留在你的电脑,计算交给琼仁智度

30 天免费试用,全部功能开放。API 可按教程自行申请,也可以请我们协助(¥499/次)。

入门版 ¥99/月/店铺 · 含 10 个产品 · 每增加 1 个产品 +¥10/月
继续了解

相关功能

上线前必读

上线接入流程

7 个环节:准备 → 开通 → 装中转 → 录入 → 同步 → 选方案 → 接管,每步谁做、做完什么样都写清楚。

查看 →
AWS 教程

AWS 小时级数据

5 步把亚马逊小时级广告数据接进你自己的 AWS,再交给中转客户端只读读取。

查看 →
凭证安全

凭证不离开你的电脑

凭证只加密存在你的电脑,云端从不接收、从不存储。

查看 →
离线保护

关机断网不失控

离线推迟、回线补做一次、超 2 小时双向提醒,亚马逊上的设置照常生效。

查看 →
多店铺

一店一机一出口

一台电脑只服务一家店,两家店共用公网出口时系统拒绝接入。

查看 →
客户端安全

中转客户端安全

不开入站端口、设置页仅本机、只认亚马逊请求、全程加密、自动恢复。

查看 →
REFERENCES

参考资料与权威来源

本页所有涉及亚马逊规则、行业数据与方法论的表述均标注来源。链接指向官方文档、同行评审论文、专利或法律法规原文;访问日期 2026-09。

  1. [1]官方Using Python on Windows(Python documentation) — Python Software Foundation · 2026Windows 完整安装程序可选择把安装目录加入 PATH;为所有用户安装须选择 Customize installation,可能需要管理员授权,并安装到 Program Files。
  2. [2]官方Refresh tokens — Amazon Ads API Docs · 20262026-07-30 及以后签发的 refresh token 自广告主同意之日起 365 天到期,到期日不因使用而延长,到期后须重新授权;撤销授权、移除应用、修改 LwA 凭证或可疑活动也会使其失效并返回 invalid_grant;建议加密保存并在到期前提醒重新授权。
  3. [3]官方Step 3: Retrieve a profile ID — Amazon Ads API Docs · 2026调用 GET /v2/profiles(请求头只需 Amazon-Advertising-API-ClientId 与 Authorization: Bearer)获取 profileId;返回空数组表示授权账号在该区域没有 View and Edit 权限。
  4. [4]官方View your Application Information and Credentials — Amazon Selling Partner API Docs · 2026在 Develop Apps → 找到应用 → Edit app → LWA credentials 下点 View,可查看应用的 LWA client identifier 与 client secret。
  5. [5]官方Authorize Private Applications — Amazon Selling Partner API Docs · 2026私有应用在草稿状态即可自授权:点 Authorize app 生成 refresh token,每点一次生成新 token 且不使旧 token 失效;须为该卖家中心账户的 Primary User;token 应加密保存、不写入日志或 URL;运行时向 api.amazon.com/auth/o2/token 换取有效期通常 3600 秒的 access token。
  6. [6]官方Store Identifiers(Marketplace IDs) — Amazon Selling Partner API Docs · 2026北美区域 Marketplace ID:美国 ATVPDKIKX0DER、加拿大 A2EUQ1WTGCTBG2、墨西哥 A1AM78C64UM0Y8、巴西 A2Q3Y263D00KWC;许多 SP-API 操作需用它指定目标站点。
  7. [7]官方Manage access keys for IAM users — AWS · 2026访问密钥由访问密钥 ID 与秘密访问密钥组成;秘密密钥只在创建时可取回,丢失只能删除后重建;每个用户最多 2 个访问密钥;不要用根用户创建访问密钥,不要把密钥写进应用文件或项目目录。