Instalar el Pixel de Facebook y la API de Conversiones

Mucha gente ve el Pixel de Meta como una simple herramienta de medición. En realidad es el flujo de datos con el que el algoritmo aprende quiénes son tus clientes. Un Pixel limpio junto con la API de Conversiones (CAPI) baja el coste por resultado y le muestra a Meta que detrás del dominio hay una empresa real. Una instalación descuidada logra lo contrario.

Esta guía te explica paso a paso dónde poner el código y cómo comprobar que todo funciona. Sirve para tus propias cuentas y para una cuenta de agencia de Facebook que uses con nosotros.

Por qué la calidad del tracking afecta a la salud de la cuenta

Los sistemas de Meta valoran la imagen completa de un anunciante. Una empresa que envía de forma constante eventos de conversión de calidad desde un dominio verificado parece lo que es: un negocio real con clientes reales. Una cuenta que dirige tráfico a un dominio sin eventos, o con eventos rotos, parece más arriesgada.

También cuenta el coste: mejores datos significan mejor optimización y, por tanto, un CPA más bajo. Entre nuestros clientes, pasar de "solo Pixel" a "Pixel más CAPI bien deduplicada" reduce el CPA entre un 10 y un 25 % de media.

Pixel o API de Conversiones: qué hace cada uno

Necesitas ambos: el Pixel capta lo que puede en el navegador y la CAPI envía los mismos eventos desde el servidor para no perder nada.

Paso 1: verifica tu dominio

En la configuración del negocio ve a Seguridad de la marca → Dominios y añade tu dominio. Verifícalo con un registro DNS TXT (recomendado) o una metaetiqueta. Así demuestras que el dominio es tuyo, y es necesario para configurar eventos web.

Si usas un Business Manager alquilado, verifica el dominio en el BM que es propietario del Pixel, idealmente el tuyo.

Paso 2: instala el Pixel en el lugar correcto según tu plataforma

El código base es igual en todas partes; lo que cambia es dónde lo pegas. Encuentra el ID del Pixel en el Administrador de eventos → Fuentes de datos → tu Pixel.

Web a medida o HTML estático

Pega el código en la plantilla que comparten todas las páginas, justo antes de la etiqueta de cierre del head. Sustituye YOUR_PIXEL_ID por tu ID.

<script>
!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', 'YOUR_PIXEL_ID');
fbq('track', 'PageView');
</script>

WordPress

Usa el plugin oficial Meta for WordPress (Facebook for WordPress). Conecta tu cuenta de Meta, elige el Pixel y activa la API de Conversiones. Si pegas el código a mano, ponlo en el encabezado y no en el pie, para que PageView se dispare antes de que el visitante se vaya.

Shopify y WooCommerce

Instala el canal de ventas Facebook & Instagram (Shopify) o Facebook for WooCommerce. Elige tu Pixel, ajusta el uso compartido de datos a Máximo y confirma que se envían correo y teléfono. Purchase, AddToCart y ViewContent viajan entonces por el navegador y la CAPI.

Next.js, React y otras aplicaciones de una sola página

Carga el código base una vez en el layout raíz y dispara PageView en cada cambio de ruta. Envía los eventos de conversión desde el componente que gestiona la acción, por ejemplo el manejador del formulario.

// after the form is saved successfully
const eventId = crypto.randomUUID();
fbq('track', 'Lead', { content_name: 'contact-form' }, { eventID: eventId });
await fetch('/api/lead', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ ...formData, eventId }),
});

Google Tag Manager

Crea una etiqueta HTML personalizado con el código base, actívala en Todas las páginas y añade una etiqueta por evento (Lead, Purchase) con su activador. Comprueba en el modo Vista previa que cada etiqueta se dispara una sola vez. Nunca instales el mismo Pixel a la vez por GTM y en el código, o cada evento se contará dos veces.

Los eventos estándar clave: ViewContent en las fichas de producto, AddToCart al añadir al carrito, InitiateCheckout al empezar el pago, Purchase en la página de gracias con valor y moneda, Lead al enviar un formulario. Usa nombres estándar: los eventos personalizados se optimizan peor.

Paso 3: envía los mismos eventos con la API de Conversiones

Tu servidor envía el evento a la Graph API con un token de acceso generado en el Administrador de eventos, en Configuración → API de Conversiones. Guárdalo en una variable de entorno, nunca en código de front-end.

import crypto from 'node:crypto';

const sha256 = (v) =>
  crypto.createHash('sha256').update(String(v).trim().toLowerCase()).digest('hex');

export async function sendLead({ email, phone, eventId, url, ip, userAgent, fbp, fbc }) {
  const body = {
    data: [{
      event_name: 'Lead',
      event_time: Math.floor(Date.now() / 1000),
      event_id: eventId,            // same value the browser sent
      action_source: 'website',
      event_source_url: url,
      user_data: {
        em: [sha256(email)],
        ph: [sha256(phone.replace(/\D/g, ''))],
        client_ip_address: ip,       // not hashed
        client_user_agent: userAgent, // not hashed
        fbp, fbc,                    // not hashed
      },
    }],
    // test_event_code: 'TEST12345', // only while testing
  };
  const res = await fetch(
    `https://graph.facebook.com/v21.0/${process.env.PIXEL_ID}/events?access_token=${process.env.CAPI_TOKEN}`,
    { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify(body) }
  );
  return res.json();
}

