本文介绍如何在 Ozon 的 Performance API 中获取广告凭证,并在 Linkfox 绑定已有 Ozon 店铺、添加广告账号。完成后,可在“广告账号 / Ozon Ads”列表核对接入结果。

操作路径:准备已有 Ozon 店铺 → 获取 Performance API 的 Client ID 和 Client Secret → 工作台 → 账号授权管理 → 添加授权账号 → 广告账号 / Ozon Ads → 选择绑定店铺并填写凭证 → 校验凭证 → 核对结果与广告账号列表。

当前流程点击“校验凭证”后会自动保存广告关联,无需复制授权链接、回填授权码或再次点击“完成授权”。店铺 Seller API 和广告 Performance API 是两组独立凭证,请勿混用。

授权前准备

如果尚未添加店铺,请先参考 如何添加授权ozon店铺账号,完成店铺接入后再添加广告账号。

在 Ozon 获取广告凭证

进入 Performance API 服务账号

登录 Ozon 卖家后台,确认目标店铺后,从头像进入设置 → API 集成 → Performance API。已有对应服务账号时打开该账号;需要新建时,点击“创建账户”,按平台提示创建后打开。

图 1 Ozon Global 官方中文帮助原图:选择 Performance API,点击“创建账户”。白色高亮为官方原图指引,中文菜单和操作说明保留;图为旧版 API 密钥布局,当前入口可能位于“API 集成”。

请认准 Performance API,不要进入 Seller API 获取店铺密钥。下图直接取自 Ozon 官方中文帮助,原图使用白色高亮提示操作位置;示例为旧版“API 密钥”布局,目前入口可能移至“设置 → API 集成 → Performance API”,以当前后台为准。

添加密钥并复制配套的两个值

打开服务账号详情,点击“添加密钥”;如果平台显示英文,对应入口为 Add new key。按页面提示填写密钥名称并确认,再从生成的同一条密钥记录中分别复制 Client ID 和 Client Secret。

图 2 Ozon Global 官方中文帮助原图:在目标服务账户中点击“添加密钥”,生成后从同一条记录复制 Client ID 和 Client Secret。图中字段值为官方历史示例及掩码,不能作为实际凭证。

官方示例图展示了已添加密钥后的记录:Client ID 被截断,Client Secret 以掩码显示,日期为历史示例。请在自己的目标服务账户中生成密钥并复制实际完整值,不要复制图片中的值、密钥名称、列表掩码或其他记录的凭证。本次未找到“添加密钥”后填写名称及首次展示完整密钥窗口的单独官方截图,相关细节按平台当前提示和本节文字操作。

本流程使用 Linkfox 当前提供的 Performance API 密钥录入方式。Ozon 平台其他授权入口是否适用于本次接入,应以 Linkfox 当前表单和实际校验结果为准。

在 Linkfox 添加广告授权

打开账号授权管理并添加账号

进入 Linkfox 工作台,点击右上方“账号授权管理”。普通成员的面板标题可能显示为“我的账号”。

图 3 工作台右上方的“账号授权管理”入口,1440×810 实拍。

确认当前团队已有目标 Ozon 店铺,然后点击“添加授权账号”。已有店铺记录仍会保留,本次为该店铺增加广告能力。

图 4 已有 Ozon 店铺时,点击“添加授权账号”(示例数据,1440×810)。

选择广告账号和 Ozon Ads

在“授权新账号”弹窗中,账号类型选择“广告账号”,授权平台选择“Ozon Ads”,点击“下一步”。

图 5 选择“广告账号 / Ozon Ads”,点击“下一步”(示例数据,1440×810)。

绑定目标店铺并填写广告凭证

确认顶部显示“当前授权:Ozon Ads / 广告账号”,再按下表填写。三个项目均为必填。

