抖音开放平台Logo
开发者文档
“/”唤起搜索
控制台
  • 开发教程与代码示例
  • 入门
  • 小程序框架
  • 小程序运行时
  • 自定义组件
  • 基础教程
  • 能力教程
  • 流量入口
  • 通用能力
  • 推广变现
  • 接入线索组件
  • 接入广告能力
  • 经营能力
  • 行业能力
  • AI/AR 算法能力
  • 性能优化
  • 安全
  • 接入线索组件

    收藏
    我的收藏

    背景知识

    能力介绍

    线索组件是抖音开放平台提供给线索类小程序的核心经营能力,帮助经营者高效获取手机号等线索,提升流量分发精准性。开发者通过接入线索组件实现相关功能。
      •进阶能力获取:基础库 3.3.0 及之后版本中,获得线索组件权限的小程序可在 form 表单中使用获取手机号功能。
      •分发扶持:帮助经营者将服务类目、服务区域等信息透传给抖音开放平台,从而帮助小程序在直播等场景获得更精准的流量分发,提升线索获取效率。
      •数据披露:接入线索组件后,线索相关的详细业务数据可在后台进行统计分析,并可通过接口获取,包括从视频/直播观看量到线索量中的层层数据漏斗,并实现线索量归因、直播间实时展现。
      •权益挂钩:抖音开放平台对线索类小程序的权益激励,均与通过线索组件获取的线索量挂钩。

    准入条件

    线上类目包括线索类目的小程序均可接入线索组件,建议在小程序上线前完成线索组件接入。

    分发扶持

    将接入线索组件的小程序挂载在直播间后,抖音开放平台通过感知经营者提供的信息辅助直播间流量精准分发。建议将挂载页面设置为包含 form 组件的留资页面以缩短用户留资步骤,具体挂载步骤详见绑定抖音号、直播挂载。

    数据披露

    数据查看路径为控制台-数据-能力-留资分发配置,可得数据包括:
    数据
    示意图
    线索组件整体使用情况
    组件交互与线索的流量来源
    短视频与直播间的线索转化详情
    不同线索业务的线索转化详情

    线索组件开放类目

    一级类目
    二级类目
    三级类目
    线索组件接入要求
    汽车
    二手车
    二手车线下零售
    ​
    汽车
    二手车
    二手车服务平台
    ​
    政务
    政务民生
    人力资源
    ​
    政务
    政务民生
    教育
    ​
    IT 科技
    IT 科技
    虚拟运营商及代理商
    ​
    IT 科技
    IT 科技
    基础电信运营商
    ​
    IT 科技
    IT 科技
    电信业务代理商
    ​
    IT 科技
    IT 科技
    软件服务提供商
    ​
    金融
    金融业
    股票信息服务平台
    ​
    金融
    金融业
    新三板信息服务平台
    ​
    金融
    金融业
    保险中介公司
    ​
    金融
    金融业
    保险公司
    ​
    金融
    金融业
    公募基金
    ​
    金融
    金融业
    私募基金
    ​
    金融
    金融业
    信托
    ​
    金融
    金融业
    银行
    ​
    商业服务
    商业服务
    工业品供应商
    ​
    商业服务
    商业服务
    出国移民
    ​
    商业服务
    商业服务
    工商/税务/财务代理
    ​
    商业服务
    商业服务
    一般财务服务
    ​
    商业服务
    商业服务
    农林牧渔
    ​
    商业服务
    商业服务
    公共印章刻制
    ​
    商业服务
    商业服务
    典当
    ​
    商业服务
    商业服务
    亲子/司法鉴定
    ​
    商业服务
    商业服务
    司法拍卖
    ​
    商业服务
    商业服务
    文物拍卖公司
    ​
    商业服务
    商业服务
    拍卖公司(非文物)
    ​
    商业服务
    商业服务
    会展服务
    ​
    商业服务
    商业服务
    广告/设计
    ​
    商业服务
    商业服务
    法律服务
    ​
    商业服务
    商业服务
    第三方人力资源服务
    必接
    商业服务
    商业服务
    税务师事务所
    ​
    商业服务
    商业服务
    会计师事务所
    ​
    商业服务
    商业服务
    专利/商标代理
    ​
    商业服务
    商业服务
    招聘/求职(中介)
    必接
    商业服务
    商业服务
    公证
    ​
    商业服务
    商业服务
    律师事务所
    ​
    商业服务
    商业服务
    企业自招工
    ​
    房地产
    房地产
    房地产资讯
    ​
    房地产
    房地产
    商品房预售
    ​
    房地产
    房地产
    房地产开发商
    ​
    房地产
    房地产
    房屋中介
    ​

    准备工作

    接入流程

    操作步骤
    示意图
    说明
      1.申请开通能力
    ​
    申请路径:控制台 > 能力 > 页面及信息 > 用户能力 > 线索组件
      2.配置线索组件
    ​
    一个线索组件对应一个具体的线索业务(区域及类目),配置完成后获取组件 ID
    ​
      3.实现前端页面
    ​
      1.调用 form 表单组件实现小程序线索页面设计。
      2.在 form 表单组件中设置线索组件 ID线索组件基础用法。
      3.调用获取手机号开放能力快速获取线索。
    注意
    获取手机号能力仅在配置了线索组件 ID 的 form 表单页面中可用。
    ​
      4.联调测试
    该环节非必要,但建议开发者进行联调测试,以确保组件可用性及数据准确性

    代码示例

    相关组件能力

    form 表单

    属性名
    类型
    默认值
    必填
    说明
    最低支持版本
    conversion-target
    number
    0
    否
    用于分发目的。取值:0 或 1,其中 0 表示默认,1 表示留资目标,需要和线索组件一起使用,详情见线索组件配置
    2.88.0
    clue-component-id
    string
    ""
    否
    用于分发目的。开发者在【小程序开发者后台 -> 进入目标小程序 -> 能力 -> 用户数据能力 -> 身份数据 -> 线索组件】申请能力后复制创建的配置 ID,需要和线索组件一起使用,详情见线索组件配置
    2.88.0
    bindsubmit
    EventHandle
    无
    否
    携带 form 中的数据触发 submit 事件,event.detail = {value : {'name': 'value'} , ...}。
    1.0.0
    bindreset
    EventHandle
    无
    否
    表单重置时会触发 reset 事件。
    1.0.0

    button 按钮

    属性名
    类型
    默认值
    必填
    说明
    最低支持版本
    form-type
    string
    ​
    否
    用于嵌在 form 组件中,控制 submit/reset,详情见 form-type 的合法值
    1.0.0
    open-type
    string
    ​
    否
    用于调用开放能力, 详情见 open-type 的合法值
    1.0.0
    bindgetphonenumber
    EventHandle
    ​
    否
    获取用户手机号回调,只在 open-type="getPhoneNumber" 时有效
    1.14.0

    其他表单组件能力

    其他表单组件能力的使用方法可以参考相关文档。

    代码示例

    线索组件基础用法

    需要在 form 组件中配置 clueComponentId 和 conversionTarget 属性值,其中 clueComponentId 是小程序后台生成的专属组件 ID(仅限对应的小程序使用),conversionTarget 需设置为 1。
    .ttml
    .js
    <!-- .ttml --> <form bindsubmit="formSubmit" bindreset="formReset" clue-component-id="{{clueComponentId}}" conversion-target="{{conversionTarget}}" > <!-- 这里可以根据需要来使用表单组件 --> <slider name="slider" value="50" show-value></slider> <switch name="switch1" /> <switch name="switch2" checked="checked" /> <button open-type="getPhoneNumber" bindgetphonenumber="getPhoneNumber"> getPhoneNumber </button> <button type="primary" form-type="submit">提交</button> <button form-type="reset">重设</button> </form>

    只有一个 openType="getPhoneNumber" button 的使用方式

    需在 form 组件配置 conversion-target="1" 和 clueComponentId,form 内部 button 应同时设置 formType="submit" 和 open-type="getPhoneNumber"。clueComponentId 是由小程序后台生成的专属组件 ID,仅限创建时对应的小程序使用。
    .ttml
    .js
    <!-- .ttml --> <form bindsubmit="formSubmit" bindreset="formReset" clue-component-id="{{clueComponentId}}" conversion-target="{{conversionTarget}}" > <button form-type="submit" open-type="getPhoneNumber" bindgetphonenumber="getPhoneNumber" > getPhoneNumber </button> </form>

    异步获取到 clueComponentId 后再使用

    需要在 form 组件中配置 conversion-target 值为 1,通过 tt:if 控制 form 组件渲染时机,确保渲染前设置正确的 clueComponentId。该 ID 是小程序后台生成的专属组件标识。
    .ttml
    .js
    <!-- .ttml --> <form tt:if="{{clueComponentId}}" conversion-target="{{conversionTarget}}" clue-component-id="{{clueComponentId}}" > <button formType="submit" open-type="getPhoneNumber" bindgetphonenumber="getPhoneNumber" > getPhoneNumber </button> </form>

    注意事项

      •只支持用「抖音」app 联调。
      •若联调时出现有「点击」或「留资」事件,但是没有「曝光」事件,可重启抖音再联调尝试。
      •需在组件渲染前设置 clue-component-id 和 conversion-target,渲染完成后通过 setData 修改将影响行为上报。
      •联调用于验证线索组件的正确使用方式。若使用方式正确,未完成联调和激活时,曝光、点击、留资行为仍可正常上报。
    ​