业务向——基于淘宝联盟平台的CPS
- 导读
- 小试牛刀
- 签名
- 商品活动
- 订单获取及用户
导读
上篇文章我们分享了多多进宝平台，那么这篇文章想继续带来CPS业务的分享，这次玩转的平台是淘宝联盟。在对接的过程中，也是踩了一些坑，特别是对于订单和用户绑定这一功能。在本文中，我们也继续从0到1，深入了解及实践如何玩转淘宝联盟CPS，为自己的副业拓宽一下路子。
小试牛刀
在开始之前，我们需要通过如下两个链接注册一下账号。如图1，注册完淘宝联盟后，我们可以在推广管理，找到媒体备案管理和推广位管理。媒体备案管理其实就是填报一下你的信息及计划在哪个平台推广（小程序、web等），推广位则是指淘宝客推广时用于跟踪和结算的参数依据，对于我们来说，也是绑定用户和订单的重要依据。
- 淘宝开放平台
- 淘宝联盟
如图2、图3所示，这里我们先新增推广位，然后选择创建好的媒体类型及填写广告位名称，即可完成。
完成备案并创建好推广位后，就可以点击顶部导航栏“我要推广”，去选择对应的商品、活动等，获取推广链接，进行推广了。
关于淘宝联盟，下面这几个参数是最容易搞混乱的，这里想做一解释：
- 推广位ID：即pid信息，如：mm_2039840091_2459350210_115589800408，可用于区分媒体备案内不同资源位的识别，是淘宝客推广识别、跟踪和结算的依据，也可查看对应推广位的数据。
- 广告位ID：其中115589800408即为广告位id，通常也叫adzone id。
- 渠道ID：其中2459350210即为渠道位id，通常也叫site id。该值就是你媒体备案的时候，创建媒体渠道后对应的ID值。注意，渠道专属推广位是有20个的个数限制。
- 会员ID：其中2039840091即为会员id，通常也叫member id。该值就是你注册账号后对应的会员ID.
- 关系ID：这个参数也叫**relation_id，在后边获取商品详情API传参时需要传入该参数，用于绑定用户订单。**该参数的获取来源比较繁琐，需要邀请用户绑定授权，通常我们可以上淘宝找人代刷一下。
由于淘宝SDK获取流程比较繁琐，切总是莫名其妙出现一些接口缺失的问题，因为它会根据你的当前的权限，动态生成不同的SDK，而权限的获取，对于某些API又需要你的接口的请求量达到一定级别了才会开放给你，所以下面的实践案例都是采用原始的Http请求方式进行获取。
签名
- 如下，这里先提供一个统一的签名工具类，在这之前，我们还需要引入依赖：
import org.apache.commons.lang3.StringUtils;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.util.Assert;
import java.security.MessageDigest;
import java.security.NoSuchAlgorithmException;
import java.util.Arrays;
import java.util.Map;
import static org.apache.commons.codec.Charsets.UTF_8;
/**
* 淘宝签名工具
*/
public class SignUtil {
private static final Logger LOGGER = LoggerFactory.getLogger(SignUtil.class);
// 參數签名
public static String signParams(Map<String, Object> params, String appSecret) {
String[] keys = params.keySet().toArray(new String[0]);
Arrays.sort(keys);
StringBuilder query = new StringBuilder();
query.append(appSecret);
for (String key : keys) {
Object value = params.get(key);
if (value != null && StringUtils.isNotBlank(key)) {
query.append(key).append(value);
}
}
byte[] bytes = null;
try {
query.append(appSecret);
bytes = MessageDigest.getInstance("md5").digest(query.toString().getBytes(UTF_8));
} catch (NoSuchAlgorithmException e) {
LOGGER.error("加密出错" + e);
throw CommonExceptions.BIZ_INVALID.newWithErrMsg("加密出错" + e);
}
Assert.notNull(bytes, "加密后字节数组为null");
return byte2hex(bytes);
}
private static String byte2hex(byte[] bytes) {
Assert.notNull(bytes, "字节数组为null");
StringBuilder builder = new StringBuilder();
for (byte aByte : bytes) {
String hex = Integer.toHexString(aByte & 0xFF);
if (hex.length() == 1) {
builder.append("0");
}
builder.append(hex.toUpperCase());
}
return builder.toString();
}
}
商品活动
taobao.tbk.activity.info.get
- 这里的relation_id就是我们上面的关系ID
- activity_material_id为官方活动会场ID，从淘宝客后台“我要推广-活动推广”中获取。
- method即为我们的接口能力，taobao.tbk.activity.info.get。
- **adzone_id，我们上述所的广告位ID，**mm_xxx_xxx_xxx的第三位。
TopActivityLinkRequest request = new TopRequestVo().new TopActivityLinkRequest();
request.setActivity_material_id(config.topActivity).setAdzone_id(userPidAdzone.getAdzoneId()).
setRelation_id(userPidAdzone.getRelationId()).
setMethod(TopAPIConstant.TOP_ACTIVITY_LINK).
setTimestamp(DateTimeUtil.getCurrentDayOfString(DateTimeUtil.DATE_TIME)).
setApp_key(config.topAppKey);
String sign = SignUtil.signParams(BeanToMapUtil.beanToObjMap(request), config.topAppSecret);
request.setSign(sign);
TopActivityLinkResponse response = topActivityLinkService.request(request);
- 关于这里的request方法：
public TopActivityLinkResponse request(TopActivityLinkRequest topActivityLinkRequest) {
String result = null;
try {
String query = TopRequestUtil.buildQuery(BeanToMapUtil.beanToObjMap(topActivityLinkRequest));
result = TopRequestUtil.handle(query, TopAPIConstant.TOP_REQUEST_URL);
LOGGER.info("11111:" + result);
} catch (Exception e) {
LOGGER.error("淘宝官方转链请求失败 : {}", JSONObject.toJSON(result), e);
throw CommonExceptions.BIZ_INVALID.newWithErrMsg("淘宝官方转链请求失败");
}
LOGGER.info("淘宝官方转链原始数据 : {}", JSONObject.toJSON(result));
JSONObject jsonObject = JSONObject.parseObject(result);
jsonObject = jsonObject.getJSONObject("tbk_activity_info_get_response");
if (!jsonObject.containsKey("data")) {
return null;
}
return JSONObject.parseObject(JSONObject.toJSONString(jsonObject.get("data")), TopActivityLinkResponse.class);
}
public static String buildQuery(Map<String, Object> params) throws UnsupportedEncodingException {
if (params == null || params.isEmpty()) {
return null;
}
StringBuilder query = new StringBuilder();
Set<Map.Entry<String, Object>> entries = params.entrySet();
boolean hasParam = false;
for (Map.Entry<String, Object> entry : entries) {
String name = entry.getKey();
Object value = entry.getValue();
// 忽略参数名或参数值为空的参数
if (StringUtils.isNotBlank(name) && value != null) {
if (hasParam) {
query.append("&");
} else {
hasParam = true;
}
query.append(name).append("=").
append(URLEncoder.encode(String.valueOf(value), UTF_8.toString()));
}
}
return query.toString();
}
public static String handle(String query, String url) {
byte[] content = query.getBytes(UTF_8);;
HttpURLConnection conn = null;
try {
URL newUrl = new URL(url);
conn = (HttpURLConnection) newUrl.openConnection();
conn.setRequestMethod(DEFAULT_REQUEST_METHOD);
conn.setRequestProperty("Host", newUrl.getHost());
} catch (IOException e) {
throw CommonExceptions.BIZ_INVALID.newWithErrMsg("淘宝请求失败" + e);
}
conn.setDoInput(true);
conn.setDoOutput(true);
conn.setRequestProperty("Accept", "text/xml,text/javascript");
conn.setRequestProperty("User-Agent", "top-sdk-java");
conn.setRequestProperty("Content-Type", "application/x-www-form-urlencoded;charset=" + UTF_8);
try (OutputStream out = conn.getOutputStream();) {
out.write(content);
} catch (IOException e) {
throw CommonExceptions.BIZ_INVALID.newWithErrMsg("淘宝请求失败" + e);
}
conn.disconnect();
try {
return responseToString(conn);
} catch (IOException e) {
throw CommonExceptions.BIZ_INVALID.newWithErrMsg("淘宝请求失败" + e);
}
}
protected static String responseToString(HttpURLConnection conn) throws IOException {
assert conn != null;
if (conn.getResponseCode() >= ERROR) {
// Client Error 4xx and Server Error 5xx
throw new IOException(conn.getResponseCode() + " " + conn.getResponseMessage());
}
String contentEncoding = conn.getContentEncoding();
return "gzip".equalsIgnoreCase(contentEncoding) ?
getStreamToString(new GZIPInputStream(conn.getInputStream()), UTF_8.toString())
:
getStreamToString(conn.getInputStream(), UTF_8.toString());
}
protected static String getStreamToString(InputStream stream, String charset) throws IOException {
Reader reader = new InputStreamReader(stream, charset);
StringBuilder response = new StringBuilder();
final char[] buff = new char[1024];
int read = 0;
while ((read = reader.read(buff)) > 0) {
response.append(buff, 0, read);
}
stream.close();
return response.toString();
}
订单获取及用户
tobao.ovs.tbk.order.details.batch.get
● 关于淘宝联盟的订单获取请求方式大致如上，这里不再贴代码了，注意，关于淘宝联盟订单获取一般会有权限限制，需要你访问量达到一定级别才会开放给你接口权限。所以一般我们会选取如大淘客这样的第三方平台做对接。
● 关于订单和用户绑定：通过上面的请求我们可以看到在传参时有传入关系ID和广告位ID。那么有一个绑定的思路如下：
○ 提前生成好一批关系ID，这里找淘宝帮忙代刷可以有500个。
○ 提前生成好一批PID，这个是有数量限制的，只有20个
○ 将关系ID和PID的第三段即广告位ID，进行组合即500*20
○ 当用户进入商品页时，在我们的业务方，先将某个组合锁住，如标记位1，并更新updateTime
○ 当下一个用户进来时，我们根据updateTime，选取最久未使用的组合进行标记，并更新updateTime
○ 另外，每个用户和组合的关系也会记录下来
○ 获取淘宝订单列表时，淘宝联盟也会返回我们关系ID和广告位ID，还有用户下单时间，这时我们可以根据下单时间前后5min，找到组合，从而时间订单和用户的绑定。
● 上面的思路在实践验证也是可行的，除非你是大V用户，并发量贼大，不过这种可以单独找淘宝运营申请专门的接口进行对接。其他情况，采用上面思路是可以实现绑定关系的。
![环形链表[简单]](https://img-blog.csdnimg.cn/direct/e92b8ed50fda4905adadf2d249f18a33.png)
