Voltar ao blog

Blog

SignalHost para BigCommerce: instale a aplicação, confirme uma vez e registe cada venda do lado do servidor

Publicado · 7 min de leitura

O SignalHost para BigCommerce ainda não está na BigCommerce App Marketplace. Até lá, pode adicioná-lo à mão: Adicionar a SignalHost à mão

A aplicação SignalHost põe o Google Tag Manager do lado do servidor numa loja BigCommerce sem código para colar. Acrescenta dois scripts através do Script Manager, transforma a camada de dados do próprio BigCommerce em eventos de comércio eletrónico do Google Analytics, mantém ambos atualizados quando algo muda do nosso lado e desaparece quando a aplicação desaparece. Este guia segue a ordem em que vai encontrando cada passo: instalar, ligar um contentor, confirmar, testar e o que fazer quando algo não funciona.

Antes de começar

  • Uma loja BigCommerce com um tema Stencil. É aí que os scripts são executados; uma montra headless, incluindo a Catalyst, não apresenta nem os scripts nem a camada de dados do BigCommerce, por isso precisa que o código lhe seja acrescentado diretamente.
  • Uma conta SignalHost. O plano gratuito chega para experimentar: 10.000 pedidos por mês e um contentor. Pode criar a conta durante a instalação.
  • Uma loja que ainda não foi lançada também pode ser ligada. A SignalHost só não consegue verificar a montra até ela ser lançada.

1. Instalar a aplicação

Abra SignalHost no BigCommerce App Marketplace e instale-a. O BigCommerce enumera as permissões que a aplicação pede: Content, para escrever os seus scripts através do Script Manager; Checkout Content, para que também sejam executados no checkout e na confirmação da encomenda; e Information & Settings, para o nome e a moeda da sua loja e para ativar a camada de dados. Confirme, e a página da aplicação abre-se dentro do seu painel de controlo. Mais tarde, encontra-a no menu Apps.

2. Ligar um contentor

Carregue em Conectar com o SignalHost. Abre-se um novo separador em signalhost.io; inicie sessão ou crie uma conta gratuita (a página da aplicação também tem um botão Criar uma conta gratuita para isso).

O ecrã seguinte enumera o que a aplicação vai e não vai fazer. Vai adicionar o tracking a todas as páginas da sua loja, incluindo o checkout, e mantê-lo atualizado, e enviar para o contentor as visualizações de produto e os eventos de carrinho, checkout e compra da sua loja. Não pode ler os dados de contacto dos seus clientes, usar a sua conta Google nem ver a sua faturação.

Escolha um contentor existente, ou escolha Novo contentor e percorra o assistente curto. Um contentor é o seu próprio servidor de etiquetagem, construído na sua própria conta Google, por isso continua a ser seu. Construir um novo demora alguns minutos; pode ligá-lo de imediato, e a aplicação acrescenta o tracking assim que estiver pronto. Carregue em Ligar. O separador indica então Quase pronto: confirme no BigCommerce.

3. Confirmar no BigCommerce

Volte à página da aplicação no seu painel de controlo. Ela deteta sozinha que regressou e mostra Confirme a conexão, com a sua conta e o contentor que escolheu. Carregue em Confirmar. Nenhum script é acrescentado à sua loja antes disso.

A página indica então O rastreamento começa em poucos minutos e, assim que os scripts estiverem no lugar, O rastreamento está ativo. Se o pedido tiver expirado quando regressar, carregue de novo em Conectar com o SignalHost.

4. Testar

Abra a sua montra, veja um produto, adicione-o ao carrinho e inicie o checkout. A página da aplicação conta os últimos 7 dias: Visualizações de página, Adicionados ao carrinho, Checkouts e Compras. Quando o tracking estiver ativo, mostra também a verificação que a própria SignalHost faz à sua montra; Encontrado na página inicial da sua loja online significa que os scripts estão lá.

Abrir estatísticas e configurações leva-o à página do contentor, onde o separador Recente das Estatísticas avançadas abrange os últimos 30 minutos. A partir do plano Growth, Monitoramento de eventos ao vivo mostra também cada evento pelo nome à medida que chega.

O que a aplicação acrescenta à sua loja

