Guide du module Gestionnaire de publicités pour Larapen

Diffusez votre propre publicité sur votre propre site. Définissez les emplacements que propose votre thème, remplissez-les de bannières maison, de blocs HTML ou d’une balise publicitaire tierce, décidez qui voit quoi, et consultez les impressions et les clics dans le panneau d’administration.

Cas d’utilisation

Vendre de l’espace directement à des sponsors

Le cas pour lequel les plafonds et la planification ont été conçus.

• Créez pour chaque sponsor une campagne avec ses coordonnées et les dates convenues.
• Plafonnez la campagne au nombre d’impressions payées ; elle s’arrête d’elle-même une fois ce nombre atteint.
• Envoyez-lui l’export CSV à la fin du mois comme preuve de diffusion.

Monétiser avec une régie publicitaire

Collez la balise de la régie une fois par emplacement et laissez-la tourner.

• Le code de la régie attend le consentement marketing du visiteur, puis se charge sans rechargement de la page.
• Faites tourner deux régies dans le même emplacement pour les comparer.
• Affichez plutôt une publicité maison lorsqu’un bloqueur de publicités fait disparaître la création de la régie.

Promouvoir vos propres produits

L’annonceur le moins cher, c’est vous.

• Placez un bloc HTML dans l’emplacement dans l’article de votre blog et faites-le pointer vers une page d’atterrissage.
• Ciblez uniquement les visiteurs non connectés, pour ne pas proposer à vos clients un produit qu’ils possèdent déjà.
• Consultez le taux de clics pour savoir quelle formulation fonctionne.

Campagnes géographiques et saisonnières

Des créations différentes pour des publics différents, depuis un seul endroit.

• Diffusez une bannière en France et une autre partout ailleurs.
• Servez une création étroite aux téléphones et une création large aux ordinateurs.
• Planifiez une campagne saisonnière plusieurs semaines à l’avance ; elle démarre et s’arrête toute seule.

Prérequis

• Larapen CMS v1.0.0 ou ultérieur
• PHP 8.3+
• MySQL 8.0+

Installation

Étape 1 : Téléverser l’add-on

Dans le panneau d’administration, allez dans Admin → Extensions → Add-ons et cliquez sur le bouton Télécharger un add-on. Sélectionnez le fichier ZIP de l’add-on : le système le décompresse automatiquement et l’add-on apparaît dans la liste des add-ons installés.

Étape 2 : Activer l’add-on

Repérez Ad Manager dans la liste et cliquez sur Activer. Ses migrations et ses permissions sont mises en place automatiquement, sept zones prêtes à l’emploi sont créées, et un exemple de campagne maison est ajouté en brouillon pour que vous ayez quelque chose à examiner.

Étape 3 : Placer une zone

Rien n’est montré aux visiteurs tant qu’aucune zone n’apparaît sur une page. Ajoutez une balise de zone à votre thème (voir Ajouter une zone à un thème), ou activez le placement automatique en haut ou en bas de chaque page.

Code d’achat (clé de licence)

Ad Manager est vendu comme un produit séparé, il possède donc son propre code d’achat (clé de licence), distinct du code d’achat de l’application principale et de celui de chaque autre add-on. Il vous est demandé lorsque vous activez Ad Manager dans Panneau d’administration → Add-ons.

Nos produits sont vendus sur trois plateformes. La façon dont vous recevez un code d’achat dépend de l’endroit où vous avez acheté le produit.

1. Boutique bedigit.com (achat sur le site)

• Dès que le statut de paiement de la commande devient Payée, une clé de licence est générée automatiquement pour chaque article sous licence de la commande (une clé par unité achetée : acheter 3 unités donne 3 clés distinctes).
• Elle est envoyée par e-mail à l’adresse utilisée pour la commande, soit dans un e-mail de licence dédié, soit dans l’e-mail de confirmation de commande. Vérifiez votre boîte de réception et votre dossier spam / courrier indésirable.
• La clé reste disponible dans votre compte sous Mon compte → Mes licences. Les clés sont masquées dans la liste ; ouvrez la page de détail de la licence pour afficher et copier la clé complète, voir les domaines sur lesquels elle est activée, et désactiver un domaine pour libérer un emplacement d’activation.
• La facture correspondante se trouve sous Mon compte → Mes commandes.

2. Gumroad

