抖音开放平台Logo
开发者文档
“/”唤起搜索
控制台
  • JS API 列表
  • 基础
  • TTML
  • 网络
  • 媒体
  • 地图
  • 文件
  • 数据缓存
  • 地理位置
  • 设备
  • 画布
  • 界面
  • 页面导航
  • 开放接口
  • 登录
  • 用户信息
  • 广告
  • 营销能力
  • 支付
  • 分享
  • 小程序跳转
  • 抖音视频能力
  • 收货地址
  • 设置
  • 授权
  • 评价能力
  • 数据分析
  • 视频拍摄器
  • 引导关注
  • 订阅消息
  • 电商插件能力(即将废弃)
  • 流量来源识别
  • 隐私信息授权
  • web化
  • 转发和挂载
  • 侧边栏能力
  • tt.getSidebarActivity
  • tt.navigateToScene
  • tt.updateSidebarActivity
  • tt.createSceneActivityContext
  • SceneActivityContext
  • SceneActivityContext 概述
  • SceneActivityContext.bind
  • SceneActivityContext.query
  • SceneActivityContext.checkScene
  • SceneActivityContext.jump
  • SceneActivityContext.receive
  • SceneActivityContext.on
  • 直播能力
  • AI/AR能力
  • 安全能力
  • 行业开放
  • 第三方平台
  • 其它
  • 生活服务(即将废弃)
  • 基础库 3.27.0 开始支持本方法,这是一个异步方法。

    查询复访福利活动id列表

    前提条件

    请确认已通过开发者平台控制台中或通过 OpenAPI 创建小程序券模板和小程序营销活动,接入方式详见:侧边栏复访营销

    业务背景
    使用限制

    暂不支持抖音开发者工具调试,真机调试请参考小程序线上调试彩蛋

    注意事项

    该能力需要开发者前置在控制台或通过 openapi 创建复访营销活动并且复访营销活动的引流方式需要为小程序内组件调用,弹窗样式需要选择自定义样式,才可进行调用,具体申请流程可参考>>小程序券创建流程小程序营销活动创建流程

    支持沙盒
    相关教程

    语法

    SceneActivityContext.query(options)

    参数说明

    options 为 object 类型,属性如下:

    属性名类型默认值必填说明最低支持版本
    successfunction
    接口调用成功的回调函数
    3.27.0
    failfunction
    接口调用失败的回调函数
    3.27.0
    completefunction
    接口调用结束的回调函数(调用成功、失败都会执行)
    3.27.0

    回调成功

    object 类型,属性如下:

    属性名类型说明最低支持版本
    activityListarray

    复访福利活动 id 列表

    3.27.0
    errMsgstring
    "SceneActivityContext.query:ok"
    3.27.0

    回调失败

    object 类型,属性如下:

    属性名类型说明最低支持版本
    errMsgstring
    "SceneActivityContext.query:fail" + 详细错误信息
    3.27.0

    错误码

    errNoerrMsg说明最低支持版本
    21001ActivityContext.query:fail activity does not exist

    营销复访活动不存在,请先查阅《小程序营销活动创建流程

    3.27.0

    扫码体验

    请使用字节宿主APP扫码

    代码示例

    开发者工具中预览

    Page({ activityContext: undefined, data: { queryResult: '', }, onLoad() { this.activityContext = tt.createSceneActivityContext(); this.activityContext.query({ success: console.log, fail: console.log }) }, });