Extensions et fonctions d’application

Certaines applications ajoutent des fonctionnalités à votre boutique en utilisant des extensions et des fonctions. Les extensions et les fonctions sont configurées par le développeur d’application et deviennent disponibles lorsque vous installez et activez l’application.

Les extensions permettent aux applications d’ajouter des fonctionnalités à des sections telles que votre Boutique en ligne, le paiement, les comptes clients ou POS. Par exemple, une application peut ajouter un champ personnalisé à votre page de paiement, ouvrir un robot de chat sur votre boutique en ligne ou afficher des points de fidélité dans les comptes clients.

Les fonctions permettent aux applications de personnaliser la logique d'arrière-plan de votre boutique. Par exemple, une application peut utiliser une fonction pour créer un type de réduction personnalisée, ajuster les options de livraison au moment du paiement ou appliquer des règles de paiement spécifiques. Les fonctions s’exécutent automatiquement dans le cadre des opérations de votre boutique une fois que vous avez configuré l’application.

Vous pouvez consulter et gérer les extensions et les fonctions de vos applis installées depuis Paramètres > Applis dans votre interface administrateur Shopify. Sur la page « À propos » de l’appli, les encadrés Extensions et Functions indiquent le nombre d’extensions et de fonctions actuellement actives, ainsi que les sections de votre boutique où elles sont disponibles. Survolez le texte des sections pour voir où elles sont actives, par exemple Paiement, Comptes clients, Boutique en ligne ou POS pour les extensions, et Paiement, Réductions, Paiements ou Expédition et livraison pour les fonctions.

Cliquez sur Extensions ou Functions pour afficher la liste complète pour cette appli. Sur la page Extensions ou Functions, vous pouvez passer de l’onglet Actives à l’onglet Inactives pour voir quelles extensions ou fonctions sont actuellement en cours d’exécution. Cliquez sur une extension ou une fonction pour l’ouvrir. Selon l’extension, vous accédez à la section de votre boutique où elle peut être activée ou gérée, ou aux détails sur l’état de fonctionnement de l’extension.

Si vous êtes un(e) développeur(-euse) d’application, consultez les dev docs de Shopify sur les extensions et les dev docs de Shopify sur les fonctions pour obtenir la documentation technique.

Activation des extensions et des fonctions

Vous activez et désactivez les extensions et les fonctions dans la section de votre interface administrateur Shopify où elles sont utilisées. À partir de la page Extensions ou Fonctions dans les paramètres de l’application, cliquez sur le nom d’une extension ou d’une fonction pour accéder à la section où elle peut être gérée. Une fois que vous avez activé une extension ou une fonction, elle s'affiche comme active sur la page d'information de l’application.

Si vous pouvez consulter les détails sur l’état de fonctionnement d’une extension, cliquer sur une extension de paiement ou de comptes clients ouvre ces détails plutôt que l’éditeur. Pour ouvrir l’éditeur de l’une de ces extensions, survolez la ligne de l’extension, puis cliquez sur l’icône Ouvrir dans l’éditeur.

Extensions

Les extensions peuvent être activées dans les sections suivantes de votre interface administrateur Shopify :

Fonctions

Les fonctions peuvent être activées dans les sections suivantes de votre interface administrateur Shopify :

Événements d’appli issus des extensions

Les applis peuvent utiliser leurs extensions de paiement et de compte client pour envoyer des événements d’appli à Shopify. Un événement d’appli enregistre une action effectuée dans une extension, telle que la consultation d'une offre par un client. Shopify utilise les événements d’appli pour afficher la façon dont les clients utilisent l’appli dans les analyses de votre boutique. Le développeur d’applis peut également consulter ces événements afin de surveiller son appli et de fournir une assistance pour celle-ci, y compris à ses propres fins d'analyse.

Les applis peuvent également envoyer des événements d’appli depuis leurs extensions dans l’interface administrateur Shopify. Ces événements enregistrent les actions que vous ou vos employés effectuez dans l’appli.

Les événements d’appli sur la page de paiement et dans les comptes clients sont envoyés uniquement après qu’un client a autorisé l’analyse dans vos paramètres de confidentialité des clients. Shopify peut renvoyer au marchand, à des fins d’analyse, des informations agrégées liées aux ID de visiteur et de visite, jointes à un événement d’appli du développeur. Si vous ne souhaitez pas qu’une appli envoie des événements d’appli, désinstallez-la.

Comprendre l’état de fonctionnement des extensions

