视频圆窗

“视频圆窗”是网站右下角或左下角的圆形浮动小部件，内含一段视频。访客首先看到海报或无声静音预览；点击后打开一个窗口，播放带声音的视频，并显示说明文字和行动按钮：“下单”、“预订桌子”、“预约”、“在聊天中提问”等。

与常见视频小部件的主要区别在于——这里的视频不是独立文件。它是菜单或目录中某个项目的视频，已经存在于该项目的卡片中：由您上传，或由 AI 根据菜品照片生成。小部件没有第二个视频存储库，而“下单”按钮会在下单小部件中打开访客刚刚观看的那道菜。

该小部件免费：无需购买单独的扩展。

在哪里启用：管理后台 → 营销 → “我的网站” → “视频圆窗”卡片。开关启用小部件，齿轮打开设置。

安装到网站#

无需自己的代码——使用“我的网站”部分的通用标签即可：

<script src="https://cdn.cenaly.com/site/v1.js" data-domain="ВАШ-ДОМЕН" async></script>

在 <head> 中或 </body> 前添加一行，之后小部件的组成由账户中的开关决定。各平台（HTML、Google Tag Manager、WordPress、Tilda/Wix、Shopify、Webflow）的说明见文章我的网站的“在热门平台上安装”部分。

圆窗的单独标签位于“高级”区块：

<script src="https://cdn.cenaly.com/video-widget/v1.js" data-domain="ВАШ-ДОМЕН" async></script>

其属性：

属性	作用
`data-domain`	您在“我的网站”中的域名——必填
`data-brand`	平台品牌，如果标签不在其域名上
`data-lang`	服务性文字的语言；未指定时使用页面语言（`<html lang>`），然后是浏览器语言
`data-position`	角落：`bl`——左下，`br`——右下
`data-color`	边框和按钮颜色，`#rrggbb`
`data-size`	圆窗直径（像素），从 64 到 160

⚠️ 标签上的属性优先于账户中的设置——其他小部件则相反。圆窗常被放在角落已被其他代码占用的页面上，调整它应由编辑该页面的人完成，而无需进入管理后台。

安装检查能看到什么、看不到什么。“检查安装”按钮读取页面的原始 HTML：它会找到通用加载器或圆窗的单独标签、其他位置的代码或缺失情况。由 Google Tag Manager 在浏览器中插入的标签，它看不到——请用眼睛查看网站。

视频从哪里来#

圆窗的视频是菜单或目录中某个项目的视频。没有单独的“为小部件上传视频”功能，这是有意为之：同一个视频既用于店面中的菜品卡片，也用于网站上的圆窗。

要让某个项目拥有视频：

在**“菜单”**部分（或商品目录中）打开该项目，将视频上传到其媒体中。
或者直接在卡片中用 AI 根据菜品照片生成视频。生成是菜品卡片的功能，有其自身条件；圆窗不为其付费。⚠️ 在 Yandex 云端品牌（cenaly.ru）上没有视频生成——那里需上传现成视频。
等待视频处理完成：平台会生成海报，并在已配置的情况下生成从 360p 到 1080p 的画质选项。

如果没有任何项目有视频，圆窗面板会如实说明并建议前往菜单——不会出现没有视频的虚构预览。

⚠️ 文件格式很重要。浏览器能稳定播放 mp4、webm 和 m4v。其他格式的视频（例如 iPhone 的 .mov、.avi、.mkv）只有在已为其准备好画质选项时，圆窗才会显示；否则它根本不会进入圆窗——打开后显示“视频不可用”的圆窗，比没有更糟。

小部件设置#

设置会自动保存。字段旁边是预览：带第一个所选视频海报的圆圈，以及展开的窗口，包含文字说明和按钮，用词与访客所见一致。

视频#

选择 — 所选门店中带视频的项目列表。勾选最多 6 个视频并排列顺序：访客将按此顺序用箭头浏览。
文字说明 — 视频的简短文字（最多 80 个字符），使用所需语言：显示在圆圈下方和展开窗口中。
操作按钮 — 观看后执行的操作（见下表）。默认为「下单」，并带上该菜品。
按钮文字 — 自定义，每种语言最多 40 个字符；留空则使用按操作类型对应的标准文字。

圆圈设置中保存的是项目视频的链接以及选择时的视频数据（格式、已生成的质量选项、海报、时长），而非文件副本。

视频下方的按钮#

