基于京东商智API与Python的日常客户维护零门槛实操技术指南

一、前期准备：获取API权限与环境搭建

1. 京东商智API权限申请

直接访问京东商智开发者平台 https://open.jd.com/home/home/index，用已开通商智专业版的京东商家账号登录，按以下步骤操作：

• 点击顶部导航栏应用管理 → 创建应用
• 选择商家自研应用，应用名称填写“日常客户维护工具”，应用类型选Web应用，回调URL填写临时占位符（本地测试用 http://127.0.0.1:8000），应用描述简单写“自动化日常客户分层、触达提醒”
• 提交后等待审核，一般1-2个工作日通过，通过后在应用管理 → 我的应用中获取App Key和App Secret，记下来后续备用

2. Python环境与依赖库安装

电脑未安装Python的，访问 https://www.python.org/downloads/ 下载最新稳定版3.10+，安装时勾选Add Python to PATH。

打开终端（Windows用CMD或PowerShell，Mac用Terminal），依次输入以下命令安装依赖库：

``` pip install requests pandas openpyxl ```

二、获取客户数据：自动化拉取近30天复购意向强的客户

复购意向强的客户定义为“近30天浏览商品≥3次、未下单、未领取优惠券”，按以下步骤拉取：

1. 编写数据拉取脚本

新建一个名为`jd_customer_maintenance.py`的文件，复制以下完整代码，替换其中的`your_app_key`、`your_app_secret`、`your_shop_id`（你的京东店铺ID，可在商家后台店铺设置查看）：

```python import requests import hashlib import time import json import pandas as pd 配置参数 APP_KEY = "your_app_key" APP_SECRET = "your_app_secret" SHOP_ID = "your_shop_id" BASE_URL = "https://api.jd.com/routerjson" 生成签名函数（京东API固定要求） def generate_sign(params): sorted_params = sorted(params.items()) sign_str = APP_SECRET + "".join([f"{k}{v}" for k, v in sorted_params]) + APP_SECRET return hashlib.md5(sign_str.encode("utf-8")).hexdigest().upper() 拉取近30天客户浏览行为数据 def get_customer_browse(): current_time = int(time.time() 1000) end_time = current_time start_time = end_time - 30 24 60 60 1000 params = { "method": "jingdong.data.vender.customerbehavior.browse.get", "app_key": APP_KEY, "timestamp": str(current_time), "format": "json", "v": "2.0", "sign_method": "md5", "shopId": SHOP_ID, "startTime": str(start_time), "endTime": str(end_time), "pageSize": "100", "pageNo": "1" } params["sign"] = generate_sign(params) response = requests.post(BASE_URL, data=params) result = json.loads(response.text) browse_data = [] if result.get("jingdong_data_vender_customerbehavior_browse_get_response"): data_list = result["jingdong_data_vender_customerbehavior_browse_get_response"]["result"]["dataList"] for item in data_list: browse_data.append({ "客户ID": item["customerId"], "客户昵称": item["customerNick"], "浏览商品数": item["browseProductCount"], "最近浏览时间": time.strftime("%Y-%m-%d %H:%M:%S", time.localtime(item["lastBrowseTime"]/1000)) }) 处理多页数据（默认拉取前2页，可根据需求增加pageNo） for page in range(2, 4): params["pageNo"] = str(page) params["sign"] = generate_sign(params) response = requests.post(BASE_URL, data=params) result = json.loads(response.text) if result.get("jingdong_data_vender_customerbehavior_browse_get_response"): data_list = result["jingdong_data_vender_customerbehavior_browse_get_response"]["result"]["dataList"] for item in data_list: browse_data.append({ "客户ID": item["customerId"], "客户昵称": item["customerNick"], "浏览商品数": item["browseProductCount"], "最近浏览时间": time.strftime("%Y-%m-%d %H:%M:%S", time.localtime(item["lastBrowseTime"]/1000)) }) return browse_data 主函数：筛选复购意向强的客户并导出Excel if __name__ == "__main__": browse_df = pd.DataFrame(get_customer_browse()) 筛选：浏览商品≥3次 intent_df = browse_df[browse_df["浏览商品数"] >= 3].copy() 导出Excel（文件名带当前日期） today = time.strftime("%Y%m%d") intent_df.to_excel(f"复购意向客户_{today}.xlsx", index=False, engine="openpyxl") print(f"已导出复购意向客户数据：复购意向客户_{today}.xlsx") ```

