Synchroniser les métachamps
Aperçu IA
Découvrez comment synchroniser les metafields de produit et de variante d’une Source store vers une Destination store dans Tipo Sync. Vous activez le partage des metafields dans la Source store et leur synchronisation dans la Destination store, puis choisissez les metafields à synchroniser avec namespace.key. Les types de données doivent correspondre exactement entre les deux boutiques.
Voir plusVoir moins
- Les types Reference et les MetaObjects ne sont pas pris en charge ; les types de données des metafields doivent correspondre dans les deux boutiques.
- Dans la Source store, ouvrez Settings, activez Share Metafields, choisissez la ressource Product ou Variant, et ajoutez les définitions sous la forme namespace.key.
- Dans la Destination store, ouvrez Stores, ouvrez le détail de la connexion, activez Metafields sync et sélectionnez les ressources.
- Cliquez sur Save ; les définitions manquantes sont créées automatiquement dans la Destination store.
- Une valeur vide dans la Source n’écrase jamais une valeur existante dans la Destination.
Résumé généré par IA. Il peut contenir des erreurs : consultez le guide complet ci-dessous.
Ce guide explique comment synchroniser les métachamps de votre boutique source vers votre boutique de destination dans l’application Tipo.
ℹ️ Que sont les métachamps ?
Section intitulée « ℹ️ Que sont les métachamps ? »- Métachamps de produit
- Métachamps de variante (si vous l’activez)
L’application Tipo peut synchroniser les métachamps pour :
- matière, guide des tailles, spécifications
- badges personnalisés (par ex. « best_seller »)
- détails supplémentaires du produit utilisés par les thèmes ou les applications
Les métachamps sont des champs personnalisés de Shopify qui servent à stocker des données produit supplémentaires, telles que :
✅ Types de métachamps pris en charge
Section intitulée « ✅ Types de métachamps pris en charge »- Texte multiligne (Multi-line text)
- Texte enrichi (Rich text)
- Entier (Integer)
- Décimal (Decimal)
- Date et heure (Date and time)
- Date
- Dimension
- Volume
- Poids (Weight)
- Vrai ou faux (True or false)
- Évaluation (Rating)
- URL
- Montant (Money)
- Lien (Link)
- JSON
🚫 Pas encore pris en charge :
Les types de référence (par ex. référence de produit, référence de collection) ne sont actuellement pas pris en charge.
🛠️ Étape 1 : configurer les métachamps sur la boutique source
Section intitulée « 🛠️ Étape 1 : configurer les métachamps sur la boutique source »- Ouvrez l’application > cliquez sur Paramètres (Settings) > activez Partager les métachamps (Share Metafields)
- Choisissez la ressource que vous souhaitez partager :
- Ressource produit (Product resource) – Partager les métachamps de produit.
- Ressource variante (Variant resource) – Partager les métachamps de variante.
- Ajoutez des définitions de métachamps spécifiques pour limiter les métachamps partagés.
-
Cliquez sur l’icône Parcourir les métachamps (Browse metafields), ou
-
Saisissez la définition du métachamp au format :
namespace.keyPar exemple :
custom.materialseo.titlespecifications.weight
-
- Click Save to update the changes


🛠️ Étape 2 : configurer les métachamps sur la boutique de destination
Section intitulée « 🛠️ Étape 2 : configurer les métachamps sur la boutique de destination »- Ouvrez l’application > cliquez sur Boutiques (Stores) > cliquez sur l’URL de la boutique source pour ouvrir les détails de la connexion

-
Activez Synchronisation des métachamps (Metafields sync)
-
Choisissez ce qu’il faut synchroniser
Sous Données autorisées (Allow data), sélectionnez une option ou les deux :
- Ressource produit → synchroniser les métachamps de produit
- Ressource variante → synchroniser les métachamps de variante
-
Cliquez sur l’icône de recherche à droite pour voir tous les métachamps pris en charge > cliquez sur le bouton Sélectionner un métachamp valide à synchroniser (Select valid metafield to sync)


- Cliquez sur Enregistrer pour enregistrer les modifications
🔄 Ce qui se passe pendant la synchronisation
Section intitulée « 🔄 Ce qui se passe pendant la synchronisation »1) Si la boutique de destination n’a pas la définition du métachamp
Section intitulée « 1) Si la boutique de destination n’a pas la définition du métachamp »L’application crée automatiquement la définition du métachamp dans la boutique de destination (lorsque nécessaire).
Une fois celle-ci créée, les valeurs de métachamps synchronisées apparaissent sur le produit ou la variante dans la boutique de destination.
2) Si des métachamps existent mais ne sont pas « structurés » (métachamps non structurés)
Section intitulée « 2) Si des métachamps existent mais ne sont pas « structurés » (métachamps non structurés) »Dans certains cas, les métachamps peuvent être synchronisés même s’ils n’ont pas été entièrement définis ou structurés dans la boutique de destination.
Pour les consulter dans l’admin Shopify :
- ouvrez Paramètres → Métachamps et métaobjets (Settings → Metafields and metaobjects) de la boutique
- Choisissez Produit (Product) (ou Variante (Variant))
- Ouvrez Voir les métachamps non structurés (View unstructured metafields)
💡 Astuce : vous pourrez définir ou structurer manuellement ces métachamps plus tard afin de garder les données de votre boutique propres et cohérentes.