• Un achat sur Gumroad produit deux e-mails distincts : le reçu Gumroad (envoyé par Gumroad, donnant accès aux fichiers) et un e-mail de clé de licence (envoyé par bedigit.com) qui contient votre code d’achat.
• L’e-mail de clé de licence est généré dès que Gumroad nous notifie la vente, il arrive donc normalement quelques secondes après le paiement. Ici aussi, vérifiez votre boîte de réception et votre dossier spam / courrier indésirable.
• Lorsque le produit Gumroad utilise la fonctionnalité de clés de licence propre à Gumroad, la même clé apparaît aussi dans votre reçu Gumroad et sous Bibliothèque dans votre compte Gumroad.
• La clé est également enregistrée sur votre compte bedigit.com, sous Mon compte → Mes licences.

3. Envato Market (CodeCanyon)

• Envato délivre lui-même le code d’achat. Nous ne l’envoyons jamais par e-mail, car nous ne le recevons pas.
• Récupérez-le depuis votre compte Envato : Downloads → trouvez l’article → License certificate & purchase code (la version texte comme la version PDF le contiennent).
• Il ressemble à xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.

Démarrage rapide

Afficher une première publicité à l’écran prend environ trois minutes.

1. Allez dans Admin → Régie pub → Paramètres → Placement automatique et réglez Injecter en bas de chaque page sur Pied de page (bas de page). Enregistrez.
2. Allez dans Admin → Régie pub → Campagnes et cliquez sur Nouvelle campagne. Donnez-lui un nom, réglez le statut sur Active et enregistrez.
3. Allez dans Admin → Régie pub → Publicités et cliquez sur Nouvelle publicité.
4. Choisissez Bloc HTML, collez un peu de balisage et indiquez une URL de destination.
5. Ouvrez l’onglet Placement et cochez Pied de page (bas de page).
6. Réglez le statut sur Active et enregistrez.

Ouvrez votre site dans une fenêtre de navigation privée : la publicité se trouve en bas de la page. Revenez dans Admin → Régie pub → Tableau de bord : l’impression est déjà comptabilisée.

Zones

Une zone est un emplacement nommé sur vos pages. Elle détermine où une publicité peut apparaître, combien de publicités partagent l’emplacement, comment elles se relaient, et ce qui s’affiche lorsqu’il n’y a rien à montrer. Les publicités ne sont jamais placées directement sur une page : elles sont réservées dans des zones.

Gérez-les dans Admin → Régie pub → Zones.

Zones intégrées

Sept zones sont créées à l’activation de l’add-on. Renommez-les, redimensionnez-les, désactivez celles dont vous n’avez pas besoin, et ajoutez les vôtres.

Paramètres d’une zone

Modes de rotation

• Aléatoire : chaque publicité éligible a la même chance à chaque affichage de page.
• Pondérée : les publicités sont tirées au sort proportionnellement à leur poids. Le poids d’une publicité est multiplié par celui de sa campagne : vous pouvez donc fixer une part une fois par sponsor tout en la répartissant entre ses créations.
• Séquentielle : les publicités se relaient, l’une après l’autre, dans l’ordre.

Ajouter une zone à un thème

Les zones apparaissent là où votre thème les place. Ouvrez le gabarit sur lequel vous voulez afficher des publicités et insérez la balise de zone. Les deux formes ci-dessous font exactement la même chose, utilisez celle qui se lit le mieux à cet endroit :

<x-admanager::zone key="sidebar_top" />

{!! ad_zone('sidebar_top') !!}

La balise exacte de chaque zone figure sur sa page d’édition, avec un bouton de copie, ainsi que dans la liste des zones. Quelques points à savoir :

• La balise ne produit absolument rien, pas même un conteneur vide, lorsque la zone est inconnue, désactivée, n’a aucune publicité à diffuser, ou que le visiteur est exempté de publicités. Vous n’avez jamais besoin de l’entourer d’une condition.
• Ajoutez un espacement avec l’attribut class : <x-admanager::zone key="sidebar_top" class="my-5" />.
• Une page peut contenir autant de zones que vous le souhaitez, et la même zone deux fois si cela a du sens dans votre mise en page.
• Tout ce dont l’emplacement a besoin, ses styles et son petit script, est ajouté à la page automatiquement, une seule fois, quel que soit le nombre de zones.

Dans un article

L’emplacement dans l’article se place entre deux paragraphes d’un contenu rédigé par quelqu’un, ce qu’une balise de gabarit ne peut pas faire seule. Enveloppez plutôt le contenu :

