接口文档SDK业务专题开发者工具

网服业务参数说明

参数说明：

有枚举值的字段已经在备注中注明。
字符串类型的字段长度不允许超过200。数组参数类型以”_ARR”为后缀，字段元素个数不超过10个。
★为关键必填字段，没有这个信息，就无法和商品目录关联。
–为在该维度下不必要的，可忽略的字段。
√为建议填写字段，完善的字段内容帮助我们做出更好的商品推荐算法以获得更高的广告点击和转化。请尽可能提供。
参数中相关的ID字段，需要和商品目录中的相应ID字段对应。这样我们才可以做出更多的及准确的商品推荐算法。

小说阅读类

当content_type为readings时，不同Actions所对应的参数如下：

Actions：VIEW_CONTENT（阅读小说）

参数名称 参数说明 参数类型 Readings Readings
content_type 行业类型 STRING ★Readings ★Readings
object 行为对象 STRING ★category ★product
product_id 商品id STRING — ★
first_category_id 一级类目ID INT √ √
first_category_name 一级类目名称 STRING √ √
second_category_id 二级类目ID INT √ √
second_category_name 二级类目名称 STRING √ √
third_category_id 三级类目ID INT √ √
third_category_name 三级类目名称 STRING √ √
reading_duration 用户阅读时长 STRING √ √
reading_chapters 用户阅读章节数 STRING √ √
user_consumption 用户消费水平 STRING √ √

Actions：ADD_TO_WISHLIST（收藏/加入书架）
COMPLETE_ORDER（购买小说）
SHARE（分享小说/小说章节）

参数名称 参数说明 参数类型 Readings Readings
content_type 行业类型 STRING ★Readings ★Readings
object 行为对象 STRING ★category ★product
product_id 商品id STRING — ★
first_category_id 一级类目ID INT √ √
first_category_name 一级类目名称 STRING √ √
second_category_id 二级类目ID INT √ √
second_category_name 二级类目名称 STRING √ √
third_category_id 三级类目ID INT √ √
third_category_name 三级类目名称 STRING √ √

Actions：SEARCH（搜索小说）

参数名称 参数说明 参数类型 Readings Readings
content_type 行业类型 STRING ★Readings ★Readings
object 行为对象 STRING ★category ★product
query 搜索query STRING ★
first_category_id 一级类目ID INT √ √
first_category_name 一级类目名称 STRING √ √
second_category_id 二级类目ID INT √ √
second_category_name 二级类目名称 STRING √ √
third_category_id 三级类目ID INT √ √
third_category_name 三级类目名称 STRING √ √

Actions：RATE（评论小说/小说章节)

参数名称 参数说明 参数类型 Readings
content_type 行业类型 STRING ★Readings
object 行为对象 STRING ★product
product_id 商品id STRING ★
first_category_id 一级类目ID INT √
first_category_name 一级类目名称 STRING √
second_category_id 二级类目ID INT √
second_category_name 二级类目名称 STRING √
third_category_id 三级类目ID INT √
third_category_name 三级类目名称 STRING √
user_rating 用户评价等级 STRING √

新闻资讯类

当content_type为news cartoon时，不同Actions所对应的参数如下：

Actions：VIEW_CONTENT（查阅资讯详情内容）

custom_action action_param内参数 参数说明 参数类型 行为对象为类目 行为对象为商品
— content_type 行业类型 STRING ★news cartoon ★news cartoon
— object 行为对象 STRING ★category ★product
— product_id 商品id STRING — ★
— first_category_id 一级类目ID INT √ √
— first_category_name 一级类目名称 STRING √ √
— second_category_id 二级类目ID INT √ √
— second_category_name 二级类目名称 STRING √ √
— third_category_id 三级类目ID INT √ √
— third_category_name 三级类目名称 STRING √ √

备注：1、如行为对象为类目，类目信息为必填，至少填写一级类目信息（可单独填写二级 or 单独填写三级类目信息），且类目信息需与入库类目对齐 2、该行为指资讯详情页浏览

Actions：PAGE_VIEW（浏览资讯标题、封面）

custom_action action_param内参数 参数说明 参数类型 行为对象为类目 行为对象为商品
— content_type 行业类型 STRING ★news cartoon ★news cartoon
— object 行为对象 STRING ★category ★product
— product_id 商品id STRING — ★
— first_category_id 一级类目ID INT √ √
— first_category_name 一级类目名称 STRING √ √
— second_category_id 二级类目ID INT √ √
— second_category_name 二级类目名称 STRING √ √
— third_category_id 三级类目ID INT √ √
— third_category_name 三级类目名称 STRING √ √

