Videocírculo

O "Videocírculo" é um Widget flutuante redondo com um vídeo no canto inferior do seu site. Primeiro, o visitante vê um pôster ou uma prévia silenciosa sem som; ao clicar, abre-se uma janela com o vídeo com som, legenda e botão de ação: "Pedir", "Reservar uma Mesa", "Agendar", "Perguntar no chat" e outros.

A principal diferença em relação aos videowidgets comuns é que o vídeo aqui não é um arquivo separado. É o vídeo de um Item do seu menu ou catálogo, que já está no card dele: enviado por você ou gerado por IA a partir da foto do prato. O Widget não tem um segundo armazenamento de vídeos, e o botão "Pedir" abre no widget de Pedido exatamente o prato que o visitante acabou de ver.

O Widget é gratuito: não é preciso comprar uma extensão separada.

Onde ativar: Painel de administração → Marketing → "Meu site" → card "Videocírculo". O interruptor ativa o Widget, a engrenagem abre as configurações.

Instalação no site#

Não é necessário código próprio — funciona a tag comum da seção "Meu site":

<script src="https://cdn.cenaly.com/site/v1.js" data-domain="SEU-DOMÍNIO" async></script>

Uma linha no <head> ou antes de </body>; depois, a composição dos Widgets é definida por interruptores na Conta. Instruções por plataforma (HTML, Google Tag Manager, WordPress, Tilda/Wix, Shopify, Webflow) — no artigo Meu site, seção "Instalação nas plataformas populares".

A tag individual do círculo está no bloco "Avançado":

<script src="https://cdn.cenaly.com/video-widget/v1.js" data-domain="SEU-DOMÍNIO" async></script>

Seus atributos:

⚠️ O atributo na tag tem prioridade sobre a configuração na Conta — nos outros Widgets é o contrário. O círculo muitas vezes é colocado em uma página onde o canto já está ocupado por outro código, e quem deve movê-lo é quem edita essa página, sem entrar no painel de administração.

O que a verificação de instalação vê e o que não vê. O botão "Verificar instalação" lê o HTML de origem da página: ele encontra o carregador comum ou a tag individual do círculo, o código de outra Unidade ou a ausência dele. A tag que o Google Tag Manager insere já no navegador ela não vê — confira o site com os próprios olhos.

De onde vêm os vídeos#

O vídeo do círculo é o vídeo de um Item do menu ou catálogo. Não existe um envio separado de "vídeo para o Widget", e isso é intencional: o mesmo vídeo funciona no card do prato na Vitrine e no círculo no site.

Para que um Item tenha vídeo:

1. Abra o Item na seção "Menu" (ou no catálogo de produtos) e envie o vídeo na mídia dele.
2. Ou gere um vídeo por IA a partir da foto do prato direto no card. A geração é uma função do card do prato com suas próprias condições; o círculo não paga por ela. ⚠️ Nas marcas na Nuvem Yandex (cenaly.ru) não há geração de vídeo — lá o vídeo é enviado pronto.
3. Aguarde o processamento do vídeo: a plataforma cria o pôster e, onde isso está configurado, opções de qualidade de 360p a 1080p.

Se nenhum Item tiver vídeo, o painel do círculo dirá isso e sugerirá ir ao menu — não haverá prévia inventada sem vídeo.

⚠️ O formato do arquivo importa. Os navegadores reproduzem com segurança mp4, webm e m4v. Um vídeo em outro formato (por exemplo, .mov de iPhone, .avi, .mkv) o círculo só mostrará se houver opções de qualidade prontas para ele; caso contrário, ele não entra no círculo de forma alguma — um círculo que abre em "vídeo indisponível" é pior do que a ausência dele.

Configuração do Widget#

As configurações são salvas automaticamente. Ao lado dos campos há uma prévia: o círculo com o pôster do primeiro vídeo selecionado e a janela expandida com a legenda e o botão, com as mesmas palavras que o visitante verá.

Vídeos#

• Seleção — lista de itens da Unidade selecionada que têm vídeo. Marque até 6 vídeos e ordene-os: nessa ordem o visitante navega por eles com as setas.
• Legenda — texto curto do vídeo (até 80 caracteres) nos idiomas desejados: abaixo do círculo e na janela expandida.
• Botão de ação — o que fazer após assistir (veja a tabela abaixo). Por padrão — «Fazer pedido» com esse mesmo prato.
• Texto do botão — personalizado, até 40 caracteres em cada idioma; vazio — texto padrão conforme o tipo de ação.

Nas configurações do círculo fica armazenado o link do vídeo do item e os dados do vídeo no momento da seleção (formato, opções de qualidade prontas, pôster, duração), e não uma cópia do arquivo.

Botão abaixo do vídeo#

⚠️ O botão funciona por meio do widget vizinho. Se o widget para o qual ele leva estiver desativado na sua conta (ou for uma extensão paga sem Assinatura), o botão no site não aparecerá — o visitante apenas assistirá ao vídeo. O painel sinaliza essas ações com antecedência, e nas estatísticas do círculo isso aparece como um motivo separado.

