Instalação
Guia de instalação do Spark! no Shopify, passo a passo
Última atualização: 2026-01-19
Este guia acompanha a instalação do Spark! na loja Shopify. O processo leva cerca de 5 minutos e não exige conhecimento de programação.
Se o app Chargezen já estiver instalado, o Spark! estará disponível imediatamente no painel. Basta acessar a seção Spark! para ativá-lo.
Etapas de instalação
Instale o Chargezen pela Shopify App Store
Acesse o Spark! no painel
Ative o Spark! na loja
Verifique a instalação do rastreamento
Configure a URL do portal
Verifique a instalação
Para confirmar a instalação correta do Spark!:
- Abra a loja em uma janela anônima ou privada do navegador
- Abra as ferramentas de desenvolvedor: F12 ou clique com o botão direito → Inspect
- Acesse a aba Network e filtre por “spark”
- Atualize a página e procure requisições para spark.chargezen.com
Execute o diagnóstico integrado em Spark! Settings → Installation → Run Diagnostics. Ele verifica a instalação do pixel, as configurações de cookies e a conexão com a API.
Domínio personalizado, opcional
Para um portal de afiliados profissional, configure um domínio personalizado:
- Adicione um registro CNAME apontando para
portal.chargezen.com - Informe o domínio em Spark! Settings → Portal → Custom Domain
- Aguarde o provisionamento do certificado SSL, normalmente menos de 5 minutos
Integração com o tema
O Spark! se integra automaticamente ao tema Shopify. Para personalizações avançadas:
- Selo de link de afiliado — Mostre “Referred by [Name]” no carrinho ou checkout
- Widget de compartilhamento — Adicione botões “Become an Affiliate” às páginas
- Rastreamento de indicações — Mostre o crédito pela indicação na página de agradecimento
Usa uma loja headless ou checkout personalizado? Consulte a documentação da API para instruções de integração manual. Ver referência da API →
Problemas comuns de instalação
O pixel não carrega: confira se bloqueadores de anúncios ou extensões de privacidade podem bloquear o script. O Spark! usa rastreamento próprio para minimizar bloqueios.
O portal mostra 404: verifique se a rota do portal Spark! está ativada nas configurações de URL do tema Shopify. Alguns temas exigem configuração manual da rota.
Os pedidos não são atribuídos: verifique se o cookie de rastreamento foi definido, procurando _spark_ref nos cookies do navegador. A duração padrão é de 30 dias.
Próximos passos
Artigos relacionados
Precisa de mais ajuda? Fale com o suporte