Dois scripts no Script Manager, ambos escritos e mantidos atualizados pela aplicação:

  • SignalHost, no head de cada página, incluindo o checkout: o carregador do Google Tag Manager, apontado para o seu próprio endereço de etiquetagem em vez de googletagmanager.com. Carrega a partir daí o seu contentor do Tag Manager.
  • SignalHost events, no rodapé de cada página, incluindo o checkout e a confirmação da encomenda: transforma a camada de dados do BigCommerce em eventos de comércio eletrónico do Google Analytics. As visualizações de categorias e de produtos tornam-se view_item_list e view_item, o carrinho add_to_cart, remove_from_cart e view_cart, e o checkout begin_checkout, add_shipping_info, add_payment_info e purchase, com o número da encomenda, os impostos, o envio e o cupão.

O script de eventos lê produtos, valores e o número da encomenda, nunca o nome, o e-mail, o telefone ou a morada de um cliente. Uma página de confirmação recarregada não conta uma encomenda duas vezes no mesmo navegador.

A camada de dados é uma definição da loja, desativada até alguém a ativar. A aplicação ativa-a por si; isso acrescenta o script de eventos do próprio BigCommerce à montra e não muda nada do que os seus clientes veem. Se o BigCommerce recusar, a página da aplicação indica onde está o interruptor.

Ambos os scripts estão na categoria de consentimento Analytics: se a sua loja mostrar o banner de cookies do BigCommerce, a SignalHost só funciona para os clientes que aceitam os cookies de análise. 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 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 para passar a usar um subdomínio do seu próprio site, como sgtm.asualoja.com, que sobrevive às listas de filtros e mantém os cookies dos cliques como cookies de primeira parte. Quando fica ativo, a aplicação muda a sua loja para ele sozinha, em poucos minutos. Não há nada a substituir à mão.

Adicionar a SignalHost à mão

Pode acrescentar o carregador sem a aplicação. Na página do contentor, encontre o código no cartão Instalar no seu site e carregue em Copiar. No seu painel de controlo, abra Storefront › Script Manager e adicione um script com esse código, no head de todas as páginas e, se a sua loja mostrar o banner de cookies do BigCommerce, na categoria de análise. Depois carregue em Já o fiz na página do contentor.

Isso dá-lhe visualizações de página e nada mais. O script de eventos, a ativação da camada de dados, a verificação da montra e a mudança automática para o seu próprio domínio só vêm com a aplicação; quando o seu endereço de etiquetagem muda, é a si que cabe substituir o script pelo novo código que a SignalHost lhe envia por e-mail. Use um ou outro: com a aplicação também instalada, o carregador seria executado duas vezes.

Gerir e desligar

A página da aplicação mostra o seu plano e os pedidos deste mês. O plano é faturado em signalhost.io, não pelo BigCommerce, e Fazer upgrade do plano abre-o lá. Na página do contentor, o cartão de instalação indica Instalado pela app BigCommerce, e Gerir leva a Definições, Sites ligados.

Desconectar, no fundo da página da aplicação, pede um segundo clique e depois remove os dois scripts em poucos minutos. Desligar, em Sites ligados, faz o mesmo. O seu contentor e as suas estatísticas mantêm-se, e pode voltar a ligar a loja a partir da página da aplicação.

Desinstalar a aplicação em Apps › My Apps também remove os dois scripts: o BigCommerce apaga-os ele próprio, porque foram criados para acompanhar a aplicação, e a SignalHost termina a ligação da loja.

Quando algo não funciona

  • Os scripts não estão na página inicial da sua montra: são executados em temas Stencil. Uma montra headless precisa que o código lhe seja acrescentado diretamente.
  • Ainda não foi possível verificar a sua montra: normalmente, a loja ainda não foi lançada. Os scripts estão no lugar e começam a funcionar assim que ela for lançada.
  • Chegam visualizações de página, mas nenhum carrinho nem compra: a camada de dados está desativada. Ative-a em Settings › Data Solutions › Data layer. Os clientes que recusaram os cookies de análise no banner do BigCommerce não são contados de todo.
  • O seu contentor ainda não tem uma propriedade do Google Analytics: termine a configuração em signalhost.io.
  • O SignalHost ainda não está configurado para esta loja: remova a aplicação em Apps › My Apps e instale-a de novo.
  • A página está aberta há muito tempo: abra o SignalHost de novo a partir do menu Apps.
  • A última atualização não foi concluída: é repetida automaticamente.
  • 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 BigCommerce, 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.; BigCommerce é uma marca registada da BigCommerce Pty. Ltd.

Deixa de perder dados para bloqueadores

Comece gratuitamente. O primeiro contentor fica pronto em poucos minutos.