{!! ad_zone_in_content($post->content, 'in_article') !!}

La zone est insérée après le nombre de paragraphes configuré sur elle (trois par défaut). Si le contenu compte moins de paragraphes, l’emplacement est placé à la fin plutôt que d’être abandonné. Lorsque l’add-on est désactivé, ou que la zone n’a rien à diffuser, le contenu est renvoyé intact.

Placements prêts à l’emploi

Les pages des add-ons Blog, Forum, Glossaire, Petites annonces, Événements et Carrières intègrent déjà les zones, dans chaque thème fourni. Dès que vous réservez une publicité dans l’une de ces zones, elle s’y affiche ; il n’y a aucun gabarit à modifier. Sur un site sans Ad Manager, ces pages restent exactement identiques.

L’emplacement dans l’article ne se place que dans le texte principal de la page : le corps d’un article, l’explication détaillée d’un terme, la description d’une annonce ou d’un événement, la description d’une offre d’emploi, ou le premier message d’une discussion du forum (jamais les réponses). Les emplacements de barre latérale se trouvent sous la carte principale de la page, comme Contacter le vendeur ou S’inscrire, pour que la publicité ne repousse jamais cette carte vers le bas. La page d’offre d’emploi fait exception : sa carte de détails suit le lecteur vers le bas de la page, sa publicité se place donc au-dessus.

Pages des outils

Les add-ons d’outils (outils d’image, outils PDF, etc.) disposent de leurs propres emplacements publicitaires, en haut et en bas de leurs pages, gérés dans l’onglet Paramètres → Publicités de chaque groupe d’outils. Lorsque Ad Manager est actif, chaque placement y gagne un choix Source des publicités :

• Code publicitaire : le code publicitaire collé dans cet onglet, comme auparavant. C’est la valeur par défaut.
• Zone Ad Manager : le placement affiche ce qu’Ad Manager diffuse dans la zone choisie. Par défaut, le placement du haut utilise before_content et celui du bas after_content ; choisissez n’importe quelle autre zone, ou créez des zones réservées aux pages des outils si vous voulez les vendre séparément.

Les interrupteurs Afficher sur du placement (page de liste des outils, page d’outil) déterminent toujours où il apparaît. Si la zone n’a rien à afficher, le code publicitaire collé est utilisé à la place : vous pouvez ainsi garder une publicité de régie en secours. Pour limiter une publicité aux pages des outils, ciblez les types de page Hubs d’outils et Pages d’outils, ou choisissez un ou plusieurs groupes d’outils pour n’atteindre que ces outils.

Placement automatique

Si vous préférez ne toucher à aucun gabarit, deux paramètres dans Admin → Régie pub → Paramètres → Placement automatique placent une zone tout en haut ou tout en bas de chaque page du site :

• Injecter en haut de chaque page : placée juste après la balise body ouvrante.
• Injecter en bas de chaque page : placée juste avant la balise body fermante.

Les deux sont désactivés par défaut, et tous deux sont indépendants des balises de zone déjà présentes dans votre thème : un site peut utiliser l’un, l’autre, ou les deux. Les pages du panneau d’administration ne sont jamais modifiées.

Publicités

Une publicité est une création : une bannière, un bloc HTML ou une balise de régie publicitaire. Chaque publicité appartient à une campagne et est réservée dans une ou plusieurs zones.

Créez-les dans Admin → Régie pub → Publicités. Le formulaire comporte trois onglets : la Création, son Placement et son Ciblage.

Bannières image

Le format classique. Choisissez la création dans la médiathèque, indiquez une URL de destination, et l’add-on s’occupe du reste.

• Une bannière mobile facultative est affichée à la place de la principale en dessous de 576px, pour qu’un large leaderboard ne se réduise pas à une bande illisible sur un téléphone.
• Le texte alternatif est traduisible et décrit la bannière aux lecteurs d’écran et à toute personne dont les images ne se chargent pas.
• Les dimensions réelles de la création sont lues à l’enregistrement et inscrites dans le balisage : le navigateur réserve ainsi l’espace exact et la page ne bouge jamais à l’arrivée de l’image. Lorsque la médiathèque a généré des copies plus petites de l’image, elles sont aussi proposées au navigateur : un téléphone télécharge donc un fichier à sa taille.
• Les clics passent par un bref relais de suivi avant d’arriver à destination, ce qui rend possibles les chiffres de clics.

