Comment inclure les URL cibles résolues des redirections dynamiques dans un export BigCommerce ?

Définition : La tâche d’export des redirections de BigCommerce accepte include_dynamic_target_urls: true pour ajouter au CSV une colonne en lecture seule contenant l’URL cible des redirections dynamiques. Cette option se place dans le corps de la requête d’export et s’applique aux redirections sélectionnées pour cette tâche.

Points clés

• Dans sa référence de création d’une tâche d’export des redirections, BigCommerce décrit l’opération comme une requête POST qui crée une tâche d’export de redirections 301.
• Le champ include_dynamic_target_urls est un booléen facultatif dont la valeur par défaut est false ; la valeur true ajoute au CSV une colonne en lecture seule pour les URL cibles des redirections dynamiques.
• La documentation des routes de la vitrine de BigCommerce décrit une redirection dynamique par un type d’entité et un identifiant d’entité correspondant à une ressource existante de la boutique.
• Dans sa documentation de l’événement de mise à jour des redirections, la référence des webhooks de BigCommerce indique qu’une cible manuelle possède un champ url, tandis qu’une cible dynamique possède un champ entity_id et un champ type, tel que product, category, brand, page ou post.

Comment activer la colonne CSV supplémentaire ?

L’option se place dans le corps de la requête d’export. La référence de création d’une tâche d’export des redirections de BigCommerce présente include_dynamic_target_urls comme un booléen facultatif dont la valeur par défaut est false. La valeur true ajoute au CSV une colonne en lecture seule contenant l’URL cible des redirections dynamiques.

{
  "include_dynamic_target_urls": true
}

La même référence donne le point de terminaison POST https://api.bigcommerce.com/stores/{store_hash}/v3/storefront/redirects/imex/export et indique que la réponse en cas de succès contient l’id de la tâche d’export. Ce paramètre détermine le contenu du CSV produit par l’export ; il ne sert pas à créer une redirection.

Qu’entend BigCommerce par URL cible dynamique ?

La documentation des routes de l’API GraphQL Storefront de BigCommerce décrit la réponse d’une route comme une entité, une redirection ou une réponse vide lorsqu’aucune entité ni redirection ne correspond au chemin. Son modèle de redirection comporte deux formes. Une redirection manuelle renvoie une URL de destination fixe et peut nécessiter une autre requête de route lorsque cette destination mène à une autre redirection. Une redirection dynamique renvoie le type et l’identifiant d’entité d’une ressource existante de la boutique.

La documentation des routes nomme cinq types de redirections dynamiques : ProductRedirect, BrandRedirect, BlogPostRedirect, CategoryRedirect et PageRedirect. Avec redirectBehavior: FOLLOW, la réponse de la route peut placer l’entité cible dynamique dans node. La documentation des webhooks utilise la représentation des événements REST : une cible manuelle possède url, tandis qu’une cible dynamique possède entity_id et type. Ces descriptions expliquent pourquoi l’option d’export fait spécifiquement référence à une URL cible de redirection dynamique plutôt qu’à un champ de destination saisi par l’utilisateur.

Comment choisir les redirections exportées par la tâche ?

La référence de l’export prévoit deux critères de sélection dans le même corps de requête. site_id est facultatif et accepte la valeur null. Son omission entraîne l’export des redirections de tous les sites. redirect_ids est une liste facultative d’identifiants entiers, vide par défaut. L’omission des identifiants de redirection entraîne l’export de toutes les redirections des sites sélectionnés.

L’option peut donc se combiner avec ces critères pour produire un CSV couvrant un site particulier ou un ensemble choisi de redirections. BigCommerce présente cette tâche comme une requête API au niveau de la boutique, authentifiée par l’en-tête X-Auth-Token. Le chemin de la requête contient le store_hash permanent de la boutique.

Comment vérifier une valeur résolue ?

La documentation des routes de BigCommerce présente une requête FOLLOW qui demande à la fois les détails de la redirection et le nœud du produit cible. Une vérification ponctuelle peut utiliser le chemin représenté par une redirection exportée et examiner ensemble les éléments renvoyés : toUrl, le fragment to et node.

query {
  site {
    route(path: "/mug" redirectBehavior: FOLLOW) {
      redirect {__typename to {__typename ...on ProductRedirect{entityId path}} toUrl}
      node {
        id
        ... on Product {
          name
        }
      }
    }
  }
}

Le comportement documenté de FOLLOW renvoie l’entité cible d’une redirection dynamique. La représentation des webhooks fournit site_id, from_path et l’objet cible ; ces champs permettent donc d’identifier la redirection correspondante lors de la vérification. La référence d’export de BigCommerce décrit la fonction de la colonne ajoutée, mais ne publie ni son en-tête CSV exact ni un exemple de ligne.

Termes associés

• Peut-on limiter un export de redirections BigCommerce à certaines règles ou à un seul site ?
• En quoi les cibles des redirections manuelles et dynamiques de BigCommerce diffèrent-elles ?
• Que renvoie FOLLOW pour une redirection de route GraphQL BigCommerce ?
• Comment enregistrer des redirections BigCommerce pour un site vitrine précis ?

Questions fréquentes

L’option ajoute-t-elle un champ de redirection modifiable ?

Le comportement documenté ajoute au CSV une colonne en lecture seule. Le champ de requête est une option de la tâche d’export nommée include_dynamic_target_urls.

Que se passe-t-il si vous omettez site_id ?

BigCommerce présente site_id comme facultatif et indique que son omission entraîne l’export des redirections de tous les sites. redirect_ids limite alors les enregistrements uniquement si une liste d’identifiants est fournie.

L’API des routes permet-elle d’examiner la cible dynamique d’une redirection exportée ?

Oui. Avec redirectBehavior: FOLLOW, la documentation des routes de BigCommerce décrit une réponse dans laquelle node renvoie l’entité cible d’une redirection dynamique, tandis que redirect expose les détails de la redirection.

La référence donne-t-elle le nom de la colonne CSV ?

La référence d’export ne publie ni en-tête exact ni exemple de ligne CSV. Elle décrit le résultat comme une colonne supplémentaire en lecture seule contenant l’URL cible des redirections dynamiques.

Sources

1. BigCommerce, « Create Redirects Export Job », sans date
2. BigCommerce, « Storefront Routes with the GraphQL Storefront API », sans date
3. BigCommerce, « Webhook Events », sans date

---

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