Meta (Facebook + Instagram)

#Que es Meta Pixel

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

• Ver cuanta gente visita tu catalogo
• Saber que productos ven mas
• Crear audiencias de retargeting (mostrar anuncios a personas que ya visitaron tu tienda)
• Medir el retorno de tus campanas 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 numero de 15-16 digitos (ejemplo: 548293017264831)

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

#Configurar en Karrito

1. Ve a tu panel de admin en karrito.shop/admin
2. Navega a Settings → Integraciones
3. En la seccion Meta Pixel, pega tu Pixel ID
4. Guarda los cambios

Eso es todo. Karrito inyecta el codigo del Pixel automaticamente en tu catalogo publico. No necesitas tocar codigo.

#Eventos que Karrito trackea

Karrito envia 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 automaticamente.

Evento	Cuando se dispara	Browser	Server (CAPI)
PageView	Cada pagina del catalogo	✓	—
ViewContent (product)	Abre pagina de producto	✓	✓
ViewContent (product_group)	Abre pagina de categoria/coleccion	✓	✓
AddToCart	Agrega al carrito	✓	✓
RemoveFromCart (custom)	Quita del carrito	✓	—
InitiateCheckout	Click "Pedir por WhatsApp"	✓	✓ (con email/telefono si estan disponibles)
Purchase	Orden creada en Karrito	✓	✓ (action_source: business_messaging)
Search	Pagina /search?q=...	✓	✓

#Advanced Matching (EMQ)

Cuando el cliente llena su email/telefono/nombre en el carrito antes de "Pedir por WhatsApp", esos datos se hashean con SHA-256 en el servidor y se envian 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 unico que los ve, y solo para hashearlos.

#Ejemplo de evento ViewContent

Cuando un visitante abre la pagina de "Camisa azul clasica", Karrito envia:

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 envia los mismos eventos directo a graph.facebook.com desde el backend. Imparable por el navegador del cliente.

#Configurar CAPI

1. En Settings > Integraciones > Meta 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 produccion) mientras este configurado. Borralo del admin cuando quieras volver a trafico real.

#Health check automatico

Cada hora un cron chequea que los eventos esten llegando a Meta sin errores. Si el success rate cae por debajo del 80%, veras un badge "Degradado" en el header de la seccion 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 vacio — eso preserva el token actual (decision de diseño para evitar borrados accidentales).

#Product Feed (catalogo para Meta Commerce)

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

Karrito genera el feed automaticamente 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 automaticamente (ej: https://tienda.com/feed/products.xml).

Encuentras la URL lista para copiar en Settings > Integraciones > Meta > Catalogo 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 catalogo → Fuentes de datos → Agregar productos con un feed de datos
3. Pega la URL, selecciona Programada y elige Diaria. Meta sincroniza todos los dias automaticamente

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

#Por que Karrito garantiza que funciona

El feed usa los mismos IDs de producto que envia 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 catalogo publicitario y atribuir la venta a la campana correcta.

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

#Verificar que funciona

#Facebook Pixel Helper

1. Instala la extension Facebook Pixel Helper en Chrome
2. Visita tu catalogo (tu-tienda.karrito.store)
3. Haz click en el icono de la extension
4. Deberias ver un check verde con "PageView" registrado
5. Navega a un producto y verifica que aparece "ViewContent"

#Events Manager

Los eventos tambien 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 ultimos 30 dias"
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 especificos
3. Ideal para anuncios de "te olvidaste algo?"

#Tips

• Deja el Pixel activo al menos 7 dias antes de crear campanas. Necesita datos para optimizar
• Usa el mismo Pixel en tu catalogo 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 campanas. La data historica es valiosa para futuras optimizaciones

#Disponibilidad

• Meta Pixel (browser-side): disponible en todos los planes, incluyendo FREE
• Conversions API (CAPI): disponible en todos los planes, incluyendo FREE
• Health check automatico: incluido sin costo

#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 catalogo 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 envian el mismo event_id. Meta deduplica automaticamente 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).