开发
API

小程序接入分享指南

内容转发

小程序支持转发链接、图文、视频和分享口令等不同形式的内容。

获取分享素材 ID

开发者可以提前通过开发者后台配置分享图片、标题、文案,并由平台进行审核。

⚠️ 审核通过的分享内容,在线上的转发行为依然会受平台监管,请开发者遵守运营规范相关要求。

获取路径:字节小程序开发者平台-> 选择对应小程序 -> 流量配置 -> 分享设置 -> 新建分享

新建分享,按照要求填写分享标题、分享文案内容,上传分享图案,点击提交审核即可

新建分享时,支持预览效果,可以自由切换抖音端 or 头条端

分享内容定义

分享内容

字段

名称

使用建议

内容定义

最低版本

分享标题

title

分享标题

不超过 14 个中文字符

一句话介绍小程序


分享图片

imageUrl

分享图片

图片规格:适应各场景

小程序相关图片,能够配合文案


分享文案

desc

分享文案

不超过 28 个中文字符

小程序简介、分享场景等

1.30.0.1

注:自定义内容暂时只支持端内分享。

分享内容指定方式

平台支持不同形式来指定转发的内容(图片、标题、文案),最终按照优先级规则进行选择。

分享内容优先级

今日头条/头条极速版:

场景

优先级

端内分享

代码指定 > 模板指定 > 平台默认

端外分享

模板指定 > 平台默认

小程序内接入转发能力

通过转发图文、视频和口令等不同形式的内容,具体用法参考开发文档

代码示例

Page({
  ...
  onShareAppMessage (option) {
    // option.from === 'button'
    return {
      title: '这是要转发的小程序标题',
      desc: '这是默认的转发文案,用户可以直接发送,也可以在发布器内修改',
      path: '/pages/index/index?from=sharebuttonabc&otherkey=othervalue', // ?后面的参数会在转发页面打开时传入onLoad方法
      imageUrl: 'https://e.com/e.png', // 支持本地或远程图片,默认是小程序icon
      templateId: '这是开发者后台设置的分享素材模板id',
      success () {
        console.log('转发发布器已调起,并不意味着用户转发成功,微头条不提供这个时机的回调');
      },
      fail () {
        console.log('转发发布器调起失败');
      }
    }
  },
  onLoad (query) {
    if (query.from === 'sharebuttonabc') {
      // do something...
    }
  }
});
点击纠错
评价此篇文档