# Ligar o Shopify

> Ligar uma loja Shopify ao DataFirefly Server-Side: webhook Order payment assinado, signing secret, pixel da DataFirefly para a navegação.

- Página original: https://server-side.datafirefly.com/pt/docs/shopify.html
- Idioma: pt
- Atualizado em: 2026-09-01
- Editor: DataFirefly (Datafirefly Limited), https://server-side.datafirefly.com/pt/

---

Nenhum módulo para instalar: o Shopify envia as encomendas através de webhooks assinados, e o pixel da DataFirefly cobre a navegação.

## 1. Criar o webhook de encomenda

1. Admin Shopify: **Settings > Notifications > Webhooks**.
2. Clique em **Create webhook**, escolha o evento **Order payment** e o formato JSON, com destino a:  
   `https://serverside.datafirefly.com/v1/shopify/O-SEU-SITE-ID`  
   substituindo `O-SEU-SITE-ID` pelo Site ID exato da [página do seu site](https://server-side.datafirefly.com/pt/docs/connect-your-site.html).
3. Recomendado: adicione também **Refund creation** para fazer chegar os reembolsos. **Checkout creation** e **Cart creation** só são úteis enquanto o pixel da DataFirefly não estiver colocado.

Escolha bem **Order payment**, nunca **Order creation**: este último dispara também para encomendas não pagas e provoca uma contagem em duplicado.

## 2. Colar o signing secret

1. No fundo da página Webhooks, o Shopify mostra o **signing secret**: copie-o.
2. Cole-o no campo **« Shopify webhook signing secret »** da página do seu site DataFirefly e guarde.

## 3. Colocar o pixel da DataFirefly

1. Admin Shopify: **Settings > Customer events** e, em seguida, adicione um pixel personalizado.
2. Cole o snippet fornecido no guia Shopify da sua área de cliente (página [**Modules**](https://admin.datafirefly.com/app/connectors)).
3. Com o pixel colocado, elimine os webhooks Checkout creation e Cart creation: o pixel substitui-os.

## ChatGPT Ads

A compra é enviada a partir do servidor, através do webhook assinado **Order payment**. A referência do clique publicitário (`oppref` e `obref`) é captada pelo pixel da DataFirefly do passo 3, colado na administração do Shopify (**Settings > Customer events**) e não no tema: liga a referência ao checkout, e o servidor associa-a à compra. Só é captada com consentimento de marketing.

Se também utiliza o seu próprio pixel da OpenAI, substitua a chamada de compra desse pixel pelo código indicado no guia Shopify da sua área de cliente, para que a compra no navegador tenha o mesmo identificador de evento que a do servidor (`shopify-order-` seguido do número da encomenda). Caso contrário, desative o evento de compra do seu próprio pixel da OpenAI.

## Consentimento

O pixel da DataFirefly segue o consentimento de marketing registado no Shopify. Quando um visitante recusa o marketing, o pixel envia os eventos desse visitante à DataFirefly marcados como recusados, sem qualquer referência de clique publicitário, e nada disso é reencaminhado para as plataformas publicitárias. As encomendas, por sua vez, chegam por webhooks assinados que não transmitem qualquer sinal de consentimento, pelo que se lhes aplica a política de consentimento da sua loja.

## Verificar

1. Faça uma encomenda de teste paga: deve aparecer como **Delivered** no Monitoring.
2. O botão **« Diagnose my connection »** confirma a receção dos últimos eventos.

## Em caso de problema

- Um webhook que falha durante cerca de 48 horas é **eliminado automaticamente pelo Shopify**. Se o webhook tiver desaparecido, verifique o Site ID no URL, recrie-o e vigie o Monitoring.
- Encomendas em duplicado? Verifique se não resta nenhum webhook **Order creation**.
- As restantes causas frequentes estão listadas no [guia de resolução de problemas](https://server-side.datafirefly.com/pt/docs/troubleshooting.html).

Atualizado: 1 de setembro de 2026
