业务介绍

2023/3/1起，平台升级订单“短视频”“商品卡”“直播”“广告”标签，支持第二天后查看前一天订单流量来源，查看详情（跳转进入详情页）订单标签将进行如下调整：

1、订单页面“短视频”“商品卡”“直播”标签更新：

指当前订单成交时，是通过哪种内容体裁。2023/3/1（含）起，消费者当天下单生成的订单，将于第二天12:00后根据下单时的体裁，更新订单标签。您可根据“短视频”“商品卡”“直播”标签来识别您通过上述内容体裁成交的订单；

2、订单页面新增“广告”标签：

指当前订单成交时，通过广告流量成交。2023/3/1（含）起，消费者当天下单生成的订单，将于第二天12:00后根据是否广告流量，更新“广告”标签。您可根据“广告”标签来识别您通过广告流量成交的订单；

3、订单导出新增订单流量来源字段：

2023/3/1（含）起，消费者当天下单生成的订单，将于第二天12:00后根据成交时的情况，在订单导出报表中更新流量来源，包括流量类型（广告/自然流量），流量渠道（订单成交的渠道，如商城），流量体裁（直播/短视频等），以方便您导出后进行分析；

上述变更仅针对2023/3/1（含）起消费者创建的订单生效，存量订单不受影响；

注意事项

1. 广告/非广告，体裁、渠道这三种类型的渠道标签T+1生成，请开发者使用【doudian_order_orderSourceTag】订单来源打标消息监听标签生成时间，收到消息推送后再调用订单接口查询标签信息，未生成前查查询上述三种标签返回为空；
2. 广告/非广告，体裁、渠道这三种类型的渠道标签仅对2023年3月1日开始产生的订单返回标签，此前订单不返回上述标签信息，请开发者做好逻辑处理；

涉及接口

1. /order/searchList
2. /order/orderDetail

字段说明

用于开发者判断订单是否为广告和体裁订单标签；

字段取值说明

获取接口响应参数shop_order_detail. sku_order_list.sku_order_tag_ui

响应示例值

{
					"help_doc": "",
					"key": "compass_source_ad_mark",   //广告/非广告  详见 广告/非广告枚举值
					"sort": 0,
					"tag_type": "",
					"Text": "广告",
					"extra": "",
				},
				{
					"help_doc": "",
					"key": "compass_source_content_type_video",  //体裁 详见 体裁枚举值
					"sort": 0,
					"tag_type": "",
					"text": "短视频",
					"extra": "{\"compass_first_level_entrance\":\"video_to_live\",\"compass_first_level_entrance_text\":\"短视频引流直播间\"}",    //渠道code、渠道说明文案
					"icon": ""
				}
				

字段枚举值说明

流量类型（广告/非广告）

用于开发者判断是否为广告渠道带来的订单标签。
字段枚举值说明

key	text
compass_source_ad_mark	广告
compass_source_not_ad_mark	非广告

流量体裁

订单页面“短视频、商品卡、直播标签更新：指当前订单成交时，是通过哪种内容体裁；

字段枚举值

key	text
compass_source_content_type_live	直播间
compass_source_content_type_video	短视频
compass_source_content_type_product_card	商品卡
compass_source_content_type_other	其他

流量渠道【extra】

体裁渠道来源取自 sku_order_tag_ui中extra字段值。

渠道code(compass_first_level_entrance)	渠道含义
window	橱窗
store	店铺页面
search	搜索
recommend	商城推荐
channel_activity	频道及活动页面
aftersale	购后页面
recommend_video	短视频推荐
homepage_follow	关注来源
activity	频道及活动页面
general_search	搜索
other_profile	达人个人主页
guess_you_like	商城推荐
video_to_live	短视频引流直播间
recommend_live	直播推荐
general_search	搜索
others_homepage	个人主页&店铺&橱窗
douyin_shopping_center	商城推荐
activity	活动页
touxi_saas	头条西瓜
other	其他