Los campos clave son event_name, event_time (segundos Unix), una event_id idéntica a la del navegador, action_source "website", la URL de la página y user_data.

Aplica el hash a los datos personales correctamente

Correo, teléfono, nombre, apellido, ciudad e ID externo deben normalizarse y aplicarse SHA-256: correo sin espacios y en minúsculas, teléfono solo con dígitos incluyendo el prefijo del país, nombres en minúsculas y sin signos. La IP, el user agent, fbp y fbc no llevan hash. Además, lee el fbclid de la URL de la página de destino y guárdalo en una cookie: con él se construye fbc, y así Meta asocia el lead al clic exacto en el anuncio.

Paso 4: deduplica los eventos del navegador y del servidor

Si el Pixel y la CAPI envían ambos un evento Lead, Meta lo cuenta dos veces salvo que deduplices. La regla: mismo event_name y misma event_id desde ambos lados. Genera el ID en el navegador al enviar el formulario, pásalo al Pixel como eventID y envíalo al servidor junto con los datos del formulario para reutilizarlo en la petición CAPI. En el Administrador de eventos verás "Deduplicado".

Paso 5: mejora la calidad de coincidencia de eventos

La calidad de coincidencia (EMQ) indica lo bien que Meta puede asociar tus eventos con personas reales. Envía más identificadores en cada evento del servidor: correo con hash (el mayor impacto), teléfono con hash, fbp y fbc, IP y user agent, e ID externo con hash. Muchos clientes pasan de una EMQ de 4–6 a más de 8 en una semana. Para el tráfico de iOS, ordena tus eventos por prioridad en la medición de eventos agregados y pon arriba el más valioso (Lead o Purchase).

Privacidad y consentimiento en la UE

Para usuarios del Espacio Económico Europeo, el Pixel instala cookies y envía datos personales a Meta. En la práctica necesitas un banner de cookies con consentimiento antes de cargar el Pixel, conforme al RGPD y a las directrices de la AEPD. Técnicamente, el código base solo se ejecuta tras aceptar, por ejemplo con un activador de consentimiento en Tag Manager o con la función de consentimiento de fbq. La CAPI también debería enviar solo datos de quienes han dado su consentimiento. Esto no es asesoramiento legal: pide a un profesional que revise el banner, la política de privacidad y las transferencias de datos.

Qué no debes enviar

• Categorías sensibles como estado de salud o situación financiera en URL, parámetros de evento o nombres de contenido.
• Datos personales sin hash en cualquier parámetro, incluidas las URL. Una página de gracias como /gracias?email=juan@ejemplo.es envía el correo al Pixel automáticamente.
• Eventos de páginas que no son tuyas.

Prueba antes de gastar el primer euro

1. Abre Administrador de eventos → Probar eventos, escribe tu URL y lanza una conversión de prueba.
2. El evento Lead debe aparecer dos veces, como Navegador y como Servidor, fusionadas en una línea marcada "Deduplicado".
3. Comprueba en el resumen que la calidad de coincidencia de Lead sea de al menos 6,0.
4. Instala la extensión de Chrome Meta Pixel Helper. Un icono verde con un solo PageView por página indica que el código base se dispara una vez.
5. Quita el test_event_code antes de salir en producción, para que los eventos reales no se tomen por pruebas.
6. Tras 24 horas, revisa Diagnósticos: parámetros que faltan, eventos duplicados o dominio sin verificar.

Problemas frecuentes y soluciones

Usar tu Pixel con una cuenta de agencia

Cuando usas una cuenta publicitaria con nosotros, el Pixel se queda en tu Business Manager y se comparte con la cuenta de agencia. Datos, audiencias y aprendizaje siguen siendo tuyos. Si hubiera que sustituir la cuenta, compartes el Pixel con la nueva y las campañas continúan con todo el historial. Por eso la instalación del Pixel está incluida en nuestros planes Growth y Scale: consulta los servicios y precios. Combina un tracking sólido con una subida de presupuesto gradual y la fase de aprendizaje termina mucho antes.

Lista de comprobación

• Dominio verificado en el BM propietario del Pixel
• Código base en todas las páginas, PageView en cada cambio de ruta
• Eventos estándar en las acciones clave
• CAPI enviando los mismos eventos con event_id idéntica
• Correo y teléfono con hash SHA-256
• EMQ de 6 o más en el evento principal
• Consentimiento obtenido antes del Pixel (UE)
• Sin datos sensibles en URL ni parámetros

Sigue leyendo: Por qué tu cuenta publicitaria de Facebook sigue siendo baneada y Alquiler de cuenta publicitaria de Facebook: precio y riesgos.

¿Prefieres no hacerlo tú? HD Agency instala el Pixel, verifica tu dominio y configura la API de Conversiones deduplicada. Escríbenos por Telegram o WhatsApp, respuesta en unos 5 minutos. Mira también las soluciones por sector.