Os textos padrão dos botões e os textos internos do círculo vêm incorporados em quatro idiomas — inglês, russo, georgiano e turco; nos demais idiomas da página eles ficam em inglês. Você define seus próprios textos em qualquer idioma.

Aparência#

«Não mostrar após fechar» — por quantos dias o círculo fica em silêncio depois que o visitante o fecha no X. 0 — apenas até o fim da visita (sessão do navegador).

Quando mostrar#

O bloco é compartilhado com o multibutton, a ligação de retorno e a «Vitrine ao vivo»: máscaras de página «somente em…» e «exceto…» (até 20 em cada lista, * = qualquer trecho, as exceções têm prioridade), atraso de até 600 segundos, dispositivo (todos · computadores · celulares), programação — até 14 janelas próprias ou o horário de funcionamento da Unidade.

⚠️ Os horários são contados no fuso horário da localização; se o fuso não estiver definido, as janelas são contadas pelo horário do visitante.

Quando o círculo reproduz o vídeo sozinho#

Esta é a regra principal do widget — o contrato de velocidade: enquanto o círculo não decidir mostrar a prévia, na página não há nenhum elemento de vídeo com link para o vídeo nem nenhuma requisição ao arquivo dele. O visitante baixa o pôster, não o vídeo.

A prévia sem som (sem áudio, em loop) só é iniciada quando todas as condições forem atendidas:

1. a prévia não está desativada nas configurações;
2. a página já carregou — o vídeo não toma a banda do seu conteúdo;
3. o círculo está na parte visível da tela;
4. o visitante não tem «reduzir movimento» ativado (prefers-reduced-motion);
5. o visitante não tem economia de dados ativada (Save-Data).

Caso contrário, no círculo aparece o pôster do vídeo. Se não houver pôster (a plataforma ainda não o gerou ou o processamento de vídeo não está configurado), o círculo mostra o primeiro quadro: isso custa mais que o pôster, por isso só nas condições 1, 2 e 5. Se a prévia estiver desativada e não houver pôster — um círculo escuro com borda e ▶.

Qualidade conforme a tela. Se houver opções de 360p a 1080p prontas para o vídeo, o widget escolhe a adequada: no círculo — a leve, na janela expandida — conforme a largura dela. Se não houver opções — o arquivo original é reproduzido.

Som — somente após o toque do visitante. Os navegadores não permitem ativar o som sem um gesto, e nós não contornamos isso.

Peso do widget — cerca de 20 KB em gzip (tag com async). Os arquivos dos vídeos não entram nesse peso.

O que o visitante vê e o que é coletado nesse momento#

O visitante vê o círculo no canto escolhido — com pôster ou prévia sem som, a duração do vídeo e uma legenda abaixo dele. Ao clicar (ou pressionar Enter / espaço no teclado), abre-se uma janela:

• o vídeo com som e um botão "desativar som";
• setas ‹ › entre os vídeos, se houver mais de um;
• a legenda e o botão de ação;
• fechar — pelo X, pela tecla Esc ou clicando fora da janela; o foco volta para o círculo.

Ao clicar no botão de ação, a janela do círculo se fecha e abre-se o widget vizinho — duas janelas sobrepostas na página de terceiros seriam um beco sem saída. Um pequeno X no próprio círculo o remove por um número definido de dias.

Se no mesmo canto já houver nosso botão (multibotão, retorno de chamada, pedido, reserva, agendamento, chat), o círculo sobe acima dele, e os selos da «Vitrine ao vivo» — acima do círculo. O multibotão não engole o círculo: ele não é um canal de comunicação.

O widget não coleta dados pessoais. Ele não tem formulários nem campos. Pedido, reserva ou agendamento feitos pelo botão chegam às mesmas seções que os feitos pelos próprios widgets — por exemplo, em «Pedidos». O próprio círculo envia apenas estatísticas anônimas: exibição, abertura, visualização com som por mais de 3 segundos, clique no botão por tipo de ação (pedido, reserva, chat…) e fechamento. Não há nomes, contatos nem números de vídeos nelas. O resumo fica visível no cartão do widget em «Meu site».

Limitações#

• O formato é um só — o círculo no canto inferior. Não há stories, carrossel nem player incorporado à página.
• O vídeo é apenas o vídeo de um item do menu ou do catálogo. Não é possível carregar "só um vídeo" separado do item.
• Links do YouTube e do TikTok não são suportados: o player de terceiros instala seus próprios cookies (isso vai contra o banner de consentimento) e é mais pesado do que o contrato de velocidade permite.
• Vídeo que não pode ser reproduzido não é exibido: um formato que o navegador não reproduz, sem versões de qualidade prontas, não entra no círculo. Um círculo sem nenhum vídeo reproduzível não aparece de forma alguma.
• Na nossa vitrine não há círculo — lá o vídeo do prato já está no cartão dele. O círculo funciona apenas no seu próprio site.
• Não há botão se não houver o widget dele: a ação leva ao widget vizinho, e sem ele o botão não é desenhado.
• No máximo 6 vídeos em um círculo.
• As legendas de interface são em quatro idiomas (en, ru, ka, tr), os demais idiomas — em inglês.
• Não há geração de vídeo por IA no cenaly.ru — lá os vídeos são apenas carregados.