操作	会发生什么	默认文字
下单	打开下单小部件 — 直接定位到该菜品	「下单」
预订桌子	打开桌子预订表单	「预订桌子」
预约	打开在线预约，可直接选择所需服务	「预约」
聊天	打开聊天	「在聊天中提问」
回电	打开回电表单	「申请回电」
多按钮	展开带联系渠道的多按钮	「联系我们」
帮助	打开支持中心	「帮助」
文档	打开所选的法律文档 — 文档为必填项	「打开文档」
支持	打开聊天的「咨询」标签页 — 新咨询表单	「联系支持」
链接	在新标签页中打开您的地址 `http(s)://…`	「了解更多」

⚠️ 按钮通过相邻小部件工作。 如果按钮所指向的小部件已关闭（或是未订阅的付费扩展），网站上不会显示按钮 — 访客只会观看视频。面板会提前标记此类操作，圆圈统计中也会以单独原因显示。

按钮的标准文字和圆圈的服务性文字内置四种语言 — 英语、俄语、格鲁吉亚语和土耳其语；页面使用其他语言时显示英语。自定义文字可设置为任意语言。

外观#

设置	值	默认
角落	左下 · 右下	左下（右下通常已有其他按钮）
大小	直径 64…160 px	96 px
颜色	圆圈边框和操作按钮	蓝色
静音预览	开启 · 关闭	开启
关闭后不再显示	0…90 天	7 天

「关闭后不再显示」— 访客点击叉号关闭后，圆圈保持静默的天数。0 — 仅到本次访问结束（浏览器会话）。

何时显示#

该区块与多按钮、回电和「实时店面」共用：页面掩码「仅在…」和「除…之外」（每个列表最多 20 条，* = 任意片段，排除优先），延迟最多 600 秒，设备（全部 · 电脑 · 手机），时间表 — 最多 14 个自定义时段或门店营业时间。

⚠️ 时间按位置所在时区计算；未设置时区时，时段按访客时间计算。

圆圈何时自动播放视频#

这是小部件的核心规则 — 速度契约：在圆圈决定显示预览之前，页面上没有任何带视频链接的视频元素，也没有对其文件的任何请求。访客下载的是海报，而非视频。

静音预览（无声音，循环播放）仅在满足所有条件时启动：

预览未在设置中关闭；
页面已加载完成 — 视频不会抢占您内容的带宽；
圆圈位于屏幕可见区域；
访客未开启「减少动态效果」（prefers-reduced-motion）；
访客未开启流量节省（Save-Data）。

否则圆圈中显示视频海报。没有海报（平台尚未生成或未配置视频处理）— 圆圈显示第一帧：这比海报开销更大，因此仅在条件 1、2 和 5 下使用。预览已关闭且没有海报 — 显示带边框和 ▶ 的深色圆圈。

按屏幕适配质量。 如果视频有 360p 到 1080p 的可用选项，小部件会选取合适的：圆圈中用轻量版，展开窗口中按窗口宽度选择。没有可用选项 — 播放原始文件。

声音仅在访客点击后播放。 浏览器不允许无手势播放声音，我们也不会绕过此限制。

小部件体积 — 约 20 KB（gzip 压缩，带 async 的标签）。视频文件不计入此体积。

访客看到什么以及会收集哪些数据#

访客会在选定的角落看到圆形视频入口——带有封面图或静音预览、视频时长以及下方说明文字。点击（或使用键盘 Enter / 空格键）后会打开窗口：

带声音的视频以及“关闭声音”按钮；
多个视频之间的 ‹ › 箭头；
说明文字和操作按钮；
关闭方式——点击叉号、按 Esc 键或点击窗口外区域；焦点会返回圆形入口。

点击操作按钮后，圆形入口窗口会关闭，并打开相邻的小部件——在他人页面上同时出现两个窗口会让人无从下手。圆形入口上的小叉号会将其隐藏指定的天数。

如果同一角落已经有我们的按钮（多功能按钮、回拨、订单、预订、预约、聊天），圆形入口会浮在它上方，而“在线店面”的标签则浮在圆形入口上方。多功能按钮不会被圆形入口吞并：它不是沟通渠道。

小部件不收集个人数据。它没有表单和字段。通过按钮完成的订单、预订或预约会进入与各小部件相同的板块，例如“订单”。圆形入口本身只发送匿名统计数据：展示、展开、有声观看超过 3 秒、按操作类型（订单、预订、聊天……）统计的按钮点击以及关闭。其中没有姓名、联系方式或视频编号。汇总数据可在“我的网站”的小部件卡片上查看。

