Blog
SignalHost para Shopify: tracking do lado do servidor desde a primeira visualização de página até à compra
Publicado · 8 min de leitura
A aplicação SignalHost dá a uma loja Shopify o Google Tag Manager do lado do servidor sem editar o tema e sem código. Quando a liga, a SignalHost cria na sua loja um web pixel que envia as visualizações de página, os carrinhos, cada passo do checkout e as compras para o seu próprio servidor de etiquetagem, que os reencaminha para o Google Analytics 4 e para as suas plataformas de publicidade. Este guia trata da instalação, da ligação, do teste, do embed opcional do tema e do que fazer quando algo não funciona.
Antes de começar
- Uma loja Shopify com loja online. A aplicação funciona na montra e no checkout do Shopify.
- Uma conta SignalHost. O plano gratuito chega para experimentar: 10.000 pedidos por mês e um contentor. Pode criar a conta durante a ligação.
- Permissão para instalar aplicações no painel de administração do Shopify.
1. Instalar a aplicação
Abra SignalHost: Server Tag Manager na Shopify App Store e instale-a. A aplicação pede ao Shopify apenas duas permissões: gerir web pixels e ler eventos de clientes. Não pede acesso ao seu tema nem aos dados dos seus clientes. Depois de instalada, abre-se no painel de administração do Shopify, em Apps.
2. Ligar a sua loja a um contentor
A página da aplicação oferece Ligar ao SignalHost e, se ainda não tiver conta, Criar uma conta gratuita. Qualquer um dos dois abre signalhost.io num novo separador; inicie sessão ou registe-se aí.
O ecrã seguinte diz o que a aplicação poderá fazer — acrescentar o seu código de tracking a todas as páginas da sua loja, enviar os eventos de carrinho e de checkout da loja para o contentor e ler o estado do contentor — e o que não poderá: ler os dados de contacto dos seus clientes, usar a sua conta Google ou ver a sua faturação. Depois pergunta que contentor a loja deve usar. Um contentor é o seu próprio servidor de etiquetagem: um contentor web e um contentor de servidor do Tag Manager, construídos na sua própria conta Google, por isso continuam a ser seus.
Escolha um e carregue em Ligar, ou escolha Novo contentor para a sua loja e carregue em Criar contentor para percorrer o assistente curto. De volta ao Shopify, a página da aplicação atualiza-se sozinha. Se mostrar Confirmar a ligação, verifique a conta e o contentor que indica e carregue em Confirmar ligação.
3. O tracking começa sozinho
Não há código para colar, nenhum tema para editar e nada para publicar. Quando a loja fica ligada, a SignalHost cria o web pixel da aplicação e dá-lhe o seu endereço de etiquetagem e o ID de medição do Google Analytics 4 do seu contentor. O Shopify executa-o em todas as páginas da montra e no seu checkout. A aplicação mostra Quase pronto enquanto um contentor novo está a ser construído e, depois, O tracking está ativo.
4. Testar
Abra a sua loja num novo separador, aceite o banner de cookies, veja um produto, adicione-o ao carrinho e inicie o checkout. De volta à aplicação, Últimos 7 dias conta Visualizações de página, Adições ao carrinho, Checkouts e Compras em poucos minutos; Atualizar estado lê o estado mais recente.
Abrir estatísticas e definições abre o seu contentor em signalhost.io, onde, a partir do plano Growth, Monitoramento de eventos ao vivo lista cada evento à medida que chega, com o país, o navegador e o estado do consentimento.
O que a aplicação envia
O Shopify entrega ao pixel os seus próprios eventos de clientes, e o pixel transforma-os em eventos do Google Analytics 4:
- page_view, nas páginas da montra e do checkout
- view_item, view_item_list e search
- add_to_cart, remove_from_cart e view_cart
- begin_checkout, add_shipping_info e add_payment_info
- purchase, com valor, impostos, envio e códigos de desconto
O pixel usa os cookies do Google Analytics do visitante, por isso um evento do checkout pertence ao mesmo visitante e à mesma sessão que a página de produto anterior. Cada pedido sai do navegador num formato que os bloqueadores de anúncios não reconhecem, e o seu servidor de etiquetagem reencaminha-o para o Google Analytics 4 e para as plataformas de publicidade que configurar na página do contentor: Google Ads, Meta, TikTok e outras.
O Shopify só executa o pixel quando a escolha de privacidade do visitante permite a análise, por isso é o banner de cookies do Shopify que decide quem é contado; a escolha sobre publicidade segue com cada evento, para que o seu contentor de servidor possa reter eventos em vez de os enviar às plataformas de publicidade. A aplicação nunca lê os dados de contacto dos seus clientes.
Opcional: o seu próprio contentor do Tag Manager em todas as páginas
O pixel envia ele próprio os seus eventos e não carrega o seu contentor web do Tag Manager. Só precisa desse contentor na montra se ele tiver etiquetas próprias, como uma ferramenta de mapas de calor ou o tracking de scroll e de cliques do GA4. Nesse caso, abra Opcional: carregue o seu próprio contentor do Tag Manager em todas as páginas na aplicação e carregue em Ativar no editor de temas; o editor de temas do Shopify abre-se com o SignalHost ativado, e a alteração entra em vigor quando carregar em Guardar.
A partir daí, o seu contentor do Tag Manager envia as visualizações de página nas páginas da montra e o pixel deixa-as de fora nessas páginas, por isso nada é contado duas vezes. A definição do embed Use Shopify's cookie banner for Google Consent Mode faz as etiquetas esperarem pela resposta do visitante; desative-a apenas se outra aplicação já definir o Google Consent Mode.
O seu próprio domínio de tracking
O seu contentor começa num endereço sob signalhost.io. Num plano pago, Configurar o seu próprio domínio, na página do contentor, guia-o na configuração de um subdomínio do domínio da sua loja, como metrics.asualoja.com, com um único registo DNS. Os navegadores tratam-no como primeira parte, por isso os seus cookies contam como seus e os cliques nos anúncios continuam a ser atribuídos. Quando fica ativo, a aplicação muda a sua montra e o seu checkout para ele em poucos minutos. Não há nada a substituir à mão.
Adicionar a SignalHost à mão
Pode pôr a SignalHost numa loja Shopify sem a aplicação. Em signalhost.io, abra o seu contentor, encontre o snippet no cartão Instalar no seu site e carregue em Copiar. Depois, no Shopify, vá a Online Store › Themes › ⋯ › Edit code, abra theme.liquid e cole o snippet logo a seguir à etiqueta head de abertura. Se o seu tema já carrega o Google Tag Manager ou uma etiqueta Google para a mesma propriedade do Analytics, substitua esse snippet em vez de acrescentar um segundo. Guarde, visite a sua loja e carregue em Já o fiz na página do contentor.
Isso carrega o seu contentor do Tag Manager nas páginas do tema, com as visualizações de página e tudo o que o próprio tema envie para a camada de dados. Fica a faltar o que o pixel acrescenta: o checkout do Shopify não executa código do tema, por isso os passos do checkout e a compra nunca chegam a um snippet em theme.liquid, e os eventos de produto e de carrinho também vêm do pixel. Quando o seu próprio domínio fica ativo, é a si que cabe substituir o snippet. Se instalar a aplicação mais tarde, remova primeiro o snippet, ou cada visualização de página será contada duas vezes.
Planos e faturação
Uma loja ligada através da aplicação paga a SignalHost através do Shopify. Planos e faturação, na página da aplicação, abre a página do Shopify para escolher ou mudar o seu plano, e a cobrança aparece na sua fatura do Shopify. Depois de ligada, a aplicação mostra também os pedidos deste mês face ao limite do seu plano.
Uma conta tem um único pagador. Se a sua conta SignalHost já paga por cartão, ou se outra loja Shopify paga por ela, a aplicação indica-o e o plano desta loja não é usado; cancele um deles para não pagar duas vezes.
Gerir e desligar
Desligar fica no fundo da página da aplicação e pede um segundo clique. A SignalHost remove então o pixel da aplicação e os valores que o embed do tema lê, e deixa de carregar na sua loja em poucos minutos. O seu contentor e as suas estatísticas mantêm-se, e Ligar ao SignalHost volta a ligar a loja. Definições › Sites ligados, em signalhost.io, também lista a loja.
Se, em vez disso, desinstalar a aplicação no Shopify, a SignalHost marca a loja como desligada, e um plano pago através do Shopify termina com a aplicação: a sua conta volta ao plano gratuito.
Quando algo não funciona
- A aplicação fica em Quase pronto: um contentor novo ainda está a ser construído, o que demora alguns minutos. Se a construção falhou, abra o contentor para ver porquê.
- A aplicação diz que o seu contentor ainda não tem uma propriedade do Google Analytics: abra o contentor e adicione uma. Até lá, o pixel não tem para onde enviar dados.
- Últimos 7 dias continua a zero: abra a loja publicada e aceite o banner de cookies. O Shopify só executa o pixel para os visitantes cuja escolha de privacidade permite a análise.
- Com o embed do tema ativo, a aplicação diz que o código de tracking aparece duas vezes ou que ainda há uma cópia antiga no seu tema: remova o snippet que colou antes em theme.liquid.
- Atingiu o limite do seu plano: os novos eventos não são registados até à data que a aplicação indica, a menos que suba de plano.
- Qualquer outra coisa: escreva para hello@signalhost.io com o endereço da sua loja.
Marcas registadas
A SignalHost é um produto independente da Algorithmo GmbH e não é afiliada nem apoiada pela Shopify, pela Google, pela Meta ou pelo TikTok. Google Analytics, Google Ads e Google Tag Manager são marcas registadas da Google LLC; Meta é uma marca registada da Meta Platforms, Inc.; TikTok é uma marca registada da ByteDance Ltd.; Shopify é uma marca registada da Shopify Inc.

