-
客户端展示
2019-03-13 12:56:06进行客户端展示相关配置,有利于增加小程序的曝光1、搜索关键词:请在开发者后台配置。精确寻址,通用词、泛词等词汇均会被审核同学拒绝2、分享设置分享相关文案及图片请在开发者后台自行配置3、获取内测资格只有获取内测资格才可以进行4,5条操作4、小视频、个人主页tab:获得内测资格的头条号在绑定小程序后进行小视频、个人主页tab相关操作,具体教程见下文5、头条号作者编辑文章插入卡片:获得内测资格的头条号在绑定小程序后可以在图文编辑器中进行手动插入,可以自选落地页以及卡片样式
获取内测资格内测阶段,功能权限需要申请配置,申请流程:邮件到developer@bytedance.com,邮件中需要包含:1.小程序名称,2.头条号名称,3.appid,4.mid,5.头条号主页链接1.若账号较多,请将表格保存至附件发送2.appid获取方式:在开发者平台-开发-小程序Key中获取3.mid获取方式:选择主页链接,如头条小程序头条号主页链接,https://www.toutiao.com/c/user/106116465495/
mid=1616272632042504,其中,mid=1616272632042504
头条号绑定小程序1.进入头条号后台,在实验室中选择「小程序」(有内测资格的头条号才会有小程序功能)。2.新建绑定。3.输入Appid,点击确定绑定即可。4.此时绑定状态显示等待确认,需要到开放平台对应小程序的设置中确认绑定。5.确认后,需要审核,审核通过即可.
文章插入小程序1.进入图文发布入口,在图文编辑器中可以看到小程序图标。2.在想要插入的位置选择对应插入的小程序就可以啦,点击高级设置可以编辑介绍文案和落地地址呢~
小视频插入小程序1.进入小视频发布入口,上传视频后,在编辑视频内容时可以看到看到小程序项及落地地址,选择要插入的小程序并填写落地路径即可成功插入。
头条号首页底部插入小程序入口效果图:1.进入头条号后台,选择自定义菜单,并新建菜单。2.按照提示选择要配置的小程序。 -
开发入驻
2019-03-13 12:56:06
开发者入驻进入字节跳动小程序开发者平台,首次使用选择【快捷登录】即可注册,并根据提示设置开发者用户名。内测阶段填写申请材料申请开发
填写小程序资质
第一步:个人/企业资质审核提交登录成功后,【进入开发者平台】,点击【创建小程序】开始创建。每次创建小程序会进行【个人/企业资质审核提交】操作,开发者根据业务需要选择资质类型。个人主体:个人开发者。企业主体:以企业、个体工商户、企业相关品牌身份进行开发,可以使用支付功能、配置业务域名。小程序中的设置页面中可以看到审核结果:
第二步:填写小程序信息并提交根据提示填写所对应的身份信息后,点击【下一步】,进行【小程序信息】的填写,请准确填写小程序相关信息,提交后信息修改受规则限制。小程序名称:在小程序发布/更新时可修改,每年可以修改两次。小程序简介/小程序图标:小程序发布/更新时可修改简介。提交并通过审核,小程序创建成功。
小程序开发准备
添加开发者与管理员登录开发者平台,进入小程序详情页,点击【协作】,可通过开发者用户名添加开发者和管理员。
获取AppID登录开发者平台,进入小程序详情页,点击【开发】,可获取AppID(头条小程序ID),AppSecret(头条小程序密钥)。
设置服务器域名登录开发者平台,进入小程序详情页,点击【开发】,可修改配置服务器域名。request合法域名socket合法域名uploadFile合法域名downloadFile合法域名企业资质的开发者可以配置webview域名。
开通支付登录开发者平台,进入小程序详情页,点击【支付】,企业资质通过后可申请开通支付。使用个人资质创建的小程序将无法使用支付功能。
下载安装开发者工具详细阅读开发者文档并进入下载页面,下载开发者工具。详细开发者工具操作见开发者工具操作说明。设计小程序UI之前,建议先查看小程序设计文档。建议写代码之前,先查看开发文档,了解小程序相关能力。
提审、发布、更新使用开发者平台进行小程序的提审、发布和更新的等操作,上传测试版本后即可获取小程序二维码,在手机上进行开发测试。一个小程序可以同时拥有多个测试版本,一个线上版本。
第一步:上传测试版本登录开发者平台,进入小程序详情页,点击【发布】,选择【测试版本】中的【更新】按钮,填写当前版本信息并上传三张小程序内容截图、zip格式的小程序应用包,点击【确认】后进行编译。版本号应符合字节头条小程序版本号规范及建议管理策略更新日志中应包含小程序不同版本之间的变动,不建议使用无意义内容
第二步:提交审核在平台或IDE上完成上传后,可以在小程序详情页的【开发】中查看到上传的测试版本。当测试完成,小程序的功能和体验都较为完整,选择要提审的测试版本,点击【提审】,即可提交版本信息及小程序内容,审核将会在1-2个工作日完成。可以在【审核版本】中看到正在审核的小程序版本及审核状态,若审核不通过,会显示未通过原因。审核状态显示通过后,方可发布小程序上线。
第三步:设置搜索关键词与分享当发布未配置搜索关键词与分享内容版本时,会弹出提示与跳转地址,点击【前往配置】。如果已有搜索关键词和分享内容,想要查看或进行修改,可以在小程序详情页中的【设置】进行相应的配置。配置搜索关键词:提交的搜索关键词应符合小程序搜索关键词分享设置
第四步:发布小程序通过审核并且配置过搜索关键词与分享内容的版本,在【审核版本】中点击发布即可将小程序发布至线上。可以在小程序列表中看到相应小程序线上的版本号。 -
数据解析
2019-03-13 12:56:06开发者平台提供的数据功能是面向小程序开发者和运营人员的数据分析工具,帮助开发者和运营人员进行产品迭代优化和小程序的运营推广。
数据指标解析日访问数:当日访问小程序的人数,即小程序日活新增用户数:当日第一次访问小程序的人数总用户数:历史上访问过小程序的用户去重后的总和30日活跃用户数:当日及其前30天内的活跃用户去重后的总和人均时长:当日所有用户停留在该小程序的总时长(分钟)/当日该小程序日活用户数人均打开次数:当日该小程序总访问人次/当日该小程序日活用户数,如果一个用户访问了同一小程序2次,访问人次为2人均浏览页面数:当日该小程序访问页面总次数/当日该小程序日活用户数,如果一个用户访问了同一页面2次,访问页面次数为2分享次数:当日使用分享功能将该小程序分享到微头条&端外的总次数新用户次留:当日新增且1天后回访的用户数/当日新增用户数7日留存:当日活跃且7天后回访用户数/当日活跃用户数30留存:当日活跃且30天后回访用户数/当日活跃用户数实时用户数:统计每天精确到小时的活跃用户数(UV)实时访问次数:统计每天精确到小时的访问人次(PV)实时新增用户数:统计每天精确到小时的新增用户数实时总用户数:统计每天精确到小时的历史总用户数量
名词解释用户:使用小程序的用户,每个用户拥有唯一设备id停留:打开小程序,到主动退出或切换后台之间的状态 -
常见问题Q&A
2019-03-13 12:56:06
基本情况Q:头条小程序优势在哪里?A:头条小程序更擅长做的是基于今日头条的算法将相关内容分发到更精确的目标用户。Q:头条小程序的入口有哪些?A:目前有八大入口能够在更多合适场景为目标用户提供精准分发,详情请见场景文档。Q:头条小程序,可以引导关注头条号么?A:暂时没有开放给第三方开发者的规划。Q:小程序主要是通过什么方式进行展现?A:目前阶段主要是通过内容分发,通过图文插入小程序,以及小视频中插入小程序等方式。Q:文章挂载小程序,是否有自动挂载的考虑?A:自动挂载可以做到,AILAB匹配文章卡片。Q:信息流会直接推荐小程序吗?A:信息流目前可以投cpc、ocpc。Q:商业化投放小程序支持OCPM吗A:以后会支持。Q:搜索词如何配置?A:搜索词可在开发者后台进行配置,共5个搜索词,每周可修改5次,审核通过后即生效。
支付问题Q:通过小程序支付的交易流程是什么样的?A:直接调起支付宝APP,通过头条的API进行支付没有手续费,钱直接打到商家。开发者后台上有开发上传接口和界面。Q:支付宝里面的参数填什么?A:https://docs.open.alipay.com/204/105465/参考这里的定义,params没有关系。Q:支付回调地址支持https吗?A:支持。Q:小程序requestPayment接口中sign字段需要对什么范围的字段进行签名?A:sign是(在头条小程序中开通支付功能的商户)使用分配的秘钥对参数加签获得的签名,参与签名的参数请参考http://developer.toutiao.com/docs/open/requestPayment.html,sign主要目的是确认调用方的合法性。Q:小程序怎么接入支付宝支付?A:首先确保业务本身已经接入了支付宝app并已跑通,然后才能接入头条小程序。接入支付宝流程详情见支付宝的接入文档,https://docs.open.alipay.com/204/105465/。Q:目前支持虚拟支付吗?A:安卓可正常支付,ios暂不支持支付。Q:支付接口trade_no订单号是开发中自己的订单号,还是支付宝的订单号?A:头条的单号,是预下单时候返回的。Q:关于密钥申请,这个密钥是指支付宝的还是头条的?如果已经有支付宝收款账户,需要使用现有的账户收款的话。A:两个都需要。财经的秘钥是用来发起头条的请求,只涉及信息交互,是两个接口,最终的资金流,都是支付宝的。就是说需要分别向头条、支付宝申请两个密钥。Q:接入支付宝的商户实际上是头条还是小程序开发者呢?A:小程序开发者。Q:头条是否会保存支付宝订单信息A:不会。Q:用户付款之后,资金的流向是直接打到开发者的帐上,还是先打给头条,头条再打回给开发者?A:直接打给开发者。Q:微信用户和头条用户,两边账号怎么贯穿打通?如果有人在一边下单,在另一边的订单记录却看不到会造成困扰。A:无法打通,头条和微信的用户都对应不上。Q:通过头条的API进行支付有没有手续费之类的?A:目前没有,因为钱不过头条,是直接打给商家账户的。功能方面:Q:小程序允许跳到外链么?比如跳去淘宝、京东、头条小店。A:小程序目前没有跳出小程序的能力。Q:有计划做给app引流的功能吗?A:暂时未提供。Q:小程序与小程序之间可不可跳转?A:暂时不支持。Q:目前配备了客服功能吗,有打开客服会话组件吗?A:还在排期开发中。Q:目前不支持客服的话,可以留个客服的微信号,引导打客服电话吗?A:留微信号需要评估,目前无法给出结论。Q:想问下用户授权后我们具体能拿到用户的那些信息?用户的手机号会能获取到吗,还是需要额外的授权获取?A:手机号目前无法获取,需要额外授权获取。Q:如果用户在头条这边下单,那么后面的订单状态变更,好友互动提醒,有没有什么机制通知到用户呢?A:规划中有发push的功能,还在排期开发中。Q:现在支持分包加载了嘛?A:暂时不支持,后续会支持的。Q:内置地图采用的是什么?A:高德地图。Q:小程序有没有属性值区别数据来自头条、抖音及其他来源?A:有的。Q:UI上有什么要求吗?A:符合用户规范的优秀设计即可。详情请见UI文档。Q:怎么获取指定页面的链接?A:提供路径和参数即可实现。Q:哪些系统版本上可以运行头条小程序?A:安卓5.0及以上,ios9.0及以上。Q:支持直播功能吗?头条端的小程序有直播资质的强要求吗?A:暂不支持,资质要求见《信息网络传播视听节目许可证》或《网络文化经营许可证》。Q:如何下载今日头条ios内测版?A:使用testflight并提供appleid,添加内测名单后,会将邀请码发送到对应邮箱。Q:营业执照上的注册地址跟目前的经营地址一致,无法通过审核怎么办?A:加一个盖章的说明函即可。Q:小程序对嵌套h5的支持嘛?A:主流程用原生做,某些页面用H5是合理的,可接受,只是不要一整块业务全用H5就好。Q:微信小程序已经开发好了,有没有什么快速的方法转成头条小程序呢?A:暂不支持一键转换工具。Q:请问下,现在有办法识别头条用户了么?有用有唯一标示了么?A:头条就是用的openid这个,和微信基本一致。Q:目前看起来还是很初级,目前跟微信自己的小程序一样,不支持npm包组件化等。是否会兼容市场上的wepy/taro/mpvue等适合复杂框架的小程序?A:目前是不支持wepy,mpvue等框架,需要开发者主动把利用wepy框架开发的代码,编译为小程序的语法,然后才能在头条上正常的渲染。
开放平台问题Q:小程序和轻服务是啥区别?A:轻服务是另外一个事情,和小功能关系不大。Q:企业版小程序和个人版小程序有什么不同?A:企业版小程序支持支付功能,而个人版小程序不支持;webview等域名只有企业版小程序能够配置。Q:上线后如何进行分享配置A:在开发者后台可以配置分享图片以及分享文案。Q:分享文案可以改变吗?所有页面都必须是同一文案吗?A:不同页面的不同分享配置可在代码里进行配置。Q:怎么能获取小程序上线之后的数据?A:开发者后台可以看到。Q:如何添加管理员?A:通过添加管理员在开发者后台注册的用户名即可添加,非头条账号。Q:管理员后期可变更吗?A:后续会优化流程,目前阶段可通过增加新管理员实现。Q:头条号如何匹配小程序?A:在mp后台申请匹配小程序,小程序开发者后台确认,审核通过后即可完成。Q:为什么注册用户的时候显示系统错误,请更换开发者ID重试?A:可能是因为设置的用户名中了敏感词机制。Q:webview的域名校验文件,下载以后是上传到被校验域名的根目录下吗?A:是的。Q:新建小程序的名称的简介和图标,后期还能不能改?图标大小有要求吗?A:后期可修改,平台有修改的入口。icon传144*144的。
开发者工具问题Q:ide上扫描二维码部分,显示压缩文件出错是什么原因?A:暂时不支持代码超过4M。Q:ide上的二维码为什么会显示获取编译状态失败?A:没有权限,需在开发者后台添加权限。Q:报错401,点击预览的时候,编译器会出现上传预览失败,生成不了二维码A:code为401是没有权限,主要是IDE的登陆这个得是用他们主管的手机号登陆,可以先切换账号=用主管手机号登陆=在打开的对应工程的project.config.json中输入主管手机号对应的appid如果工程appid是touristappid,也会出现permission是404那个问题,这个appid会读取project.config.json中的appid,需要手动修改。Q:ide上有编辑器功能吗?A:1.1.9版本及后续版本均已支持。Q:开发者工具在页面跳转时直接销毁了上一个页面,符合预期嘛?A:目前IDE上是单webview的,加载新的页面就回销毁上一个页面。Q:ide上有个小问题,通过底部的tabBar切换,每次都会走onLoad嘛?A:是的ide这里的实现和真机不一样。Q:开发工具里能直接切换其他文件吗?A:后续会支持直接打开项目的功能。Q:编译的时候为什么总是暂停?A:去掉断点就好了。
组件问题Q:支持自定义组件吗?A:目前除了relation,基本特性都已经支持了,文档已更新。Q:视频组件支持了吗?A:video组件是有的,但只有最基础的UI控制能力,createVideoContext这个API目前还没有支持。Q:视频组件vidoe看文档上写的只有autoplay一个属性,而我们需要至少有用户点击播放和播放完毕的回调函数。A:视频目前只能自动播放,其他功能后续排期实现。Q:微信小程序的wxs组件,头条支持吗?A:不支持的,短期之内无支持计划。Q:为什么无法获取定位信息?A:目前头条小程序不支持地图组件,只支持openLocation和getLocation。Q:头条小程序有webview组件与原生组件的划分吗?A:有,原生组件包括video/input/textarea/webview/picker,其余组件微web组件。Q:image中可以嵌套text组件吗?A:不可以。Q:picker组件什么时候会支持mode=region?A:已经支持了。Q:小程序有支持block循环嵌套渲染的计划吗?一些页面渲染受限。A:可以使用多个blockwx:for={{}}来嵌套,但这种情况还是推荐使用view来代替block。Q:能否通过判断userAgent是否包含“ToutiaoMicroApp”来识别当前是否处于头条小程序的webview中?A:可以。Q:tabbar不支持,那么只能自己页面自定义了?A:tabbar支持,可以设置图片和文案,只是不支持自定义。Q:转换后端返回数据转换html时rich-text组件用不了,所以处理起来有点很费功夫。A:wxparser已支持。Q:nestedtextcomponent不支持吗?A:text里套text是支持的,不支持套其他的。
API问题Q:有获取xml节点信息相关的API嘛?A:正在做。Q:如何将画布导出图片?A:可以使用tt.canvastotempfilepath。Q:drawImageimage参数必须为本地资源吗?A:这个支持网络图片,但目前不支持网络图片绘制后,canvas的导出。Q:目前项目里面会有查询节点信息的一些需求,小程序有支持createSelectorQuery()查询WXML节点信息的计划吗?A:暂不支持。
测试问题Q:内测阶段小程序的提审流程的大概流程是什么样的?A:请在开发者后台进行提审,审核版本经由审核同学审核通过后发布线上版本,qa负责进行一到两轮测试确定功能无误后,提交LR测试,之后即可上线。Q:为什么提审的时候,扫码进入小程序是没问题的,发布线上版本之后发现白屏无内容了?A:线上版本的小程序会进行域名校验,麻烦在开发者后台进行域名配置。Q:头条小程序怎么在手机端预览?A:通过其他扫码工具,通过Chrome浏览器打开小程序。Q:ios预览,有vconsole嘛?A:有的。Q:已经提交审核,大概多长时间会有反馈?A:内测阶段仍是人工测试,大概2-3天会给反馈。 -
tt.getUpdateManager
2019-03-13 11:29:04
UpdateManagertt.getUpdateManager()获取全局唯一的版本更新管理器,用于管理小程序更新
输出
UpdateManager更新管理对象 -
tt.hideToast
2019-03-13 11:29:04
tt.hideToast(Objectobject)隐藏消息提示框
输入继承标准对象输入 -
tt.hideKeyboard
2019-03-13 11:29:04
tt.hideKeyboard(Objectobject)隐藏键盘
输入继承标准对象输入 -
tt.hideLoading
2019-03-13 11:29:04
tt.hideLoading(Objectobject)隐藏loading提示框
输入继承标准对象输入