# Conectar Shopify

> Conectar una tienda Shopify a DataFirefly Server-Side: webhook Order payment firmado, signing secret, píxel de DataFirefly para la navegación.

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

---

Sin módulo que instalar: Shopify envía los pedidos mediante webhooks firmados, y el píxel de DataFirefly cubre la navegación.

## 1. Crear el webhook de pedido

1. Desde el panel de control de Shopify, vaya a **Configuración > Notifications** y luego a **Webhooks**.
2. Haga clic en **Crear webhook**, elija el evento **Order payment** y el formato JSON, con destino a:  
   `https://serverside.datafirefly.com/v1/shopify/SU-SITE-ID`  
   sustituyendo `SU-SITE-ID` por el Site ID exacto de la [página de su sitio](https://server-side.datafirefly.com/es/docs/connect-your-site.html).
3. Recomendado: añada también **Refund creation** para que los reembolsos también lleguen. **Checkout creation** y **Cart creation** solo son útiles mientras el píxel de DataFirefly no esté instalado.

Elija bien **Order payment**, nunca **Order creation**: este último se dispara también con pedidos no pagados y provoca un doble conteo.

## 2. Pegar el signing secret

1. Al final de la página Webhooks, Shopify muestra el **signing secret**: cópielo.
2. Péguelo en el campo **«Shopify webhook signing secret»** de la página de su sitio DataFirefly y guarde.

## 3. Instalar el píxel de DataFirefly

1. Desde el panel de control de Shopify, vaya a **Configuración > Customer events** y añada un píxel personalizado.
2. Pegue el snippet proporcionado en la guía Shopify de su área de cliente (página [**Modules**](https://admin.datafirefly.com/app/connectors)).
3. Con el píxel en marcha, elimine los webhooks Checkout creation y Cart creation: el píxel los sustituye.

## ChatGPT Ads

La compra se envía desde el servidor, a través del webhook firmado **Order payment**. La referencia del clic publicitario (`oppref` y `obref`) la capta el píxel de DataFirefly del paso 3, pegado en el panel de control de Shopify (**Configuración > Customer events**) y no en el tema: vincula la referencia con el proceso de pago, y el servidor la asocia a la compra. Solo se capta con consentimiento de marketing.

Si además usa su propio píxel de OpenAI, sustituya su llamada de compra por el código de la guía Shopify de su área de cliente, para que la compra del navegador lleve el mismo ID de evento que la del servidor (`shopify-order-` seguido del número de pedido). Si no, desactive el evento de compra de su propio píxel de OpenAI.

## Consentimiento

El píxel de DataFirefly sigue el consentimiento de marketing registrado en Shopify. Cuando un visitante rechaza el marketing, el píxel envía los eventos de ese visitante a DataFirefly, marcados como rechazados, sin ninguna referencia de clic publicitario, y nada de ello se reenvía a las plataformas publicitarias. Los pedidos, en cambio, llegan por webhooks firmados que no transmiten ninguna señal de consentimiento, por lo que se les aplica la política de consentimiento de su tienda.

## Verificar

1. Realice un pedido de prueba pagado: debe aparecer como **Delivered** en el Monitoring.
2. El botón **«Diagnose my connection»** confirma la recepción de los últimos eventos.

## Si algo falla

- Un webhook que falla durante unas 48 horas es **eliminado automáticamente por Shopify**. Si el webhook ha desaparecido, verifique el Site ID de la URL, vuelva a crearlo y vigile el Monitoring.
- ¿Pedidos duplicados? Compruebe que no quede ningún webhook **Order creation**.
- Las demás causas frecuentes están en la [guía de resolución de problemas](https://server-side.datafirefly.com/es/docs/troubleshooting.html).

Actualizado: 1 de septiembre de 2026
