全部产品

Recommend

描述

该接口用于获取指定实例的推荐结果

请求方法

GET

URI

/openapi/instances/{instanceId}/actions/recommend

请求参数

名称 类型 是否必选 描述
sceneId String 物品被投放的场景id
userId String 用户唯一id
ip String 用户最后登录的ip
imei String 1、非注册用户必填2、按照指定要求,mac地址,设备号等无效,会无法使用内部用户画像信息,仅保留曝光过滤功能3、32位MD5值 4、安卓:MD5(imei),IOS:MD5(idfa)
ReturnCount Integer 返回结果条数(0-50之间)

返回参数

名称 类型 描述
RequestId String 请求id,公共参数
Result List ResultItem组成的数据

ResultItem的参数

名称 类型 描述
traceId String traceId=traceInfo:两个兼容,回传日志时使用,回传日志时,trace_id=ali,trace_info为返回结果里traceInfo的值(注意:每个item的值均不一样,回传日志时,需要传对应的)
itemId String 物品Id
itemType String 物品类型
matchInfo String 不用关心,debug时可能用到
weight Float 不用关心,debug时可能用到
position Integer 物品在需要展示的位置,从0开始(注意:返回结果已经按照position排序,可以不用关注)
traceInfo String traceInfo=traceId

请求示例

GET /openapi/instances/airec-cn-dsksdlisdlfsd/actions/recommend
?sceneId=1&userId=2&ip=10.120.70.19&returnCount=10

返回示例

{
  "requestId": "04707E49-642A-4649-827A-F8EEB07D4C27",
  "result": [
    {
      "traceId": "1007.19746.107647.100200300000000:c7bd13e3-371b-4276-b142-4c1a439f21a0:1:40000:0::::2:content___1729346806:image:cd:0.0545865490313237:0.027317269681932512:0.6218346196125295:::::::::::",
      "itemId": 1729346806,
      "itemType": "image",
      "matchInfo": "cd",
      "weight": 1.2,
      "position": 0,
      "traceInfo": ""      
    },
    {
      "traceId": "1007.19746.107647.100200300000000:c7bd13e3-371b-4276-b142-4c1a439f21a0:1:40000:0::::2:content___1729346806:image:cd:0.0545865490313237:0.027317269681932512:0.6218346196125295:::::::::::",
      "itemId": 1729346806,
      "itemType": "image",
      "matchInfo": "cd",
      "weight": 1.0,
      "position": 0,
      "traceInfo": ""
    }
  ]
}