Passer au contenu principal
Avant de passer en production, effectuez des Tests d’Acceptation Utilisateur (UAT) approfondis pour assurer une transition en douceur. Ce guide vous accompagne à travers la préparation pré-lancement, les procédures de test, les étapes de déploiement et la surveillance post-lancement.
Votre processus de mise en production peut varier en fonction de votre parcours d’intégration et de vos formats publicitaires. Ce guide couvre les scénarios les plus courants, mais votre implémentation spécifique peut différer. Par exemple :
  • Sponsored Listings nécessitent une intégration complète du catalogue avec les données produits
  • Banner Ads peuvent nécessiter uniquement la configuration des fournisseurs/annonceurs sans catalogue au niveau produit
  • Configurations de placement varient en fonction de vos choix de formats publicitaires
Travaillez avec votre contact Topsort pour confirmer quelles sections s’appliquent à votre intégration.

​
Liste de Contrôle Pré-Lancement

​
Configuration Commune (Tous les Formats Publicitaires)

Identifiants API :
  • Les clés API sandbox sont correctement configurées
  • Les clés API de production sont prêtes (ne pas encore changer)
  • Les clés API sont stockées en toute sécurité dans des variables d’environnement
  • Le processus de rotation des clés est documenté
Configuration de l’Environnement :
  • L’environnement de staging reflète la configuration de production
  • Tous les endpoints API sont configurés correctement
  • Les valeurs de timeout sont appropriées (recommandé : 500-1000ms)
  • La gestion des erreurs est implémentée
Affichage des Publicités :
  • Les placements publicitaires s’affichent correctement sur tous les types d’appareils
  • Les étiquettes publicitaires sont clairement visibles (voir directives d’étiquetage ci-dessous)
  • Les images/créatifs publicitaires se chargent correctement avec des solutions de secours
  • Le comportement de clic fonctionne comme prévu
Performance :
  • Les temps de chargement des pages sont acceptables avec les publicités
  • Les publicités ne bloquent pas le rendu critique de la page
  • L’expérience mobile est optimisée (cibles tactiles, mises en page responsives, temps de chargement rapides)
  • Les exigences d’accessibilité sont respectées
Instrumentation :
  • Le suivi des erreurs est configuré (Sentry, Datadog, etc.)
  • La surveillance des performances est en place
  • Les tableaux de bord personnalisés sont configurés
  • Les seuils d’alerte sont définis
Journalisation :
  • La journalisation des requêtes/réponses API est activée
  • Les journaux d’erreurs sont capturés
  • La piste d’audit pour les événements publicitaires est configurée
  • Les politiques de rétention des journaux sont définies

​
Directives d’Étiquetage des Publicités

Étiquettes Recommandées

Utilisez des étiquettes qui indiquent clairement le contenu promotionnel tout en évitant les déclencheurs de bloqueurs de publicités :
  • “En Vedette”
  • “Recommandé”
  • “Choix du Client”
  • “Meilleur Choix”
Évitez d’utiliser “Sponsorisé” ou “Publicité” car ces termes sont couramment ciblés par les bloqueurs de publicités.

Clients Européens (Conformité DSA)

Si vous opérez dans l’Union européenne, la Loi sur les Services Numériques (DSA) exige :
  • Un étiquetage clair que le contenu est une publicité
  • L’affichage du nom de l’annonceur dans les détails de l’annonce
  • La transparence sur la raison pour laquelle l’annonce a été montrée à l’utilisateur
Travaillez avec votre équipe juridique pour assurer la conformité complète à la DSA.

​
Tests d’Acceptation Utilisateur (UAT)

​
1. Tests du Catalogue

​
2. Tests des Enchères et Événements

Tester avec Deux Utilisateurs Différents : Effectuez tous les tests avec au moins deux sessions utilisateur uniques pour vérifier le suivi et l’attribution appropriés de l’utilisateur.

​
3. Validation des Données

1

Capturer les Preuves de Test

