Skip to main content

​
Aperçu

Voici des réponses à quelques-unes des questions les plus courantes sur l’utilisation de l’API d’Upcart.

​
Où ajouter les scripts de l’API Upcart ?

Vous pouvez ajouter des scripts dans les paramètres Custom HTML d’Upcart ou directement dans le code de votre thème Shopify. La meilleure option dépend de vos besoins de personnalisation.

​
Comment utiliser le Custom HTML d’Upcart ?

  1. Accédez à Upcart → Settings → Custom HTML
  2. Utilisez des scripts API pour modifier le comportement du panier, comme le moment d’ouverture ou l’affichage des upsells
  3. Ajustez des éléments en dehors d’Upcart, comme masquer les boutons de la page produit

​
💡 Exemple : masquer le bouton de panier flottant lorsque le panier est vide

Note sur l’ancienne version : les callbacks window.upcartOnCartLoaded fonctionnent toujours, mais ils sont obsolètes et affichent des avertissements dans la console. Utilisez upcartSubscribeCartLoaded pour tous les nouveaux scripts. Notez que event.cart ne possède pas de propriété item_count — utilisez event.cart.items.reduce((total, item) => total + item.quantity, 0) pour calculer le nombre total d’articles.

​
Dois-je être développeur pour utiliser l’API d’Upcart ?

Non ! L’API d’Upcart est facile à utiliser, même sans compétences en programmation. De nombreuses fonctionnalités sont intégrées, et notre documentation de personnalisation inclut des scripts prérédigés que vous pouvez copier dans les paramètres Custom HTML d’Upcart — aucun codage requis ! Si vous souhaitez écrire des scripts personnalisés, des connaissances de base en JavaScript sont utiles. Si vous débutez en JavaScript, pas d’inquiétude ! Ces ressources adaptées aux débutants — W3Schools et MDN Web Docs — peuvent vous aider à démarrer.

​
L’API d’Upcart peut-elle s’intégrer à d’autres applications tierces ?

Oui ! L’API d’Upcart fonctionne avec des applications de traduction, d’analytique, d’upsell, et plus encore. Certaines s’intègrent automatiquement, tandis que d’autres peuvent nécessiter un petit script. Par exemple, si vous utilisez TripleWhale pour le suivi, vous devrez ajouter le script suivant pour vous assurer qu’il enregistre correctement l’activité du panier :
Note sur l’ancienne version : les callbacks window.upcartOnAddToCart fonctionnent toujours, mais ils sont obsolètes et affichent des avertissements dans la console. Utilisez upcartSubscribeAddedToCart pour tous les nouveaux scripts. Notez que les propriétés de l’événement se trouvent sur event.item (avec variantId et quantityAdded), et ne sont pas transmises comme paramètres séparés.
Comme chaque application est différente, consultez l’équipe d’assistance de votre application pour savoir si du code supplémentaire est nécessaire. Upcart n’offre pas d’assistance pour les scripts des applications tierces, mais votre fournisseur d’application peut avoir un guide d’intégration.

​
Comment tester si mes modifications d’API fonctionnent ?

Après avoir ajouté un script dans les paramètres Custom HTML d’Upcart, suivez ces étapes pour vous assurer qu’il fonctionne :
  1. Actualisez votre boutique et ajoutez un article au panier.
  2. Videz votre cache et réessayez pour voir les dernières modifications.
  3. Ajoutez un message de test : insérez console.log("The script works!"); avant </script> pour vérifier si votre script s’exécute.
  4. Vérifiez la console de votre navigateur :
    • Ouvrez les Dev Tools (F12 ou Ctrl + Shift + J sous Windows, Cmd + Option + J sur Mac).
    • Allez dans l’onglet Console et cherchez “The script works!”
    • Si vous voyez le message, votre script s’exécute ! Sinon, le script ne s’exécute peut-être pas correctement.
  5. Testez différentes actions (par exemple, la suppression d’un article) pour vous assurer du comportement attendu.
Résolvez les problèmes en vérifiant les fautes de frappe ou les erreurs de console et en ajustant le code au besoin.

​
Que faire si un script API ne fonctionne pas ?

Si votre script API ne fonctionne pas, essayez ces étapes de dépannage :
  • Vérifiez les fautes de frappe – Même de petites erreurs peuvent casser un script. Cherchez des caractères manquants ou une syntaxe incorrecte.
  • Vérifiez l’emplacement du script – Assurez-vous que le script se trouve dans la bonne section sous Upcart → Settings → Custom HTML. Upcart comporte dix sections de scripts (neuf points d’injection HTML plus une section Scripts-before-load) — Consultez ces sections ici.
  • Vérifiez la console du navigateur – Suivez les étapes ci-dessus pour rechercher des erreurs.
  • Testez un autre script – Essayez un autre script API Upcart prérédigé pour voir si le problème vient de votre code.
  • Toujours bloqué ? – Si vous modifiez votre thème Shopify ou intégrez des applications tierces, un expert Shopify du Shopify Partner Directory peut vous aider.
Ces étapes devraient vous aider à identifier et résoudre la plupart des problèmes de scripts !

​
Comment annuler des modifications si j’ajoute un script qui casse quelque chose ?

Si vous ajoutez un script qui ne fonctionne pas comme prévu, vous pouvez facilement le supprimer ou le désactiver :
  • Allez dans les paramètres Custom HTML d’Upcart où le script a été ajouté.
  • Supprimez le script ou désactivez-le temporairement en ajoutant // au début de chaque ligne (cela le transforme en commentaire, l’empêchant de s’exécuter).
  • Enregistrez les modifications et actualisez votre boutique pour vérifier si le problème est résolu.
Si le problème persiste, essayez de vider votre cache ou d’annuler les modifications récentes du thème — cela résout souvent des conflits cachés.
🚧 Vous recherchez des personnalisations avancées ? Vous avez besoin de personnalisations à l’échelle de la boutique ou d’intégrations avec des applications tierces ? Vous aurez peut-être besoin d’un développeur pour ajouter l’API d’Upcart à votre thème Shopify. Envisagez d’embaucher un expert Shopify via le Shopify Partner Directory et partagez avec lui notre documentation API pour obtenir de l’aide