Ces flux additionnels Shopify peuvent être de trois types différents :
- metafields et metaobjets
- traductions
- emplacements de stock
Comment faire pour créer un flux additionnel Shopify ?
L’url d’un flux additionnel Shopify est spécifique à Shopify, comme celle de votre flux principal. Elle contient :
- le jeton d’accès à l’API de l’application
- l’extension spécifiée à la fin de l’URL, qui permettra d’indiquer à Shoppingfeed quelles informations ce flux additionnel doit récupérer.
A/ Créez votre flux additionnel Shopify sur Shoppingfeed :
1 – Copiez l’url de votre flux principal en conservant le même token/jeton d'accès API Shopify et retirez les extensions contenues dans l’url copiée (les urls de flux additionnels ne doivent pas contenir d’autre paramètres que ceux supportés, voir ci-dessous) sauf l’extension "&published-status=...", celle-ci doit bien être conservée :
2 – Appliquez ensuite l’extension nécessaire à la fin de l’url, selon le type de flux additionnel que vous souhaitez créer :
- "&metafields=true" pour récupérer vos metafields et metaobjets
- "&translations=true&lang=[ISO-code]" pour récupérer les traductions
- "&locations=true" pour récupérer les différents emplacements de stock existants pour votre inventaire
3 – Via l'onglet "Catalogue > Sources", créez votre nouveau flux additionnel sur Shoppingfeed avec cette url, en utilisant la virgule (,) comme séparateur et “reference” (sans les guillemets) comme titre de la colonne SKU (à savoir que lors de la création, vous verrez un message d’erreur au moment de la preview, ce qui est normal, le format étant particulier) :
Flux additionnel - Metafields & Metaobjets
Ce type de flux additionnel récupère les metafields et metaobjets existants pour une boutique Shopify, afin qu’ils soient disponibles dans Shoppingfeed sous forme d’attributs.
Vous pouvez utiliser l’extension &metafields=true pour récupérer les metafields et metaobjets de vos produits.
Traductions des metafields et metaobjets
Si vos metafields sont traduits dans Shopify et que ces traductions sont publiées, vous pouvez préciser une langue spécifique dans laquelle Shoppingfeed doit les récupérer via le paramètre : "&lang=[isoCode]" (par exemple &lang=es). Attention, certaines langues (comme le portugais) peuvent avoir un code double (voir la liste des locales Shopify). Vous ne pouvez spécifier qu'une seule langue.
Lorsque ce paramètre est ajouté, le flux additionnel importera les metafields et les metaobjets avec leurs valeurs dans la langue spécifiée, de la façon suivante :
- avec des noms d’attributs suffixés nomdelattribut-es dans le cas de notre exemple
- avec les valeurs traduites si elles existent dans la langue spécifiée
- avec les valeurs non traduites (donc dans la langue d’origine) s’il n’y a pas de traductions existantes.
Si vous avez déjà des metafields récupérés sur Shoppingfeed via votre flux principal et que vous souhaitez passer sur une récupération par flux additionnel, veuillez prendre contact avec notre équipe Support.
Flux additionnel - Traductions
Ce type de flux additionnel récupère les traductions de tous les champs traduisibles, sauf les metafields et metaobjets. Attention, pour pouvoir être récupérées, les traductions doivent être publiées sur votre Shopify.
Les traductions peuvent uniquement exister pour les champs suivants :
- name
- link
- description
- category
- options (et les valeurs de ces options)
- collection
Les traductions peuvent être récupérées pour plusieurs langues dans un même flux additionnel. Pour cela, il faut spécifier les langues dans un même paramètre, séparées par des pipes (|), par exemple : "&translations=true&lang=en|de|it". Attention, certaines langues (comme le portugais) peuvent avoir un code double (voir la liste des locales Shopify).
Dans Shoppingfeed, les traductions seront disponibles sous forme d’attributs, avec un nom contenant la langue (code ISO à deux lettres) :
- une option (= qui varie selon le produit) aura pour nom : option-langue-nomSource-nomTraduit
- les autres attributs garderont leur nom : nomSource-Langue
Si une traduction manque pour un champ, ce champ sera vide pour la langue cible.
Flux additionnel - Emplacements de stock
Ce type de flux additionnel récupère les stocks de tous les différents emplacements pour l’inventaire des produits d’une boutique. Dans Shopify, l’inventaire pour un produit donné peut être réparti sur plusieurs stock différents, appelés emplacements.
Avec un flux additionnel de ce type, Shoppingfeed importe pour chaque produit (sous forme d’attribut) :
- tous les emplacements de stock existants
- le niveau d’inventaire pour chacun de ces emplacements.
Par défaut, les valeurs sont mises à 0 lorsqu’un emplacement n’existe pas pour un produit.