2. 运行脚本与验证

• 打开终端，进入脚本所在的文件夹（Windows用`cd D:\你的文件夹路径`，Mac用`cd /Users/你的用户名/你的文件夹路径`）
• 输入命令`python jd_customer_maintenance.py`，按回车
• 等待10秒左右，终端显示“已导出复购意向客户数据：复购意向客户_YYYYMMDD.xlsx”，打开文件夹查看生成的Excel文件

三、触达提醒自动化：生成待触达标签的客户标签表

京东商家后台支持批量导入客户标签，我们将筛选后的客户生成符合格式的标签表，具体步骤：

1. 下载商家后台标准标签导入模板

访问京东商家后台 https://shop.jd.com/，登录后点击客户运营 → 客户管理 → 标签管理 → 导入标签，下载标准导入模板.xlsx，放在脚本同一文件夹下。

2. 编写标签生成脚本

在`jd_customer_maintenance.py`文件末尾添加以下代码：

```python 读取标准模板 template_df = pd.read_excel("标准导入模板.xlsx", engine="openpyxl") 构造标签数据 tag_data = [] for idx, row in intent_df.iterrows(): tag_data.append({ "客户ID": row["客户ID"], "客户昵称": row["客户昵称"], "标签名称": "近30天浏览≥3次未下单" }) tag_df = pd.DataFrame(tag_data) 合并到标准模板（保留模板的空列） final_df = pd.concat([template_df.iloc[:0], tag_df], ignore_index=True) 导出标准标签表 final_df.to_excel(f"待导入客户标签_{today}.xlsx", index=False, engine="openpyxl") print(f"已生成待导入客户标签表：待导入客户标签_{today}.xlsx") ```

重新运行脚本，会生成两个Excel文件。

四、批量导入与发券设置

1. 批量导入客户标签

回到商家后台客户运营 → 客户管理 → 标签管理 → 导入标签，选择刚才生成的待导入客户标签_YYYYMMDD.xlsx，点击开始导入，等待1分钟左右查看导入结果，成功导入后可在我的标签中找到“近30天浏览≥3次未下单”标签。

2. 设置自动发券触发规则

点击客户运营 → 营销活动 → 客户分层营销 → 新建活动：

• 活动名称填写“近30天浏览3次未下单专属券”，活动类型选自动发券
• 触发条件选进入标签，标签选择“近30天浏览≥3次未下单”
• 发券内容选择店铺已创建的无门槛/满减优惠券（未创建的先去营销中心 → 优惠券管理创建，面额建议比日常券高5%-10%）
• 活动时间选择长期有效，触发次数选每个客户1次/7天，避免打扰客户
• 点击提交审核，审核通过后自动生效

五、日常运维：定时运行脚本与数据复盘

1. Windows系统设置定时任务

• 打开任务计划程序，点击创建基本任务
• 名称填写“每日拉取复购意向客户”，触发器选每天，时间设置为早上9点
• 操作选启动程序，程序或脚本选Python的安装路径下的`python.exe`（可通过终端输入`where python`查看），添加参数填写`jd_customer_maintenance.py`，起始于填写脚本所在的文件夹路径
• 点击完成即可

2. 数据复盘简单脚本

为了快速查看昨日触达效果，可在脚本中添加拉取昨日标签客户领券/下单数据的功能，但需注意京东商智下单行为API的权限范围（部分专业版套餐可能需额外申请），基础版客户可直接在商家后台客户运营 → 数据中心查看分层营销活动的效果数据。