接入线索组件
收藏背景知识
能力介绍
线索组件是抖音开放平台提供给线索类小程序的核心经营能力，帮助经营者高效获取手机号等线索，提升流量分发精准性。开发者通过接入线索组件实现相关功能。
- •进阶能力获取：基础库 3.3.0 及之后版本中，获得线索组件权限的小程序可在 form 表单中使用获取手机号功能。
- •分发扶持：帮助经营者将服务类目、服务区域等信息透传给抖音开放平台，从而帮助小程序在直播等场景获得更精准的流量分发，提升线索获取效率。
- •数据披露：接入线索组件后，线索相关的详细业务数据可在后台进行统计分析，并可通过接口获取，包括从视频/直播观看量到线索量中的层层数据漏斗，并实现线索量归因、直播间实时展现。
- •权益挂钩：抖音开放平台对线索类小程序的权益激励，均与通过线索组件获取的线索量挂钩。
准入条件
线上类目包括线索类目的小程序均可接入线索组件，建议在小程序上线前完成线索组件接入。
分发扶持
将接入线索组件的小程序挂载在直播间后，抖音开放平台通过感知经营者提供的信息辅助直播间流量精准分发。建议将挂载页面设置为包含 form 组件的留资页面以缩短用户留资步骤，具体挂载步骤详见绑定抖音号、直播挂载。
数据披露
数据查看路径为控制台-数据-能力-留资分发配置，可得数据包括：
数据 | 示意图 |
线索组件整体使用情况 | |
组件交互与线索的流量来源 | |
短视频与直播间的线索转化详情 | |
不同线索业务的线索转化详情 |
线索组件开放类目
一级类目 | 二级类目 | 三级类目 | 线索组件接入要求 |
汽车 | 二手车 | 二手车线下零售 | |
汽车 | 二手车 | 二手车服务平台 | |
政务 | 政务民生 | 人力资源 | |
政务 | 政务民生 | 教育 | |
IT 科技 | IT 科技 | 虚拟运营商及代理商 | |
IT 科技 | IT 科技 | 基础电信运营商 | |
IT 科技 | IT 科技 | 电信业务代理商 | |
IT 科技 | IT 科技 | 软件服务提供商 | |
金融 | 金融业 | 股票信息服务平台 | |
金融 | 金融业 | 新三板信息服务平台 | |
金融 | 金融业 | 保险中介公司 | |
金融 | 金融业 | 保险公司 | |
金融 | 金融业 | 公募基金 | |
金融 | 金融业 | 私募基金 | |
金融 | 金融业 | 信托 | |
金融 | 金融业 | 银行 | |
商业服务 | 商业服务 | 工业品供应商 | |
商业服务 | 商业服务 | 出国移民 | |
商业服务 | 商业服务 | 工商/税务/财务代理 | |
商业服务 | 商业服务 | 一般财务服务 | |
商业服务 | 商业服务 | 农林牧渔 | |
商业服务 | 商业服务 | 公共印章刻制 | |
商业服务 | 商业服务 | 典当 | |
商业服务 | 商业服务 | 亲子/司法鉴定 | |
商业服务 | 商业服务 | 司法拍卖 | |
商业服务 | 商业服务 | 文物拍卖公司 | |
商业服务 | 商业服务 | 拍卖公司（非文物） | |
商业服务 | 商业服务 | 会展服务 | |
商业服务 | 商业服务 | 广告/设计 | |
商业服务 | 商业服务 | 法律服务 | |
商业服务 | 商业服务 | 第三方人力资源服务 | 必接 |
商业服务 | 商业服务 | 税务师事务所 | |
商业服务 | 商业服务 | 会计师事务所 | |
商业服务 | 商业服务 | 专利/商标代理 | |
商业服务 | 商业服务 | 招聘/求职（中介） | 必接 |
商业服务 | 商业服务 | 公证 | |
商业服务 | 商业服务 | 律师事务所 | |
商业服务 | 商业服务 | 企业自招工 | |
房地产 | 房地产 | 房地产资讯 | |
房地产 | 房地产 | 商品房预售 | |
房地产 | 房地产 | 房地产开发商 | |
房地产 | 房地产 | 房屋中介 | |
准备工作
接入流程
代码示例
相关组件能力
form 表单
属性名 | 类型 | 默认值 | 必填 | 说明 | 最低支持版本 |
conversion-target | number | 0 | 否 | 用于分发目的。取值：0 或 1，其中 0 表示默认，1 表示留资目标，需要和线索组件一起使用，详情见线索组件配置 | 2.88.0 |
clue-component-id | string | "" | 否 | 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 修改将影响行为上报。- •联调用于验证线索组件的正确使用方式。若使用方式正确，未完成联调和激活时，曝光、点击、留资行为仍可正常上报。