备注：1、如行为对象为类目，类目信息为必填，至少填写一级类目信息（可单独填写二级 or 单独填写三级类目信息），且类目信息需与入库类目对齐

Actions：RATE（评论/打分）

custom_action action_param内参数 参数说明 参数类型 行为对象为类目 行为对象为商品
— content_type 行业类型 STRING ★news cartoon ★news cartoon
— object 行为对象 STRING ★category ★product
— product_id 商品id STRING — ★
— first_category_id 一级类目ID INT √ √
— first_category_name 一级类目名称 STRING √ √
— second_category_id 二级类目ID INT √ √
— second_category_name 二级类目名称 STRING √ √
— third_category_id 三级类目ID INT √ √
— third_category_name 三级类目名称 STRING √ √

备注：1、如行为对象为类目，类目信息为必填，至少填写一级类目信息（可单独填写二级 or 单独填写三级类目信息），且类目信息需与入库类目对齐

Actions：SHARE（转发资讯）

custom_action action_param内参数 参数说明 参数类型 行为对象为类目 行为对象为商品
— content_type 行业类型 STRING ★news cartoon ★news cartoon
— object 行为对象 STRING ★category ★product
— product_id 商品id STRING — ★
— first_category_id 一级类目ID INT √ √
— first_category_name 一级类目名称 STRING √ √
— second_category_id 二级类目ID INT √ √
— second_category_name 二级类目名称 STRING √ √
— third_category_id 三级类目ID INT √ √
— third_category_name 三级类目名称 STRING √ √

备注：1、如行为对象为类目，类目信息为必填，至少填写一级类目信息（可单独填写二级 or 单独填写三级类目信息），且类目信息需与入库类目对齐

Actions：ADD_TO_WISHLIST（收藏资讯、关注账号）

custom_action action_param内参数 参数说明 参数类型 行为对象为类目 行为对象为商品
— content_type 行业类型 STRING ★news cartoon ★news cartoon
— object 行为对象 STRING ★category ★product
— product_id 商品id STRING — ★
— first_category_id 一级类目ID INT √ √
— first_category_name 一级类目名称 STRING √ √
— second_category_id 二级类目ID INT √ √
— second_category_name 二级类目名称 STRING √ √
— third_category_id 三级类目ID INT √ √
— third_category_name 三级类目名称 STRING √ √

备注：1、如行为对象为类目，类目信息为必填，至少填写一级类目信息（可单独填写二级 or 单独填写三级类目信息），且类目信息需与入库类目对齐

Actions：CUSTOM（自定义）

custom_action action_param内参数 参数说明 参数类型 行为对象为类目 行为对象为商品
LIKE（点赞资讯、账号） content_type 行业类型 STRING ★news cartoon ★news cartoon
LIKE（点赞资讯、账号） object 行为对象 STRING ★category ★product
LIKE（点赞资讯、账号） product_id 商品id STRING — ★
LIKE（点赞资讯、账号） first_category_id 一级类目ID INT √ √
LIKE（点赞资讯、账号） first_category_name 一级类目名称 STRING √ √
LIKE（点赞资讯、账号） second_category_id 二级类目ID INT √ √
LIKE（点赞资讯、账号） second_category_name 二级类目名称 STRING √ √
LIKE（点赞资讯、账号） third_category_id 三级类目ID INT √ √
LIKE（点赞资讯、账号） third_category_name 三级类目名称 STRING √ √

备注：1、如行为对象为类目，类目信息为必填，至少填写一级类目信息（可单独填写二级 or 单独填写三级类目信息），且类目信息需与入库类目对齐

Actions：CUSTOM（自定义）

custom_action action_param内参数 参数说明 参数类型 行为对象为类目 行为对象为商品
POST（发布资讯内容） content_type 行业类型 STRING ★news cartoon ★news cartoon
POST（发布资讯内容） object 行为对象 STRING ★category ★product
POST（发布资讯内容） product_id 商品id STRING — ★
POST（发布资讯内容） first_category_id 一级类目ID INT √ √
POST（发布资讯内容）） first_category_name 一级类目名称 STRING √ √
POST（发布资讯内容） second_category_id 二级类目ID INT √ √
POST（发布资讯内容） second_category_name 二级类目名称 STRING √ √
POST（发布资讯内容） third_category_id 三级类目ID INT √ √
POST（发布资讯内容） third_category_name 三级类目名称 STRING √ √

