Restrições de iframe
Devido a possíveis problemas de segurança inerentes à forma como os iframes funcionam, o Hotjar não pode rastrear as interações do usuário dentro dos iframes. No entanto, o Hotjar ainda pode exibir iframes, desde que o iframe não dependa de JavaScript para renderizar seu conteúdo. O Hotjar se refere à exibição de iframes dessa forma como "permitindo" iframes.
Neste artigo, explicaremos as configurações e os recursos relacionados a iframes e as limitações que persistem ao usar o Hotjar com páginas que contêm iframes.
- Qual é o comportamento padrão quando o Hotjar detecta um iframe?
- O que significa permitir iframes no Hotjar?
- Quais são as limitações existentes após a permissão de um iframe?
Qual é o comportamento padrão quando o Hotjar detecta um iframe?
Por padrão, os mapas de calor e as gravações bloquearão o conteúdo do iframe. Em vez do conteúdo do iframe, você verá uma mensagem informando que o Hotjar não pode rastrear iframes incorporados em sua página:
Se você não estiver familiarizado com iframes, pode pensar neles como páginas da Web dentro de outras páginas da Web. Eles geralmente são usados para adicionar ferramentas ou conteúdo de um site de terceiros, como chatbots, vídeos ou formulários. Você pode saber mais sobre iframes na documentaçãodo Mozilla Developer Network.
O que significa permitir iframes no Hotjar?
O Hotjar oferece a capacidade de permitir que iframes apareçam dentro de Heatmaps e Recordings. No entanto, isso não significa que o Hotjar possa rastrear as interações do usuário dentro dos iframes. Significa apenas que você pode carregar o conteúdo da página do iframe. Se JavaScript for necessário para que o conteúdo do iframe seja carregado, permitir o iframe não funcionará porque o Hotjar impedirá o carregamento do JavaScript.
Antes de permitir iframes em seu site Hotjar, analise a próxima seção deste artigo, que descreve as limitações que podem impedir a exibição de iframes no Hotjar.
Como permitir um iframe no Hotjar:
Adicione data-hj-allow-iframe como um atributo HTML ao seu iframe.
Você pode fazer isso adicionando um atributo HTML, data-hj-allow-iframe, ao iframe que deseja exibir.
Isso pode ser escrito como data-hj-allow-iframe="", data-hj-allow-iframe="true" ou apenas data-hj-allow-iframe. De qualquer forma, o valor será exibido como "true" no backend.
Esse atributo deve ser colocado no próprio elemento
Uma página de origem de iframe será recarregada sempre que for exibida no Hotjar
O URL para o qual o iframe aponta é armazenado em nossos servidores e recarregado toda vez que uma gravação é reproduzida. Isso significa que se o carregamento da página de origem do iframe acionar algum comportamento adicional, isso poderá causar resultados inesperados e adversos.
Acesse sua página Sites & Organizações.
Clique no ícone de engrenagem de configurações do site 
para acessar a página de configurações do site.
Expanda o menu Session targeting & tracking.
Digite o nome de domínio de nível superior que você deseja permitir, sob o título ALLOWED IFRAME DOMAINS (Domínios dos IFRAME PERMITIDOS).
Digite apenas o domínio de nível superior ao inserir nomes de domínio no campo ALLOWED IFRAME DOMAINS. O domínio de nível superior é o domínio sem www, http:// ou https:// conectado a ele. Por exemplo, se você quiser permitir https://www.hotjar.com/ nesse campo, o domínio de nível superior será hotjar.com
Clique em Save Changes (Salvar alterações)
Que limitações existem após a permissão de um iframe?
Antes de permitir um iframe, considere as limitações que persistirão mesmo após a permissão do iframe:
O iframe deve ter um atributo src.
O Hotjar não poderá permitir um iframe se o atributo src usar um caminho de página relativo (exemplo: src="/page") em vez do URL completo (exemplo: src="https://hotjar.com/page").
O JavaScript será bloqueado dentro do iframe.
As interações (eventos de clique e rolagem, digitação, animações CSS, mutações DOM, etc.) não serão rastreadas no iframe.
Essas limitações significam que muitos iframes de terceiros podem não ser exibidos porque dependem de JavaScript, mesmo depois de permitir o iframe. Alguns exemplos de tipos de conteúdo que não funcionarão com um iframe permitido incluem:
- Chatbots
- Reprodutores de vídeo de terceiros (incluindo YouTube e Vimeo)
- Formulários de terceiros (incluindo formulários Typeform)
- Aplicativos da Web que são carregados por meio de iframes
- A maioria dos sistemas de pagamento de terceiros
- A maioria dos conteúdos de terceiros
Isso significa que o Hotjar só pode mostrar os seguintes aspectos de um iframe permitido:
Conteúdo estático da página (sem JavaScript) carregado por meio de um iframe.
O comportamento do cursor é rastreado, em relação à página principal.
Solução alternativa para iframes de mesma origem
Se você puder editar o HTML do iframe e o URL de origem do iframe usar o mesmo domínio da página à qual o iframe está sendo adicionado, você poderá colocar o código de rastreamento do Hotjar dentro da página de origem do iframe, em vez da página principal. Com essa opção, você pode rastrear a página de origem do iframe, mas não outros aspectos da página principal.