Instalar y activar Beaconry

Quince minutos desde el clic en "Comprar" hasta tu primera conversión en Meta Events Manager. Sin GTM, sin Stape, sin FTP.

1. Comprar una licencia

Elige un tier en la página de precios. Polar procesa el checkout como Merchant of Record (gestiona el IVA para compradores UE). En uno o dos minutos tras el pago recibirás dos emails:

• El recibo de Polar con tu clave de licencia.
• Un enlace de descarga directa a la última beaconry.zip.

Tu clave de licencia tiene la forma polar_li_*. Guárdala. La .zip siempre refleja la última versión publicada, no necesitas descargar otra para futuras actualizaciones.

2. Comprobar requisitos del sistema

• WordPress 6.4 o más reciente.
• PHP 8.3 o más reciente (Beaconry usa type-hints y enums modernos).
• HTTPS en el sitio WordPress (los requests CAPI server-side deben salir desde un endpoint TLS).
• HTTPS saliente permitido a graph.facebook.com, business-api.tiktok.com, googleads.googleapis.com, api.linkedin.com y www.google-analytics.com (Beaconry solo llama a las plataformas que efectivamente configures).

La mayoría de hostings WordPress gestionados permiten HTTPS saliente por defecto. Si corres en un VPC con firewall estricto, pide al admin de red abrir los endpoints de plataforma que vayas a usar.

3. Instalar el plugin

WordPress Admin → Plugins → Añadir nuevo → Subir plugin. Selecciona beaconry.zip. Haz clic en Activar plugin.

Ahora tienes un nuevo menú de admin de nivel superior llamado Beaconry con cinco pestañas: Dashboard, Tracking, Forms, Advanced, Logs.

4. Activar la licencia

Ve a Beaconry → Dashboard. La tarjeta superior pide tu clave de licencia. Pega la clave polar_li_* del recibo de Polar y haz clic en Activar.

Beaconry llama una vez al validador central de Beaconry (un Cloudflare Worker), valida la clave contra la API de Polar, cachea el resultado y conmuta el dashboard de "Inactivo" a "Activo". La activación es por sitio, no por red WordPress. Tu tier (Solo / Studio / Agency) define cuántos sitios de producción puede activar la misma clave.

Power user: si prefieres mantener la clave fuera de la base de datos, define BCNR_LICENSE_KEY en wp-config.php. La constante prevalece sobre lo guardado en wp_options.

5. Conectar tu primer canal

La pestaña Tracking lista los cinco canales con un pill de estado por cada uno. Elige aquel donde inviertas más presupuesto publicitario. El orden por defecto en el UI es Meta, TikTok, Google Ads, LinkedIn, GA4, pero puedes configurarlos en cualquier orden, de forma independiente.

Cada canal tiene su propia guía de setup:

• Meta, Pixel + Conversions API
• Google Ads, Conversion Tracking + CAPI
• TikTok, Pixel + Events API (en inglés)
• LinkedIn, Insight Tag + Conversions API (en inglés)
• GA4, Measurement Protocol (en inglés)

6. Enviar un evento de prueba

Cada canal tiene un botón Enviar evento de prueba en la pestaña Tracking. Haz clic después de guardar credenciales. El botón dispara un ViewContent síncrono (o equivalente por plataforma) y reporta la respuesta de la plataforma inline.

HTTP 200 con code: 0 (o el éxito específico de plataforma) significa que las credenciales están correctas. HTTP 4xx significa una credencial mala. La pestaña Logs guarda los últimos 200 dispatches con el payload completo de request y response.

7. Decidir sobre el modo híbrido

Cada canal tiene un toggle "Modo híbrido". Server-side por sí solo cubre el 100 por ciento de los visitantes que dan consentimiento (ningún adblocker puede bloquear /wp-json/). El modo híbrido carga adicionalmente el pixel del navegador de la plataforma para que las cookies first-party (fbp, _ttp, li_fat_id) estén disponibles. Beaconry deduplica los eventos de navegador y servidor con el mismo event_id estable.

Recomendado: deja el modo híbrido apagado hasta que realmente necesites cookies first-party para mejorar el match-rate. La pipeline server-side es el default más seguro y envía menos bytes al visitante.

Qué viene después

Una vez activo un canal, cada compra de WooCommerce, lead de Kadence Form y envío de Fluent Forms se dispara automáticamente a través de Beaconry. La documentación detallada de despacho server-side, adblock-immune, license-gate, troubleshooting y FAQ está actualmente en inglés.