Ce guide vous explique comment connecter votre boutique Shopify à iAdvize pour activer l’Assistant Shopping IA sur votre site e-commerce en quelques clics.
Vous y trouverez le détail de l’installation, les champs produits synchronisés, ainsi que les limitations et points d’attention à connaître.
Installation
Si vous commencez notre offre d'essai gratuit, après avoir créé votre compte et défini votre mot de passe, cliquez sur « Connexion avec Shopify ».
Ce bouton vous ouvrira automatiquement la fiche de l’application iAdvize sur le Shopify App Store.
Autrement,
- Connectez-vous à votre interface Shopify Admin.
- Rendez-vous sur la boutique d'applications Shopify (Shopify App Store) en cliquant ici.
- Cliquez sur Installer
💡 Information
Par défaut, l’intégration iAdvize récupère les données du marché principal de la boutique Shopify.
Si vous associez un autre marché Shopify à un projet iAdvize (pendant l’installation ou depuis la page Markets de l’application), le catalogue de ce projet est synchronisé avec les prix de ce marché. Un marché non associé utilise l’assistant et les prix du projet par défaut, sauf si vous y désactivez l’assistant.
Autorisez iAdvize à accéder aux données produits et variantes de votre boutique, cliquez sur Installer :
Connexion au compte iAdvize
À partir de cette étape, l'application est disponible uniquement en anglais.
La première étape de l’installation consiste à connecter le compte iAdvize sur lequel vous souhaitez installer l'application.
Si vous avez déjà créé un compte iAdvize, cliquez sur Connect to iAdvize.
Sinon, cliquez sur Start Free Trial pour créer votre compte iAdvize.
Un e-mail vous a été envoyé précédemment pour créer un mot de passe et activer votre compte iAdvize. Renseignez vos identifiants et connectez-vous :
NB : Choisissez les marchés Shopify sur lesquels activer iAdvize et associez chacun à un projet iAdvize (site web). Le marché principal est coché par défaut. Une fois l'application installée, vous pourrez associer d'autres marchés ou changer leurs projets depuis la page Markets.
Si la liste des marchés ne s'affiche pas, l'application vous propose un seul projet pour toute la boutique (le premier est présélectionné) : votre boutique ne peut alors être liée qu'à un seul projet iAdvize. Pour changer de projet, désinstallez puis réinstallez l'application.
Cliquez sur le bouton Link projects (ou Link project s'il n'y a qu'un projet à choisir) pour continuer :
Une fois les projets associés, la synchronisation du catalogue produit démarre automatiquement en arrière-plan. Le détail est dans la section « Synchronisation du catalogue produit et tag de transaction », plus bas.
Activez votre Assistant Shopping
Étape 1 : activer le tag iAdvize sur votre boutique
Cette première étape permet d’installer le tag principal et des données personnalisées sur la boutique Shopify.
Accédez à la page de personnalisation de la boutique en ligne en cliquant sur le lien fourni. Une nouvelle fenêtre s’ouvrira avec le thème Shopify actuellement en usage.
Dans cette nouvelle fenêtre, assurez-vous des points suivants :
- L'option Tag iAdvize est activée dans le thème de la boutique.
Toujours depuis le menu App Embeds → Tag iAdvize, vous pouvez répondre à la question Comment souhaitez-vous qu'iAdvize se charge et s'affiche sur votre boutique ? de la section Consentement aux cookies pour adapter le comportement du tag à votre système de gestion du consentement (CMP).
| Mode | Comportement |
|---|---|
| Chargement selon le pays (par défaut) | Le tag se charge sans attendre de consentement sur les boutiques basées aux États-Unis. Pour les boutiques situées dans d'autres pays, le chargement est conditionné au consentement de l'utilisateur via la bannière Shopify native. Si l'API de consentement Shopify n'est pas disponible sur la boutique, le tag se charge sans attendre le consentement. |
| Bannière cookies Shopify | Le tag se charge uniquement si l'utilisateur a donné son consentement via la bannière Shopify native, quelle que soit la localisation de la boutique. À utiliser si la bannière Shopify est votre seul système de gestion du consentement. |
| Outil de consentement externe | Le tag se charge sans attendre le signal de consentement Shopify. À utiliser si votre CMP externe gère déjà le chargement des scripts de manière indépendante, sans passer par l'API de consentement Shopify. |
| Installé en dehors de Shopify | Le tag reste inactif via l'application Shopify. iAdvize doit être chargé indépendamment, via un gestionnaire de tags externe (ex. Tealium, Google Tag Manager). |
- Cliquez sur le bouton Enregistrer en haut à droite pour appliquer les modifications.
Une fois les modifications enregistrées, fermez cet onglet pour revenir à l'installateur.
Ensuite, cliquez sur le bouton Next step pour continuer.
NB : Vous pouvez activer le tag iAdvize sur plusieurs thèmes, notamment si vous changez fréquemment le thème de votre boutique. Pour cela, personnalisez le thème souhaité dans la boutique en ligne, sélectionnez le menu « App Embeds » à gauche, activez l'option « Tag iAdvize » et cliquez sur Enregistrer pour mettre à jour le thème.
Étape 2 : afficher l’Assistant sur les pages de paiement et de remerciement
Cette deuxième étape permet d’afficher votre Assistant sur les pages de paiement et de remerciement.
Pour les autres plans, le chat peut uniquement être intégré sur la page de remerciement (« Thank You »).
Cliquez sur le lien fourni pour accéder à la section de personnalisation. Cela ouvrira un nouvel onglet avec le thème Shopify actuellement utilisé.
Dans le nouvel onglet, vous devez :
- Cliquer sur le bouton « + » de la section iAdvize Tag.
- Sélectionner la page où activer le tag iAdvize : Checkout.
- Cliquer sur le bouton Enregistrer en haut à droite pour appliquer les modifications.
- Cliquer de nouveau sur le bouton « + » de la section iAdvize Tag.
- Sélectionner la page où activer le tag iAdvize : Thank You Pages.
- Cliquer sur le bouton Enregistrer en haut à droite pour appliquer les modifications.
Une fois le tag activé sur les deux pages et les modifications enregistrées, vous pouvez fermer cet onglet pour revenir à l’installateur.
Ensuite, cliquez sur le bouton Next step pour continuer.
NB : Vous pouvez activer l'Assistant iAdvize sur plusieurs thèmes, en particulier si vous changez fréquemment le thème de votre boutique.
Pour cela, personnalisez le thème souhaité de votre boutique en ligne. Sélectionnez le menu App Embeds à gauche. Ensuite, activez l’option iAdvize tag, cliquez sur la page souhaitée (Checkout et/ou Thank You), puis cliquez sur Enregistrer pour mettre à jour votre thème.
Étape 3 : ajouter les pages de votre boutique comme source de connaissances
Cette dernière étape vous permet de choisir les pages web de la boutique qui seront utilisées pour créer une source de connaissances Helpful Content.
Sélectionnez autant de pages que nécessaire, mais uniquement celles contenant du contenu utile (FAQ, guides, conseils, etc.). Évitez de sélectionner des informations spécifiques aux produits afin d’assurer le bon fonctionnement de votre Assistant.
Sélectionnez les pages souhaitées, puis cliquez sur le bouton Finish app installation pour finaliser l’installation.
Page d'accueil de l'application
Une fois l’installation terminée, la page d’accueil de l’application s’affichera. Elle vous permet de consulter les fonctionnalités configurées lors de l’installation et de les ajuster :
- Settings : l’état de chaque fonctionnalité. Le bouton Manage de la ligne « Empower your AI Shopping Assistant with product data » ouvre la page Product data.
- iAdvize tag on your live theme : indique si le tag est activé dans votre thème publié (Active, Turned off ou Not added) et donne accès à l’éditeur de thème.
- Markets : le nombre de marchés couverts par votre Assistant. Le bouton Manage ouvre la page Markets. Si un marché n’est relié à aucun projet iAdvize, un bandeau Link markets s’affiche en haut de la page.
- Tax-inclusive prices : affiché seulement si les prix de votre boutique sont saisis hors taxes. Renseignez votre taux de TVA (supérieur à 0, jusqu’à 100) pour que l’Assistant affiche des prix TTC, ou laissez le champ vide pour garder les prix tels quels. Si vous vendez sur plusieurs marchés, VAT rate per market permet un taux différent par marché : 0 pour un marché sans TVA, vide pour appliquer le taux de la boutique.
Une dernière action est nécessaire :
-
Configurer et activer votre widget sur votre espace iAdvize : https://ha.iadvize.com/admin/
Synchronisation du catalogue produit et tag de transaction
Après la connexion au compte iAdvize, la synchronisation du catalogue produit commence automatiquement en arrière-plan, sans intervention supplémentaire.
Simultanément, une source de connaissances intitulée « Shopify knowledge source » sera créée dans iAdvize.
De plus, le tag de transaction sera automatiquement implémenté sur les pages de paiement via l'extension Shopify Web Pixel.
Champs synchronisés
| Champ iAdvize | Champ Shopify | Détail |
|---|---|---|
| id | variant.id | |
| item_group_id | product.id | |
| title | variant.displayName | |
| description | product.description | |
| url | product.onlineStoreUrl | |
| image_link | Variant.image.url if non null, else product.featuredImage.url | |
| additional_images_links | - | Jusqu'à 10 images supplémentaires par produit |
| availability | variant.inventoryQuantity |
InStock if inventoryQuantity > 0 Synchronisé en temps réel Mises à jour en temps réel : disponibilité calculée par Shopify (availableForSale), un produit peut rester en stock avec un stock à 0 |
| price | Variant.compareAtPrice if non null, variant.price else | Prix tel qu'enregistré dans Shopify. Si votre boutique saisit ses prix hors taxes, renseignez votre taux de TVA sur la page d'accueil de l'application. Synchronisé en temps réel |
| sale_price | Variant.price if Variant.compareAtPrice non null, null else | Prix tel qu'enregistré dans Shopify. Si votre boutique saisit ses prix hors taxes, renseignez votre taux de TVA sur la page d'accueil de l'application. Synchronisé en temps réel |
| product_type | product.productType if non null, else product.category | |
| brand | product.vendor | |
| color | variant.selectedOptions.name = “Color” or “Coloris” or “Couleur” |
|
| size | variant.selectedOptions.name = “Size” or “Taille” |
|
| material | variant.selectedOptions.name = “Material” or “Matière” |
|
| cross-sell products | variant.complementary_products | Produits complémentaires via l’app Shopify Search & Discovery |
| condition | - | |
| availabilityDate | - | |
| gender | - | |
| product details | variant.metafields & product.metafields |
Seuls les éléments que vous sélectionnez sur la page Product data de l’application sont partagés avec iAdvize : metafields (de la variante et du produit), metaobjects, tags et collections. Après la première synchronisation, les metafields trouvés dans votre catalogue sont présélectionnés, sauf les metafields techniques. Les metaobjects, tags et collections ne sont partagés que si vous les sélectionnez. Les metafields, tags et collections sélectionnés sont ajoutés dans iAdvize comme « détails produit ». |
Gérer vos marchés
Ouvrez la page Markets avec le bouton Manage du bloc Markets, sur la page d’accueil de l’application. Elle liste vos marchés Shopify et le projet iAdvize associé à chacun.
- Une ligne par marché et par devise : un marché dont les pays paient dans plusieurs devises apparaît sur une ligne par devise. Chaque ligne s’associe à son propre projet iAdvize : un même projet ne peut pas servir deux lignes.
- Badges : Primary pour le marché principal de la boutique, Covered pour un marché associé à un projet, New pour un marché que vous n’aviez pas encore vu sur cette page, Inactive in Shopify pour un marché désactivé dans Shopify. Un marché non associé porte Uses suivi du nom de votre projet par défaut, ou Assistant off.
- Associer un projet : bouton Add sur la ligne du marché (Change ou Remove si un projet est déjà associé). Le catalogue de ce projet reçoit alors les prix et la devise du marché. Lors de la synchronisation du catalogue, un produit exclu du catalogue Shopify de ce marché n’est pas envoyé à ce projet.
- Marché non associé : la liste AI Shopping Assistant de la ligne propose Use suivi du nom de votre projet par défaut, ou No assistant. Avec No assistant, iAdvize ne se charge pas pour les pays de ce marché, ni sur le site ni au paiement.
- Sur le site : l’Assistant suit le pays du visiteur et charge le projet associé à son marché.
- Au paiement : sur les pages de paiement et de remerciement, le chat s’ouvre sur le projet du pays de livraison dès que l’acheteur l’a saisi, puis garde ce projet même si le pays change.
- Ventes : chaque vente est envoyée au projet que l’acheteur a eu en naviguant sur le site, en priorité celui du pays de la commande.
Choisir les données produit partagées
Ouvrez la page Product data depuis le menu de l’application, ou avec le bouton Manage de la ligne « Empower your AI Shopping Assistant with product data » sur la page d’accueil de l’application. Seuls les éléments sélectionnés sur cette page sont partagés avec iAdvize.
- Metafields : metafields des produits et des variantes. Ceux ajoutés par des applications de SEO, d’avis ou de flux produits sont masqués ; le lien Show … hidden fields les affiche.
- Metaobjects : contenus liés à vos produits, comme un guide des tailles. Pour les partager, cliquez sur Allow access to metaobjects et confirmez l’autorisation demandée par Shopify. Sélectionner un metafield qui pointe vers un metaobject sélectionne aussi ce type de metaobject.
- Tags : chaque tag sélectionné est ajouté aux détails des produits qui le portent. Laissez de côté les tags internes, comme les codes fournisseur.
- Collections : le nom de chaque collection sélectionnée est ajouté aux détails de ses produits, par exemple pour indiquer qu’un produit est une meilleure vente.
- Field mapping · Advanced : si votre prix soldé ou vos tailles sont stockés dans un metafield, choisissez-le ici. Par défaut, le prix soldé vient du prix barré Shopify (compare-at price) et les tailles de l’option de variante Size ou Taille. Seul un metafield sélectionné plus haut peut être choisi.
Le bloc See what your AI Shopping Assistant knows about a product affiche, en lecture seule, la fiche que votre Assistant détient pour un produit. Cliquez sur Choose a product, puis choisissez si besoin la variante (Variant) et, si plusieurs marchés sont associés à un projet, le marché à consulter (Market). Chaque champ vide indique pourquoi il est vide. Si l’Assistant n’a pas de fiche pour un produit en brouillon ou archivé, un message l’indique : seuls les produits actifs sont synchronisés.
Gestion des données personnalisées (custom data)
L’application iAdvize pour Shopify crée automatiquement certaines custom data par défaut (product_id, page_type).
Si vous souhaitez ajouter des custom data supplémentaires, vous pouvez éditer votre thème Shopify en utilisant la méthode décrite dans notre plateforme développeurs.
Vous devez ensuite déclarer ces custom data dans l'admin iAdvize.
Page Checkout : spécificités
Sur les pages de paiement et de confirmation de commande, l'application iAdvize déploie automatiquement un composant Chat via l'extension Shopify dédiée au checkout. Ce déploiement est soumis à plusieurs contraintes imposées par Shopify, détaillées ci-dessous.
Disponibilité de l'emplacement Chat
Shopify ne permet qu'à une seule extension d'occuper la zone de chat du checkout à la fois. Si une autre application utilise déjà cet emplacement, le composant Chat iAdvize ne s'affichera pas sur les pages de paiement et de confirmation de commande.
Si le composant Chat iAdvize n'apparaît pas sur les pages checkout, vérifiez dans votre interface Shopify Admin → Checkout → Extensions qu'aucune autre application n'occupe déjà la zone de chat. Le cas échéant, désactivez-la pour permettre le déploiement d'iAdvize.
Pour plus d'informations sur cette contrainte, consultez la documentation officielle Shopify.
Continuité de la conversation
Pour assurer la continuité de la conversation entre votre site et les pages checkout, les cookies tiers doivent être activés dans le navigateur du visiteur.
Design et affichage du widget
Le widget affiché sur le checkout est standardisé par Shopify : son design et son libellé (« Message us ») ne peuvent pas être personnalisés.
Par ailleurs, une chatbox classique est affichée sur ces pages : le Shopping Panel n'est pas disponible dans le contexte du checkout.
Mise à jour de vos connaissances
Vous n’avez aucune action à effectuer depuis iAdvize : vos connaissances sont automatiquement synchronisées avec votre boutique Shopify. Assurez-vous simplement que vos informations soient à jour dans Shopify.
La mise à jour s’effectue quotidiennement, garantissant que votre Assistant dispose toujours des informations les plus récentes de votre catalogue et contenus utiles.