Blocs HTML

Votre propre balisage : une annonce textuelle, un encart promotionnel, une carte stylisée, tout ce que vous savez écrire. Il est rendu exactement tel que vous l’avez saisi.

• Indiquez une URL de destination et le bloc entier devient un lien suivi. Laissez l’URL vide et il est affiché tel quel, sans suivi, ce qui est utile pour un avis plutôt que pour une publicité.
• Comme le bloc est enveloppé dans un lien lorsque vous indiquez une URL, n’y placez pas de lien de votre cru.

Code de régie publicitaire

La balise fournie par votre régie publicitaire, collée telle quelle. La régie affiche la publicité et compte ses propres clics.

• Les impressions sont tout de même comptabilisées de votre côté : vous pouvez comparer les chiffres de la régie avec les vôtres.
• Les clics ne le sont pas : la balise de la régie apporte son propre lien, qui ne passe jamais par cet add-on. Consultez-les dans le tableau de bord de la régie.
• C’est le seul format qui attend le consentement aux cookies. Voir Consentement aux cookies.

Autres paramètres de publicité

• Attribut rel du lien : les moteurs de recherche attendent qu’un lien payant porte sponsored. La valeur par défaut du site est utilisée, sauf si vous la remplacez sur la publicité.
• Ouvrir dans un nouvel onglet : activé par défaut, pour que votre visiteur conserve la page qu’il lisait.
• Poids : la part d’une rotation pondérée que prend cette création.
• Ordre : départage les publicités, la plus basse en premier.
• Aperçu : ouvre la création seule pour que vous puissiez la vérifier avant sa mise en ligne. Un aperçu ne compte jamais d’impression.
• Dupliquer : copie la publicité et ses réservations de zones en brouillon, pour créer rapidement une variante.

Campagnes & plafonds

Une campagne regroupe des publicités sous un annonceur, un calendrier et un budget. Chaque publicité appartient à une campagne. Si vous ne diffusez que des publicités maison, une seule campagne intitulée “Publicités maison” est parfaitement raisonnable.

L’annonceur

Nom, e-mail, téléphone, site web et une note libre. Ce sont des coordonnées pour votre propre référence : les annonceurs n’ont pas de compte, ne peuvent pas se connecter et ne voient jamais le panneau d’administration.

Le calendrier

Début et Fin sont tous deux facultatifs. Une campagne sans l’un ni l’autre tourne aussi longtemps que son statut est Active. Une campagne qui n’a pas encore commencé, ou dont la date de fin est passée, ne diffuse rien : vous n’avez pas à penser à la désactiver.

Les plafonds

Quatre limites facultatives, combinables à volonté :

La liste des campagnes indique pourquoi une campagne s’est arrêtée d’elle-même, et la page d’édition le répète. Pour relancer une campagne terminée, augmentez ou supprimez le plafond et remettez son statut sur Active.

Poids et priorité

• Le poids multiplie le poids de chaque publicité de la campagne, dans les zones réglées en rotation pondérée. Un sponsor qui achète deux fois la part d’un autre ne demande de modifier qu’un seul nombre, pas cinq.
• La priorité départage les campagnes ; la plus élevée passe en premier.

Ciblage

Le ciblage restreint qui voit une publicité et où. Il se configure sur la publicité, dans son onglet Ciblage.

Pages & URL

Types de page

De grandes catégories plutôt que des pages individuelles : la page d’accueil, les pages statiques, les articles de blog, les listes du blog, les produits de la boutique, les listes de la boutique, le panier et le paiement, les pages d’outils, le forum, les termes et listes du glossaire, les petites annonces et leurs listes, les événements et leurs listes, les offres d’emploi et leurs listes, le portfolio, les cours, les pages du compte, les pages de connexion, et tout le reste. Choisissez-en autant que vous le souhaitez ; laissez le champ vide pour diffuser sur toutes.

Sous Groupes d’outils, le sélecteur liste aussi chaque add-on d’outils installé (Outils d’image, Outils PDF, etc.), pour diffuser une publicité sur un seul groupe d’outils. Ces choix s’ajoutent aux types de page au lieu de les remplacer : une page des outils d’image compte à la fois comme Pages d’outils et comme Outils d’image, une publicité destinée à toutes les pages d’outils continue donc de s’y afficher.

Les catégories dont la section n’est pas installée ne correspondent tout simplement jamais : laisser “Produits de la boutique” coché sur un site sans boutique est sans conséquence.