3) Si la boutique source n’a aucune valeur, la destination n’est pas écrasée
Section intitulée « 3) Si la boutique source n’a aucune valeur, la destination n’est pas écrasée »Si un métachamp existe dans la destination mais que la valeur de la source est vide, Tipo Sync n’écrase pas la valeur de la destination.
4) Les types de données doivent correspondre (très important)
Section intitulée « 4) Les types de données doivent correspondre (très important) »Les types de données des métachamps doivent correspondre exactement entre la source et la destination.
Exemples de types de données qui ne correspondent pas :
single_line_text_fieldvsmulti_line_text_fieldnumber_integervsnumber_decimalproduct_referencevstext
⚠️ Si les types de données ne correspondent pas, la synchronisation peut échouer ou ignorer ce métachamp.
📌 Exemple : synchroniser un métachamp de produit – « Material » (matière)
Section intitulée « 📌 Exemple : synchroniser un métachamp de produit – « Material » (matière) »Vous souhaitez synchroniser un métachamp de produit personnalisé appelé Material (par ex. « Cotton », « Leather », « Wool ») de votre boutique source vers votre boutique de destination à l’aide de notre application.
Étape 1 : définir le métachamp dans Shopify
Section intitulée « Étape 1 : définir le métachamp dans Shopify »Dans votre boutique source :
- Allez dans l’admin Shopify > ouvrez Paramètres > Métachamps et métaobjets de la boutique > choisissez Produit (ou Variante)
- Cliquez sur Ajouter une définition (Add definition) (si elle n’est pas déjà créée) > remplissez la définition du métachamp :
- Nom (Name) : Material
- Espace de noms (Namespace) :
custom - Clé (Key) :
material - Type : Texte sur une seule ligne (Single line text)
=> Vous obtenez ainsi la clé complète du métachamp : custom.material
Répétez cette étape dans votre boutique de destination (la clé et le type doivent être identiques).

Étape 2 : ajouter des données de métachamp aux produits
Section intitulée « Étape 2 : ajouter des données de métachamp aux produits »Dans votre boutique source, ouvrez un produit et faites défiler jusqu’à Métachamps (Metafields) > sous Material, saisissez : Cotton
Ce produit possède désormais le métachamp custom.material = "Cotton".

Étape 3 : configurer la synchronisation dans l’application Tipo
Section intitulée « Étape 3 : configurer la synchronisation dans l’application Tipo »- Ouvrez notre application dans la boutique de destination > allez dans Configuration de la connexion (Connect Configuration) > Synchronisation des métachamps
- Choisissez Métachamps spécifiques (Specific Metafields) > saisissez exactement la clé du métachamp :
custom.material

Résultat
- Notre application trouvera
custom.materialdans la boutique source - S’il n’existe pas dans le produit de la destination, l’application le créera
=> Résultat :custom.material = "Cotton"dans les deux boutiques - S’il existe dans la destination mais que la source est vide, nous n’écrasons pas la valeur
Q1 : comment définir namespace.key dans votre boutique ?
Section intitulée « Q1 : comment définir namespace.key dans votre boutique ? »Pour synchroniser un métachamp spécifique, vous devez saisir la clé de définition du métachamp au format : namespace.key (par exemple : custom.color).
Voici comment la trouver dans votre admin Shopify :
- Allez dans votre admin Shopify > accédez à Paramètres > Données personnalisées > Produits (Settings > Custom Data > Products)
- Cliquez sur le métachamp que vous souhaitez synchroniser
→ Vous verrez les valeurs Espace de noms (Namespace) et Clé (Key) - Combinez-les au format :
namespace.key
→ Exemple :custom.description
Q2 : pourquoi mes métachamps ne se synchronisent-ils pas ?
Section intitulée « Q2 : pourquoi mes métachamps ne se synchronisent-ils pas ? »Si vos métachamps ne se synchronisent pas correctement, l’une des raisons suivantes peut en être la cause :
- La synchronisation des métachamps n’est pas activée
Assurez-vous que la synchronisation des métachamps est activée dans les deux boutiques :- Activez Partager les métachamps dans la boutique source.
- Activez Recevoir les métachamps (Receive Metafields) dans la boutique de destination.

- La clé de définition du métachamp n’est pas ajoutée
En plus d’activer la synchronisation des métachamps, vous devez aussi ajouter la clé de définition du métachamp (namespace.key) que vous souhaitez synchroniser.
- Allez dans Paramètres → Partager les métachamps
- Vérifiez que Activer (Enable) est coché
- Sous Données autorisées, ajoutez la définition du métachamp au format :
namespace.key
Exemple :custom.material

- Types de métachamps non pris en charge
Certains types de données de métachamps ne sont pas pris en charge, comme les types de référence ou les métaobjets.
Rouge : métachamps non pris en charge qui ne peuvent pas être synchronisés par l’application

- Types de métachamps différents entre les boutiques
Le métachamp de votre source et celui de votre destination doivent avoir le même type de données et la même structure.
Les différences courantes sont :
- L’un des métachamps est de type Texte sur une seule ligne, tandis que l’autre est de type Texte multiligne.
- L’un des métachamps utilise Valeur unique (Single value), tandis que l’autre utilise Liste de valeurs (List of values).
Pour résoudre ces problèmes, vérifiez que les métachamps des deux boutiques ont le même espace de noms, la même clé et le même type de données, puis relancez la synchronisation.
🙋 Besoin d’aide ?
Si vous avez encore besoin d’aide, n’hésitez pas à nous écrire à hi@tipo.io. Nous serons ravis de vous accompagner.