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

旅游相关业务参数说明


参数说明:

  1. 有枚举值的字段已经在备注中注明。
  2. 字符串类型的字段长度不允许超过200。数组参数类型以”_ARR”为后缀,字段元素个数不超过10个。
  3. ★为关键必填字段,没有这个信息,就无法和商品目录关联。
    –为在该维度下不必要的,可忽略的字段。
    √为建议填写字段,完善的字段内容帮助我们做出更好的商品推荐算法以获得更高的广告点击和转化。请尽可能提供。
  4. 参数中相关的ID字段,需要和商品目录中的相应ID字段对应。这样我们才可以做出更多的及准确的商品推荐算法。
当 content_type 为Hotel, Flight, Train, Bus, Vacation,Scenery时,不同Actions所对应的参数如下:
Actions 参数名称 参数说明 参数类型 取值范围 Hotel Flight
Train
Bus
Vacation Scenery 备注
VIEW_
CONTENTADD
_TO_
WISHLISTINITIATE_
CHECKOUTCOMPLETE_
ORDERPURCHASE
content_type 行业类型 string ^.{0,200}$ ★hotel ★ flight 或 train 或 bus ★ vacation ★ scenery 长度为0-200
object 行为对象 string ^.{0,200}$ ★hotel ★ flight 或 train 或bus ★ vacation ★ scenery
product_id 商品ID string ^.{0,200}$
product_name 商品名称 string ^.{0,200}$
city 所在城市 string ^.{0,200}$
departure 出发地城市/地区 string ^.{0,200}$
destination 目的地城市/地区 string ^.{0,200}$
region_type 区域类型 string 枚举值:国内,国外。
stars_level 星级 integer [0,6] 酒店行业专有,枚举值:0, 1, 2, 3, 4, 5, 6,无星级的用0表示
start_date 开始/出发日期 string ^(\d{4})-(\d{2})-(\d{2})$ 格式为 YYYY-MM-DD
end_date 结束/返程日期 string ^(\d{4})-(\d{2})-(\d{2})$ 格式为 YYYY-MM-DD
flight_type 机票类型 string 枚举值:直达,中转。
journey_type 旅游产品类型 string ^.{0,200}$ 旅游可能是自由行、半自助游、跟团游、邮轮等,景点可能是当地玩乐的套餐。
price 价格 float
Actions 参数名称 参数说明 参数类型 取值范围 Hotel Flight
Train
Bus
Vacation Scenery 备注
VIEW_
CONTENT
content_
type
行业类型 string ^.{0,200}$ ★ hotel ★ flight 或 train 或 bus ★ vacation ★ scenery 该行为的 object 为某些特定的活动或专题页面
object 行为对象 string ^.{0,200}$ ★ hotel_list ★ flight_list 或 train_list 或 bus_list ★ vacation_list ★ scenery_list
product_
ids_list
商品id合集 string[] ^.{0,200}$
Actions 参数名称 参数说明 参数类型 取值范围 Hotel Flight
Train
Bus
Vacation Scenery 备注
SEARCH content_type 行业类型 string ^.{0,200}$ ★ hotel ★ vacation ★ cenery 长度0-200
object 行为对象 string ^.{0,200}$ ★ search_
hotel_
list

search_
vacation_
list

search_
scenery_
list
长度0-200
departure 出发地城市/地区 string ^.{0,200}$ 长度0-200
destination 目的地城市/地区 string ^.{0,200}$ 长度0-200
product_
ids_list
商品id合集 string[] ^.{0,200}$ 搜索只给出 Top 10 结果即可,按搜索顺序给出。
region_type 区域类型 string 枚举值:国内、 国外。
start_date 开始/出发日期 string ^(\d{4})-(\d{2})-(\d{2})$ 格式为 YYYY-MM-DD
end_date 结束/返程日期 string ^(\d{4})-(\d{2})-(\d{2})$ 格式为 YYYY-MM-DD
preferred_
star_ratings
偏好星级 integer[] [0,6] 酒店行业专有,枚举值:0, 1, 2, 3, 4, 5, 6,无星级的用 0 表示
preferred_
price_range
偏好价格范围 integer[] 价格范围数据按照数组顺序两两配对,如:假设要有3组价格范围,分别是 [0,50] [30,70] [100,200] ,则所传数组应为 [0, 50, 30, 70, 100, 200] 。
preferred_
commercial_
area
偏好商圈 string[] ^.{0,200}$ 长度0-200
journey_type 旅游产品类型 string ^.{0,200}$ 旅游可能是自由行、半自助游、跟团游、邮轮等,景点可能是当地玩乐的套餐。