备注：1、如行为对象为类目，类目信息为必填，至少填写一级类目信息（可单独填写二级 or 单独填写三级类目信息），且类目信息需与入库类目对齐

Actions：CUSTOM（自定义）

custom_action action_param内参数 参数说明 参数类型 行为对象为类目 行为对象为商品
REFRESH（刷新页面） content_type 行业类型 STRING ★news cartoon ★news cartoon
REFRESH（刷新页面） object 行为对象 STRING ★category ★product
REFRESH（刷新页面） product_id 商品id STRING — ★
REFRESH（刷新页面） first_category_id 一级类目ID INT √ √
REFRESH（刷新页面） first_category_name 一级类目名称 STRING √ √
REFRESH（刷新页面） second_category_id 二级类目ID INT √ √
REFRESH（刷新页面） second_category_name 二级类目名称 STRING √ √
REFRESH（刷新页面） third_category_id 三级类目ID INT √ √
REFRESH（刷新页面）） third_category_name 三级类目名称 STRING √ √

备注：1、如行为对象为类目，类目信息为必填，至少填写一级类目信息（可单独填写二级 or 单独填写三级类目信息），且类目信息需与入库类目对齐 2、建议描述在垂类、专题页面的刷新操作，行为对象为类目

视频音乐类

当content_type为video时，不同Actions所对应的参数如下：

Actions：VIEW_CONTENT（播放视频，观看具体内容）

custom_action action_param内参数 参数说明 参数类型 行为对象为类目 行为对象为商品
— content_type 行业类型 STRING ★video ★video
— object 行为对象 STRING ★category ★product
— product_id 商品id STRING — ★
— first_category_id 一级类目ID INT √ √
— first_category_name 一级类目名称 STRING √ √
— second_category_id 二级类目ID INT √ √
— second_category_name 二级类目名称 STRING √ √
— third_category_id 三级类目ID INT √ √
— third_category_name 三级类目名称 STRING √ √

备注：1、如行为对象为类目，类目信息为必填，至少填写一级类目信息（可单独填写二级 or 单独填写三级类目信息），且类目信息需与入库类目对齐

Actions：PAGE_VIEW（浏览视频标题、封面）

custom_action action_param内参数 参数说明 参数类型 行为对象为类目 行为对象为商品
— content_type 行业类型 STRING ★video ★video
— object 行为对象 STRING ★category ★product
— product_id 商品id STRING — ★
— first_category_id 一级类目ID INT √ √
— first_category_name 一级类目名称 STRING √ √
— second_category_id 二级类目ID INT √ √
— second_category_name 二级类目名称 STRING √ √
— third_category_id 三级类目ID INT √ √
— third_category_name 三级类目名称 STRING √ √

备注：1、如行为对象为类目，类目信息为必填，至少填写一级类目信息（可单独填写二级 or 单独填写三级类目信息），且类目信息需与入库类目对齐

Actions：RATE（评论/打分）

custom_action action_param内参数 参数说明 参数类型 行为对象为类目 行为对象为商品
— content_type 行业类型 STRING ★video ★video
— object 行为对象 STRING ★category ★product
— product_id 商品id STRING — ★
— first_category_id 一级类目ID INT √ √
— first_category_name 一级类目名称 STRING √ √
— second_category_id 二级类目ID INT √ √
— second_category_name 二级类目名称 STRING √ √
— third_category_id 三级类目ID INT √ √
— third_category_name 三级类目名称 STRING √ √

备注：1、如行为对象为类目，类目信息为必填，至少填写一级类目信息（可单独填写二级 or 单独填写三级类目信息），且类目信息需与入库类目对齐

Actions：SHARE（转发视频）

custom_action action_param内参数 参数说明 参数类型 行为对象为类目 行为对象为商品
— content_type 行业类型 STRING ★video ★video
— object 行为对象 STRING ★category ★product
— product_id 商品id STRING — ★
— first_category_id 一级类目ID INT √ √
— first_category_name 一级类目名称 STRING √ √
— second_category_id 二级类目ID INT √ √
— second_category_name 二级类目名称 STRING √ √
— third_category_id 三级类目ID INT √ √
— third_category_name 三级类目名称 STRING √ √

