Résolution des problèmes liés au contenu de vos Checkout Blocks
Le contenu de vos Checkout Blocks peut ne pas s’afficher comme prévu pour diverses raisons, ce qui peut entraîner la disparition ou le dysfonctionnement de certains éléments. Les problèmes courants incluent le non-respect des règles d’affichage, des autorisations mal configurées ou des écarts entre les paramètres du bloc lui-même et la manière dont le bloc a été ajouté à l’éditeur de page de paiement et de comptes.
Ce guide vous aide à résoudre vous-même les problèmes courants liés à Checkout Blocks. Si vous rencontrez toujours des problèmes après avoir suivi les étapes de ce guide, contactez l’Assistance Shopify pour obtenir de l’aide.
Sur cette page
- Résolution des problèmes liés aux blocs
- Résolution des erreurs lors de la création ou de l’enregistrement de blocs
- Résolution des problèmes de réductions personnalisées
- Résolution des problèmes de personnalisation de la livraison et des moyens de paiement
- Validation de vos modifications avec un paiement test
- Foire aux questions
- Avant de contacter l’Assistance Shopify au sujet de Checkout Blocks
Résolution des problèmes de blocs
Les blocs sont les éléments de personnalisation qui affichent du contenu sur votre page de paiement, tels que des champs personnalisés, du contenu dynamique et des bannières. Si un bloc ne fonctionne pas comme prévu, utilisez les sections suivantes pour identifier et résoudre le problème.
Le bloc ne s’affiche pas sur la page de paiement
Résoudre le problème d’un bloc non ajouté à l’éditeur
La création d’un bloc dans l’application Checkout Blocks ne l’ajoute pas automatiquement à votre page de paiement. Vous devez ajouter le bloc à la configuration de votre page de paiement à l’aide de l’éditeur de la page de paiement et des comptes.
Étapes :
- Depuis votre interface administrateur Shopify, accédez à Paramètres > Paiement.
Résoudre le problème d’un bloc qui n’est pas défini comme Actif
Un bloc doit être défini comme Actif pour s’afficher sur la page de paiement. Les blocs en brouillon ne s’affichent pas pour les clients.
Étapes :
- Depuis votre interface administrateur Shopify, accédez à Applications > Checkout Blocks.
Résoudre le problème d’un bloc non publié sur un marché ou une page
Si votre bloc est configuré avec des paramètres de publication propres à un marché, il s’affiche uniquement sur les marchés que vous avez sélectionnés. Si le bloc n’est publié que sur des pages de paiement spécifiques, il ne s’affichera pas sur les autres pages.
Étapes :
- Depuis votre interface administrateur Shopify, accédez à Applications > Checkout Blocks.
Résoudre le problème de règles d’affichage non respectées
Les règles d’affichage définissent les conditions qui doivent être remplies pour qu’un bloc s’affiche sur la page de paiement. Si ces conditions ne sont pas remplies pendant la session de paiement d’un client, le bloc ne s’affiche pas.
Étapes :
- Depuis votre interface administrateur Shopify, accédez à Applications > Checkout Blocks.
Résoudre le problème de non-concordance de l’ID du bloc
Chaque type de bloc dans l’éditeur de page de paiement et de comptes a un paramètre ID du bloc. L’ID du bloc dans l’éditeur doit correspondre à l’ID du bloc que vous avez créé dans l’appli Checkout Blocks. Si les ID ne correspondent pas, le bloc ne s’affiche pas.
Par exemple, si votre bloc a un ID de bloc de 4 dans l’appli Checkout Blocks, le bloc dans l’éditeur de page de paiement et de comptes doit également avoir son ID de bloc défini sur 4.
Étapes :
- Depuis votre interface administrateur Shopify, accédez à Applications > Checkout Blocks.
Résoudre le problème du champ d’ID du bloc d’aperçu contenant une valeur
Le champ ID du bloc d’aperçu (à des fins de test) dans l’éditeur de page de paiement et de comptes est destiné uniquement aux tests. Si ce champ contient une valeur après l’enregistrement de votre page de paiement, cela peut remplacer les règles d’affichage de votre bloc et entraîner un comportement inattendu.
Étapes :
- Depuis votre interface administrateur Shopify, accédez à Paramètres > Paiement.
Résoudre le problème d’un bloc de priorité supérieure qui s’affiche à la place
Si vous avez plusieurs blocs du même type avec des règles d’affichage qui se chevauchent, seul le bloc ayant la priorité la plus élevée s’affiche. En savoir plus sur la priorité des blocs.
Étapes :
- Depuis votre interface administrateur Shopify, accédez à Applications > Checkout Blocks.
Résolution de problèmes liés à la limite de blocs actifs atteinte
Checkout Blocks prend en charge jusqu’à 30 blocs actifs par type de bloc. Si vous avez plus de 30 blocs actifs d’un seul type, par exemple 35 blocs de champs personnalisés actifs, seuls les 30 premiers blocs peuvent s’afficher sur la page de paiement.
Étapes :
- Depuis votre interface administrateur Shopify, accédez à Applications > Checkout Blocks.
Un bloc s’affiche plusieurs fois sur la page de paiement
Résolution de problèmes liés à un bloc ajouté à une section partagée
Selon l’endroit où vous ajoutez un bloc dans l’éditeur de page de paiement et de comptes, il peut s’afficher à chaque étape du processus de paiement. La section Récapitulatif de la commande et la zone associée au bouton Continuer ou retourner sont identiques sur toutes les pages de paiement.
Pour afficher un bloc uniquement à une étape spécifique, ajoutez-le à la zone de contenu principale de cette étape.
Étapes :
- Depuis votre interface administrateur Shopify, accédez à Paramètres > Paiement.
Résolution de problèmes liés à l’ajout de plusieurs instances de bloc
Certains types de blocs, tels que les blocs de Modification d’article, ne doivent généralement être ajoutés qu’une seule fois à la page de paiement. Le bloc s’appuie sur des règles d’affichage pour afficher un contenu différent pour des scénarios différents. Si le contenu du bloc est dupliqué, il se peut que vous ayez accidentellement ajouté le bloc plus de fois que nécessaire.
Étapes :
- Depuis votre interface administrateur Shopify, accédez à Paramètres > Paiement.
Résolution des erreurs lors de la création ou de l’enregistrement de blocs
Si une erreur s’affiche lorsque vous essayez de créer ou d’enregistrer un bloc, consultez les sections suivantes.
Résolution de l’erreur « Des problèmes sont survenus lors de la soumission de votre formulaire »
Cette erreur indique généralement que votre compte d’employé ne dispose pas des autorisations requises pour créer des blocs dans Checkout Blocks.
Autorisations requises :
- Autorisations de la boutique > Contenu : les employés doivent disposer des autorisations pour consulter, ainsi que pour créer et modifier les définitions de métaobjet, et également pour consulter, ainsi que pour créer et modifier les entrées.
- Autorisations de la boutique > Paramètres de la boutique : les employés doivent disposer de l’autorisation Gérer les paramètres.
- Autorisations des applications : les employés doivent disposer au minimum des autorisations pour Checkout Blocks.
Étapes :
- Depuis votre interface administrateur Shopify, accédez à Paramètres > Utilisateurs et autorisations.
- Cliquez sur le compte d’employé qui rencontre l’erreur.
- Sous Autorisations de la boutique, développez la section Contenu.
- Vérifiez que les autorisations Consulter et Créer et modifier sont sélectionnées pour les définitions de métaobjet.
- Vérifiez que les autorisations Consulter et Créer et modifier sont sélectionnées pour les entrées.
- Sous Paramètres de la boutique, vérifiez que l’autorisation Gérer les paramètres est sélectionnée.
- Sous Autorisations des applications, vérifiez que Checkout Blocks est sélectionné.
- Cliquez sur Enregistrer.
Si vous ne disposez pas de l’autorisation de modifier les autorisations des employés, contactez le propriétaire de la boutique ou un employé disposant des autorisations de gestion des utilisateurs.
Résolution des problèmes liés aux réductions personnalisées
Il est possible que les réductions personnalisées créées dans Checkout Blocks ne s’appliquent pas comme prévu pour plusieurs raisons.
Résolution de problèmes liés à la limite de réductions automatiques actives atteinte
Shopify autorise un maximum de 25 réductions automatiques actives à la fois, y compris les réductions basées sur des applis provenant de toutes les applications installées. Cette limite s’applique à l’ensemble de votre boutique, et pas seulement à Checkout Blocks.
Si vous essayez d’activer une 26e réduction automatique, elle ne sera pas appliquée au moment du paiement.
Étapes :
- Depuis votre interface administrateur Shopify, accédez à Réductions.
- Filtrez pour n’afficher que les réductions automatiques.
- Comptez le nombre de réductions automatiques actuellement actives.
- Si vous avez 25 réductions automatiques actives ou plus, désactivez ou supprimez celles dont vous n’avez plus besoin avant d’en activer de nouvelles.
En savoir plus sur les limites relatives à la combinaison des réductions.
Résolution de problèmes de réduction non active
Une réduction personnalisée doit être définie comme Active pour s’appliquer au moment du paiement. La réduction ne doit pas non plus être arrivée à expiration, en fonction des dates de début et de fin configurées.
Étapes :
- Depuis votre interface administrateur Shopify, accédez à Applications > Checkout Blocks.
Résolution de problèmes de règles de réduction non respectées
Les réductions personnalisées dans Checkout Blocks peuvent avoir des règles conditionnelles détaillées qui déterminent quand la réduction s’applique. Si ces conditions ne sont pas remplies pendant la session de paiement d’un client, la réduction ne s’appliquera pas.
Étapes :
- Depuis votre interface administrateur Shopify, accédez à Applications > Checkout Blocks.
Résolution des problèmes liés aux personnalisations des modes de livraison et de paiement
Si les modes de livraison ou de paiement ne sont pas masqués, renommés ou réorganisés comme prévu, consultez les sections suivantes.
Résoudre le problème de la personnalisation inactive
Une personnalisation de mode de livraison ou de paiement doit être définie sur Active pour qu’elle s’applique à l’étape du paiement.
Étapes :
- Depuis votre interface administrateur Shopify, accédez à Applications > Checkout Blocks.
Résoudre le problème de la limite de fonctions actives atteinte
Shopify Functions impose des limites sur le nombre de fonctions actives que vous pouvez avoir par type. Vous pouvez activer un maximum de 25 fonctions de personnalisation des paiements sur chaque boutique. Si vous dépassez cette limite, vous pourriez recevoir l’erreur suivante : Failed to enable customization. Please try again or contact support.
Ces limites permettent de garantir que le processus de paiement reste très performant. Vous devez fusionner ou supprimer des personnalisations pour ne pas dépasser la limite.
Étapes :
- Depuis votre interface administrateur Shopify, accédez à Applications > Checkout Blocks.
Résolution des problèmes liés aux règles de personnalisation non respectées
Les personnalisations des modes de livraison et de paiement reposent sur des règles qui déterminent quand la personnalisation s’applique. Si ces conditions ne sont pas remplies pendant la session de paiement d’un client, la personnalisation ne prendra pas effet.
Étapes :
- Depuis votre interface administrateur Shopify, accédez à Applications > Checkout Blocks.
Validation de vos modifications avec un paiement de test
Avant de vous fier à vos personnalisations Checkout Blocks dans un environnement réel, vous devez valider leur bon fonctionnement à l’aide d’un paiement de test.
Étapes :
- À partir de votre boutique en ligne, ajoutez à votre panier des produits qui correspondent aux conditions des blocs, des réductions ou des personnalisations que vous souhaitez tester.
- Passez à l’étape du paiement, mais ne finalisez pas l’achat.
- Examinez chaque étape du paiement et vérifiez les points suivants :
- Les blocs s’affichent aux bons emplacements avec le bon contenu.
- Les réductions personnalisées s’appliquent lorsque les critères d’admissibilité sont remplis.
- Les personnalisations des modes de livraison et de paiement fonctionnent comme prévu.
- Si vous testez des règles d’affichage basées sur le total du panier, essayez différentes valeurs de panier pour confirmer que les blocs apparaissent et disparaissent aux seuils appropriés.
- Si vous testez des règles d’affichage basées sur le client, testez les scénarios de paiement pour les clients connectés et les invités.
Foire aux questions
Combien de blocs puis-je avoir d’actifs en même temps ?
Vous pouvez avoir jusqu’à 30 blocs actifs par type de bloc. Par exemple, vous pouvez avoir 30 champs personnalisés actifs, 30 blocs de contenu dynamique actifs et 30 blocs de modification d’articles du panier actifs simultanément. Vous pouvez créer plus de 30 blocs d’un même type, mais seuls les 30 premiers blocs actifs peuvent s’afficher à l’étape du paiement.
Pourquoi ai-je besoin d’autorisations du personnel spécifiques pour utiliser Checkout Blocks ?
Checkout Blocks crée des définitions de métaobjet pour stocker les configurations de blocs. Les employés ont besoin des autorisations nécessaires pour créer et modifier les définitions et les entrées de métaobjet afin de pouvoir enregistrer des blocs dans l’application. En outre, les employés ont besoin de l’autorisation Gérer les paramètres dans les Paramètres de la boutique et des Autorisations de l’application explicites pour Checkout Blocks.
Puis-je utiliser Checkout Blocks si je n’ai pas d’abonnement à Shopify Plus ?
Les marchands disposant du forfait Basic ou d’un forfait supérieur peuvent utiliser les blocs de contenu dynamique et de contenu statique sur leurs pages de remerciement et de statut de la commande uniquement. Toutes les autres fonctionnalités de Checkout Blocks, y compris les champs personnalisés, les réductions personnalisées et les personnalisations de la livraison et des moyens de paiement, nécessitent le forfait Shopify Plus.
Comment puis-je savoir quel ID de bloc utiliser ?
Lorsque vous créez un bloc dans l’application Checkout Blocks, un ID de bloc lui est attribué (la valeur par défaut est 0). Lorsque vous ajoutez ce type de bloc à votre page de paiement dans l’éditeur, vous devez définir le même ID de bloc pour que l’éditeur sache quel bloc spécifique afficher. Si vous souhaitez afficher différents blocs du même type à différents emplacements, attribuez à chaque bloc un ID de bloc unique et faites correspondre ces ID dans l’éditeur. En savoir plus sur les ID de bloc.
Puis-je combiner les réductions de Checkout Blocks avec d’autres réductions ?
Les réductions personnalisées créées dans Checkout Blocks sont des réductions automatiques optimisées par Shopify Functions. Elles suivent les mêmes règles de combinaison des réductions que les autres réductions automatiques. Vous pouvez avoir un maximum de 25 réductions automatiques actives dans votre boutique, y compris celles créées dans Checkout Blocks et d’autres applications.
Avant de contacter l’Assistance Shopify au sujet de Checkout Blocks
Si vous avez suivi les étapes de résolution de problèmes ci-dessus et que votre problème avec Checkout Blocks persiste, vous pouvez contacter l’Assistance Shopify pour obtenir de l’aide. Avant de contacter l’Assistance Shopify, rassemblez les informations suivantes, spécifiques à Checkout Blocks, pour permettre une résolution plus rapide de votre problème :
- Détails du bloc : le nom, le type (par exemple, champ personnalisé, contenu dynamique ou modification d’article du panier) et l’ID de bloc du bloc qui ne fonctionne pas.
- Captures d’écran de la configuration : des captures d’écran des paramètres du bloc dans l’appli Checkout Blocks, y compris les règles d’affichage, les paramètres de publication et le statut.
- Captures d’écran de l’éditeur : des captures d’écran de la configuration du bloc dans l’éditeur de la page de paiement et des comptes, y compris les champs ID de bloc et ID de bloc d’aperçu.
- Messages d’erreur : des captures d’écran ou le texte exact de tout message d’erreur que vous recevez lors de la création, de l’enregistrement ou de l’aperçu de blocs.
- URL du paiement de test : un lien vers un paiement de test ou un paiement abandonné où le problème peut être reproduit, ainsi que le contenu du panier utilisé pour déclencher les règles d’affichage.
- Comportement attendu par rapport au comportement réel : une description claire de ce qui était censé se passer par rapport à ce qui se passe réellement à l’étape du paiement.
- Étapes de résolution de problèmes effectuées : les sections de ce guide que vous avez déjà consultées et ce que vous avez essayé.
- Autorisations du personnel : confirmation que votre compte possède les autorisations requises pour le Contenu (définitions et entrées de métaobjets), les paramètres de la boutique (Gérer les paramètres) et les autorisations d’application (Checkout Blocks)
Ces informations spécifiques à Checkout Blocks aident l’Assistance Shopify à diagnostiquer et à résoudre votre problème plus efficacement.