Añada Zenovay a cualquier publicación de Ghost en dos minutos. Code Injection está disponible en todos los planes de Ghost, incluido Ghost CMS autoalojado — no se requiere actualización.
Code Injection está disponible en todos los planes de Ghost, incluido Ghost CMS autoalojado. Los temas personalizados necesitan el helper {{ghost_head}} en default.hbs (la mayoría de los temas ya lo incluyen).
Inicio rápido
- Copie su fragmento de seguimiento desde el panel de Zenovay.
- En su admin de Ghost, abra Settings → Code injection → Site Header.
- Pegue el fragmento.
- Haga clic en Save.
Instalación
Inyección en el Site Header (recomendado)
- Inicie sesión en su admin de Ghost (normalmente
https://su-sitio.com/ghost/). - Haga clic en Settings (icono de engranaje).
- Desplácese hasta Site → Code injection.
- Pegue este fragmento en el campo Site Header:
<script defer data-tracking-code="YOUR_TRACKING_CODE" src="https://api.zenovay.com/z.js"></script>
- Haga clic en Save.
Inyección por entrada / por página
Para rastrear solo una entrada específica:
- Abra la entrada en el editor.
- Haga clic en el icono de engranaje (configuración) en la parte superior derecha.
- Expanda Code injection.
- Pegue el fragmento en Post Header.
- Update la entrada.
No lo pegue en ambos, en todo el sitio y por entrada — contará doble.
Verificar la instalación
- Abra su sitio Ghost en una ventana de incógnito.
- Vea el código fuente y busque
<script defer data-tracking-code=...>en el<head>. - Compruebe la vista en tiempo real de Zenovay — su visita aparece en ~30 segundos.
Identificar miembros de Ghost
Ghost expone el miembro actual a través de /members/api/member/. Identifique en cada página:
<script>
fetch('/members/api/member/', { credentials: 'include' })
.then(r => r.ok ? r.json() : null)
.then(member => {
if (member && window.zenovay) {
window.zenovay('identify', member.uuid, {
email: member.email,
name: member.name,
plan: member.subscriptions?.[0]?.plan?.nickname,
});
}
})
.catch(() => {});
</script>
Seguimiento de suscripciones al boletín
Los formularios de suscripción de Ghost emiten un evento estándar submit:
<script>
document.addEventListener('DOMContentLoaded', () => {
document.addEventListener('submit', (e) => {
const form = e.target;
if (form?.matches('[data-members-form]')) {
window.zenovay?.('track', 'signup', {
form_type: form.dataset.membersForm || 'signup',
});
}
}, true);
});
</script>
Seguimiento de clics en suscripciones de pago
Ghost renderiza los botones activadores del portal con atributos data-portal:
<script>
document.addEventListener('click', (e) => {
const target = e.target.closest('[data-portal]');
if (target && window.zenovay) {
window.zenovay('track', 'portal_opened', {
action: target.dataset.portal,
});
}
}, true);
</script>
Para una atribución de ingresos precisa en membresías de pago, use la integración de webhook de Stripe de Ghost y envíe los eventos de Stripe a Zenovay a través del seguimiento del lado del servidor.
Trabajo con temas de Ghost personalizados
El Code Injection se renderiza a través del helper Handlebars {{ghost_head}}. Si usa un tema personalizado, asegúrese de que default.hbs contenga:
{{ghost_head}}
…dentro del <head>, antes de </head>. La mayoría de los temas de Ghost de terceros (Casper, Source, Edition, etc.) lo incluyen por defecto.
Resolución de problemas
Sin datos, tema personalizado. Verifique que {{ghost_head}} esté presente en su default.hbs. Sin él, el Code Injection no tiene dónde renderizarse.
Sin datos en URLs /amp/. Si ha habilitado la integración Ghost AMP, el Code Injection no se aplica a las variantes AMP (AMP elimina los scripts arbitrarios). Desactive AMP o acepte que el tráfico AMP no se rastrea.
Vistas de página duplicadas. Fragmento pegado tanto en Site Header como en Code Injection por entrada. Elija un solo ámbito.
Los miembros nunca se identifican. /members/api/member/ devuelve 404 en versiones antiguas de Ghost (< 4.x). Actualice su instalación de Ghost.
Requisitos del plan
| Edición de Ghost | Code Injection | Temas personalizados |
|---|---|---|
| Ghost(Pro) Starter | ✅ | ❌ (solo Casper) |
| Ghost(Pro) Creator | ✅ | ✅ |
| Ghost(Pro) Team / Business | ✅ | ✅ |
| Ghost CMS autoalojado | ✅ | ✅ |
Privacidad
Para el seguimiento sin cookies añada data-cookieless="true":
<script defer
data-tracking-code="YOUR_TRACKING_CODE"
data-cookieless="true"
src="https://api.zenovay.com/z.js"></script>
Las propias analíticas de miembros de Ghost usan cookies first-party de todos modos, por lo que combinar Zenovay en modo sin cookies es un patrón habitual.
Siguientes pasos
- Lea la guía completa de integración con Ghost en docs.zenovay.com para configuraciones avanzadas que incluyen trabajo con temas personalizados y seguimiento de webhooks de Stripe del lado del servidor.
- Configure objetivos de conversión.
- ¿Necesita ayuda? Contacte a [email protected].