O Shopify dá-te dois sítios para pôr um script e só um deles serve para isto. A versão curta: cola o fragmento no theme.liquid, e não o ponhas num pixel personalizado. O resto desta página é o porquê, e o que o Shopify não deixa nenhum script ver.
Vai buscar primeiro o fragmento ao teu painel. Tem este aspeto, com o teu próprio identificador de sítio no caminho:
<script src="https://t.skomi.com/s/your-site-id.js" defer></script>
Cola-o no teu tema
- Online Store → Themes, encontra o tema que estás a publicar.
- Abre o menu ⋯ dele e escolhe Edit code.
- Em Layout, abre o
theme.liquid. - Cola a etiqueta imediatamente antes da etiqueta
</body>de fecho. - Guarda.
A instalação é isto.
⚠ A etiqueta vive no tema, portanto vai-se embora com o tema. Duplicar um tema leva-a atrás; publicar um tema diferente, ou instalar uma cópia nova da loja de temas, não, e o sintoma é a analítica parar pura e simplesmente, sem nada que o explique. Volta a colá-la depois de qualquer mudança de tema, e confere os números nesse mesmo dia.
Não um pixel personalizado
O mais recente Settings → Customer events → Add custom pixel do Shopify tem ar de ser o sítio moderno para um script de medição, e para ferramentas que só medem eventos é. O fragmento da Skomi não pertence ali, e vale a pena saber exatamente porquê antes de alguém tentar e gastar uma tarde nisso.
Um pixel personalizado corre naquilo a que o Shopify chama uma caixa de areia Lax: um iframe com sandbox="allow-scripts allow-forms". A própria documentação do Shopify é clara quanto ao que isso custa: um pixel não consegue ler informação da página, não consegue escrever nela, e não chega de todo à moldura de topo; o window.href dentro de um pixel devolve o endereço da caixa de areia em vez da página para onde o cliente está a olhar.
Tudo o que a Skomi faz precisa da página verdadeira:
- Os mapas de calor e as gravações de sessão são um retrato da página. Não há página nenhuma dentro da caixa de areia.
- O widget de opiniões tem de aparecer nela.
- Até a analítica simples precisa do endereço verdadeiro, e a caixa de areia não o tem.
Portanto: o tema, não o pixel.
O que nenhum script consegue ver no Shopify
Esta é a parte honesta, e é uma decisão do Shopify e não nossa. O Shopify mexeu neste terreno várias vezes, portanto: verificado contra a própria documentação do Shopify a 6 de setembro de 2026.
O Shopify retirou todos os pontos de ligação que um script de tema tinha ao processo de compra. O checkout.liquid não é suportado nos passos de informação, envio e pagamento; o checkout.liquid e o campo Additional scripts foram descontinuados para as páginas de agradecimento e de estado da encomenda em agosto de 2025; e as etiquetas de script nessas páginas foram descontinuadas em agosto de 2025 para as lojas Plus e em agosto de 2026 para toda a gente.
O que isso quer dizer na prática:
- A Skomi mede a tua montra (página inicial, coleções, páginas de produto, carrinho) por inteiro, com mapas de calor, gravações e opiniões.
- A Skomi não vê os passos do processo de compra, a página de agradecimento nem a página de estado da encomenda. Nada colado num tema vê mais do que isso.
- Portanto não há evento de compra nem número de receita a partir do fragmento no Shopify. Se a receita na Skomi te importa, é isso que há a saber antes de começares e não depois.
O substituto útil é um objetivo no último passo que consegues ver: chegar a /checkout é o momento em que um visitante se comprometeu, e a taxa da página de produto até esse ponto é o número que a maior parte das lojas Shopify anda mesmo a tentar mexer. O que aconteceu a seguir, os relatórios do próprio Shopify já to dizem com rigor.
O teu endereço .myshopify.com
Todas as lojas respondem também em a-tua-loja.myshopify.com, e isso não é um subdomínio do domínio que registaste na Skomi, portanto os registos vindos dali são recusados pela verificação de origem. Isso costuma estar certo: as pré-visualizações de temas e as tuas próprias voltas não deviam estar nos teus números. É também a razão por que uma pré-visualização dá a sensação de que nada funciona. Testa no domínio verdadeiro.
Mais do que um domínio por país
O Shopify Markets pode servir uma loja em vários domínios. Os subdomínios de um domínio registado são aceites por esse sítio, mas um domínio diferente (example.de ao lado de example.com) é um sítio diferente na Skomi, com o seu próprio identificador e a sua própria etiqueta.
Confirma que está a funcionar
Carrega uma página da montra no domínio verdadeiro dela, e depois olha para o teu painel. Se não chegar nada, percorre o que verificar quando o fragmento não funciona; no Shopify a resposta é quase sempre um tema que foi publicado sem a etiqueta, ou um teste feito no endereço .myshopify.com.