Installation de Kixell Tag

L'installation de Kixell Tag se déroule en quelques étapes : téléchargez le fichier du module depuis votre compte, déployez-le sur votre boutique PrestaShop, vérifiez les hooks de votre thème, puis activez votre licence. Suivez les instructions ci-dessous ; en cas de difficulté, la section Résolution des problèmes courants en fin de page liste les points à vérifier.

Prérequis

Avant de commencer, assurez-vous de disposer de :

un accès administrateur au back-office PrestaShop ;
PHP 5.6 ou une version supérieure ;
la possibilité d'uploader un fichier de plus de 2 Mo depuis le back-office, ou d'un accès FTP/SFTP au répertoire modules ;
les trois hooks d'affichage présents dans votre thème (détaillés plus bas).

Télécharger le module

Pour télécharger le module depuis votre interface, suivez les étapes suivantes :

Accédez à Mon Compte.
Sélectionnez Mes licences.
Cliquez sur la licence concernée.
Cliquez sur le bouton Télécharger le plugin.

Le fichier kixelltag.zip obtenu doit être déployé dans son intégralité. Vous pouvez l'uploader via le backoffice ou le déployer par FTP/SFTP dans le répertoire modules de votre site.

Note : Le fichier kixelltag.zip, supérieur à 2 Mo, doit être déployé dans son intégralité. Si votre configuration serveur n'accepte pas cette taille de fichier en upload, préférez le déploiement par FTP/SFTP dans le répertoire modules de votre site.

Activer la licence

Voir la gestion des licences Kixell Tag

Vérification ou ajout des hooks sur votre boutique

Assurez-vous que les hooks suivants sont présents dans votre thème :

{hook h='displayAfterTitleTag'} après la balise </title>.
{hook h='displayAfterBodyOpeningTag'} après l'ouverture de la balise <body>.
{hook h='displayBeforeBodyClosingTag'} avant la fermeture de la balise </body>.

Ces hooks sont essentiels pour le fonctionnement du module.

Télécharger les configurations exemples pour Google Tag Manager (GTM)

Il y a deux options pour déployer une configuration GTM : Client Side ou Server Side. Pour le déploiement Client Side, un seul fichier JSON est nécessaire, tandis que pour le Server Side, deux fichiers JSON sont requis.

Nous fournissons des fichiers JSON pour accélérer le déploiement d'une configuration initiale. Ces configurations sont conçues pour vous faire gagner du temps, mais vous pouvez tout à fait créer votre propre configuration ou modifier celle existante.

JSON Google Tag Manager Client Side

Pour télécharger le fichier JSON pour GTM Client Side depuis votre interface :

Accédez à Mon Compte.
Sélectionnez Mes licences.
Cliquez sur la licence concernée.
Cliquez sur le bouton Télécharger le JSON GTM Client Side.

Accéder à la configuration de GTM Client Side

JSON Google Tag Manager Server Side

Pour télécharger les fichiers JSON pour GTM Server Side depuis votre interface :

Accédez à Mon Compte.
Sélectionnez Mes licences.
Cliquez sur la licence concernée.
Cliquez sur le bouton Télécharger le JSON GTM Client Side pour GTM Server Side.
Cliquez sur le bouton Télécharger le JSON GTM Server Side.

Accéder à la configuration de GTM Server Side

Résolution des problèmes courants

Si l'installation ne se déroule pas comme prévu, vérifiez les points suivants :

Le fichier kixelltag.zip est refusé à l'upload : sa taille (supérieure à 2 Mo) dépasse souvent la limite upload_max_filesize du serveur. Déployez-le alors par FTP/SFTP dans le répertoire modules.
Le module est installé mais rien ne se déclenche : vérifiez que les trois hooks sont bien présents dans votre thème (displayAfterTitleTag, displayAfterBodyOpeningTag, displayBeforeBodyClosingTag).
Les balises ne remontent pas : assurez-vous que votre licence est activée et que Google Tag Manager est correctement configuré.
Une mise à jour ne s'applique pas : utilisez Forcer la mise à jour depuis le menu Settings, puis videz le cache de PrestaShop.