备注：1、如行为对象为类目，类目信息为必填，至少填写一级类目信息（可单独填写二级 or 单独填写三级类目信息），且类目信息需与入库类目对齐

Actions：ADD_TO_WISHLIST（收藏视频、关注账号）

custom_action action_param内参数 参数说明 参数类型 行为对象为类目 行为对象为商品
— content_type 行业类型 STRING ★video ★video
— object 行为对象 STRING ★category ★product
— product_id 商品id STRING — ★
— first_category_id 一级类目ID INT √ √
— first_category_name 一级类目名称 STRING √ √
— second_category_id 二级类目ID INT √ √
— second_category_name 二级类目名称 STRING √ √
— third_category_id 三级类目ID INT √ √
— third_category_name 三级类目名称 STRING √ √

备注：1、如行为对象为类目，类目信息为必填，至少填写一级类目信息（可单独填写二级 or 单独填写三级类目信息），且类目信息需与入库类目对齐

Actions：CUSTOM（自定义）

custom_action action_param内参数 参数说明 参数类型 行为对象为类目 行为对象为商品
LIKE（点赞视频、账号） content_type 行业类型 STRING ★video ★video
LIKE（点赞视频、账号） object 行为对象 STRING ★category ★product
LIKE（点赞视频、账号） product_id 商品id STRING — ★
LIKE（点赞视频、账号） first_category_id 一级类目ID INT √ √
LIKE（点赞视频、账号） first_category_name 一级类目名称 STRING √ √
LIKE（点赞视频、账号） second_category_id 二级类目ID INT √ √
LIKE（点赞视频、账号） second_category_name 二级类目名称 STRING √ √
LIKE（点赞视频、账号） third_category_id 三级类目ID INT √ √
LIKE（点赞视频、账号） third_category_name 三级类目名称 STRING √ √

备注：1、如行为对象为类目，类目信息为必填，至少填写一级类目信息（可单独填写二级 or 单独填写三级类目信息），且类目信息需与入库类目对齐

Actions：CUSTOM（自定义）

custom_action action_param内参数 参数说明 参数类型 行为对象为类目 行为对象为商品
LIKE（点赞视频、账号） content_type 行业类型 STRING ★video ★video
POST（发布视频内容） object 行为对象 STRING ★category ★product
POST（发布视频内容） product_id 商品id STRING — ★
POST（发布视频内容） first_category_id 一级类目ID INT √ √
POST（发布视频内容） first_category_name 一级类目名称 STRING √ √
POST（发布视频内容） second_category_id 二级类目ID INT √ √
POST（发布视频内容） second_category_name 二级类目名称 STRING √ √
POST（发布视频内容） third_category_id 三级类目ID INT √ √
POST（发布视频内容） third_category_name 三级类目名称 STRING √ √

备注：1、如行为对象为类目，类目信息为必填，至少填写一级类目信息（可单独填写二级 or 单独填写三级类目信息），且类目信息需与入库类目对齐

Actions：CUSTOM（自定义）

custom_action action_param内参数 参数说明 参数类型 行为对象为类目 行为对象为商品
REFRESH（刷新页面） content_type 行业类型 STRING ★video ★video
REFRESH（刷新页面） object 行为对象 STRING ★category ★product
REFRESH（刷新页面） product_id 商品id STRING — ★
REFRESH（刷新页面） first_category_id 一级类目ID INT √ √
REFRESH（刷新页面） first_category_name 一级类目名称 STRING √ √
REFRESH（刷新页面） second_category_id 二级类目ID INT √ √
REFRESH（刷新页面） second_category_name 二级类目名称 STRING √ √
REFRESH（刷新页面） third_category_id 三级类目ID INT √ √
REFRESH（刷新页面） third_category_name 三级类目名称 STRING √ √

备注：1、如行为对象为类目，类目信息为必填，至少填写一级类目信息（可单独填写二级 or 单独填写三级类目信息），且类目信息需与入库类目对齐 2、建议描述在垂类、专题页面的刷新操作，行为对象为类目

广告资源

广告技术

开发文档

辅助工具

帮助支持

手机浏览开发者官网

Copyright © 1998 - Tencent Inc. All Rights Reserved.