Solução de problemas#

O círculo não aparece no site.

1. Tag não encontrada — "Verificar instalação". "Código ausente" — a tag não foi inserida ou não está em todas as páginas do template; "código de outra localização" — data-domain de terceiros. Se a tag for instalada pelo GTM, a verificação não a verá.
2. Widget desativado — o botão no cartão "Videocírculo".
3. Nenhum vídeo selecionado — sem vídeos, o círculo não é desenhado.
4. Nenhum vídeo pode ser reproduzido — todos os vídeos selecionados têm um formato que o navegador não reproduz, e não há versões de qualidade. Carregue um mp4 no cartão do item ou aguarde o processamento do vídeo.
5. O visitante fechou o círculo pelo X — ele fica silencioso pelo número definido de dias (por padrão, 7). Verifique em uma janela anônima ou em um novo perfil do navegador.
6. As condições de exibição excluíram a página — verifique as máscaras, o dispositivo, o atraso e o cronograma.
7. As alterações não chegaram — as configurações são distribuídas via CDN com cache de até 5 minutos: aguarde e atualize a página.

O círculo aparece, mas não há botão abaixo do vídeo. O widget para o qual o botão leva está desativado no site (ou não foi pago, se for uma extensão) — ative-o em «Meu site». Para a ação "Documento", é preciso um documento selecionado; para "Link", um endereço http(s)://.

O círculo não reproduz a prévia, apenas o pôster. É assim mesmo que funciona se a prévia estiver desativada, se a página ainda estiver carregando, se o círculo estiver fora da tela ou se o visitante tiver ativado "reduzir movimento" ou a economia de tráfego. Verifique em outro dispositivo.

A janela mostra "Vídeo indisponível". O arquivo do vídeo não foi carregado: o vídeo foi excluído ou substituído no cartão do item. Abra as configurações do círculo e selecione o vídeo novamente.

Substituí o vídeo no cartão, mas no círculo ainda está o antigo. O círculo armazena o link para um vídeo específico do item e seus dados no momento da seleção. Selecione o vídeo novamente — o mesmo vale se você o selecionou enquanto o vídeo ainda estava sendo processado.

"Pedir" abre o prato errado. O botão "Pedir" leva por padrão ao item cujo é o vídeo; se você alterou a ação manualmente, verifique o item selecionado nas configurações do botão.

Perguntas frequentes#

O círculo vai deixar o site mais lento?#

O widget pesa cerca de 20 KB em gzip e carrega com async. Os arquivos dos vídeos não são baixados enquanto o widget não decide mostrar a prévia — e a prévia só é iniciada após o carregamento da página e apenas na parte visível da tela.

Posso carregar um vídeo direto no widget?#

Não. O vídeo é o vídeo de um item do menu ou do catálogo: carregue-o no cartão do item ou gere-o a partir da foto do prato (exceto no cenaly.ru), e selecione-o no círculo.

O que acontece com os vídeos se eu desativar o círculo ou sair da plataforma?#

Com o widget, os vídeos não desaparecem: são arquivos dos seus itens de menu, e o círculo armazena apenas links para eles. Se você desativar o widget, os vídeos permanecem nos cartões dos pratos. O círculo não tem armazenamento próprio, não há nada a migrar dele.

Posso inserir vídeos do YouTube ou do TikTok?#

Não. O player de terceiros instala cookies e é mais pesado do que o contrato de velocidade do círculo permite.

O som é ativado automaticamente?#

Não. A prévia no círculo é sempre sem som, e o vídeo só é reproduzido com som após o clique do visitante.

Quantos vídeos posso exibir?#

Até seis em um círculo. O visitante navega entre eles com as setas; cada um tem sua própria legenda e seu próprio botão.

O círculo vai aparecer na vitrine Cenaly?#

Não. Na vitrine, o vídeo do prato já está no cartão dele, por isso o círculo funciona apenas no seu próprio site.

O que entra nas estatísticas?#

Exibições do círculo, aberturas, visualizações com som por mais de 3 segundos, cliques no botão por tipo de ação e fechamentos — sem dados pessoais e sem números de vídeos.

Seções relacionadas#

• Meu site — código de instalação e os demais Widgets
• Pedido online no seu próprio site — para onde leva o botão «Fazer pedido»
• Vitrine ao vivo — selos honestos com números de Pedidos ao lado do círculo
• Multibutton — todos os canais de contato em um só botão
• Cookies e Consentiu — por que não inserimos players de terceiros