Génération du flux par boutique — Langues, devises et pays
Configurez les langues et les pays pour lesquels le flux de votre catalogue produits est généré, ainsi que la devise reçue par chaque marché.
Disponible depuis la v2.0.0
Vue d'ensemble
Le module génère jusqu'à trois fichiers XML distincts par boutique : un flux principal, un flux Langues optionnel et un flux Pays optionnel. Vous choisissez les langues et les pays actifs, et le module produit les données produits correctes — noms traduits, descriptions, URLs et prix dans la bonne devise — pour chacun d'eux.
Facebook et Instagram exigent une seule URL de catalogue par marché. En activant des langues et des pays supplémentaires ici, vous évitez de gérer plusieurs installations du module ou de dupliquer manuellement les catalogues. Une seule génération produit tous les fichiers dont vos comptes publicitaires ont besoin.
Si votre boutique ne vend que dans une seule langue et une seule devise, il vous suffit de configurer le flux principal. Les flux Langues et Pays sont facultatifs et ne sont générés que lorsqu'au moins une langue ou un pays est activé en dehors des valeurs par défaut.
Configuration
- Accédez à Modules > Gestionnaire de modules, trouvez Facebook & Instagram Product Catalogue Feed Pro et cliquez sur Configurer.
- Cliquez sur l'onglet Génération du flux. Si vous gérez plusieurs boutiques, un onglet distinct apparaît pour chacune d'elles.
- Configurez les champs décrits ci-dessous, puis cliquez sur Enregistrer la configuration.
Paramètres du flux principal
| Champ | Valeurs | Description |
|---|---|---|
| Générer cette boutique ? | Activé / Désactivé | Apparaît uniquement dans les configurations multi-boutiques. Lorsqu'il est désactivé, cette boutique est entièrement ignorée lors de la génération du flux — aucun fichier n'est écrit et les URLs de flux de la boutique retournent un contenu vide. |
| Langue par défaut du flux | Toute langue active | La langue utilisée pour les noms de produits, les descriptions et les URLs dans le flux principal. |
| Devise par défaut du flux | Toute devise active | La devise utilisée pour les prix des produits dans le flux principal. Définissez-la sur votre devise de vente principale. |
| URL du flux par défaut | (lecture seule) | L'URL à enregistrer dans Facebook Ads Manager > Catalogues. Cliquez dessus pour la copier dans votre presse-papiers. |
Le flux principal est toujours généré tant que la boutique est activée. Il utilise la langue et la devise par défaut que vous choisissez ici, quels que soient les paramètres de langue ou de pays supplémentaires.
Langues supplémentaires
Cette section n'apparaît que lorsque votre boutique comporte plus d'une langue active.
| Champ | Valeurs | Description |
|---|---|---|
| Générer [Nom de la langue] | Activé / Désactivé | Lorsqu'il est activé, les données produits de cette langue sont incluses dans le flux Langues. Vous pouvez activer autant de langues que vous en avez de disponibles. |
| URL du flux Langues | (lecture seule) | L'URL du flux Langues. Utilisez cette URL — et non l'URL du flux principal — pour enregistrer le catalogue spécifique à cette langue dans Facebook. |
N'activez une langue ici que si vous disposez de noms de produits, descriptions et URLs traduits dans votre boutique pour cette langue. Si les traductions sont absentes, le flux utilisera le contenu de la langue par défaut.
Les langues déjà sélectionnées comme Langue par défaut du flux sont automatiquement exclues du flux Langues pour éviter les doublons.
Substitution de devise / Prix par pays
Cette section n'apparaît que lorsque votre boutique comporte plus d'un pays actif.
| Champ | Valeurs | Description |
|---|---|---|
| [Nom du pays] (bascule) | Activé / Désactivé | Lorsqu'il est activé, une section spécifique à ce pays est incluse dans le flux Pays avec les prix dans la devise sélectionnée. |
| Devise | Toute devise active | La devise à utiliser pour les prix des produits lors de la génération du flux Pays pour ce pays. |
| Langue associée | Toute langue active | La langue utilisée pour les noms de produits, les descriptions et — point crucial — les URLs des produits dans le flux de ce pays. Facebook utilise l'URL pour rediriger les acheteurs directement vers la page produit correcte. |
| URL du flux Pays | (lecture seule) | L'URL du flux Pays. Enregistrez cette URL dans Facebook lorsque vous avez besoin de prix ou de devises spécifiques par pays. |
Intégration du catalogue Facebook
| Champ | Description |
|---|---|
| Numéro de catalogue | L'ID de votre catalogue produits Facebook. Visible uniquement lorsque le module Facebook Pixel Plus est également installé. Trouvez ce numéro dans Facebook Ads Manager > Catalogues — il apparaît sous le nom de votre catalogue. Collez-le ici pour que les deux modules puissent échanger des données. |
Fonctionnement
Trois flux, une seule génération
À chaque génération du flux — qu'elle soit manuelle, via cron ou via l'URL de génération — le module écrit jusqu'à trois fichiers XML par boutique :
- Flux principal (
fpf-{shop-name}-{hash}.xml) : toujours généré. Contient tous les produits actifs dans la langue et la devise par défaut. - Flux Langues (
fpf-{shop-name}-lang-{hash}.xml) : généré uniquement si au moins une langue est activée dans la section Langues supplémentaires. Contient les mêmes produits traduits dans chaque langue activée. - Flux Pays (
fpf-{shop-name}-country-{hash}.xml) : généré uniquement si au moins un pays est activé dans la section Pays. Contient les prix recalculés dans la devise assignée au pays.
Les trois fichiers partagent le même catalogue produits. Activer davantage de langues ou de pays ne duplique pas les produits — cela génère des représentations localisées supplémentaires des mêmes articles.
Stockage des données de langue et de pays
Lorsque vous enregistrez les paramètres de Génération du flux, le module stocke les langues activées sous forme d'objet JSON compact dans un seul enregistrement de base de données (FPF_{shop_id}_LANGS). Les paramètres de pays — le flag d'activation, la devise et la langue associée — sont stockés ensemble dans un second enregistrement JSON (FPF_{shop_id}_COUNTRIES). Cette conception signifie que la génération du flux ne lit que deux lignes de base de données pour connaître l'ensemble de la matrice langues/pays, ce qui maintient une génération rapide même avec de nombreux paramètres régionaux configurés.
Comportement en multi-boutiques
Chaque boutique possède son propre onglet Génération du flux avec des paramètres indépendants. Le bouton Générer cette boutique ? (visible uniquement en mode multi-boutiques) vous permet d'exclure entièrement une boutique de la génération sans supprimer sa configuration. La langue par défaut, la devise et les substitutions de langue ou de pays sont toutes stockées par boutique et ne sont jamais partagées entre boutiques.
URLs et sécurité
Les URLs de flux contiennent un hash MD5 dérivé de la clé de cookie de votre boutique. Cela les rend impossibles à deviner sans être configurables. Si vous avez besoin de protéger davantage les flux, utilisez les paramètres de protection du flux (authentification HTTP Basic) dans l'onglet Protection du flux — ces paramètres s'appliquent aux trois types de flux.
Exemples d'utilisation
Exemple : boutique française vendant en France, en Belgique et en Suisse
Définissez la Langue par défaut du flux sur le français et la Devise par défaut du flux sur EUR. Activez la Suisse dans la section Pays et sélectionnez CHF comme devise avec le français comme langue associée. Le flux principal couvre la France et la Belgique (toutes deux en EUR) ; le flux Pays couvre la Suisse avec les prix en CHF. Enregistrez les deux URLs de flux dans vos paramètres de catalogue Facebook.
Exemple : boutique espagnole avec des traductions en anglais et en allemand
Définissez la langue par défaut sur l'espagnol. Activez l'anglais et l'allemand dans la section Langues supplémentaires. Les trois langues sont incluses dans le flux — l'espagnol dans le flux principal, l'anglais et l'allemand dans le flux Langues. Enregistrez l'URL du flux Langues dans Facebook en complément de l'URL du flux principal pour servir les acheteurs dans chaque langue.
Exemple : configuration multi-boutiques avec une boutique B2B et une boutique B2C
Dans une configuration multi-boutiques, chaque onglet de boutique est indépendant. Activez le bouton Générer cette boutique ? uniquement pour la boutique B2C. La boutique B2B est exclue de toute génération de flux, ce qui empêche les prix grossistes d'apparaître dans votre catalogue Facebook.
Notes importantes
- Le bouton Générer cette boutique ? n'apparaît qu'en mode multi-boutiques. Sur les installations mono-boutique, la génération est toujours active.
- L'URL du flux Langues et l'URL du flux Pays sont identiques pour toutes les boutiques — le module utilise les mêmes noms de fichiers hashés pour toutes les boutiques. Si vous gérez plusieurs boutiques, leurs flux sont écrits dans des fichiers distincts nommés d'après le slug de la boutique.
- Les entrées de pays n'apparaissent dans cette section que si le pays est actif et associé à la boutique actuelle dans votre back-office PrestaShop (International > Localisations > Pays).
- Désactiver toutes les boutiques dans une configuration multi-boutiques entraîne l'abandon immédiat de la génération sans aucune sortie.
- La Langue associée d'un pays affecte à la fois le contenu des produits (noms, descriptions) et les URLs des produits dans le flux Pays. Si votre boutique dispose d'URLs spécifiques à une langue (par ex.
/de/pour l'allemand), assignez la langue correcte afin que le lien dans le flux pointe vers la bonne page pour les acheteurs de ce pays.
Résolution des problèmes
| Problème | Solution |
|---|---|
| La section Langues ou Pays n'apparaît pas | La section est masquée lorsque votre boutique ne comporte qu'une seule langue ou un seul pays actif. Ajoutez d'autres langues ou pays dans International > Traductions et International > Localisations, puis revenez à cet onglet. |
| L'URL du flux Pays retourne un fichier vide | Aucun pays n'est encore activé, ou tous les pays activés n'ont aucun produit après les filtres de catégorie/exclusion. Activez au moins un pays et régénérez. |
| Les prix d'un pays apparaissent dans la mauvaise devise | Vérifiez le menu déroulant Devise pour ce pays dans la section Pays. Assurez-vous que la devise sélectionnée est active dans International > Localisation > Devises. |
| Après l'enregistrement, une sélection de langue revient à la valeur précédente | Le formulaire conserve le dernier état enregistré depuis le stockage JSON. Si le menu déroulant semble se réinitialiser, videz le cache de votre navigateur et rechargez la page de configuration. |
| Multi-boutiques : seul le flux d'une boutique est généré | Vérifiez que Générer cette boutique ? est activé pour toutes les boutiques que vous souhaitez inclure. Ce paramètre est global — il n'est pas affecté par le sélecteur de contexte de boutique du back-office. |
| Le champ Numéro de catalogue est absent | Ce champ n'apparaît que lorsque le module Facebook Pixel Plus (facebookconversiontrackingplus) est installé et actif. |
Foire aux questions
Dois-je enregistrer les trois URLs de flux dans Facebook ?
N'enregistrez que les URLs des flux que vous avez réellement configurés. Si vous n'avez activé aucune langue supplémentaire, ignorez l'URL du flux Langues. Si vous n'avez activé aucun pays, ignorez l'URL du flux Pays. Enregistrer une URL de flux vide ou inexistante dans Facebook provoquera des erreurs de catalogue.
Que se passe-t-il si je change la langue par défaut après la première génération ?
La prochaine génération reconstruit le flux principal dans la nouvelle langue par défaut. L'ancien fichier est remplacé. Si Facebook a déjà importé le flux précédent, il mettra à jour son catalogue lors du prochain import planifié.
Puis-je avoir une devise par défaut différente pour chaque langue ?
Pas via le flux Langues — celui-ci utilise la même devise par défaut que le flux principal, en traduisant uniquement le contenu textuel. Pour servir des devises différentes, utilisez le flux Pays et assignez à chaque pays sa propre devise dans le menu déroulant Devise.
Comment la langue associée d'un pays affecte-t-elle les URLs des produits ?
Facebook utilise l'URL du produit dans le flux pour rediriger les acheteurs vers la page produit correcte. Si votre boutique dispose d'URLs spécifiques à une langue (par ex. /fr/ pour le français, /en/ pour l'anglais), définissez la langue associée en conséquence afin que le lien dans le flux se résolve correctement pour les acheteurs de ce pays.
Si j'active dans Langues supplémentaires la même langue que celle utilisée par défaut, apparaîtra-t-elle deux fois ?
Non. Le module exclut automatiquement la langue par défaut du flux Langues lors de la génération, même si elle est activée dans la section Langues supplémentaires.
L'activation de nombreux pays ralentira-t-elle la génération du flux ?
Chaque pays activé ajoute une passe supplémentaire sur votre catalogue produits lors de la génération. Pour les grands catalogues, envisagez d'utiliser les paramètres de génération par cycles (onglet Options de génération) pour répartir le travail sur plusieurs requêtes, ou configurez une tâche cron pour une génération non surveillée.
Fonctionnalités associées
- Options de génération — Configurer la taille des cycles, les délais d'expiration et le nombre maximum de produits par exécution
- Protection du flux — Protéger vos URLs de flux par authentification HTTP Basic
- Génération automatique (tâches cron) — Planifier la génération du flux sans intervention manuelle