字节跳动小程序 open 字节如意接入规范
2020-02-12 22:57 更新
小程序 open 字节如意根据搜索结果展示样式,给出了详细的规范说明以及具体的字段含义说明。开发者需要将必须字段填写完整,可选字段可根据站点情况来选择填写。
- 数据填写越完整,搜索侧越能得到更好的用户体验,从而获取更多自然搜索流量
- 该方式支持在头条 iOS 端搜索小程序
- 宿主支持:今日头条
- 仅小程序可进行配置,目前小游戏暂不支持。
一、卡片样式示例:
二、提交方式:
进入小程序开发者后台,流量页面—新增入口—小程序 opne 字节如意。
三、数据 XML 文件要求
- 数据 XML 文件的根节点必须为
。 - 数据 XML 文件编码必须为 UTF-8,第一行为:
- 数据 XML 文件禁止使用命名空间,禁止使用规定之外的属性。
- 数据 XML 单个文件大小不得超过 5M(必须满足),item 数目不得超过 5000 条。
- item 节点中
、 节点为必需节点。 - 除根节点之外的其它节点,标签名建议采用英文小写字母及下划线‘_’。
- 数据节点中包含转义字符,请使用 CDATA。
- 对于数组型的节点,请在只有一个子节点时保证和多个节点时的结构相同。
四、数据字段说明
注意:图片需要保证头条服务器可以访问到,如果不可访问,线上体验会很差。建议:将此服务*.snssdk.com 加白名单。
字段名称 | 必填 | 详细含义 | 规则 |
---|---|---|---|
key | 是 | 以随机数字+合作方名称命名,key 长度限制在 64 字符内,唯一不变。例:123456toutiao | 文字类型 |
display | 是 | 数据区域,不能修改或者删除字段,可增加字段,节点总大小上限 20KB,不建议超过 3KB | 数据区域 |
title | 是 | 网站名称 | 文字类型 |
tmaid | 是 | 字节跳动小程序平台分配的小程序 id,例:tta1e1b2xxx | 字符串 |
path | 否 | 标识 h5 跳转 url,例:http://toutiao.com | 字符串 |
lightappid_path | 是 | 字节跳动小程序平台分配的小程序 id,例:tta1eb2xxx | 字符串 |
lightapp_path | 是 | 小程序内部 PATH,PATH 开头省略/,例如:pages/xxx,而不是/pages/xxx | 字符串 |
slogan | 是 | 运用于官网样式 title 后缀,字数控制在 10 字符内,==短摘要(<20 字)可以不填写此字段,长摘要(>20 字)必选字段== | 文字类型 |
description | 是 | 摘要描述,摘要小于 20 字,前端展示弱卡样式,摘要在 20-40 字之间,前端展示强卡样式。 | 文字类型 |
logo | 是 | 网站 logo,用于前端展示 | 链接格式 |
square | 否 | 正方形 logo,像素是 153*153,==摘要小于 20 字提供正方形图,与 rectangle 二选一== | 链接格式 |
rectangle | 否 | 长方形 logo,像素是 327*216,==摘要大于 20 字提供长方形 logo,与 square 二选一== | 链接格式 |
funcs | 是 | 在头条搜索里,展现的功能 tab | 数组类型 |
五、XML 数据文件示例
<?xml version="1.0" encoding="utf-8"?>
<DOCUMENT version="1">
<!--根节点必须为⼤写DOCUMENT,标记整个xml⽂件的开始和结束-->
<item>
<!-- item: 一个item为一条数据,单文件最大允许5000条,且文件大小不应超过5M -->
<key>
<![CDATA[123456douguo]]>
</key>
<display type="object">
<!-- display:数据区域,不能修改或者删除字段,可增加字段,节点总大小上限20KB,不建议超过3KB,必须字段 -->
<title type="string">
<![CDATA[豆果美食]]>
</title>
<!-- title: 网站名称,字符串类型,必须字段 -->
<path type="string">
<![CDATA[http://toutiao.com]]>
</path>
<tmaid type="string">
<![CDATA[tta1e1b2c3d4a5]]>
</tmaid>
<!-- tmaid: 字节跳动小程序平台分配的小程序id,字符串类型,必须字段 -->
<lightappid_path type="string">
<![CDATA[tta1e1b2c3d4a5]]>
</lightappid_path>
<!-- lightappid_path: 字节跳动小程序平台分配的小程序id(内容与tmaid一样),字符串类型,必须字段 -->
<lightapp_path type="string">
<![CDATA[pages/xxx]]>
</lightapp_path>
<!-- lightapp_path: 小程序内部PATH,PATH开头省略/,例如:pages/xxx,而不是/pages/xxx,字符串类型,必须字段 -->
<slogan type="string">
<![CDATA[家常美食]]>
</slogan>
<!--slogn type:运用于官网大功能样式title后缀,字数控制在10字符内,短摘要可以不填写此字段,长摘要必选字段 -->
<description type="string">
<![CDATA[豆果美食,开启美好生活]]>
</description>
<!-- description: 小程序简介,官网小功能字数不超过20字,官网大功能字数应控制在20-40字内,字符串类型,必须字段 -->
<logo type="object">
<!-- logo: 官网logo,如果是选择正方形logo选择square type,长方形logo选择rectangle type,必须字段 -->
<square type="object">
<!-- square: 正方形的官网logo,可选字段 -->
<url type="string">
<![CDATA[https://image.xiaohongshu.com/wise/toutiao/light_app/logo/img/square.jpg]]>
</url>
<!-- url: icon对应的图片链接,字符串类型,长度不超过1024个字符,可选类型 -->
<height type="integer">
<![CDATA[153]]>
</height>
<!-- height: icon对应的图片高度,数字类型,可选类型 -->
<width type="integer">
<![CDATA[153]]>
</width>
<!-- width: icon对应的图片宽度,数字类型,可选类型 -->
</square>
<rectangle type="object">
<!-- rectangle: 长方形的官网logo,可选字段 -->
<url type="string">
<![CDATA[https://image.xiaohongshu.com/wise/toutiao/light_app/logo/img/square.jpg]]>
</url>
<!-- url: icon对应的图片链接,字符串类型,长度不超过1024个字符,可选类型 -->
<height type="integer">
<![CDATA[216]]>
</height>
<!-- height: icon对应的图片高度,数字类型,可选类型 -->
<width type="integer">
<![CDATA[327]]>
</width>
<!-- width: icon对应的图片宽度,数字类型,可选类型 -->
</rectangle>
</logo>
<funcs type="array">
<!-- funcs: 在头条搜索里,展现的功能tab,必选字段,最多出现1次 -->
<value type="object">
<!-- value: tab详细信息,对象类型,可出现1到多次 -->
<name type="string">
<![CDATA[功能列表1]]>
</name>
<!-- name: icon上的文字,字符串类型,长度不超过4个字符,必选类型 -->
<lightapp_link_path type="string">
<![CDATA[pages/xxx]]>
</lightapp_link_path>
<!-- lightapp_link_path: 小程序内部PATH,PATH开头省略/,例如:pages/xxx,而不是/pages/xxx,字符串类型,必须字段 -->
<lightappid_link_path type="string">
<![CDATA[tta1e1b2c3d4a5]]>
</lightappid_link_path>
<!-- lightappid_link_path: 字节跳动小程序平台分配的小程序id,字符串类型,必须字段 -->
<path type="string">
<![CDATA[http://toutiao.com/funcs1]]>
</path>
</value>
<value type="object">
<!-- value: tab详细信息,对象类型,可以出现1到多次 -->
<name type="string">
<![CDATA[功能列表2]]>
</name>
<!-- name: icon上的文字,字符串类型,长度不超过4个字符,必选类型 -->
<lightapp_link_path type="string">
<![CDATA[pages/xxx]]>
</lightapp_link_path>
<!-- lightapp_link_path: 小程序内部PATH,PATH开头省略/,例如:pages/xxx,而不是/pages/xxx,字符串类型,必须字段 -->
<lightappid_link_path type="string">
<![CDATA[tta1e1b2c3d4a5]]>
</lightappid_link_path>
<!-- lightappid_link_path: 字节跳动小程序平台分配的小程序id,字符串类型,必须字段 -->
<path type="string">
<![CDATA[http://toutiao.com/funcs2]]>
</path>
</value>
</funcs>
</display>
</item>
</DOCUMENT>
以上内容是否对您有帮助:
更多建议: