Meta (Facebook + Instagram)

#Qué es Meta Pixel

Meta Pixel es un fragmento de código que Facebook instala en tu sitio para rastrear lo que hacen tus visitantes. Con esos datos puedes:

• Ver cuanta gente visita tu catálogo
• Saber que productos ven más
• Crear audiencias de retargeting (mostrar anuncios a personas que ya visitaron tu tienda)
• Medir el retorno de tus campañas de Facebook e Instagram Ads

Si haces publicidad en Meta (Facebook o Instagram), el Pixel es indispensable. Sin el, estas publicando anuncios a ciegas.

#Obtener tu Pixel ID

1. Ve a Facebook Events Manager
2. Si no tienes un Pixel, haz click en Conectar fuentes de datos → Web → Meta Pixel
3. Dale un nombre (ejemplo: "Karrito - Mi Tienda")
4. Copia tu Pixel ID — es un número de 15-16 digitos (ejemplo: 548293017264831)

Si ya tienes un Pixel activo, lo encuentras en Events Manager → Fuentes de datos → tu Pixel → Configuración.

#Configurar en Karrito

1. Ve a tu panel de admin en karrito.shop/admin
2. Navega a Configuración → Conexiones
3. En la sección Meta Pixel, pega tu Pixel ID
4. Guarda los cambios

Eso es todo. Karrito inyecta el código del Pixel automáticamente en tu catálogo publico. No necesitas tocar código.

#Eventos que Karrito trackea

Karrito envía 9 eventos en paralelo desde el navegador (Pixel) y el servidor (CAPI cuando lo tienes activo) con el mismo event_id para que Meta deduplique automáticamente.

#Advanced Matching (EMQ)

Cuando el cliente llena su email/teléfono/nombre en el carrito antes de "Pedir por WhatsApp", esos datos se hashean con SHA-256 en el servidor y se envían en user_data a CAPI. Esto eleva el Event Match Quality (EMQ) dramaticamente — Meta puede matchear al cliente con su perfil aunque iOS/Safari bloqueen cookies.

Los datos nunca viajan en plano: el servidor de Karrito es el único que los ve, y solo para hashearlos.

#Ejemplo de evento ViewContent

Cuando un visitante abre la página de "Camisa azul clásica", Karrito envía:

fbq("track", "ViewContent", {
  content_name: "Camisa azul clasica",
  content_ids: ["clx1a2b3c4d5e6f7g8h9i0"],
  content_type: "product",
  value: 25.00,
  currency: "USD"
});

#Conversions API (CAPI)

El Pixel solo dispara desde el navegador del cliente. Con iOS 14, Safari ITP y ad blockers, se pierde el ~30% de eventos antes de llegar a Meta.

Conversions API (CAPI) es el server-to-server de Meta: nuestro servidor envía los mismos eventos directo a graph.facebook.com desde el backend. Imparable por el navegador del cliente.

#Configurar CAPI

1. En Configuración > Conexiones > Meta Pixel asegurate de tener el Pixel ID guardado
2. Click en el badge "Configurar ahora" o pega manualmente tu Access Token en el campo
3. Generas el token en Events Manager → tu Pixel → Settings → Conversions API → Generate Access Token
4. Al guardar, Karrito valida el token contra Meta Graph API antes de persistirlo (bloquea si el token no tiene permiso sobre el Pixel)
5. El token se guarda cifrado con AES-256-GCM. Jamas viaja al cliente

#Test Event Code

Si configuras un Test Event Code (ej. TEST12345), los eventos se separan del trafico real y aparecen en Events Manager > Test Events en tiempo real. Util para verificar que todo funciona sin esperar los 15-20 minutos de delay normal.

El test code se respeta en todos los entornos (incluyendo producción) mientras este configurado. Borralo del admin cuando quieras volver a trafico real.

#Health check automático

Cada hora un cron chequea que los eventos esten llegando a Meta sin errores. Si el success rate cae por debajo del 80%, verás un badge "Degradado" en el header de la sección Meta y un email de alerta.

#Eliminar token

Si quieres desconectar CAPI, usa el boton "Eliminar token" dentro del form. No intentes guardarlo con el campo vacío — eso preserva el token actual (decisión de diseño para evitar borrados accidentales).

#Product Feed (catálogo para Meta Commerce)

Los Dynamic Product Ads y el retargeting por producto de Meta necesitan que tu catálogo este sincronizado con Meta Commerce Manager. Sin el feed, Meta recibe los eventos del Pixel pero no puede atribuir ventas a productos específicos — y los Dynamic Ads no funcionan.

Karrito genera el feed automáticamente en formato Google Shopping (compatible con Meta). Solo tienes que conectarlo una vez.

#URL del feed

Tu feed vive en:

https://tu-tienda.karrito.store/feed/products.xml

Si tienes un dominio propio verificado, la URL usa ese dominio automáticamente (ej: https://tienda.com/feed/products.xml).

Encuentras la URL lista para copiar en Configuración > Conexiones > Meta Pixel > Catálogo de productos.

#Conectarlo a Meta en 3 pasos

1. Copia la URL del feed desde tu admin de Karrito
2. Abre Meta Commerce Manager → tu catálogo → Fuentes de datos → Agregar productos con un feed de datos
3. Pega la URL, selecciona Programada y elige Diaria. Meta sincroniza todos los días automáticamente

Listo. Meta empieza a importar tus productos. La primera sync tarda 1-24h; las siguientes son incrementales.

#Por qué Karrito garantiza que funciona

El feed usa los mismos IDs de producto que envía el Pixel y el CAPI en cada evento (ViewContent, AddToCart, Purchase). Esto garantiza que cuando Meta reciba un evento Purchase con content_ids: ["abc123"], pueda ligarlo con el producto abc123 de tu catálogo publicitario y atribuir la venta a la campaña correcta.

En la mayoría de tiendas, el ID interno de Karrito funciona perfecto. Si ya tenias un catálogo en Meta con otros IDs (ej: SKUs de tu inventario), contacta soporte para migrar.

#Verificar que funciona

#Facebook Pixel Helper

1. Instala la extensión Facebook Pixel Helper en Chrome
2. Visita tu catálogo (tu-tienda.karrito.store)
3. Haz click en el icono de la extensión
4. Deberías ver un check verde con "PageView" registrado
5. Navega a un producto y verifica que aparece "ViewContent"

#Events Manager

Los eventos también aparecen en Events Manager → tu Pixel → Actividad de prueba. Puede tardar unos minutos en aparecer.

#Crear audiencias para retargeting

Con el Pixel funcionando, puedes crear audiencias personalizadas basadas en el comportamiento de tus visitantes.

#Audiencia: visitantes que no compraron

1. Ve a Audiences en Facebook Ads Manager
2. Haz click en Create Audience → Custom Audience → Website
3. Selecciona tu Pixel
4. Configura: "Personas que visitaron tu sitio en los últimos 30 días"
5. Excluye: "Personas que iniciaron checkout"
6. Nombra tu audiencia y guardala

#Audiencia: personas que vieron un producto

1. Mismos pasos, pero selecciona el evento ViewContent
2. Esto crea una audiencia de personas que mostraron interes en productos específicos
3. Ideal para anuncios de "¿te olvidaste algo?"

#Tips

• Deja el Pixel activo al menos 7 días antes de crear campañas. Necesita datos para optimizar
• Usa el mismo Pixel en tu catálogo de Karrito y en tu sitio web principal (si tienes uno). Asi Facebook tiene una vista completa del recorrido del cliente
• No desactives el Pixel entre campañas. La data historica es valiosa para futuras optimizaciones

#Disponibilidad

• Meta Pixel (browser-side): planes Pro y Lifetime
• Conversions API (CAPI): planes Pro y Lifetime
• Health check automático: incluido con los anteriores, sin costo extra

En el plan Free puedes seguir recibiendo pedidos por WhatsApp sin limite: lo que pasa a Pro es la medición, no la venta. Y la verificación de dominio de Meta sigue siendo gratis — ver HTML personalizado.

#FAQ

¿Por que no veo mis eventos en Events Manager?

Meta tiene 15-20 minutos de delay para trafico normal. Si tienes prisa, configura un Test Event Code y revisa Events Manager > Test Events — ahi aparecen en segundos.

¿El access token es seguro?

Si. Se cifra con AES-256-GCM antes de persistirse. Solo el servidor lo desencripta para hacer la llamada a Meta. El cliente jamas lo recibe ni lo ve.

¿Puedo usar el mismo pixel en mi catálogo y en mi sitio principal?

Si — de hecho es lo recomendado. Meta consolida la data de ambas fuentes.

¿Karrito duplica eventos?

No. Cuando tienes CAPI activo, browser y server envían el mismo event_id. Meta deduplica automáticamente en ventana de 48h.

Elimine el token por error, ¿como lo restauro?

Solo pega uno nuevo desde Events Manager. El token anterior no se puede recuperar (por eso lo ciframos, ni nosotros podemos leerlo).