Meta, Pixel y Conversions API

Despacho server-side a Meta. Pixel-ID emparejado con un token CAPI de larga duración. Opcional modo híbrido para cookies first-party fbp/fbc.

Requisitos

• Cuenta de Meta Business con un Pixel asociado a tu dominio.
• Permiso de Admin o "Gestionar Pixel" sobre el Pixel.
• Aproximadamente 5 minutos.

1. Encontrar el Pixel-ID

• Abre Meta Events Manager en business.facebook.com/events_manager.
• Selecciona el Pixel que debe recibir los eventos de Beaconry.
• El Pixel-ID (16 dígitos) aparece arriba. Cópialo.

2. Generar un token de Conversions API

• En la misma vista del Pixel: Configuración → Conversions API → Configurar integración directa → Con Dataset Quality API.
• Haz clic en Generar Access Token.
• Importante: en el selector de scope, marca solo el Pixel para esta instalación de Beaconry. No otorgues el token a otros Pixels.
• Verifica que la respuesta diga Expira: Nunca. Beaconry necesita un token de System User de larga duración, no un token Graph de 60 minutos.
• Copia el token inmediatamente. Meta lo muestra solo una vez.

3. Pegar credenciales en Beaconry

WordPress Admin → Beaconry → Tracking → Meta. Pega Pixel-ID y token, guarda.

El token se guarda cifrado en reposo (AES-256-CBC, ligado a los auth salts de WordPress). Alternativa con constantes: BCNR_META_PIXEL_ID y BCNR_META_CAPI_TOKEN en wp-config.php.

4. (Opcional) Definir un Test Event Code

En staging: en Meta Events Manager → pestaña Test Events, copia el código TEST*. Pégalo en el campo "Test Event Code" de Beaconry. Cada evento que Beaconry envíe quedará taggeado con ese código y se enrutará a Test Events en lugar de irse a producción.

Quita el código antes del lanzamiento de la campaña, si no las conversiones reales no llegan al reporting.

5. Enviar el evento de prueba

Haz clic en Enviar evento de prueba de Meta. Beaconry dispara un ViewContent síncrono vía CAPI y reporta la respuesta inline.

HTTP 200 sin errores significa que las credenciales funcionan. Con Test Event Code definido, el evento aparece en Events Manager → Test Events en pocos segundos. Sin código, aparece en Reports → Realtime en ~30 segundos.

6. Ajustes recomendados de Meta

Estos están en Meta, no en Beaconry. Desbloquean el match-rate y evitan trampas comunes.

Obligatorio:

• Verificación de dominio: Configuración del Negocio → Brand Safety → Dominios. iOS 14.5+ lo exige para cualquier atribución.
• Lista de dominios de confianza: Pixel → Configuración → Permisos de Tráfico. Añade cada dominio de producción desde el que anuncies.
• Aggregated Event Measurement: hasta 8 eventos prioritarios por dominio verificado, ordenados por importancia (Purchase > SubmitApplication > Lead > ViewContent).

Apaga:

• Automatic Advanced Matching: riesgo RGPD. Beaconry hashea los mismos campos server-side bajo control.
• Tracking automático sin código: la heurística colisiona con los eventos explícitos de Beaconry.
• Conversions API Gateway / Signals Gateway: Beaconry es la integración directa CAPI.

7. (Opcional) Modo híbrido

CAPI server-side por sí sola cubre el 100 por ciento de los visitantes con consentimiento. El modo híbrido carga fbevents.js en paralelo para que Meta vea las cookies first-party fbp y fbc. Beaconry deduplica navegador y servidor con el mismo event_id estable.

Activar en Beaconry → Tracking → Meta → Modo híbrido. Mejor match-rate, algo más de bytes para el visitante. Apagado por defecto.

Qué se envía automáticamente

• PageView en cada page-load con consentimiento.
• ViewContent al 50% de scroll más 10 segundos.
• Lead en cada envío de Kadence Blocks Form o Fluent Forms.
• Funnel WooCommerce: AddToCart, InitiateCheckout, Purchase. event_id estable por orden para deduplicación con el browser pixel.

Troubleshooting

• "Invalid OAuth access token": token de corta duración. Regenera con "Expira: Nunca".
• Eventos no en Test Events: el Test Event Code falta o ha expirado. Genera uno nuevo.
• Match Quality "Pobre": falta verificación de dominio o setup AEM en Meta. Beaconry envía los campos correctos, Meta necesita confianza de dominio para usarlos.