# 广告数据上报

# analytics

# 1. 接口描述

接口功能:上报广告数据

接口声明:analytics(object: Object): Promise<void>

提示

自 SDK 2.5.0 版本起支持此接口

# 2. 输入参数

字段 类型 必填 说明
report_type string 上报类型,目前支持 "mall"
report_data IReportData 上报内容
# IReportData
字段 类型 必填 说明
action_time number 上报时间,不填默认取当前客户端时间,单位为秒
action_type string 行为类型 如 访问 visit_store,分享 share,加入购物车 add_to_cart 等,详细类型参考表 action_types
click_id string 广告平台会在 URL 增加 click_id,取值方式参考 (opens new window)
action_param IActionParam 行为所带的参数
product_param IProductParam 商品结构内容
# IActionParam
字段 类型 必填 说明
value number 行为所带的参数,转化行为价值(例如金额)
leads_type string 行为来源,目前支持 PHONE(电话直呼),RESERVE(表单预约)
# IProductParam
字段 类型 必填 说明
product_yun_type string 商品 goods ,优惠券 coupon, 搜索词 search_term
product_yun_id string 商品 id
product_yun_category string 商品类目 自定义
product_yun_keywords string 商品关键词
product_yun_price number 商品原价
product_yun_value number 商品成交价
product_yun_name string 商品名
product_yun_id_ad string 广告商品库中商品 id
product_yun_category_ad string 广告商品库中商品类目
# action_types
类型值 说明
visit_store 访问
share 分享
consult 咨询
claim_offer 卡券领取
add_to_cart 加入购物车
add_to_wishlist 收藏
complete_order 下单
purchase 支付
search 搜索
deliver 发货
sign_in 签收

# 3. 输出参数

# 4. 示例代码

const tcb = require("@cloudbase/node-sdk");
const app = tcb.init({ env: "xxx" });

app.analytics({
  report_type: "mall",
  report_data: {
    action_type: "visit_store",
    action_param: {
      value: 100
    },
    product_param: {
      product_yun_type: "goods",
      product_yun_id: 1,
      product_yun_keywords: "优衣库",
      product_yun_price: 200,
      product_yun_value: 100,
      product_yun_name: "优衣库Utee-迪士尼"
    }
  }
});