Glossaire

Chaque terme, deux perspectives. La colonne de gauche correspond à la vision de l'acheteur média. La colonne de droite correspond à la vision de l'ingénieur DevOps dans le système.

Terme	Définition acheteur média	Définition DevOps / système
Siège (Seat)	Un compte acheteur sur Google Authorized Buyers. Vous délimitez votre analyse et votre ciblage par siège.	buyer_account_id dans Postgres. Stocké dans la table seats. Synchronisé via GET /seats.
QPS	Queries Per Second : le débit maximal de requêtes d'enchères que vous demandez à Google d'envoyer. Google régule le volume réel en fonction du niveau de votre compte.	Plafond configuré par configuration de prétargeting. Débit entrant réel surveillé via les métriques de l'entonnoir RTB dans rtb_daily.
Gaspillage (Waste)	QPS consommé par des requêtes d'enchères que votre bidder rejette (mauvaises zones géographiques, mauvais formats, pas de créative correspondante). De l'argent dépensé pour rien.	(total_qps - bids_placed) / total_qps. Calculé à partir des agrégats rtb_daily. Visible dans l'API de l'entonnoir.
Configuration de prétargeting	Les règles qui contrôlent quelles requêtes d'enchères atteignent votre bidder. Vous en avez 10 par siège. Contrôle les zones géographiques, formats, types, plateformes et éditeurs.	Entité mutable synchronisée depuis l'API Google AB. Stockée dans pretargeting_configs. Gérée via /settings/pretargeting. Les instantanés permettent le retour en arrière.
Entonnoir (Funnel)	La progression de la requête d'enchère à la dépense : QPS -> Enchères -> Victoires -> Impressions -> Clics -> Dépenses. Chaque étape comporte une déperdition.	Calculé à partir des métriques rtb_daily. Servi par GET /analytics/rtb-funnel. Cache frontend de 30 minutes.
Créative	Un élément publicitaire : image, vidéo, HTML ou native. Possède un format, une taille, une URL de destination et un historique de performance.	Ligne dans la table creatives. Miniatures dans le stockage blob. Synchronisé depuis l'API Google AB. Performance issue des jointures rtb_daily.
Campagne	Un regroupement logique de créatives. Utilisé pour organiser l'analyse et le reporting.	Ligne dans la table ai_campaigns. Relation many-to-many avec les créatives. Supporte l'auto-clustering par IA.
Carte de configuration	Le panneau d'interface affichant l'état d'une configuration de prétargeting, le QPS max, les zones géographiques, les formats, les types et les plateformes.	Composant React PretargetingConfigCard. Données issues de GET /settings/pretargeting-configs.
Fraîcheur des données	Une grille montrant quelles dates ont des données importées (« importé ») vs. des lacunes (« manquant ») pour chaque type de rapport.	GET /uploads/data-freshness. Utilise des requêtes generate_series + EXISTS sur rtb_daily, rtb_bidstream, rtb_quality, rtb_bid_filtering. Timeout de requête de 30s.
Import	Intégrer les données de performance CSV dans Cat-Scan, soit par import manuel soit par auto-import Gmail.	CSV analysé, validé, dédoublonné (via contrainte unique row_hash), inséré dans les tables cibles. Import par morceaux pour les fichiers > 5 Mo.
Retour en arrière (Rollback)	Restaurer une configuration de prétargeting à son état précédent. Aperçu en simulation, puis confirmation.	Restauration d'instantané : lit pretargeting_snapshots, applique le delta à l'API Google AB, enregistre un nouvel instantané. POST /snapshots/rollback.
Optimiseur / BYOM	Système automatisé qui note les segments et propose des modifications de configuration. Utilise votre propre modèle externe.	Endpoint de scoring appelé via HTTP POST. Propositions stockées dans optimizer_proposals. Cycle de vie : score -> proposition -> approbation -> application.
Préréglage de workflow	Prudent, équilibré ou agressif. Contrôle l'audace des propositions de l'optimiseur.	Paramètre canary_profile de l'API score-and-propose. Affecte les seuils de confiance et les limites d'amplitude des modifications.
CPM effectif	Ce que vous payez réellement pour mille impressions, en tenant compte du gaspillage et du coût d'infrastructure.	Calculé dans OptimizerEconomicsService. Combine les données de dépenses de rtb_daily avec le coût d'hébergement configuré.
Conversion	Une action utilisateur de valeur (achat, inscription) suivie après une impression. Réinjectée pour optimiser le ciblage.	Événement ingéré via pixel (GET /conversions/pixel) ou webhook (POST /conversions/webhook). Stocké dans les tables de conversion. Vérifié par HMAC pour les webhooks.
Taux de victoire (Win rate)	Victoires / Enchères. Mesure la compétitivité de vos enchères dans la vente aux enchères.	auction_wins / bids_placed issu de rtb_daily.
CTR	Clics / Impressions. Mesure l'attractivité de vos créatives.	clicks / impressions issu de rtb_daily.
Gate de santé runtime	(Pas un terme acheteur)	Workflow CI v1-runtime-health-strict.yml. Exécute des vérifications de bout en bout : santé API, santé des données, conversions, optimiseur, SLO QPS. Retourne PASS/FAIL/BLOCKED par vérification.
Vérification de contrat	(Pas un terme acheteur)	scripts/contracts_check.py. Valide les contrats de données (règles non négociables de l'import à la sortie API). Exécuté après déploiement. Bloque la mise en production en cas d'échec.
Cloud SQL Proxy	(Pas un terme acheteur)	Conteneur sidecar fournissant un accès authentifié à Cloud SQL Postgres. Doit être sain avant le démarrage du conteneur API.
En-tête X-Email	(Pas un terme acheteur)	En-tête HTTP défini par OAuth2 Proxy après l'authentification Google. Approuvé par l'API lorsque OAUTH2_PROXY_ENABLED=true. Supprimé par nginx pour les requêtes externes.