@mostajs/ad-slot

Auteur : Dr Hamid MADANI [email protected] · Licence : AGPL-3.0-or-later

Client léger de diffusion publicitaire en trois couches emboîtées autour d'un cœur commun. Un emplacement mesure sa fenêtre (largeur/hauteur, orientation, devicePixelRatio) et appelle la centrale ads.amia.fr/serve?w=&h=… : c'est la centrale qui décide le format qui rentre (adaptatif). Compte l'impression à la viewability et le clic. Alternative importable à la balise embed.js — les deux coexistent (embed.js pour les pages sans build, ce module pour les apps buildées).

Trois couches (chacune emboîte le cœur)

| Export | Couche | À utiliser dans | |---|---|---| | @mostajs/ad-slot | cœur JS agnostique (mountAdSlot, buildServeUrl, renderDescriptor) | tout, sans framework | | @mostajs/ad-slot/element | HTML : custom element <ads-slot> | pages HTML sans build, et dans React | | @mostajs/ad-slot/react | React : <AdSlot> | apps React (/display, /distributor…) |

// Vanilla
import { mountAdSlot } from '@mostajs/ad-slot'
const stop = mountAdSlot(el, { base:'https://ads.amia.fr', account, key, placement:'scene:bandeau' })

<!-- HTML sans build -->
<script type="module">import '@mostajs/ad-slot/element'</script>
<ads-slot base="https://ads.amia.fr" account="regie" adkey="…" placement="waiting-room"></ads-slot>

// React
import { AdSlot } from '@mostajs/ad-slot/react'
<AdSlot base="https://ads.amia.fr" account="regie" adKey={key} placement="scene:bandeau" />

Peut / ne peut pas

Peut : mesurer le slot et laisser la centrale choisir le format ; afficher image (URL http)/titre/CTA avec lien traqué ; compter l'impression à la viewability ; plusieurs slots par page ; vanilla + HTML + React ; best-effort (ne casse pas la page).

Ne peut pas : décider ciblage/format/budget (c'est la centrale @mostajs/ads) ; stocker un état / persister ; fabriquer la clé de surface (config de l'app) ; gérer l'auth régie ; sélectionner par taille si le conteneur n'a pas de hauteur ; rafraîchir tout seul ; servir le média ; contourner la garde (403 sans clé) ; SSR.

Détails complets d'utilisation, capacités et limites : voir llms.txt.