Cookield

Integração com Shopify

Adicione a Cookield à sua loja Shopify editando o arquivo theme.liquid do seu tema. Leva menos de 2 minutos.

Passo a passo

1. Acessar o editor de código

  1. No admin da Shopify, vá para Online Store → Themes
  2. No seu tema ativo, clique em Actions → Edit code

2. Editar theme.liquid

  1. No painel de arquivos à esquerda, abra Layout → theme.liquid
  2. Localize a tag </head>
  3. Adicione o script da Cookield imediatamente antes de </head>
  4. Clique em Save
<!-- theme.liquid -->
<head>
  <!-- ... outras meta tags e estilos ... -->
  {{ content_for_header }}

  <!-- Cookield CMP — adicionar antes de </head> -->
  <script src="https://cdn.cookield.io/banner/SEU_BANNER_ID.js" async></script>
</head>

Alternativa: Shopify AppEm breve

Estamos desenvolvendo um app oficial para a Shopify App Store que permitirá instalar a Cookield com um clique, sem editar código.

  • →Instalação com 1 clique direto da Shopify App Store
  • →Configuração do Banner ID diretamente no admin
  • →Compatibilidade automática com Shopify Markets
  • →Detecção automática de idioma do visitante

Enquanto isso, use a integração manual via theme.liquid descrita acima.

Limitações do Checkout

O checkout da Shopify possui restrições importantes para scripts de terceiros:

⚠️ Atenção: A Shopify não permite scripts personalizados na página de checkout (checkout.liquid) em planos que não sejam Shopify Plus.

  • →Shopify Plus: É possível adicionar o script no checkout.liquid para cobertura completa.
  • →Outros planos: O banner aparecerá em todas as páginas exceto o checkout. O consentimento coletado antes do checkout continua válido.
  • →Shopify Checkout Extensibility: Para lojas usando o novo checkout extensível, entre em contato com nosso suporte para instruções específicas.

Shopify Plus: Script no Checkout

Se você tem Shopify Plus, pode adicionar o script também no checkout:

<!-- checkout.liquid (apenas Shopify Plus) -->
<head>
  <!-- ... -->
  <script src="https://cdn.cookield.io/banner/SEU_BANNER_ID.js" async></script>
  {{ content_for_header }}
</head>

Verificando a instalação

  1. Acesse sua loja em uma janela anônima
  2. O banner de consentimento deve aparecer na primeira visita
  3. Navegue por diferentes páginas — o banner deve ser consistente
  4. No Dashboard da Cookield, verifique o status "Ativo"

Dicas para Shopify

  • ✓O script funciona com todos os temas da Shopify Theme Store.
  • ✓Para lojas com múltiplos idiomas, a Cookield detecta o idioma automaticamente.
  • ✓Se usa apps de analytics (Klaviyo, Facebook Pixel), ative o Consent Mode no dashboard.
  • ✓Teste em Preview antes de publicar alterações no tema.