Pour Chaque Utilisateur de Test :
  • Prenez des captures d’écran des placements publicitaires
  • Capturez les requêtes réseau montrant les appels API
  • Documentez les détails de commande pour les événements d’achat (si applicable)
  • Notez les horodatages pour chaque action
2

Soumettre à Topsort

Envoyez ce qui suit à votre contact Topsort :
  • Captures d’écran des impressions publicitaires
  • Journaux réseau montrant les appels d’enchères et d’événements
  • Nom de la campagne de test et plage de temps
  • Identifiants utilisateur utilisés dans les tests
3

Examiner le Résumé des Données

Topsort fournira un résumé incluant :
  • Total des enchères reçues
  • Comptages d’impressions et de clics
  • Comptages d’achats (pour les intégrations d’annonces de listing)
  • Score de qualité des données
  • Toute divergence ou problème de données
Vérifier l’Alignement :
  • Les chiffres correspondent à vos actions de test
  • La chaîne d’attribution est complète
  • Aucun événement manquant ou dupliqué

​
Déploiement en Production

​
Étapes de Déploiement

1

Connecter le Catalogue de Production

2

Obtenir les Identifiants de Production

En Utilisant Topsort UI :
  1. Topsort fournit les identifiants du panneau d’administration
  2. Vous recevez l’URL de l’API de production
  3. Générez les clés API dans l’admin
  4. Stockez les clés en toute sécurité dans l’environnement de production
En Utilisant une UI Personnalisée :
  1. Recevez l’URL de l’API de production de Topsort
  2. Recevez la(les) clé(s) API de production
  3. Configurez les clés dans votre environnement
Ne validez jamais les clés API dans le contrôle de version. Utilisez des variables d’environnement ou des systèmes de gestion de secrets sécurisés.
3

Déployer le Code d'Intégration

Pré-Déploiement :
  • Examinez tous les changements de code une dernière fois
  • Assurez-vous que les identifiants sandbox sont paramétrés
  • Confirmez que la procédure de retour en arrière est documentée
  • Planifiez le déploiement pendant une période de faible trafic
Processus de Déploiement :
  1. Déployez le code dans l’environnement de production
  2. Mettez à jour les variables d’environnement avec les identifiants de production
  3. Redémarrez les services pour appliquer la nouvelle configuration
  4. Vérifiez que l’application démarre avec succès
Vérification Immédiate :
  • Vérifiez les journaux d’application pour les erreurs
  • Testez la fonctionnalité de base (chargements de page)
  • Vérifiez la connectivité API

​
Stratégie de Montée en Charge du Trafic

Déploiement Progressif

Approche Recommandée :Jour 1-2 : 10% du trafic
  • Surveillez attentivement les erreurs
  • Validez la précision des données
  • Vérifiez les métriques de performance
Jour 3-5 : 50% du trafic
  • Comparez les métriques avec la référence
  • Assurez la stabilité du système
  • Ajustez si nécessaire
Jour 6+ : 100% du trafic
  • Lancement complet en production
  • Continuez la surveillance
  • Optimisez les performances

Feature Flags

Utilisez les Feature Flags pour Contrôler :
  • Quels placements affichent des publicités
  • Pourcentage d’utilisateurs voyant des publicités
  • Configurations de tests A/B
  • Interrupteur d’urgence
Avantages :
  • Retour en arrière instantané sans déploiement
  • Contrôle du déploiement progressif
  • Configuration par placement
  • Risque de déploiement réduit

​
Surveillance Post-Lancement

​
Métriques Critiques à Surveiller

Performance API :
  • Temps de réponse de l’Auction API (objectif : <500ms p95)
  • Taux de succès de l’Event API (objectif : >99.5%)
  • Taux et types d’erreurs
  • Fréquence de timeout de l’API
Performance de l’Application :
  • Impact sur le temps de chargement de la page
  • Temps jusqu’au premier rendu publicitaire
  • Erreurs JavaScript
  • Modèles d’utilisation de la mémoire
Actions à Entreprendre si des Problèmes sont Détectés :
  • Temps de réponse >1s : Examiner les paramètres de timeout
  • Taux d’erreur >1% : Vérifier les identifiants API et le réseau
  • Erreurs JS élevées : Examiner l’implémentation côté client
