利用 Taobao 營銷 API：自動化優惠券與活動管理

2025-04-28

在電商運營中，優惠券與促銷活動是提升用戶轉化與客單價的重要手段。隨著電商市場的競爭日益激烈，如何有效地進行行銷活動並且實現自動化，成為了眾多電商運營人員的挑戰。Taobao 平台提供了一整套營銷 API，開發者可以通過程式化的方式自動創建、管理、查詢與清理各類優惠活動，實現真正的「無人值守」營銷自動化。本篇將介紹如何利用這些 API 進行優惠券與活動管理，並實現全自動化的行銷流程。

一、Taobao 營銷 API 架構與認證

1. API 機制概覽

Taobao 營銷相關的接口主要集中在 taobao.tbk.coupon.create（聯盟券）及各類「行銷活動」接口（如滿減、直降）。開發者需要先在阿里媽媽申請 AppKey／AppSecret，並通過 OAuth2 或 TOP（Taobao Open Platform）簽名認證，才能使用這些接口進行 API 調用。

2. 簽名與認證範例（Python）

在調用 Taobao 的 API 之前，開發者需要進行簽名認證。以下是用 Python 編寫的簽名和認證範例：

import hashlib
import time
import requests
from urllib.parse import quote_plus
APP_KEY = 'YOUR_APP_KEY'
APP_SECRET = 'YOUR_APP_SECRET'
API_URL = 'https://eco.taobao.com/router/rest'
def sign(params: dict) -> str:
"""Taobao TOP MD5 簽名算法"""
keys = sorted(params.keys())
base = APP_SECRET + ''.join(f"{k}{params[k]}" for k in keys) + APP_SECRET
return hashlib.md5(base.encode('utf-8')).hexdigest().upper()
def call_taobao_api(method: str, biz_params: dict) -> dict:
system_params = {
'method': method,
'app_key': APP_KEY,
'timestamp': time.strftime('%Y-%m-%d %H:%M:%S'),
'format': 'json',
'v': '2.0',
'sign_method': 'md5',
}
all_params = {**system_params, **biz_params}
all_params['sign'] = sign(all_params)
response = requests.post(API_URL, data=all_params, timeout=10)
return response.json()

二、自動化創建優惠券

在 Taobao 上，聯盟優惠券（即推廣券）是常見的促銷工具。通過 taobao.tbk.coupon.create 接口，開發者可以批量生成推廣券。以下是如何創建優惠券的範例：

def create_coupon(item_id: str, coupon_amount: int, total_num: int, start_time: str, end_time: str):
biz = {
'num_iids': item_id,
'amount': coupon_amount,
'count': total_num,
'start_time': start_time,  # "2024-05-01 00:00:00"
'end_time': end_time       # "2024-05-07 23:59:59"
}
result = call_taobao_api('taobao.tbk.coupon.create', biz)
if 'tbk_coupon_create_response' in result:
return result['tbk_coupon_create_response']['data']
else:
raise Exception(result)
# 範例調用
coupon_info = create_coupon(
item_id='1234567890',
coupon_amount=20,
total_num=1000,
start_time='2024-05-01 00:00:00',
end_time='2024-05-07 23:59:59'
)
print('Coupon created:', coupon_info)

通過上述範例，開發者可以批量創建優惠券，並設置其金額、數量和有效期。

三、批量查詢活動狀態與使用統計

創建優惠券後，開發者可以利用 taobao.tbk.coupon.get 接口查詢券的狀態與剩餘數量。以下是查詢優惠券狀態與使用統計的範例：

def query_coupon(coupon_id: str):
biz = {'coupon_id': coupon_id}
result = call_taobao_api('taobao.tbk.coupon.get', biz)
return result.get('tbk_coupon_get_response', {}).get('results', [])
# 範例
stats = query_coupon(coupon_info['coupon_id'])
print('Coupon stats:', stats)

對於平台內的其他促銷活動（如「滿減」和「直降」等官方活動），也可以使用 tmall.marketing.activity.add、tmall.marketing.activity.get 等接口進行查詢，參數結構類似。

四、定時清理過期活動

為了避免過多的過期活動佔用資源，開發者可以定期調用刪除或失效接口來清理過期的活動。以下是清理過期優惠券的範例：

def expire_coupon(coupon_id: str):
biz = {'coupon_id': coupon_id}
result = call_taobao_api('taobao.tbk.coupon.delete', biz)
return result.get('tbk_coupon_delete_response', {})
# 在每日凌晨清理過期券
import schedule, time
def cleanup_job():
# 查詢所有過期券（此處假設有本地緩存或 DB 列表）
expired_ids = get_expired_coupon_ids()
for cid in expired_ids:
expire_coupon(cid)
print(f'Coupon {cid} expired.')
schedule.every().day.at("00:10").do(cleanup_job)
while True:
schedule.run_pending()
time.sleep(30)

這段代碼實現了每天定時清理過期的優惠券，通過調用 expire_coupon 函數來刪除過期的券，減少系統資源的浪費。

五、整合定時任務實現全流程自動化

開發者可以將上述「創建—查詢—統計—清理」的流程整合到一個日常運營腳本中，並通過 cron、Airflow 或 Kubernetes CronJob 進行排程管理，實現真正的「一鍵啟動」與「無人值守」。

這樣，整個促銷活動的管理可以實現完全自動化，從活動的創建、查詢到過期清理，全程不需要人工干預，大大提高了工作效率。

六、錯誤處理與日誌

在進行自動化操作時，錯誤處理與日誌管理是非常重要的。以下是一些建議：

重試機制：對於可重入的創建請求，應採用指數退避重試策略，避免因為臨時故障而中斷流程。
日誌與告警：在關鍵步驟（如創建失敗、查詢異常）時觸發通知（如 Email 或 Slack），便於及時處理問題。
監控指標：通過 Prometheus 收集成功率、耗時、剩餘券量等監控指標，幫助開發者了解系統狀況，及時進行調優。

小結

通過「自動化優惠券與活動管理」，電商運營人員可以將繁瑣的重複性工作交由程式化腳本完成，不僅節省了大量的人力成本，還能提高運營效率與精準度。利用 Taobao 營銷 API、排程管理與完備的錯誤處理機制，開發者可以構建出高效且高可用的行銷自動化平台，實現持續的用戶拉新與促活。

Articles related to APIs :

如您需要 Taobao API 可聯係我們：support@luckdata.com