Documentation · Opérations et maintenance
Opérations quotidiennes
Ce document décrit les vérifications quotidiennes de routine qu'un administrateur de site ou un responsable de concession devrait effectuer pour confirmer que l'extension ADP Car Market Hub fonctionne correctement sur un site WordPress en production.
Quand utiliser ce document
Lisez ce document si vous êtes responsable du fonctionnement quotidien d'un site en production qui utilise l'extension pour importer et afficher des annonces de véhicules depuis AutoScout24. Ces vérifications sont conçues pour être effectuées rapidement et pour détecter les problèmes avant qu'ils n'affectent les visiteurs ou les leads.
Aperçu
L'extension exécute automatiquement les tâches d'importation à l'aide de WP-Cron ou d'un cron de serveur externe, télécharge les images des véhicules de manière asynchrone via une file d'attente d'images, et stocke les événements des visiteurs ainsi que les demandes des clients dans la base de données WordPress. Les vérifications quotidiennes permettent de confirmer que ces processus en arrière-plan s'exécutent comme prévu et qu'aucune erreur ne s'est accumulée.
Le panneau d'administration WordPress propose un onglet Tableau de bord et un onglet Journaux qui regroupent au même endroit les données opérationnelles les plus pertinentes.
Configuration requise
- Compte administrateur doté de la capacité
manage_as24_imports, qui est accordée aux administrateurs WordPress lors de l'activation de l'extension. - Accès à WordPress Admin → ADP Car Market Hub (le menu d'administration de l'extension).
Vérifications quotidiennes
1. Confirmer la dernière exécution de l'importation
- Ouvrez ADP Car Market Hub → Tableau de bord.
- Localisez la ligne des indicateurs clés de performance (KPI). Elle affiche le nombre total de véhicules importés, les nouveaux véhicules ajoutés au cours des sept derniers jours et l'horodatage de l'importation la plus récente.
- Vérifiez que l'horodatage de la dernière importation correspond à la planification attendue. Si l'importation n'a pas eu lieu depuis le dernier intervalle prévu, examinez les paramètres d'automatisation ou la configuration du cron.
- Pour plus de détails, ouvrez ADP Car Market Hub → Importations et limites et inspectez l'heure de la Dernière exécution ainsi que le Statut de la dernière exécution (insérés, mis à jour, ignorés, erreurs).
2. Vérifier les erreurs d'importation
- Ouvrez ADP Car Market Hub → Journaux.
- Le panneau Erreurs récentes affiche les entrées de niveau d'erreur les plus récentes du fichier journal actuel. Si des erreurs sont présentes, lisez-les et recherchez-en la cause.
- Le panneau Avertissements récents affiche les entrées de niveau d'avertissement qui peuvent indiquer un fonctionnement dégradé (par exemple, des échecs partiels d'images ou des réponses de limite de taux de l'API).
- Un panneau d'erreurs vide correspond à l'état de fonctionnement normal attendu.
3. Examiner les nouveaux leads
- Ouvrez ADP Car Market Hub → Leads (ou accédez à l'onglet Leads dans l'administration de l'extension).
- Examinez tous les leads ayant le statut Nouveau qui sont arrivés depuis la veille.
- Attribuez un statut (Contacté, Fermé ou Indésirable) aux leads traités afin que la file d'attente reste gérable.
- Vérifiez que les e-mails de notification de leads ont bien été distribués en consultant la boîte de réception de l'adresse de destinataire configurée. Le destinataire est défini sous Réglages → E-mail du destinataire des leads.
4. Vérifier la file d'attente des images
- Ouvrez ADP Car Market Hub → Système et aide.
- Localisez la section de la file d'attente des images. Lorsque la file d'attente des images est activée, les images restantes sont traitées de manière asynchrone après chaque importation. Un léger retard dans la file d'attente est normal. Un retard très important ou stagnant (l'onglet Système et aide affiche un avertissement lorsque la file d'attente dépasse le seuil configuré) peut indiquer que le crochet cron de la file d'attente d'images ne se déclenche pas.
- Si la taille de la file d'attente est anormalement élevée, utilisez le bouton Déclencher la file d'attente d'images maintenant dans l'onglet Importations et limites pour la traiter manuellement, puis examinez la configuration du cron.
5. Vérifier la connexion API
- Ouvrez ADP Car Market Hub → Système et aide.
- La ligne d'état de la connexion confirme si l'extension peut joindre l'API AutoScout24 avec les identifiants actuellement configurés.
- Un statut Connecté à AutoScout24 – jeton valide et API accessible correspond à l'état de fonctionnement normal attendu.
- Si le statut affiche une erreur, vérifiez les paramètres Client ID, Client Secret et Seller ID sous ADP Car Market Hub → Réglages.
Référence de configuration
| Emplacement du réglage | Option concernée | Objectif |
|---|---|---|
| Onglet Importations et limites | Importation automatique activée | Active ou désactive les importations planifiées automatiques |
| Onglet Importations et limites | Planification | Fréquence d'importation (toutes les heures, toutes les 6 heures, deux fois par jour, tous les jours ou intervalle personnalisé) |
| Onglet Importations et limites | Nombre max de véhicules par exécution | Limite le nombre de véhicules traités lors d'une seule exécution du cron (0 = illimité) |
| Onglet Importations et limites | Mode file d'attente d'images | Lorsqu'il est activé, seule la première image est téléchargée immédiatement ; les images restantes sont mises en file d'attente |
| Onglet Réglages | E-mail du destinataire des leads | Adresse e-mail de remplacement pour les notifications de leads |
| Onglet Journaux | Journalisation détaillée | Lorsqu'elle est activée, enregistre une ligne pour chaque véhicule et chaque action d'image |
Notes opérationnelles
- L'extension utilise un verrou temporaire (
as24ci_cron_import_running) pour empêcher les exécutions d'importation simultanées. Si une exécution précédente s'est interrompue de manière inattendue, le verrou est automatiquement libéré après sa durée de vie (TTL) de 40 minutes. - Le fichier journal est stocké dans le répertoire des téléversements WordPress sous
as24ci-logs/adp-car-market-hub.log. Le répertoire est protégé contre l'accès web public par un fichier.htaccesset un fichier silencieuxindex.php. - Les fichiers journaux font l'objet d'une rotation automatique lorsqu'ils dépassent 10 Mo. Les archives issues de la rotation sont supprimées après 7 jours.
- Les données de l'onglet Tableau de bord sont mises en cache pendant trois minutes. Si vous venez de déclencher une importation manuelle, attendez quelques minutes avant de vérifier les compteurs.
Dépannage
| Symptôme | Cause probable | Vérification |
|---|---|---|
| L'heure de la dernière importation est plus ancienne que prévu | WP-Cron ne se déclenche pas ou le site a un faible trafic | Examinez le mode cron dans l'onglet Système et aide ; envisagez de passer à un cron système |
| Erreurs dans le journal après une importation | Identifiants API expirés ou invalides, ou problème réseau | Vérifiez l'état de la connexion API dans l'onglet Système et aide ; vérifiez les identifiants dans les Réglages |
| Aucun nouveau lead n'apparaît malgré l'activité des visiteurs | Formulaire de contact non configuré, ou échec de la distribution des e-mails | Testez le formulaire de contact manuellement ; vérifiez le réglage de l'e-mail du destinataire des leads |
| La file d'attente d'images augmente mais ne diminue pas | Le crochet cron de la file d'attente d'images ne s'exécute pas | Déclenchez manuellement la file d'attente d'images depuis l'onglet Importations et limites ; vérifiez l'état de santé du cron système ou de WP-Cron |
| Les compteurs du Tableau de bord semblent obsolètes | Cache temporaire | Attendez trois minutes que le cache de trois minutes expire, puis rechargez la page |