Cómo configurar Meta Conversions API (CAPI) en Shopify

Ideal para: Tiendas pequeñas con poco presupuesto

Ideal para: Tiendas con +$1,000/mes en ads

Ideal para: Equipos con devs dedicados

Crear tu Custom Pixel en Shopify (Browser)

Custom Pixel — Meta Pixel Browser

// Inicializar Meta Pixel
!function(f,b,e,v,n,t,s){if(f.fbq)return;n=f.fbq=function(){
  n.callMethod?n.callMethod.apply(n,arguments):n.queue.push(arguments)};
  if(!f._fbq)f._fbq=n;n.push=n;n.loaded=!0;n.version='2.0';
  n.queue=[];t=b.createElement(e);t.async=!0;
  t.src=v;s=b.getElementsByTagName(e)[0];
  s.parentNode.insertBefore(t,s)}(window,document,'script',
  'https://connect.facebook.net/en_US/fbevents.js');

fbq('init', 'TU_PIXEL_ID_AQUI');
fbq('track', 'PageView');

// Producto visto
analytics.subscribe('product_viewed', (event) => {
  const product = event.data.productVariant;
  fbq('track', 'ViewContent', {
    content_ids: [product.id.toString()],
    content_type: 'product',
    value: parseFloat(product.price.amount),
    currency: product.price.currencyCode
  }, { eventID: 'vc_' + product.id + '_' + Date.now() });
});

// Compra completada (Purchase)
analytics.subscribe('checkout_completed', (event) => {
  const checkout = event.data.checkout;
  const orderId = checkout.order?.id || checkout.token;
  fbq('track', 'Purchase', {
    content_ids: checkout.lineItems.map(i => i.variant.id.toString()),
    value: parseFloat(checkout.totalPrice.amount),
    currency: checkout.totalPrice.currencyCode,
    order_id: orderId
  }, { eventID: orderId });
});

💡 Nota crítica

El eventID del Purchase usa el orderId directamente. Este mismo ID se debe enviar desde el servidor para que Meta deduplique correctamente.

Obtener tu Access Token de Meta

Configurar tag de Meta CAPI en GTM Server

¿Qué son fbp y fbc?

_fbp (Facebook Browser Parameter): cookie que identifica el navegador.

_fbc (Facebook Click ID): se genera cuando alguien llega desde un anuncio de Facebook. Permite atribuir la conversión al click exacto. Sin estos, Meta tiene que adivinar quién compró.

Configurar el Trigger

Error #1 — No enviar event_id → Doble conteo

Síntoma: Los Purchases en Events Manager son el doble de tus ventas reales.

Solución: Asegúrate de que tanto el pixel del browser como el tag CAPI envíen el mismo event_id. Para Purchase, usa el order_id de Shopify.

Error #2 — Datos de usuario sin hash → Rechazo

Síntoma: Los eventos llegan a Meta pero el Match Quality es 0.

Solución: Email y teléfono deben estar hasheados con SHA-256. En GTM Server, el template de Stape hashea automáticamente si configuras los campos correctamente.

Error #3 — Access Token mal configurado → Eventos silenciosos

Síntoma: No ves eventos del servidor en Events Manager, sin error visible.

Solución: Verifica el token en Events Manager → Settings. Regenera si es necesario. Usa Test Events para confirmar.

Error #4 — Content IDs no coinciden con el Catálogo

Síntoma: Meta muestra los eventos pero no hace match con productos para Dynamic Ads.

Solución: Los content_ids deben ser exactamente iguales a los IDs en tu catálogo de Meta. Formato típico: shopify_US_{product_id}_{variant_id}.

Error #5 — Purchase se dispara en reload del thank-you

Síntoma: Un mismo pedido se registra como múltiples purchases.

Solución: Guarda el último order_id enviado en sessionStorage y bloquea el evento si ya se envió para ese pedido.

Error #6 — No incluir fbp/fbc → Match Rate bajo

Síntoma: Event Match Quality por debajo de 5.

Solución: Asegúrate de que tu server container lea las cookies _fbp y _fbc del request. Usar dominio CNAME a Stape ayuda a que se envíen automáticamente.

Error #7 — Configurar CAPI sin pixel del browser

Síntoma: Solo ves eventos 'Server' en Events Manager, nunca 'Browser'.

Solución: Necesitas ambos. El pixel captura datos que el server no puede (scroll, tiempo en página). Meta optimiza mejor con ambas señales.

Custom Pixel en Shopify con Meta Pixel (browser) configurado

Eventos: PageView, ViewContent, AddToCart, InitiateCheckout, Purchase

event_id generado y enviado en cada evento del browser

Access Token generado en Events Manager

Tag de Meta CAPI en GTM Server configurado

Datos de usuario mapeados: email, phone, IP, user agent, fbp, fbc

event_id en CAPI coincide con el del browser

Purchase usa order_id como event_id

Verificación en Test Events: eventos llegan con badge 'Server'

Deduplicación verificada: total no es doble de browser

Event Match Quality apuntando a 6.0+

Protección contra reload de thank-you page implementada