L’état de fonctionnement des extensions indique si les extensions de paiement ou de comptes clients d’une appli se chargent de manière fiable pour vos clients. Lorsqu’une extension d’appli ne se charge pas, les clients ne bénéficient pas de la fonctionnalité qu’elle ajoute à votre page de paiement ou à vos comptes clients, comme un champ personnalisé ou des points de fidélité.

Points à prendre en compte concernant l’état de fonctionnement des extensions

Avant de consulter l’état de fonctionnement des extensions d’une appli, prenez en compte les points suivants :

  • L’état de fonctionnement est évalué uniquement pour les extensions actives sur la page de paiement et dans les comptes clients.
  • L’état de fonctionnement n’est pas évalué pour les extensions d’autres sections, telles que la Boutique en ligne ou POS, ni pour les fonctions.
  • Les taux d’échec sont estimés avec prudence. Ainsi, une extension qui ne compte que quelques chargements risque moins d’être signalée à cause d’un petit nombre d’échecs.

Affichage de l’état de fonctionnement des extensions

Chaque extension de paiement ou de comptes clients affiche l’un des états de fonctionnement suivants :

  • Bon : aucun échec de chargement persistant n’a été détecté pour l’extension.
  • Avertissement : plus de 5 % des chargements de l’extension au cours des 7 derniers jours ont échoué, et le taux d’échec est resté supérieur à 5 % pendant 72 heures.
  • Critique : plus de 50 % des chargements de l’extension au cours des 7 derniers jours ont échoué, et le taux d’échec est resté supérieur à 50 % pendant 48 heures.
  • Données insuffisantes : les données sont insuffisantes pour évaluer l’état de fonctionnement de l’extension. Cet état s’affiche lorsque l’extension s’est chargée moins de 10 fois au cours des 7 derniers jours ou que l’historique de sa version actuelle est encore insuffisant. L’état de fonctionnement est évalué pour chaque version d’une extension. Une extension récemment mise à jour peut donc afficher cet état tant que sa nouvelle version ne totalise pas au moins 7 jours d’activité, même si elle se charge souvent.

Les extensions disposent également d’une page de détails qui affiche leur état de fonctionnement et les indicateurs suivants pour les 7 derniers jours :

  • Taux d’échec : proportion des chargements de l’extension qui ont échoué.
  • Échecs de chargement : nombre de fois où l’extension n’a pas pu se charger en raison d’un problème lié à l’appli.
  • Chargements de l’extension : nombre de fois où l’extension s’est chargée.

Consultation de l’état de fonctionnement d’une extension

  1. Depuis votre interface administrateur Shopify, accédez à Paramètres > Applis.

  2. Cliquez sur l’appli que vous souhaitez consulter.

  3. Cliquez sur Extensions.

  4. Dans l’onglet Actives, consultez la colonne État de fonctionnement pour chaque extension de paiement et de comptes clients.

  5. Facultatif : pour consulter plus de détails, cliquez sur le nom de l’extension.

Gestion des échecs de chargement des extensions

Si l’état d’une extension est Avertissement ou Critique, une bannière sur la page de détails de l’extension indique que les échecs sont dus à un problème lié à l’appli et que le développeur de l’appli en a été informé. Pour ouvrir l’extension dans l’éditeur, cliquez sur Ouvrir dans la page de paiement ou Ouvrir dans les comptes clients. Pour obtenir de l’aide concernant l’extension, contactez le développeur de l’appli.

Si l’état d’une extension devient Critique, les employés qui peuvent consulter l’état de fonctionnement des extensions reçoivent une alerte dans le fil des Alertes de votre boutique. Cliquez sur l’alerte pour ouvrir la page de détails de l’extension.

Résolution des erreurs liées aux fonctions

Si une fonction rencontre une erreur, un avertissement s'affiche sur la carte Fonctions de la page d’information de l’application, ainsi que sur la page des fonctions. La carte affiche Erreurs sur [number] section(s) au lieu du nombre habituel de sections disponibles, et l’avertissement indique le moment où les erreurs les plus récentes ont été détectées.

Sur la page Fonctions, les fonctions qui présentent des erreurs sont mises en évidence par une icône Avertissement. Si une fonction présente des erreurs, contactez le développeur d’application pour obtenir de l’aide. Dans certains cas, l’erreur peut déjà être résolue. Vous pouvez également partager les journaux de la fonction pour aider le développeur à résoudre le problème.