限制#

**只有一种形式——角落里的圆形入口。**没有快拍（stories）、轮播图和嵌入页面的播放器。
**视频只能是菜单或目录项目的视频。**无法脱离卡片单独上传“一个视频”。
不支持 YouTube 和 TikTok 链接：外部播放器会设置自己的 cookies（这违反同意横幅），而且比速度契约允许的更重。
无法播放的视频不会展示：浏览器无法播放的格式、且没有现成画质版本的视频不会进入圆形入口。没有任何可播放视频的圆形入口根本不会出现。
我们的店面没有圆形入口——那里的菜品视频本来就放在其卡片中。圆形入口只在您自己的网站上运行。
没有对应小部件就没有按钮：操作会跳转到相邻小部件，没有它按钮就不会绘制。
一个圆形入口最多 6 个视频。
界面文案支持四种语言（en、ru、ka、tr），其他语言使用英语。
cenaly.ru 上没有 AI 生成视频——那里的视频只能上传。

故障排除#

网站上没有圆形入口。

未找到代码——点击“检查安装”。“没有代码”——代码未插入或未放在模板的所有页面上；“代码属于其他位置”——data-domain 不匹配。通过 GTM 安装的代码，检查工具看不到。
小部件已关闭——“圆形视频”卡片上的开关。
未选择任何视频——没有视频就不会绘制圆形入口。
没有任何视频可播放——所有选中的视频都是浏览器无法播放的格式，且没有画质版本。请在项目卡片中上传 mp4，或等待视频处理完成。
访客用叉号关闭了圆形入口——它会在指定天数内保持静默（默认 7 天）。请在无痕窗口或新的浏览器配置文件中检查。
展示条件排除了该页面——请检查掩码、设备、延迟和排期。
更改尚未生效——设置通过 CDN 分发，缓存最长 5 分钟：请稍等后刷新页面。

**圆形入口存在，但视频下方没有按钮。**按钮指向的小部件在网站上已关闭（如果是扩展功能，则未付费）——请在“我的网站”中启用它。“文档”操作需要选择文档，“链接”操作需要 http(s):// 地址。

**圆形入口不播放预览，只显示封面图。**如果预览已关闭、页面仍在加载、圆形入口不在屏幕内，或访客开启了“减少动态效果”或流量节省模式，这是预期行为。请在其他设备上检查。

**窗口中显示“视频不可用”。**视频文件未加载：视频已在项目卡片中被删除或替换。请打开圆形入口设置并重新选择视频。

**在卡片中替换了视频，但圆形入口中仍是旧的。**圆形入口存储的是指向具体项目视频的链接及其在选择时的数据。请重新选择视频——如果是在视频仍在处理时选择的，也同样需要重新选择。

“订购”打开的不是那道菜。“订购”按钮默认指向该视频所属的项目；如果您手动更改了操作，请检查按钮设置中选择的项目。

常见问题#

圆形入口会拖慢网站吗？#

小部件 gzip 后约 20 KB，并以 async 加载。在圆形入口决定展示预览之前，不会下载视频文件——而预览只在页面加载完成后、且仅在屏幕可见区域内启动。

可以直接把视频上传到小部件吗？#

不能。视频是菜单或目录项目的视频：请将其上传到项目卡片，或从菜品照片生成（cenaly.ru 除外），然后在圆形入口中选择。

如果我关闭圆形入口或离开平台，视频会怎样？#

视频不会随小部件消失：它们是您菜单项目的文件，圆形入口只存储指向它们的链接。关闭小部件后，视频仍保留在菜品卡片中。圆形入口没有单独的存储空间，没有需要迁移的内容。

可以插入 YouTube 或 TikTok 的视频吗？#

不能。外部播放器会设置 cookies，而且比圆形入口速度契约允许的更重。

声音会自动开启吗？#

不会。圆形入口中的预览始终静音，视频只有在访客点击后才会带声音播放。

最多可以展示多少个视频？#

一个圆形入口最多六个。访客用箭头翻阅；每个视频都有自己的说明文字和按钮。

圆形入口会出现在 Cenaly 店面吗？#

不会。店面中菜品视频本来就放在其卡片中，因此圆形入口只在您自己的网站上运行。

统计数据包含哪些内容？#

圆形入口的展示、展开、有声观看超过 3 秒、按操作类型统计的按钮点击以及关闭——不含个人数据，也不含视频编号。