Modèles d’URL

Pour tout ce qu’une catégorie ne permet pas de cibler assez finement. Un modèle par ligne ; un astérisque correspond à n’importe quoi :

/blog/*
/pricing
/shop/*/reviews

Une publicité correspond si l’un de ses modèles correspond au chemin de la page. Les modèles sont comparés au chemin uniquement (sans domaine, sans chaîne de requête) et le préfixe de langue fait partie du chemin : ainsi, /fr/blog/* cible spécifiquement le blog français tandis que */blog/* couvre toutes les langues.

Pays, appareil, audience

Langues

Limitez une publicité à une ou plusieurs des langues actives du site. Une création en français devrait généralement être ciblée sur fr plutôt que de s’appuyer sur l’URL.

Pays

Déterminé à partir de l’adresse IP du visiteur, grâce au fournisseur GeoIP configuré dans Admin → Paramètres → GeoIP. Activez Traiter comme une liste d’exclusion pour inverser le sens : la publicité est alors diffusée partout sauf dans les pays choisis.

Un visiteur dont le pays ne peut pas être déterminé est considéré comme “absent de la liste” : une liste d’inclusion l’exclut, une liste d’exclusion le conserve. C’est l’interprétation qui ne montre jamais une publicité géo-restreinte au mauvais public.

Appareils

Ordinateur, tablette et mobile, déterminés à partir de l’agent utilisateur du navigateur. N’en cochez aucun pour diffuser partout.

Audience

• Tout le monde : la valeur par défaut.
• Visiteurs non connectés : le bon choix pour une publicité vendant quelque chose que vos clients possèdent déjà.
• Utilisateurs connectés : pour une vente additionnelle ou une annonce réservée aux membres.
• Rôles spécifiques : choisissez les rôles auxquels la publicité est destinée.

Tableau de bord

Admin → Régie pub → Tableau de bord répond aux deux seules questions qui comptent : combien de fois la publicité a-t-elle été vue, et combien de fois a-t-elle été cliquée.

• Quatre chiffres clés pour la période sélectionnée : impressions, vues uniques, clics et le taux de clics qui en résulte.
• Un graphique quotidien des impressions face aux clics, pour qu’un pic ou une chute saute aux yeux.
• Une ventilation que vous pouvez basculer entre par publicité, par zone et par campagne.
• Des filtres pour la période, et pour une zone, une campagne ou une publicité à la fois.
• Exporter en CSV vous donne une ligne par jour, publicité et zone pour tout ce que les filtres affichent actuellement : prêt à envoyer à un sponsor ou à ouvrir dans un tableur.

Les totaux cumulés de chaque publicité figurent aussi dans la liste des publicités, et ceux de chaque campagne dans la liste des campagnes : vous avez donc rarement besoin d’ouvrir les rapports pour savoir comment se porte un élément.

Fonctionnement du comptage

Impressions

Deux modes, dans Admin → Régie pub → Paramètres → Suivi :

• Lorsque la page l’affiche (par défaut) : comptée sur le serveur au moment où l’emplacement est construit. Ce mode ne nécessite aucun JavaScript et aucun bloqueur de publicités ne peut l’empêcher, mais il compte les publicités situées plus bas dans la page jusqu’auxquelles le visiteur n’a peut-être jamais fait défiler.
• Lorsque le visiteur fait défiler jusqu’à elle : comptée par le navigateur une fois l’emplacement réellement à l’écran. Plus proche de ce qu’un annonceur entend par impression, au prix de manquer les visiteurs qui bloquent les scripts.

Clics

Un clic sur une bannière ou un bloc HTML passe par une brève redirection qui l’enregistre et renvoie le visiteur vers l’annonceur. Les balises de régie comptent leurs propres clics et ne sont pas mesurées ici.

Vues uniques et clics uniques

“Unique” désigne la première fois aujourd’hui qu’un visiteur donné a vu ou cliqué une publicité donnée dans un emplacement donné. Les visiteurs sont reconnus grâce à une empreinte à sens unique de leur adresse IP et de leur navigateur, qui n’est jamais stockée : seul le fait qu’elle a déjà été vue aujourd’hui l’est, et uniquement jusqu’à minuit.

Robots

Les robots d’indexation sont reconnus et exclus des deux chiffres. Lorsqu’un add-on de statistiques est installé, son classificateur bien plus complet est utilisé à la place de celui intégré : plages publiées des robots d’indexation, plages des hébergeurs et clients qui prétendent être un navigateur mais ne se comportent pas comme tel. Vous pouvez désactiver le filtre dans Paramètres → Suivi si vous préférez voir le trafic brut.

Ce qui est stocké

Rien par événement. Chaque impression et chaque clic sont directement cumulés dans une seule ligne par jour, publicité et zone : les tables de rapports grossissent donc avec la taille de votre catalogue et non avec votre trafic. Les lignes plus anciennes que la durée de conservation (400 jours par défaut) sont purgées chaque nuit.

Consentement aux cookies

Le code publicitaire tiers dépose des cookies et contacte une régie publicitaire, ce qui, dans la majeure partie de l’Europe, exige d’abord le consentement du visiteur.

Lorsqu’un add-on de consentement aux cookies est installé et que Attendre le consentement aux cookies est activé :

• Les balises de régie ne sont pas du tout envoyées au navigateur tant que les cookies marketing ne sont pas acceptés. Ni masquées en CSS, ni chargées puis mises en pause : simplement absentes de la page.
• Les bannières image et les blocs HTML ne sont pas concernés : ils ne déposent aucun cookie et ne contactent rien.
• Dès que le visiteur accepte, les emplacements qui retenaient une publicité récupèrent leur contenu et se remplissent, sans rechargement de la page.
• Un visiteur qui refuse ne voit simplement jamais ces emplacements.

Sans add-on de consentement aux cookies installé, il n’y a aucun consentement à respecter, et le code publicitaire est diffusé normalement. La page des paramètres l’indique explicitement : vous ne vous demandez donc jamais si le réglage a un effet.

Bloqueurs de publicités

Un bloqueur de publicités retire la création de la page mais laisse l’emplacement en place : c’est ainsi qu’on se retrouve avec un trou là où se trouvait une publicité.

Donnez à une zone un Contenu de remplacement et ce trou devient utile. Peu après la stabilisation de la page, un emplacement dont toutes les publicités ont été réduites à néant révèle le contenu de remplacement :

• Une publicité maison pour l’un de vos propres produits.
• Un message courtois demandant au visiteur d’autoriser les publicités sur votre site.
• Un lien vers votre offre sans publicité, si vous en vendez une.

Le contenu de remplacement est aussi ce qu’une zone affiche lorsqu’elle n’a simplement aucune publicité à diffuser : il vaut donc la peine de le remplir même si les bloqueurs de publicités ne vous préoccupent pas.

Le remplacement ne fonctionne que lorsqu’un add-on de détection des bloqueurs de publicités est installé : c’est lui qui nous indique que le site s’en soucie. Sans lui, une publicité bloquée laisse l’emplacement vide, comme auparavant. Vous pouvez aussi désactiver ce comportement dans Paramètres → Confidentialité.

Visiteurs sans publicité

Deux groupes de personnes ne voient jamais de publicité, quel que soit le ciblage.

Utilisateurs payants

Si votre site vend des crédits ou des abonnements, leurs détenteurs naviguent sans publicité par défaut : c’est la même règle que le reste de la plateforme applique déjà, les deux ne peuvent donc jamais diverger. Désactivez Masquer les publicités aux utilisateurs payants dans Paramètres → Confidentialité si vous préférez continuer à montrer des publicités à tout le monde.

Rôles choisis

Listez des rôles dans Rôles sans publicité et leurs membres ne verront jamais de publicité. Les rédacteurs et le personnel sont les candidats habituels : ils doivent voir le site tel qu’il a été rédigé, et non tel qu’un annonceur le voit.

Les administrateurs qui naviguent dans le panneau d’administration ne voient jamais de publicités non plus : les zones n’y sont pas rendues du tout.

Multilingue

Toute l’interface d’administration est traduite dans chaque langue fournie avec la plateforme.

Sur la publicité elle-même, le texte alternatif d’une bannière est traduisible : choisissez la langue dans le sélecteur au-dessus du champ et renseignez chacune d’elles. Une traduction vide se rabat sur votre langue par défaut.

Tout le reste d’une publicité est soit invisible pour le visiteur (son nom interne), soit volontairement indépendant de la langue (la création, l’URL de destination). Pour diffuser des créations différentes selon la langue, créez une publicité par langue et ciblez chacune sur sa propre langue : cela vous permet aussi de les faire pointer vers des pages d’atterrissage différentes.

La mention “Publicité” au-dessus de chaque emplacement suit automatiquement la langue du visiteur, sauf si vous remplacez le libellé pour tout le site dans Paramètres → Général.

Paramètres globaux

Admin → Régie pub → Paramètres, quatre onglets.

Permissions

Seize permissions sont enregistrées à l’activation et accordées au rôle administrateur. Attribuez-les à d’autres rôles dans Admin → Utilisateurs → Rôles.

Mise à jour

Étape 1 : Téléverser la nouvelle version

Allez dans Admin → Extensions → Add-ons, cliquez sur Télécharger un add-on et choisissez le nouveau ZIP. Les fichiers existants sont remplacés sur place ; vos zones, campagnes, publicités et statistiques ne sont pas modifiées.

Étape 2 : Exécuter les migrations

php artisan migrate

Étape 3 : Vider les caches

php artisan config:clear
php artisan route:clear
php artisan view:clear

Étape 4 : Vérifier

Rendez-vous dans Admin → Régie pub → Publicités pour confirmer que l’add-on fonctionne correctement, et ouvrez une page du front-end portant une zone pour vérifier qu’une publicité apparaît toujours.

Désactivation

Éteindre un add-on sans rien perdre, c’est le désactiver : allez dans Panneau d’administration → Add-ons, trouvez Ad Manager et cliquez sur Désactiver.

• Ses routes, vues, entrées du menu d’administration et permissions ne sont plus enregistrées, et aucune publicité n’est diffusée nulle part.
• Les balises de zone laissées dans votre thème ne produisent rien du tout au lieu de provoquer une erreur : un add-on désactivé ne laisse ni trou ni erreur derrière lui.
• Les points de terminaison de redirection des clics et de suivi cessent de répondre.
• Ses tables de base de données et toutes les données qu’elles contiennent sont conservées (vos zones, campagnes, publicités et chaque statistique) et ses fichiers restent sous extensions/addons/admanager/. Rien n’est supprimé.
• Le code d’achat enregistré lors de l’activation est lui aussi conservé : réactiver l’add-on ne vous le redemande donc pas.
• La désactivation est refusée tant qu’un autre add-on actif dépend de celui-ci : désactivez d’abord cet add-on.

Cliquez sur Activer sur la même carte pour le réactiver. Les migrations en attente sont réexécutées, les assets sont republiés, et l’add-on reprend exactement là où il s’était arrêté, y compris chaque campagne qui était en cours.

Suppression

La suppression est définitive et détruit les données de l’add-on. Le bouton Supprimer n’apparaît que sur un add-on désactivé : la suppression se fait donc toujours en deux étapes :

1. Désactivez Ad Manager (voir Désactivation).
2. Cliquez sur Supprimer sur sa carte et confirmez.

Le panneau d’administration effectue alors, en une seule passe :

• l’exécution du hook de désinstallation de l’add-on, s’il en fournit un, tant que son code est encore sur le disque ;
• la révocation des permissions déclarées dans son addon.json ;
• l’annulation de ses migrations (cela supprime ses tables de base de données et toutes les lignes qu’elles contiennent, y compris toutes vos zones, campagnes, publicités et l’historique complet des statistiques) et la purge de ses entrées dans la table migrations, pour qu’une réinstallation ultérieure reparte de zéro ;
• la suppression de ses assets publiés : public/addons/admanager/, public/vendor/admanager/ et storage/app/public/addons/admanager/ ;
• la suppression du répertoire de l’add-on extensions/addons/admanager/ ;
• la suppression de sa ligne dans la table addons (le code d’achat enregistré disparaît avec elle) et le vidage du cache de l’application.

La suppression est refusée, avec un message explicatif et avant toute destruction, lorsque l’add-on est encore actif, lorsqu’un autre add-on actif en dépend, ou lorsque l’utilisateur du serveur web (PHP) ne peut pas supprimer extensions/addons/admanager/. Dans ce dernier cas, donnez à cet utilisateur le droit d’écriture sur le répertoire et sur son parent, puis réessayez.

Supprimer le dossier par FTP ou SSH n’est pas équivalent : les tables de l’add-on, ses entrées dans la table migrations et sa ligne dans addons sont toutes laissées en place, et sa carte reste dans la liste. Utilisez plutôt Supprimer dans le panneau d’administration.

Les balises de zone que vous avez ajoutées à votre thème vous appartiennent et ne sont jamais modifiées. Elles ne produisent rien une fois l’add-on supprimé : vous pouvez donc les laisser en place si vous envisagez de le réinstaller.

Dépannage

Aucune publicité n’apparaît nulle part

• Vérifiez que Diffuser les publicités est sur Oui dans Admin → Régie pub → Paramètres.
• Vérifiez que le statut de la publicité est Active (une nouvelle publicité démarre en brouillon), et que sa campagne est elle aussi Active. Les deux doivent l’être.
• Vérifiez les dates de la campagne : une campagne qui n’a pas commencé, ou qui est terminée, ne diffuse rien.
• Vérifiez que la publicité est réservée dans au moins une zone, dans son onglet Placement.
• Vérifiez que la zone est active et qu’elle apparaît réellement sur la page, soit via une balise dans votre thème, soit via le placement automatique.
• Consultez la page en étant déconnecté. Vous faites peut-être partie d’un rôle sans publicité, ou vous détenez des crédits.

Une publicité précise ne s’affiche jamais

• Ouvrez son onglet Ciblage et videz chaque axe, puis rajoutez-les un par un. Les axes sont combinés avec un ET : deux restrictions d’apparence raisonnable peuvent facilement exclure tout le monde.
• Vérifiez que les Formats acceptés de la zone incluent le format de la publicité.
• Si la zone affiche une publicité à la fois et que plusieurs sont éligibles, elles se relaient : rechargez plusieurs fois, ou réglez la rotation sur séquentielle pour les voir défiler.
• Vérifiez que la campagne n’a pas atteint un plafond : la liste des campagnes l’indique en toutes lettres.

Une publicité géociblée ne s’affiche nulle part

• Vérifiez que le fournisseur GeoIP configuré dans Admin → Paramètres → GeoIP renvoie réellement un pays. Sans fournisseur configuré, chaque liste d’inclusion ne correspond à personne.
• Les recherches de pays sont mises en cache pendant une heure par visiteur : un fournisseur que vous venez de corriger prend donc effet progressivement. Videz le cache du site pour le constater immédiatement.
• Sur un site local ou intranet, les visiteurs ont des adresses IP privées qui ne peuvent pas du tout être géolocalisées.

Une balise de régie publicitaire n’affiche rien

• Vérifiez que le visiteur a accepté les cookies marketing : c’est le seul format qui attend. Voir Consentement aux cookies.
• Vérifiez que la zone accepte le format Code de régie publicitaire.
• Les bloqueurs de publicités masquent agressivement les balises de régie. Testez dans un navigateur sans extension.
• De nombreuses régies doivent approuver votre domaine avant de diffuser quoi que ce soit. Vérifiez d’abord le tableau de bord de la régie : une balise pas encore approuvée affiche un cadre vide partout, pas seulement ici.

Le nombre d’impressions semble trop élevé

• Par défaut, une impression est comptée lorsque la page affiche l’emplacement, que le visiteur ait fait défiler jusqu’à lui ou non. Réglez Compter une impression sur Lorsque le visiteur fait défiler jusqu’à elle dans Paramètres → Suivi pour obtenir le chiffre le plus strict.
• Vérifiez que Ignorer le trafic des robots est activé. L’installation d’un add-on de statistiques donne au filtre un classificateur bien meilleur.
• Vos propres visites comptent aussi, sauf si votre rôle est exempté de publicités.

Les clics ne sont pas comptabilisés

• Les balises de régie comptent leurs propres clics ; ces chiffres se trouvent dans le tableau de bord de la régie, pas ici.
• Un bloc HTML contenant son propre lien contourne le relais de suivi. Indiquez plutôt une URL de destination pour le bloc et laissez l’add-on l’envelopper.
• Vérifiez que la publicité possède bien une URL de destination : sans elle, il n’y a rien à cliquer.

La page saute au chargement des publicités

• Renseignez la Hauteur de la zone. L’emplacement réserve alors cet espace dès le départ.
• Pour un emplacement visible dès l’ouverture de la page, désactivez Charger à l’arrivée dans la zone visible.

Une campagne s’est mise en pause et je ne sais pas pourquoi

• La liste des campagnes affiche la raison sous le statut, et la page d’édition la répète au-dessus du formulaire.
• Un plafond quotidien reprend de lui-même ; un plafond total ou une date de fin dépassée, non. Augmentez ou supprimez le plafond, ou déplacez la date de fin, puis remettez le statut sur Active.