用户指南

更新时间:
复制为 MD 格式

您可以在图像搜索(淘宝联盟版)控制台中完成PID管理、图搜查询和调用数据监控等功能。

控制台介绍

  1. 进入管理控制台,按照提示输入PIDPID描述,单击绑定PID

    说明
    1. PID是对应淘宝联盟账户中的推广位代码,每创建一个推广位即生成一个新的PID。绑定PID用于阿里云账户与淘宝联盟账户关联,并将佣金沉淀到绑定的淘宝联盟账户中,请谨慎操作。

    2. PID格式:mm_淘宝联盟账户ID_推广渠道ID_推广位ID。如何获取PID,可单击说明文档查看。

  2. 绑定后进入图像搜索(淘宝联盟版)控制台页面。页面包含图片搜索PID管理数据监控三个功能页签,默认进入图片搜索页签。

  3. 进入图像搜索(淘宝联盟版)控制台页面后,请选择华东2(上海)区域。在页面顶部导航栏的区域选择器中,展开下拉列表可看到华东1(杭州)华东2(上海)华北2(北京)华南1(深圳)等区域选项。

    说明

    图像搜索(淘宝联盟版)只在华东2(上海)区域节点有服务,所以请您务必先选择华东2(上海)区域后再进行后续相关操作,否则会导致服务报错。

图片搜索

  1. 图像搜索(淘宝联盟版)绑定PID后,进入图片搜索管理控制台页面。页面中依次显示搜索类型上传图片图片主体识别PID返回结果数结果起始位置图片类目卖家类型返回字段渠道ID等配置项,以及底部的确认清空参数按钮。

    1. 图像搜索(淘宝联盟版)提供使用新图片搜索相似图片使用图片URL搜索相似商品两种请求方式。

    2. 默认开启图片主体识别功能。

      说明

      若开启主体识别,则由系统自动进行主体识别或自定义主体区域,并以主体区域进行搜索,主体识别结果可在Response中获取。

      若选择不开启主体识别,则不进行主体识别,并以整张图进行搜索。

    3. 系统提供自动主体识别功能和自定义主体区域功能。

      1. 自动主体识别功能,为系统内置的主体检测算法,并在response->picInfo->mainRegionmultiRegion中返回结果。更多mainRegionmultiRegion内容请参见拍照购物

      2. 自定义主体区域功能,允许您自助画框,并针对框内的内容进行图片相似性检索。上传图片后,图片上会显示蓝色虚线选框,可拖动调整位置和大小以圈定搜索目标。

    4. PID为您在淘宝联盟版中绑定的PID。如果绑定了多个PID则可通过下拉框进行选择。

    5. 返回结果数:为一次图片相似性查询所返回的最大结果条数。默认为10条,最大为20条。

    6. 返回结果的起始位置:为返回结果的开始位置,以起到分页的功能。

      说明

      例如返回结果起始位置为20,返回结果数为10,则会从第20个结果开始返回10个结果,以起到结果翻页的效果。

    7. 图片类目为查询过滤条件,可以限定搜索结果的类目。如果设置类目,则以设置的类目为准;如果不设置类目,则由系统进行类目预测,预测的类目结果可以在Response中获取 。

      1. 例如图片中包含旅行箱,同时搜索结果只想在箱包类目中进行相似性比对,则图片类目可选择为。下拉列表中提供上衣裙装下装配饰零食美妆等类目选项。如果不选择任何类目则默认由系统进行类目识别,并进行相似搜索。建议选择默认,由系统进行类目预测。

    8. 卖家类型:支持淘宝、天猫两种卖家类型过滤。如果选择淘宝则只会在淘宝卖家中进行相似性比对;如果选择天猫则只会在天猫卖家中进行相似性比对。

    9. 返回字段:为response中返回的相关字段。返回字段详情请参考,返回数据。返回字段选择如下:展开下拉列表可看到ItemIdTitleShortTitleSubTitlePicUrlReservePriceZkFinalPricePriceAfterCoupon等字段选项,支持多选。

    10. 渠道ID:为淘宝联盟中的relationID。

    11. 输入图片,并选择相关请求参数,单击确认,获取返回结果。右侧原始返回结果面板以JSON格式展示搜索结果,包含rankScore(相似度评分)、picUrl(商品图片)、reservePrice(价格)、title(商品标题)等字段。

PID管理

  1. PID是对应淘宝联盟账户中的推广位代码,每创建一个推广位即生成一个新的PID。绑定PID用于阿里云账户与淘宝联盟账户关联,并将佣金沉淀到绑定的淘宝联盟账户中,还请谨慎操作。申请PID,请参见说明文档

  2. 新增PID,单击绑定PID,进行新PID绑定。进入PID管理页签,页面展示已绑定PID的列表,包含PID描述绑定时间列,顶部有搜索框可按条件筛选。

  3. 输入PIDPID描述,单击确定,完成PID绑定。弹出绑定PID对话框,提示最多绑定50PID。PID字段格式为mm_账号id_推广渠道id_推广位id,描述字段支持英文、中文、数字和下划线,长度不超过32个字符。

    说明
    1. 图像搜索(淘宝联盟版)单个账户最多绑定50PID。

    2. PID格式为三段式:mm_淘宝联盟账户id_推广渠道id_推广位id

    3. 申请PID,请登录淘宝联盟账户,按照说明文档进行申请。

  4. 编辑PID,单击编辑,可修改PID描述信息。PID列表的操作列中包含编辑删除数据监控三个操作链接。弹出编辑对话框,其中PID字段已预填不可更改,仅描述字段可编辑。

  5. 删除PID,单击删除,可删除已经绑定的PID。弹出确认对话框,提示删除后此PID将不能被用于图搜请求,单击确定删除完成操作。

  6. 单击数据监控,可查看此PID下的调用请求详情。image

数据监控

  1. 单击进入数据监控,可查看本账户所有PID调用信息之和。image

    说明

    本页面展示的调用数据是所有PID调用数据之和,包括所选时间段内已经删掉的PID的调用数据。