Identifiants de produit et variantes#
L’élément cible de la boutique en ligne doit identifier le même produit que le catalogue marchand. La plupart des échecs d'intégration proviennent d'une incompatibilité entre ces deux valeurs.
Choisir un identifiant stable#
Utilisez le productCode affiché pour le produit préparé. Dans le tutoriel Shopify, il s'agit du SKU de la variante. Les champs de requête de l’interface Product Import API sont définis dans la référence d'import ; ne remplacez pas ces noms de champs par des noms d'attributs de la boutique en ligne.
Gardez les identifiants identiques, y compris la casse. Ne les générez pas à partir de noms d'affichage modifiables et ne supposez pas qu'un ID produit interne d'une plateforme correspond à un SKU.
Associer la variante sélectionnée#
| État de la boutique en ligne | Comportement de la cible |
|---|---|
| Une variante préparée est sélectionnée | Définissez son productCode exact |
| La sélection change | Mettez à jour la cible et effacez l'état obsolète du SDK en suivant votre guide d'intégration |
| Aucun SKU ou produit correspondant n'existe | Gardez le bouton créé manuellement masqué ou désactivé |
| Une carte produit pointe vers une variante par défaut | Utilisez l'identifiant de cette variante de manière cohérente |
Pour Shopify, connectez la fonction de synchronisation du tutoriel à la fonction de rappel réelle de changement de variante de votre thème. Pour les autres boutiques en ligne, suivez pages dynamiques.
Valider la correspondance#
Choisissez deux variantes avec des produits visiblement différents. Enregistrez leurs codes catalogue, inspectez chaque data-product-code rendu dans les outils développeur du navigateur, puis ouvrez le Viewer pour chacun. Répétez après une navigation sans rechargement complet de la page.
Lorsqu'un identifiant change dans votre système source, coordonnez l'import du catalogue et la publication de la boutique en ligne. Une réponse d'import HTTP réussie n'est qu'une acceptation ; inspectez le statut de la tâche et les échecs d'éléments avant de vous fier au nouveau code.