抖音开放平台Logo
开发者文档
小程序
控制台
  • 开发教程与代码示例
  • 入门
  • 小程序框架
  • 小程序运行时
  • 自定义组件
  • 基础教程
  • 能力教程
  • 流量入口
  • 通用能力
  • 推广变现
  • 经营能力
  • 接入订阅消息能力
  • 接入 IM 消息收发能力
  • 识别流量来源-标记链接方式指引（视频/直播）
  • 私域经营能力
  • 行业能力
  • AI/AR 能力
  • 性能优化
  • 安全

    • 识别流量来源-标记链接方式指引（视频/直播）
    收藏
    我的收藏

    通过接入流量来源识别能力，开发者能够获取用户来源，能够根据具体的需求区分用户进入小程序的具体来源，包括视频作者、主播等标识。平台已开放视频和直播场景的流量来源识别接口tt.getAnalysisInfo，如需更多自定义标签归因需求，可通过以下指引实现。
    ​

    一、视频场景

    1. 支持归因的粒度和条件

    归因粒度
    条件（需同时满足）
    归因到「人」
    员工A <—> 用户B
    ​
      1.小程序具备自挂载权限
      2.小程序和抖音号经平台绑定授权，包括 品牌号、员工号、合作号
      3.视频需通过移动端发布，包括 4 类
    （1）发布抖音视频 - button
    （2）拍抖音 - button
    （3）拍抖音 - 菜单面板
    （4）用户在抖音客户端点击“➕” ，打开视频发布器
    归因到「视频」
    员工A <—>视频1 <—> 用户B
    ​
      1.小程序具备自挂载权限
      2.小程序和抖音号经平台绑定授权，包括 品牌号
      3.视频需通过 小程序「拍抖音」能力发布，包括 3 类
    （1）发布抖音视频 - button
    （2）拍抖音 - button
    （3）拍抖音 - 菜单面板
    注：暂时不支持UGC（通用）挂载
    ​

    2. 移动端视频发布路径

    发布视频的路径
    触发开发者的钩子函数
    支持归因粒度
    1
    移动端 - 发布
      1.用户在抖音客户端点击“➕”
      2.用户自主拍摄/上传视频
      3.选择小程序页面作为锚地
    触发 onShareAppMessage
    归因到「人」
    2
    拍抖音-小程序菜单
      1.用户进入要挂载的小程序
      2.点击右上角菜单
      3.点击面板内的「拍抖音」按钮
    触发 onShareAppMessage
    归因到「视频」
    3
    拍抖音-button
    自定义
      1.开发者在小程序页面内渲染button
      2.用户
    （1）点击button后，拉起抖音拍摄器
    （2）用户自主拍摄/上传视频
    （3）选择小程序页面作为锚点
    触发 onShareAppMessage
    归因到「视频」
    4
    发布抖音视频-button
    自定义
      1.开发者在小程序页面内渲染button
      2.用户
    （1）点击button后，带上开发者上传的视频，进入视频发布页
    （2）选择小程序页面作为锚点
    触发 onUploadDouyinVideo
    归因到「视频」
    ​

    3. 接入方案

    ​

    归因到「人」

    步骤
    时机
    方案
    1. 发布视频
    ​
    开发者自主引导员工，通过移动端发布视频且挂载小程序锚点
    ​
    移动端有4种方式
      1.直接从抖音客户端的的“➕”发布器
      2.发布抖音视频 - button <button open-type="uploadDouyinVideo" ></button>
      3.拍抖音 - button<button open-type="share" data-channel="video"></button>
      4.拍抖音 - 菜单面板 。无需前端页面button，员工可以直接点击 小程序右上角 - 菜单 - 拍抖音
    2. 带参
    员工A通过 步骤1 挂载锚点时，会触发钩子函数。其中
      1.抖音➕、拍抖音 - button 和 菜单面板
    —> 触发 onShareAppMessage函数
      2.发布抖音视频 - button
    —> 触发 onUploadDouyinVideo 函数
    ​
    【方式一】开发者在onShareAppMessage 函数内可以自主实现
      1.开发者根据 ShareOtion 中的 channel=“video” 或 channel=“anchor” 识别当前的操作场景是「视频挂载」
      2.获取员工A的openid
      3.为当前锚点生成独一无二的小程序链接，即将员工A的openid拼接在页面path后
    如 index/product？员工=openid_A
    【方式二】开发者在onUploadDouyinVideo函数内可以自主实现
      1.获取员工A的openid
      2.为当前锚点生成独一无二的小程序链接，即将员工A的openid拼接在页面path后
    如 index/product？员工=openid_A
    3. 识参
    普通用户B从视频锚点进入小程序时
    ​
      1.开发者可以通过 tt.getLaunchOptionsSync 的query获取「员工A的openid」
      2.开发者可以获取用户B的openid
      3.最终可以映射 员工A的openid <—> 普通用户B的openid
    ​
    ​

    归因到「视频」

    步骤
    时机
    方案
    1. 拍抖音
    开发者自主引导员工，通过小程序「拍抖音」或「发布视频到抖音」发布视频
    ​
    小程序「拍抖音」或「发布视频到抖音」发布视频，有三种方式
      1.发布抖音视频 - button <button open-type="uploadDouyinVideo" ></button>
      2.拍抖音 - button<button open-type="share" data-channel="video"></button>
      3.拍抖音 - 菜单面板 。无需前端页面button，员工可以直接点击 小程序右上角 - 菜单 - 拍抖音
    2. 带参
    员工A通过 步骤1 中小程序「拍抖音」或「发布视频到抖音」挂载锚点时，会触发钩子函数。其中
      1.拍抖音 - button 和 菜单面板
    —> 触发 onShareAppMessage函数
      2.发布抖音视频 - button
    —> 触发 onUploadDouyinVideo 函数
    ​
    ​
    【方式一】开发者在onShareAppMessage 函数内可以自主实现
      1.开发者根据 ShareOtion 中的 channel=“video” 识别当前的操作场景是「视频挂载」
      2.获取员工A的openid，并为当前的视频生成一个唯一的临时参数 X
      3.为当前锚点生成独一无二的小程序链接，即将员工A的openid的视频参数X，拼接在页面path
    如 index/product？员工=openid_A & 视频=参数X
      4.当员工点击“发布视频”按钮 且 开发者在ShareAppMessage返回参数设置withVideoId=true，可以通过onShareAppMessage的成功回调获得 videoid
      5.可以映射 员工A的openid <—> 参数X <—>videoid
    【方式二】开发者在onUploadDouyinVideo函数内可以自主实现
      1.获取员工A的openid，并为当前的视频生成一个唯一的临时参数 X
      2.为当前锚点生成独一无二的小程序链接，即将员工A的openid的视频参数X，拼接在页面path
    如 index/product？员工=openid_A & 视频=参数X
      3.当员工点击“发布视频”按钮 且 开发者在ShareAppMessage返回参数设置withVideoId=true，可以通过onShareAppMessage的成功回调获得 videoid
      4.可以映射 员工A的openid <—> 参数X <—>videoid
    3. 识参
    普通用户B从视频锚点进入小程序时
    ​
      1.开发者可以通过 tt.getLaunchOptionsSync 的query获取「员工A的openid」和「参数X」
      2.开发者可以获取用户B的openid
      3.最终可以映射 员工A的openid <—> 参数X <—>videoid <—> 普通用户B的openid
    ​

    Q&A

    Q1：小程序内如何获取videoid
    A1：
      1.获取条件
        通过小程序「拍抖音」或「发布视频到抖音」能力发布成功，且成功挂载了锚点。需 同时满足 以下2个条件
        条件1：由小程序通过「拍抖音」能力发布，包含 3种方式
         （1） opentype=“uploadDouyinVideo”
         （2） open-type="share" data-channel="video"
         （3）小程序菜单-面板
        条件2：视频挂载了发布视频的小程序（不挂载or挂载其他小程序，不返回videoid）
    ​
      2.获取时机
        当用户点击发布视频，成功送入抖音内容审核后，通过钩子函数onShareAppMessage的success回调videoid开发者
    ​
    Q2：开发者如何控制在“小程序菜单面板”里展示「拍抖音」按钮？
    A2：需要同时满足以下2个条件
      1.前端代码注册onShareAppMessage函数
      2.开发者没有主动隐藏入口
    ​
    ​

    二、直播间场景

    1. 支持归因的粒度和条件

    归因粒度
    条件（需同时满足）
    归因到「人」
    员工A <—> 用户B
    ​
      1.小程序具备自挂载权限（暂时不支持通用挂载归因）
      2.小程序和抖音号经平台绑定授权，包括 品牌号、员工号、合作号
      3.通过抖音移动端开播，并挂载小程序
    ​

    2. 移动端开播

    发布视频的路径
    触发开发者的钩子函数
    支持归因粒度
    1
    抖音移动端 - 发布
      1.用户在抖音客户端点击“➕” ，切换至“开直播”
      2.选择小程序页面作为锚点
    触发 onShareAppMessage
    归因到「人」
    ​

    3. 接入方案：归因到「人」

    步骤
    时机
    方案
    1. 开播
    ​
    开发者自主引导员工，通过移动端开播且挂载小程序锚点
    直接从抖音客户端的的“➕”发布器，切换至“开播”
    2. 带参
    员工A 通过 步骤1 挂载锚点时，会触发钩子函数 onShareAppMessage
    ​
    开发者在onShareAppMessage 函数内可以自主实现
      1.开发者根据 ShareOtion 中的 channel=“live_anchor” 识别当前的操作场景是「直播挂载」
      2.开发者可以通过tt.login，获取员工A的openid
      3.为当前锚点生成独一无二的小程序链接，即将员工A的openid拼接在页面path后
    如 index/product？员工=openid_A
    3. 识参
    普通用户B从直播间进入小程序时
    ​
      1.开发者可以通过 tt.getLaunchOptionsSync 的query获取「员工A的openid」
      2.开发者可以获取用户B的openid
      3.最终可以映射 员工A的openid <—> 普通用户B的openid