Tableau de bord — Vue rapide
La Vue rapide du tableau de bord vous offre un aperçu instantané de l'état de votre flux à chaque ouverture du module : date de la dernière génération, nombre de produits exportés et vitesse de génération.
Disponible depuis la v2.5.0
Vue d'ensemble
Dès que vous avez généré votre flux au moins une fois, le panneau Vue rapide du tableau de bord (#fcp) s'affiche en haut de la page de configuration du module, avant tous les autres paramètres. Tant que vous n'avez pas effectué la première génération, le guide pas à pas s'affiche en premier et le tableau de bord reste masqué.
Le panneau comporte trois sections :
- Cartes de statut — trois cartes compactes indiquant la fraîcheur de la dernière génération, le nombre de produits et les performances.
- URLs du flux — les URLs XML du flux à coller dans Meta Business Manager, chacune avec un bouton copier en un clic et un lien ouvrir pour prévisualiser le fichier dans votre navigateur.
- Tableau de statistiques de génération — un récapitulatif par flux de chaque génération effectuée (boutique, type, locale, durée et nombre d'erreurs).
Ce qu'affiche le tableau de bord
Carte Dernière génération
Indique le temps écoulé depuis la fin de la génération la plus récente, sous forme lisible : « À l'instant », « Il y a 3 minutes », « Il y a 2 h 14 min », « Il y a 3 jours », etc. En dessous du temps écoulé, la carte affiche la date et l'heure complètes de cette exécution.
Un badge de statut coloré vous indique si votre flux est à jour :
| Couleur du badge | Condition | Signification |
|---|---|---|
| Vert — À jour | Moins de 24 heures | Le flux est à jour ; Facebook dispose de données actuelles |
| Jaune — Mise à jour recommandée | 24 à 48 heures | Votre flux vieillit ; effectuez une nouvelle génération rapidement |
| Rouge — Obsolète | Plus de 48 heures | Facebook affiche peut-être des prix obsolètes ou des produits en rupture de stock |
L'horodatage est stocké sous forme de timestamp Unix dans la clé de configuration globale FPF_LAST_UPDATED. Il est mis à jour à chaque fin de génération de flux, quelle que soit la boutique ou la langue exportée.
Carte Produits
Affiche le nombre total de produits traités lors de la dernière génération. Le grand nombre en haut représente le Total — le nombre de lignes de produits que le module a tenté d'exporter sur l'ensemble des flux. En dessous, des indicateurs plus petits détaillent le résultat :
| Indicateur | Ce qu'il comptabilise |
|---|---|
| Succès | Produits écrits avec succès dans le flux XML |
| Combinaisons | Lignes de déclinaisons ajoutées (affiché uniquement si les déclinaisons sont activées et qu'au moins une a été exportée) |
| Erreurs | Produits n'ayant pas pu être traités ; cliquer sur le chiffre accède au rapport d'erreurs |
| Ignorés | Produits exclus par vos filtres (en rupture de stock, masqués, etc.) ; cliquer sur le chiffre accède au rapport des produits ignorés |
Ces compteurs sont lus depuis stats.txt dans le répertoire feeds/ du module, fichier que le générateur de flux écrit à la fin de chaque cycle de génération.
Carte Performances
Affiche le temps total écoulé (en secondes, avec deux décimales) pour la dernière génération complète, issu de la clé de configuration globale FPF_FEED_GENERATION_TIME. Lorsqu'au moins un produit a été exporté, la carte affiche également le temps moyen par produit — utile pour estimer la durée d'une génération après l'ajout de produits ou l'activation des déclinaisons.
URLs du flux
Sous les cartes de statut, le panneau liste toutes les URLs de flux XML générées par votre boutique, regroupées par shop. Chaque URL est affichée en intégralité et dispose de deux actions :
- copier — copie l'URL dans votre presse-papiers en un clic ; le texte du bouton change brièvement pour confirmer que la copie a réussi.
- ouvrir — ouvre l'URL dans un nouvel onglet du navigateur afin que vous puissiez vérifier le contenu du flux avant de le coller dans Meta Business Manager.
Trois types de flux peuvent apparaître par boutique, selon votre configuration :
| Type de flux | Libellé | Quand il apparaît |
|---|---|---|
| Flux principal | Main Feed | Toujours, après la première génération |
| Flux par langue | Languages Feed | Lorsqu'au moins une langue supplémentaire est activée |
| Flux par pays | Countries Feed | Lorsqu'au moins un paramètre de pays est activé |
Si aucun flux n'est listé, le tableau de bord affiche un avertissement : « Feed URLs Not Available — You need to generate the Feeds at least once. » Générez le flux depuis la section Génération manuelle du flux, puis revenez ici.
Tableau de statistiques de génération
Sous les URLs du flux, le panneau affiche un tableau — une ligne par type de flux par boutique — avec les colonnes suivantes :
| Colonne | Description |
|---|---|
| Shop ID | L'identifiant interne de la boutique PrestaShop |
| Name | Le nom de la boutique |
| Type | Type de flux : Main Feed, Language ou Country |
| Locale | Identifiant de langue ou de pays pour cette ligne de flux |
| Time | Durée de génération pour ce flux spécifique, en secondes |
| Total | Nombre total de produits tentés |
| Success | Produits exportés avec succès |
| Combis | Lignes de déclinaisons ajoutées |
| Skip | Produits ignorés (cliquable pour les lignes Main Feed comportant des éléments ignorés) |
| Errors | Produits en erreur (cliquable ; renvoie au rapport de détail des erreurs) |
Les statistiques sont lues depuis feeds/stats.txt dans le répertoire du module. Ce fichier est mis à jour à chaque fin de cycle de génération.
Calcul des valeurs
Horodatage de la dernière génération (FPF_LAST_UPDATED) : Enregistré sous forme de timestamp Unix à la fin de toute génération de flux. Le tableau de bord le convertit en chaîne lisible « il y a X temps » à l'aide d'un formateur tenant compte des intervalles : minutes pour moins d'une heure, heures et minutes jusqu'à 24 heures, jours et heures jusqu'à 7 jours, et total en jours au-delà.
Indicateur de première génération (FPF_FIRST_GENERATED) : Mis à 1 lors de la première génération de flux réussie. Le module utilise cet indicateur pour décider d'afficher le tableau de bord ou le guide pas à pas en premier.
Durée de génération (FPF_FEED_GENERATION_TIME) : Stockée sous forme de nombre à virgule flottante. La carte Performances l'affiche avec deux décimales et la divise par le nombre total de produits pour calculer la moyenne par produit.
Compteurs de produits : Agrégés depuis feeds/stats.txt au chargement de la page. Le tableau de bord additionne les champs totalp, current, errors, skipped et added_combi sur toutes les lignes de flux du fichier.
Remarques
- Le tableau de bord est en lecture seule. Aucune des valeurs affichées ici ne peut être modifiée ; elles reflètent le résultat de la génération la plus récente.
- Tous les horodatages et durées de génération affichés dans le tableau de bord sont globaux — ils reflètent la dernière génération sur l'ensemble des boutiques, pas les valeurs par boutique. Le détail par boutique se trouve dans le tableau de statistiques.
- Si vous utilisez le module en mode multi-boutique, le tableau de statistiques comportera une ligne par boutique et par type de flux. Les cartes de statut agrègent toujours l'ensemble des boutiques.
- Les URLs de flux contiennent un hash dérivé de
_COOKIE_KEY_. Si vous modifiez la clé secrète de votre PrestaShop, les URLs de flux existantes changeront et vous devrez les mettre à jour dans Meta Business Manager. - La section URL de paiement de la boutique (affichée entre les URLs de flux et le tableau de statistiques lorsque la fonctionnalité de paiement est configurée) dispose également d'un bouton copier et d'un bouton Test ; ceux-ci sont d écrits dans le guide URL de paiement de la boutique.
Dépannage
| Problème | Solution |
|---|---|
| Le tableau de bord n'apparaît pas en haut de la page | Le flux n'a pas encore été généré. Utilisez la Génération manuelle du flux pour effectuer la première génération, puis rechargez la page. |
| Le badge Dernière génération affiche Obsolète | Votre tâche cron ne s'exécute pas ou s'est arrêtée. Vérifiez la section Génération automatique (Cron Jobs) et contrôlez l'entrée cron sur votre serveur. |
| La section URLs du flux est vide | Au moins une génération doit se terminer avec succès avant que les URLs apparaissent. Si la génération échoue en cours de route, la section URL peut rester vide. |
| Le tableau de statistiques est absent | feeds/stats.txt n'a pas été écrit lors de la génération. Vérifiez que le répertoire feeds/ est accessible en écriture par le serveur web. |
| La carte Produits affiche 0 pour tous les indicateurs | Une génération précédente a peut-être été interrompue. Lancez une nouvelle génération complète pour reconstruire stats.txt. |
Foire aux questions
À quelle fréquence dois-je regénérer mon flux pour que le tableau de bord reste vert ?
Générez votre flux au moins une fois toutes les 24 heures pour que le badge de statut reste vert. Pour les boutiques avec des mises à jour fréquentes de stocks ou de prix, une fréquence de 1 à 6 heures est recommandée. Configurez une tâche cron pour automatiser cela.
Que signifie le badge rouge Obsolète dans le tableau de bord ?
Votre flux n'a pas été regénéré depuis plus de 48 heures. La copie de votre catalogue chez Facebook peut afficher des prix obsolètes, des produits indisponibles ou des nouveautés manquantes. Lancez une nouvelle génération dès que possible.
Pourquoi le Total de la carte Produits ne correspond-il pas au nombre de produits dans ma boutique ?
Le Total comptabilise uniquement les produits que le module a tenté d'inclure selon vos paramètres de filtrage actuels — les produits exclus par catégorie, disponibilité ou d'autres règles sont comptés séparément sous Ignorés. Les produits ayant rencontré une erreur lors du traitement sont comptés sous Erreurs.
Puis-je avoir plus de trois URLs de flux par boutique ?
Non. Chaque boutique peut avoir au maximum un flux principal (Main Feed), un flux de langues (Languages Feed) et un flux de pays (Countries Feed). Le flux de langues regroupe toutes les langues activées dans un seul fichier ; le flux de pays regroupe tous les paramètres de pays activés dans un seul fichier.
L'URL du flux a changé après une migration de serveur — pourquoi ?
Les URLs de flux contiennent un hash dérivé de votre _COOKIE_KEY_ PrestaShop. Si cette clé a changé lors de la migration (par exemple lors d'une nouvelle installation de PrestaShop), les URLs seront différentes. Copiez les nouvelles URLs depuis le tableau de bord et mettez à jour la source de données de votre catalogue dans Meta Business Manager.
Qu'est-ce que l'indicateur de première génération et quand se réinitialise-t-il ?
Cet indicateur (FPF_FIRST_GENERATED) est mis à 1 lors de la première génération de flux réussie. Il détermine si le guide pas à pas ou le tableau de bord s'affiche en premier. Il ne se réinitialise jamais automatiquement — si vous devez le réinitialiser (par exemple après une réinstallation du module), vous pouvez le faire en réinstallant le module ou en effaçant la configuration de la base de données.