# 广告数据上报

# analytics

# 1. 接口描述

接口功能:上报广告数据

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

提示

自 SDK 1.4.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. 示例代码

import cloudbase from "@cloudbase/js-sdk";
//初始化SDK实例
const app = cloudbase.init({
  env: "xxxx-yyy"
});

// 微信授权登录
const provider = auth.weixinAuthProvider({
  appid: "...",
  scope: "xxxx"
});

provider.getRedirectResult().then((loginState) => {
  if (loginState) {
    // 登录成功!
    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-迪士尼"
        }
      }
    });
  }
});