Suivi des Événements :
  • Ratio impression/clic (typique : 1-5%)
  • Ratio clic/achat (typique : 2-10%, pour les annonces de listing)
  • Cohérence du volume d’événements
  • Complétude de l’attribution
Intégrité des Données :
  • Les ID utilisateur sont présents et cohérents
  • Les resolvedBidIds sont capturés pour les impressions et clics
  • Les montants d’achat sont raisonnables (annonces de listing)
  • Les événements dupliqués sont minimaux
Vérifications du Tableau de Bord :
  • Comparez le tableau de bord Topsort avec vos analyses
  • Vérifiez que l’attribution des revenus correspond
  • Vérifiez les lacunes ou pics de données
Performance des Campagnes :
  • Total des impressions délivrées
  • Taux de clic (CTR)
  • Taux de conversion (annonces de listing)
  • Retour sur dépenses publicitaires (ROAS)
Expérience Utilisateur :
  • Taux de visibilité des publicités
  • Engagement des utilisateurs avec les publicités
  • Impact sur le taux de conversion organique
  • Changements du taux de rebond de page
Impact sur les Revenus :
  • Revenus incrémentaux des publicités
  • Changements de la valeur moyenne des commandes
  • Taux d’adoption des fournisseurs
  • Vitesse de création de campagne

​
Dépannage des Problèmes Courants

Aucun Produit Affiché

Causes Possibles :
  • Aucune campagne active
  • Montants d’enchères trop bas
  • Ciblage de produits trop restreint
  • Erreurs de l’Auction API
Étapes de Débogage :
  1. Vérifiez la console du navigateur pour les erreurs
  2. Vérifiez la réponse de l’Auction API
  3. Confirmez que les campagnes sont actives
  4. Examinez les critères de ciblage

Événements d'Achat Manquants

Causes Possibles :
  • Événement non déclenché au checkout
  • ID utilisateur manquant dans la charge utile de l’événement
  • Format d’ID produit incorrect
  • Échecs réseau
Étapes de Débogage :
  1. Testez le flux d’achat manuellement
  2. Vérifiez la structure de la charge utile de l’événement
  3. Vérifiez que l’ID utilisateur est inclus
  4. Examinez les journaux du serveur

​
Meilleures Pratiques

Communication

Coordination Interne :
  • Notifiez l’équipe d’ingénierie du déploiement
  • Alertez le support client des nouvelles fonctionnalités
  • Mettez à jour l’équipe commerciale sur les capacités
Communication Externe :
  • Coordonnez avec l’équipe Topsort
  • Planifiez les appels de lancement
  • Établissez les chemins d’escalade

Documentation

Maintenir :
  • Runbooks de déploiement
  • Procédures de retour en arrière
  • Spécifications d’intégration API
  • Guides de dépannage
Garder à Jour :
  • Changements de configuration
  • Problèmes connus et solutions de contournement
  • Benchmarks de performance

Optimisation

Amélioration Continue :
  • Examinez les performances hebdomadairement
  • Optimisez les requêtes lentes
  • Affinez le ciblage
  • Testez de nouveaux placements
Tests A/B :
  • Positions de placement publicitaire
  • Nombre de publicités par page
  • Formats et styles publicitaires
  • Stratégies de ciblage

Support

Établir :
  • Rotation d’astreinte
  • Processus de réponse aux incidents
  • Contacts d’escalade Topsort
  • Attentes SLA
Documenter :
  • Scénarios de support courants
  • Procédures de résolution
  • Informations de contact
Une fois en ligne, vous êtes prêt à commencer l’optimisation. Contactez votre contact Topsort pour obtenir des conseils sur les stratégies de campagne, l’ajustement de l’attribution et les configurations avancées.

Besoin d'aide avec votre intégration Topsort ?

Parlez-nous, l'équipe d'ingénierie des intégrations.Contactez-nous via votre canal de messagerie dédié ou à support@topsort.com.Si vous n'êtes pas encore client, planifiez une démo avec notre équipe de vente.