Ajoutez Zenovay à n'importe quelle publication Ghost en deux minutes. Code Injection est disponible sur tous les plans Ghost, y compris Ghost CMS auto-hébergé — aucune mise à niveau requise.
Code Injection est disponible sur tous les plans Ghost, y compris Ghost CMS auto-hébergé. Les thèmes personnalisés ont besoin du helper {{ghost_head}} dans default.hbs (la plupart des thèmes l'ont déjà).
Démarrage rapide
- Copiez votre snippet de suivi depuis le tableau de bord Zenovay.
- Dans votre admin Ghost, ouvrez Settings → Code injection → Site Header.
- Collez le snippet.
- Cliquez sur Save.
Installation
Injection dans le Site Header (recommandée)
- Connectez-vous à votre admin Ghost (généralement
https://your-site.com/ghost/). - Cliquez sur Settings (icône d'engrenage).
- Faites défiler jusqu'à Site → Code injection.
- Collez ce snippet dans le champ Site Header :
<script defer data-tracking-code="YOUR_TRACKING_CODE" src="https://api.zenovay.com/z.js"></script>
- Cliquez sur Save.
Injection par article / par page
Pour ne suivre qu'un article spécifique :
- Ouvrez l'article dans l'éditeur.
- Cliquez sur l'icône d'engrenage (paramètres) en haut à droite.
- Développez Code injection.
- Collez le snippet dans Post Header.
- Mettez à jour l'article.
Ne collez pas dans les deux portées (global et par article) — vous double-compterez.
Vérifier votre installation
- Ouvrez votre site Ghost dans une fenêtre de navigation privée.
- Consultez le code source et recherchez
<script defer data-tracking-code=...>dans le<head>. - Vérifiez la vue en temps réel Zenovay — votre visite apparaît en ~30 secondes.
Identifier les membres Ghost
Ghost expose le membre actuel via /members/api/member/. Identifiez sur chaque page :
<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>
Suivi des inscriptions à la newsletter
Les formulaires d'inscription Ghost émettent un événement submit standard :
<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>
Suivi des clics sur les abonnements payants
Ghost affiche les boutons de déclenchement du portail avec des attributs 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>
Pour une attribution de revenus précise sur les adhésions payantes, utilisez l'intégration webhook Stripe de Ghost et envoyez les événements Stripe à Zenovay via le suivi côté serveur.
Utilisation avec des thèmes Ghost personnalisés
Code Injection s'affiche via le helper Handlebars {{ghost_head}}. Si vous utilisez un thème personnalisé, assurez-vous que default.hbs contient :
{{ghost_head}}
…dans le <head>, avant </head>. La plupart des thèmes Ghost tiers (Casper, Source, Edition, etc.) l'incluent par défaut.
Dépannage
Pas de données, thème personnalisé. Vérifiez que {{ghost_head}} est présent dans votre default.hbs. Sans lui, Code Injection n'a nulle part où s'afficher.
Pas de données sur les URL /amp/. Si vous avez activé l'intégration Ghost AMP, Code Injection ne s'applique pas aux variantes AMP (AMP supprime les scripts arbitraires). Désactivez AMP ou acceptez que le trafic AMP ne soit pas suivi.
Pages vues en double. Snippet collé à la fois dans Site Header et dans Code Injection par article. Choisissez une seule portée.
Membres jamais identifiés. /members/api/member/ retourne 404 sur les versions Ghost plus anciennes (< 4.x). Mettez à jour votre installation Ghost.
Exigences du plan
| Édition Ghost | Code Injection | Thèmes personnalisés |
|---|---|---|
| Ghost(Pro) Starter | ✅ | ❌ (Casper uniquement) |
| Ghost(Pro) Creator | ✅ | ✅ |
| Ghost(Pro) Team / Business | ✅ | ✅ |
| Ghost CMS auto-hébergé | ✅ | ✅ |
Confidentialité
Pour un suivi sans cookies, ajoutez data-cookieless="true" :
<script defer
data-tracking-code="YOUR_TRACKING_CODE"
data-cookieless="true"
src="https://api.zenovay.com/z.js"></script>
Les propres analytics de membres de Ghost utilisent de toute façon des cookies first-party, donc superposer Zenovay en mode sans cookies est un schéma courant.
Prochaines étapes
- Lisez le guide complet d'intégration Ghost sur docs.zenovay.com pour les configurations avancées incluant le travail sur les thèmes personnalisés et le suivi des webhooks Stripe côté serveur.
- Configurez des objectifs de conversion.
- Besoin d'aide ? Contactez [email protected].