API Reference
English

扫码

事件类别:marketing_code

  • marketing[* Object Marketing]:营销活动信息
    • marketing_id[* String]:活动 ID
    • open_id[String]:三方身份 ID
    • open_id_type[String]:三方身份类型,例如 wechat
    • begin_time[Long]:开始时间,时间戳(毫秒),UTC, Jan 1, 1970
    • expire_time[Long]:结束时间,时间戳(毫秒),UTC, Jan 1, 1970
  • marketing_code[* Object MarketingCode]:营销活动码信息
    • code_id[* String]:活动码 ID
    • code_image[String]:活动码图片内容,图片 URL
    • is_valid[Boolean]:是否有效,枚举值
      • true:是
      • false:否
    • is_used[Boolean]:是否被使用,枚举值
      • true:是
      • false:否
  • marketing_address[Object Address]:营销活动码投放地址
    • country[* String]:国家,两位国家码,符合 ISO 3166 标准
    • region[* String]:省 / 州 / 地区
    • city[* String]:城市
    • district[String]:区县
    • detail[String]:详细地址
    • zip_code[String]:邮政编码
  • marketing_merchandise[Object Merchandise]:营销活动码关联的商品信息
    • merchandise_id[* String]:商品 ID
    • category_1[* String]:商品一级类目
    • category_2[String]:商品二级类目
    • category_3[String]:商品三级类目
    • name[String]:商品名称
    • count[Integer]:商品数量
    • unit_price[Object Amount]:商品单价
      • currency[* String]:原始金额货币类型,3 字母编码,符合 ISO 4217 标准
      • amount_local[* Double]:原始金额
      • amount_usd[Double]:金额(美金),将原始金额经过汇率换算后的美金金额,(条件必须:如果接入的是非 CN 站点则必须)
      • amount_cny[Double]:金额(人民币),将原始金额经过汇率换算后的人民币金额,(条件必须:如果接入的是 CN 站点则必须)
{
    "marketing": {
        "marketing_id": "X08938",
        "open_id": "o6_bmjrPTlm6_2sgVt7hMZOPfL2M",
        "open_id_type": "wechat",
        "begin_time": 1596358039000,
        "expire_time": 1616358039000
    },
    "marketing_code": {
        "code_id": "XC08938",
        "code_image": "https://tdcode.com/a.jpg",
        "is_valid": true,
        "is_used": false
    },
    "marketing_address": {
        "country": "CN",
        "region": "浙江省",
        "city": "杭州市",
        "district": "余杭区",
        "detail": "文一西路海创园 18 幢",
        "zip_code": "310000"
    },
    "marketing_merchandise": {
        "merchandise_id": "NFH837824432",
        "category_1": "3c",
        "category_2": "phone",
        "category_3": "android",
        "name": "huawei phone",
        "count": 1,
        "unit_price": {
            "currency": "CNY",
            "amount_local": 6800,
            "amount_usd": 1000,
            "amount_cny": 6800
        }
    }
}