Comment supprimer une surcharge SEO de canal dans BigCommerce ?

Définition : Une surcharge SEO (SEO override) de canal dans BigCommerce est une valeur enregistrée pour un canal dans l’API des paramètres SEO de la vitrine (Storefront SEO). Fournir null pour ce champ dans une mise à jour ciblant le canal supprime la surcharge et rétablit l’héritage de la valeur des paramètres globaux de la vitrine.

Points clés

• BigCommerce met à jour les paramètres Storefront SEO avec PUT https://api.bigcommerce.com/stores/{store_hash}/v3/settings/storefront/seo, comme l’indique sa référence Update Storefront SEO Settings.
• Le paramètre de requête channel_id limite la mise à jour aux paramètres propres à un canal. En son absence, la requête porte sur les paramètres globaux.
• La référence de mise à jour indique que null supprime une surcharge pour le canal concerné et fait hériter le champ de la valeur globale.
• Selon la référence Get Storefront SEO Settings de BigCommerce, une requête GET ciblant un canal utilise null pour indiquer qu’un champ n’a pas de surcharge au niveau du canal et hérite de la valeur globale.
• Les champs de paramètres SEO documentés sont meta_description, meta_keywords, page_title et www_redirect. Les valeurs autorisées pour www_redirect sont www, no-www et none.

Que change null ?

La mise à jour s’applique à un canal lorsque son identifiant est fourni dans le paramètre de requête channel_id. Définir un champ sur la valeur JSON null supprime la valeur de ce champ enregistrée pour le canal. BigCommerce décrit le résultat comme un héritage de la valeur globale. L’opération porte sur chaque champ séparément : une requête peut donc réinitialiser un champ tout en envoyant une valeur pour un autre.

Par exemple, cette requête réinitialise le titre de page du canal et n’inclut pas les autres paramètres dans le corps de la requête :

PUT /stores/{store_hash}/v3/settings/storefront/seo?channel_id={channel_id}
Content-Type: application/json

{"page_title": null}

Le même point de terminaison accepte meta_description, meta_keywords, page_title et www_redirect dans le corps contenant les paramètres SEO. La référence de BigCommerce indique que ces propriétés du corps sont facultatives et que www_redirect est une énumération dont les valeurs sont www, no-www et none.

Comment cibler le canal dans la requête ?

Le paramètre de requête channel_id permet de cibler le canal dans la requête PUT. BigCommerce définit store_hash comme l’identifiant permanent de la boutique et channel_id comme l’identifiant facultatif du canal pour les paramètres propres à celui-ci. L’omission de channel_id sélectionne les paramètres globaux et ne désigne donc pas de surcharge de canal à supprimer.

Une requête JSON authentifiée peut ainsi prendre la forme suivante :

curl -X PUT "https://api.bigcommerce.com/stores/{store_hash}/v3/settings/storefront/seo?channel_id={channel_id}" \
  -H "Accept: application/json" \
  -H "X-Auth-Token: {access_token}" \
  -H "Content-Type: application/json" \
  -d '{"page_title":null}'

La référence de l’API indique que l’en-tête X-Auth-Token est obligatoire. Elle précise également que le format du corps de la requête pour ce point de terminaison est application/json.

Comment vérifier l’héritage ?

Une requête GET est envoyée au même point de terminaison Storefront SEO avec l’identifiant du canal en paramètre de requête. La référence GET indique que les paramètres propres au canal utilisent null lorsqu’un champ donné n’a pas de surcharge au niveau du canal et que sa valeur est héritée des paramètres globaux.

GET /stores/{store_hash}/v3/settings/storefront/seo?channel_id={channel_id}
Accept: application/json

Une réponse peut représenter un champ hérité ainsi :

{
  "data": {
    "page_title": null
  },
  "meta": {}
}

L’objet de réponse contient data pour les paramètres SEO et meta pour les métadonnées de la réponse. Le statut de réponse GET documenté est 200 OK.

Termes associés

• Comment une agence peut-elle vérifier si les paramètres SEO d’un canal BigCommerce héritent des valeurs globales ?
• Que contrôle le réglage de redirection www de BigCommerce pour un canal headless ?
• Comment une vitrine découplée (headless) BigCommerce retrouve-t-elle une page à partir d’un chemin d’URL ?

Questions fréquentes

null réinitialise-t-il tous les paramètres SEO du canal ?

Il réinitialise le champ fourni avec la valeur null. Incluez null pour chaque champ du canal dont vous souhaitez supprimer la surcharge enregistrée, par exemple page_title ou meta_description.

Que devient le paramètre global ?

Le paramètre global reste la source dont hérite le champ du canal après la suppression de la surcharge de canal. La référence de mise à jour décrit ce résultat comme un héritage des valeurs globales.

Comment vérifier le résultat ?

Demandez les paramètres propres au canal avec GET et le même channel_id. Un champ à null dans cette réponse indique qu’il n’a pas de surcharge au niveau du canal et utilise la valeur globale.

Sources

1. BigCommerce, « Update Storefront SEO Settings », sans date
2. BigCommerce, « Get Storefront SEO Settings », sans date

---

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