图 6 Ozon Ads 表单:绑定已有店铺,并填写 Performance API 的 Client ID 和 Client Secret(示例数据,1440×810)。
表单项目应选择或填写的内容核对重点
绑定到 Ozon 店铺选择本次要开通广告能力的已有店铺下拉标签可能带店铺 Client ID,用于区分同名店铺。
Client IDPerformance API 密钥记录中的完整 Client ID这是广告侧 Client ID,不是绑定店铺下拉标签里的 Seller API 数字标识。
Client Secret与上方 Client ID 来自同一条记录的完整 Client Secret粘贴完整值;输入后以掩码显示。不要填店铺 API Key。

广告记录沿用所绑定店铺的名称,当前表单无需另外填写“广告账号名称”。请先核对绑定店铺,再核对广告凭证归属。

图 7 选择绑定店铺、填写配套的广告凭证后,点击“校验凭证”。图中均为虚构凭证(示例数据,1440×810)。

页面中的“官方授权引导”目前为不可用入口;可直接按本教程获取凭证并填写。若“校验凭证”仍不可点击,检查是否已选择店铺、两个凭证字段是否均有完整内容。

校验凭证并等待自动保存

点击“校验凭证”后等待处理,不要重复提交。系统校验并保存成功后,直接显示“账号关联已完成”。无需再经过一页手动确认保存。

图 8 广告关联保存后的结果页:“账号关联已完成”,官方授权显示“已校验”(示例数据,1440×810)。

核对结果表中的绑定店铺,以及“官方授权:已校验”。“数据同步:进行中”与凭证接入结果分别显示,不代表广告报告已全部同步完成;后续请结合实际广告数据页面核查。

Performance API 凭据只用于广告能力,不替换店铺的 Seller API 密钥。Client Secret 保存后不会在结果页或账号列表中回显明文。

返回广告账号列表核对结果

点击“返回账号列表”;普通成员可能看到“返回我的账号”。将账号类型筛选为“广告账号”、平台筛选为“Ozon Ads”,核对店铺名称、广告 Client ID 掩码及“已授权”状态。必要时点击“刷新”。

图 9 在“广告账号 / Ozon Ads”列表核对店铺名称、广告 Client ID 掩码和授权状态(示例数据,1440×810)。

同一店铺在“店铺账号 / Ozon”和“广告账号 / Ozon Ads”中可分别显示,这是不同业务能力的记录展示。核对广告时请选择 Ozon Ads,不要只看店铺账号的授权状态。

需要管理团队成员的使用权限时,由团队创建者或管理员在账号列表的“更多 → 成员权限”中处理,以当前页面可用入口为准。

常见问题与处理

没有可绑定的 Ozon 店铺

若下拉框显示“暂无可选项”,并提示“暂无可绑定的 Ozon 店铺,请先完成 Ozon 店铺授权或刷新账号列表”,应先确认当前团队中已添加目标店铺。没有店铺时先完成 Ozon 店铺授权;已有店铺时刷新列表,并确认当前账号能看到对应记录。

图 10 没有可绑定店铺时,下拉与校验按钮不可用,应先添加店铺或刷新账号列表(示例数据,1440×810)。

若提示“正在加载 Ozon 店铺列表”,先等待加载完成;这与加载后确实没有可选店铺是两种情况。

凭证校验失败

页面会保留已填写内容,并在 Client Secret 附近显示错误原因。修正后点击“重新校验”。

图 11 广告凭证校验失败后,按红色提示修正,再点击“重新校验”(示例数据,1440×810)。

列表已授权,但广告数据没有更新

先核对筛选的是目标店铺的 Ozon Ads 记录,再检查实际广告页面、同步提示和平台密钥状态。列表中的已授权状态不等于每次同步都已完成;平台侧撤销或变更密钥后,应重新核对并校验广告凭证。

本文不沿用其他 ERP 的首次同步时长、固定更新频率或历史广告数据回溯天数。持续异常时,保留店铺名称、广告 Client ID 掩码、发生时间和错误提示,联系支持人员核查,不要在反馈中发送完整 Client Secret。

为什么不能用店铺 API Key 授权广告

店铺账号使用 Seller API 的 Client ID 与 API Key;广告账号使用 Performance API 的 Client ID 与 Client Secret。两组凭证各自对应不同能力,必须分别配置。广告凭证绑定已有店铺,并不表示两组密钥可以互换。