Comment une agence peut-elle vérifier si les paramètres SEO d’un canal BigCommerce héritent des valeurs globales ?

Définition : Une agence peut examiner la réponse de BigCommerce concernant les paramètres SEO de la vitrine (storefront) pour un canal donné. Lorsqu’un champ de la réponse propre au canal vaut null, la documentation de BigCommerce indique que ce champ ne comporte aucune surcharge au niveau du canal et hérite de la valeur globale.

Points clés

• La référence Get Storefront SEO Settings de BigCommerce indique que le point de terminaison renvoie les paramètres SEO.
• Le paramètre de requête facultatif channel_id permet de demander les paramètres propres à un canal. Son omission sélectionne uniquement les paramètres globaux.
• Dans une réponse propre à un canal, null signifie que le champ concerné ne comporte aucune surcharge au niveau du canal et que sa valeur est héritée du niveau global.
• L’objet des paramètres SEO contient les champs meta_description, meta_keywords, page_title et www_redirect. Les valeurs documentées pour www_redirect sont www, no-www et none.
• La référence Update Storefront SEO Settings de BigCommerce indique que fournir null supprime une surcharge au niveau du canal et rétablit l’héritage de la valeur globale pour ce champ.
• La présentation de Multi-Storefront de BigCommerce décrit une API de paramètres qui prend en charge la configuration globale et par canal.

Comment channel_id détermine-t-il la portée des paramètres ?

Le point de terminaison GET utilise channel_id comme paramètre de requête facultatif. Une requête qui contient ce paramètre demande les paramètres du canal sélectionné ; la réponse peut ainsi faire apparaître les champs qui comportent une surcharge au niveau du canal. Une requête sans ce paramètre porte uniquement sur les paramètres globaux.

GET https://api.bigcommerce.com/stores/{store_hash}/v3/settings/storefront/seo?channel_id={channel_id}
Accept: application/json
X-Auth-Token: {access_token}

La présentation de Multi-Storefront indique que la fonctionnalité de gestion des paramètres de la REST Management API permet à une application de lire et de modifier des éléments importants de la configuration, au niveau global et par canal. L’identifiant sélectionné détermine donc la portée de l’examen des paramètres SEO.

Comment une agence repère-t-elle l’héritage dans la réponse ?

Chaque propriété s’examine séparément. Un champ texte comme page_title ou meta_description contient une valeur propre au canal lorsque la requête portant sur ce canal renvoie cette valeur. Une propriété à null est le marqueur documenté par BigCommerce pour indiquer que le canal ne comporte aucune surcharge pour cette propriété et hérite du paramètre global. L’objet data de la réponse contient les paramètres SEO, et l’objet meta contient les métadonnées de la réponse.

Les champs sont indépendants. Une même réponse peut donc contenir une valeur propre au canal pour une propriété SEO et null pour une autre. La référence de l’API répertorie meta_description, meta_keywords, page_title et www_redirect comme propriétés de SEOSettings.

Comment supprimer une surcharge au niveau d’un canal ?

La référence de mise à jour utilise le même paramètre de requête facultatif channel_id pour les modifications propres à un canal. Lorsque ce paramètre est présent, la valeur null est à fournir pour le champ dont la surcharge doit être supprimée. BigCommerce décrit cette opération comme la suppression de la surcharge pour ce canal et le rétablissement de l’héritage depuis le niveau global.

PUT https://api.bigcommerce.com/stores/{store_hash}/v3/settings/storefront/seo?channel_id={channel_id}
Content-Type: application/json
Accept: application/json
X-Auth-Token: {access_token}

{
  "meta_description": null,
  "meta_keywords": null,
  "page_title": null,
  "www_redirect": null
}

La référence de mise à jour documente aussi l’utilisation de channel_id dans le corps de la requête pour un canal à interface découplée (headless), afin de contrôler www_redirect pour l’URL de paiement unique de ce canal. Ce cas est distinct du paramètre de requête utilisé pour sélectionner les paramètres propres au canal.

Que doit consigner l’agence ?

BigCommerce définit un canal comme un espace où un commerçant vend des produits. Sa présentation indique que chaque boutique dispose dès sa création d’un canal pour sa première vitrine Stencil, et que ce canal porte l’identifiant 1 dans toutes les boutiques BigCommerce. Lors d’un audit, l’agence consigne l’identifiant du canal demandé et la valeur brute de chaque champ SEO. Une valeur null renvoyée est signalée comme héritée ; toute chaîne de caractères ou valeur d’énumération renvoyée est conservée comme paramètre propre au canal.

Termes associés

• Comment modifier l’aperçu d’une page Shopify dans les résultats de recherche ?
• Comment définir les balises meta par défaut dans le module Metatag de Drupal ?

Questions fréquentes

Que renvoie une requête sans channel_id ?

Elle sélectionne uniquement les paramètres SEO globaux. Ajoutez channel_id lorsque vous avez besoin de la réponse pour un canal précis.

Que signifie un champ SEO à null ?

Dans une réponse propre à un canal, il désigne un champ sans surcharge au niveau du canal. BigCommerce indique que le champ hérite de la valeur globale.

Comment rétablir l’héritage pour un champ ?

Envoyez null pour ce champ au point de terminaison de mise à jour, en sélectionnant le canal avec channel_id. La documentation de mise à jour décrit null comme la valeur qui supprime la surcharge au niveau du canal.

Sources

1. BigCommerce, « Get Storefront SEO Settings », sans date
2. BigCommerce, « Update Storefront SEO Settings », sans date
3. BigCommerce, « Introduction to Multi-Storefront », sans date

---

Vérifiez comment une page se lit pour les moteurs de réponse. Ouvrir l’analyseur de score GEO