---
title: "Instalação: documentação do Spark! | Chargezen"
description: "Guia de instalação do Spark! no Shopify, passo a passo. Da seção Primeiros passos da documentação do Spark! da Chargezen."
url: "https://chargezen.com/pt-br/docs/spark/getting-started/installation"
lang: "pt-BR"
updated: "2026-01-19"
---

Canonical URL: https://chargezen.com/pt-br/docs/spark/getting-started/installation

# 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.

Quem já usa o Chargezen

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

1

#### Instale o Chargezen pela Shopify App Store

2

#### Acesse o Spark! no painel

3

#### Ative o Spark! na loja

4

#### Verifique a instalação do rastreamento

5

#### 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

Diagnóstico de instalação

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:

1.  Adicione um registro CNAME apontando para `portal.chargezen.com`
2.  Informe o domínio em Spark! Settings → Portal → Custom Domain
3.  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

Lojas headless ou personalizadas

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 →](https://chargezen.com/pt-br/docs/spark/api/endpoints)

## 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

[

### Guia de início rápido

Configure seu primeiro programa de afiliados

Saiba mais



](https://chargezen.com/pt-br/docs/spark/getting-started/quick-start)[

### Configuração do programa

Defina as taxas de comissão e as automações de aprovação

Saiba mais



](https://chargezen.com/pt-br/docs/spark/affiliate-management/program-setup)

### Artigos relacionados

[

#### Início rápido

Configure seu primeiro programa



](https://chargezen.com/pt-br/docs/spark/getting-started/quick-start)[

#### Configuração do programa

Configure os ajustes do programa de afiliados



](https://chargezen.com/pt-br/docs/spark/affiliate-management/program-setup)

Esta página foi útil?

Precisa de mais ajuda? [Fale com o suporte](https://chargezen.com/pt-br/docs/checkoutos/troubleshooting/support)