> For the complete documentation index, see [llms.txt](https://help.impact.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.impact.com/brand/fr/what-would-you-like-to-learn-about/platform-features/product-catalogs/add-product-catalogs-as-a-brand.md).

# Ajouter des catalogues de produits en tant que marque

Un catalogue de produits est un flux de données qui contient une liste de vos produits et leurs métadonnées. Il est couramment utilisé si vous vendez des produits en ligne, mais peut aussi être utilisé dans d’autres secteurs, comme les cartes de crédit, les voyages, les annonces immobilières et bien plus encore. De nombreuses marques créeront un catalogue de produits via leur solution e-commerce (ou de panier d’achat), qui peut être exporté et partagé avec impact.com.

Lors de l’ajout d’un catalogue de produits retail, vous devez suivre une série d’étapes qui vous aideront à mettre en valeur vos offres, à améliorer l’expérience client et à fluidifier le processus d’achat. Suivez les étapes ci-dessous :

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2F1diRYN9k9QfiHhDHlZMK%2Feng-350-6.mp4?alt=media&token=417e2657-d1ae-4bce-a600-f7e6572d4322>" %}

## Préparez votre catalogue pour le téléversement

Effectuez les opérations suivantes pour configurer votre catalogue afin d’obtenir la meilleure visibilité et les meilleures performances possibles.

{% stepper %}
{% step %}

### Assurez-vous que les exigences de visibilité Marketplace sont respectées

1. Chaque produit de votre fichier de catalogue doit inclure des données complètes pour les champs critiques suivants, sinon il pourra être exclu des surfaces Marketplace comme le Product Marketplace et l’application mobile :
   * SKU / `CatalogItemId`
   * `URL du produit`
   * `URL de l’image`
   * `Disponibilité du stock`
   * `Prix` (seuls les produits dont le prix est > 2,00 USD apparaîtront)
     * Voir [Exigences relatives aux champs du catalogue de produits](/brand/fr/what-would-you-like-to-learn-about/platform-features/product-catalogs/product-catalog-field-requirements.md) pour la liste complète des champs.
2. Pour éviter des erreurs de validation inutiles et vous assurer de disposer de tous les champs requis, il est également préférable d’aligner votre fichier de catalogue avec nos [Bonnes pratiques pour les catalogues de produits](/brand/fr/what-would-you-like-to-learn-about/platform-features/product-catalogs/product-catalog-best-practices.md) avant de continuer.
   {% endstep %}

{% step %}

### Vérifiez les paramètres publicitaires de votre programme

Avant d’ajouter des catalogues de produits à votre programme, assurez-vous qu’ils sont activés dans vos paramètres publicitaires. Les partenaires ne pourront pas voir vos catalogues de produits tant que ce paramètre ne sera pas activé.

1. Dans la barre de navigation supérieure, sélectionnez ![](/files/287922c6cc6ea3fb3d302b92b68b352b27fd336d) **\[Profil utilisateur] → Paramètres**.
2. Dans la colonne de droite, sous *Général*, sélectionnez [**Paramètres publicitaires**](https://app.impact.com/secure/advertiser/campaign/campaign-ad-settings-flow.ihtml).
3. Dans la *Types d’annonces* section, sous *Catalogues de produits*, assurez-vous que ![](/files/94a2057cb9d4329aca9f1b322d3889a7ca036149) **\[Case cochée]** **Activer les catalogues de produits pour ce programme** est cochée.
4. Sélectionnez **Enregistrer**.
   {% endstep %}
   {% endstepper %}

## Connectez votre catalogue

Effectuez les opérations suivantes pour ajouter votre catalogue à impact.com et rendre ses produits disponibles à la promotion.

{% stepper %}
{% step %}

### Téléversez votre catalogue de produits

1. Dans la barre de navigation de gauche, sélectionnez ![](/files/15f4c8f88cb75624c1f6a18cb768e8f494128ac4) **\[Engage]** → **Contenu** → **Produits** → [**Catalogues de produits**](https://app.impact.com/secure/advertiser/engage/ads/productcatalogs/manage-ads-product-catalog-flow.ihtml).
2. Dans le coin supérieur droit, sélectionnez **Créer un catalogue de produits** **Ressource** → **Retail**.
   * Pour les catalogues de cartes de crédit, voir [Ajouter des catalogues de cartes de crédit](/brand/fr/what-would-you-like-to-learn-about/platform-features/product-catalogs/add-credit-card-catalogs-as-a-brand.md).
3. Entrez un **Nom du catalogue de produits** unique (c’est ainsi que vos partenaires le rechercheront).
4. Facultativement, saisissez des **Libellés** que les partenaires peuvent utiliser pour rechercher ce catalogue de produits.
5. Facultativement, téléversez un document PDF contenant des *Instructions du catalogue* afin que les partenaires comprennent comment naviguer dans votre catalogue de produits.
6. Sélectionnez une méthode de téléversement pour votre catalogue de produits (les méthodes sont listées par ordre de recommandation) :
   * **Récupérer depuis l’URL**: impact.com récupérera le catalogue depuis votre serveur.
   * **Importation intégrée du panier d’achat**: impact.com récupérera le catalogue depuis votre panier d’achat.
   * **Serveur FTP impact.com**: Vous envoyez le fichier vers notre serveur FTP.
   * **Serveur SFTP impact.com**: Méthode de téléversement spécialisée réservée uniquement à certaines intégrations.
   * **Téléversement direct**: Vous téléversez manuellement le fichier du catalogue chaque fois que vous souhaitez le mettre à jour.
7. Le cas échéant, sélectionnez un **Format**. Sinon, sélectionnez **Importation intégrée du panier d’achat**.

{% tabs %}
{% tab title="Format" %}

1. Sélectionnez le ![](/files/b04f0278cecdb6d4cd1acab522796f8fbdcb0fa1) **\[Menu déroulant]**, puis sélectionnez un format.
2. Saisissez le **Nom du fichier de téléversement** du catalogue de produits avec son extension de fichier. Le nom que vous saisissez ici doit correspondre au nom du fichier que vous téléversez.
   * Par exemple, `starks_catalog.xml`, `starks_catalog.txt`, `starks_catalog.csv`.
   * Si vous utilisez un fichier CSV, remplacez les espaces dans les noms de champs par des traits de soulignement.

| Format                            | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| --------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Google Merchant Center**        | impact.com prend actuellement en charge les [formats textuels](https://support.google.com/merchants/answer/7052112) de Google Merchant (fichiers TXT délimités par tabulations, et non fichiers CSV), ainsi que les [fichiers XML](https://support.google.com/merchants/answer/14987622) (RSS et Atom).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| **Format personnalisé**           | <p>impact.com prend également en charge les catalogues au format personnalisé. Vous pouvez téléverser des fichiers aux formats .XML, .TXT, .CSV et .PSV.</p><p>1. Spécifiez le <strong>champ URL du lien, champ ID de l’article du catalogue et champ Nom</strong> de votre catalogue personnalisé dans les zones de texte respectives. Ces champs sont obligatoires.</p><p>2. Remplissez les champs obligatoires <strong>ID de l’article du catalogue</strong> et <strong>Nom</strong> .</p><ul><li>Consultez les <a href="https://docs.google.com/spreadsheets/d/1Cc1-9IdACq-TWdx47Xnnekh8MF0mJvHa_3zakJqKzoc/edit?usp=sharing">champs de fichier au format personnalisé</a> pour obtenir la liste complète des champs.</li><li>Voir l’exemple ci-dessous des formats à suivre lors de la saisie des détails du produit.</li></ul><p>3. Facultativement, vous pouvez ajouter des champs personnalisés à votre catalogue de produits. Sélectionnez <strong>Ajouter un autre champ</strong>, puis sélectionnez le <img src="/files/b04f0278cecdb6d4cd1acab522796f8fbdcb0fa1" alt=""> <strong>\[Menu déroulant]</strong> et sélectionnez une option.</p><ul><li>Consultez <a href="https://docs.google.com/spreadsheets/d/1Cc1-9IdACq-TWdx47Xnnekh8MF0mJvHa_3zakJqKzoc/edit?usp=sharing">champs de fichier au format personnalisé</a> pour en savoir plus sur les options du menu déroulant.</li></ul> |
| **eBay Commerce Merchant Center** | impact.com prend en charge les formats textuels (.TXT et .CSV) ainsi que les formats XML pour eBay Commerce. Lorsque vous utilisez un fichier .CSV, veillez à remplacer les espaces dans la colonne Field par des traits de soulignement. Vous pouvez également consulter les champs du fichier marchand eBay Commerce [ici](https://docs.google.com/spreadsheets/d/1np1YixxczH_IZBxer-EckMkAdcV9_lp74RQAtI-1Ct0/edit?usp=sharing).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| **Connexity Merchant Center**     | impact.com prend actuellement en charge les versions de fichiers .TXT et .CSV de [catalogues de produits de Connexity](https://connexity.jitbit.com/helpdesk/KB/View/8469181-required-data-feed-fields-and-template). Après avoir généré votre catalogue de produits, vous pouvez le téléverser vers impact.com.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| **CJ Affiliate by Conversant**    | impact.com prend en charge différents formats pour les [catalogues de produits CJ Affiliate](https://developers.cj.com/docs/data-imports/product-feeds), y compris des fichiers .TXT, .CSV, .PSV et .XML dans la section *Spécifications du flux de produits : Shopping (format Google)* . Après avoir généré votre catalogue de produits, vous pouvez le téléverser vers impact.com.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |

{% hint style="info" %}
**Exemple**

```programlisting
name,id,url,manufacturingcost,mycurrency,mycategory
ACME Bird Seed,1234567,http://example.com/products,20,USD,Accessories
```

{% endhint %}
{% endtab %}

{% tab title="Importation intégrée du panier d’achat" %}

1. Sélectionnez votre **panier d’achat** solution :
   * **Shopify**, **Magento**, **BigCommerce**, **WooCommerce**, **Demandware**, **Shoplazza**, ou **Amazon**.
2. Saisissez vos identifiants d’accès e-commerce. Sélectionnez ci-dessous votre solution e-commerce pour obtenir des informations sur l’endroit où trouver ces identifiants :<br>

   **Shopify**

   Consultez notre guide sur le [catalogue de produits Shopify](https://integrations.impact.com/integration-guides/for-brands/plugin-integrations/e-commerce/integrate-with-shopify/shopify-product-catalog) pour apprendre à trouver et configurer vos identifiants.

   1. Saisissez le **URL de base** de votre boutique.
      * Par exemple, `https://www.acmeacademy.com`.
   2. Saisissez votre **jeton d’accès**.
      * Apprenez à obtenir votre [jeton d’accès](https://shopify.dev/docs/api/storefront/latest/objects/CustomerAccessToken).
   3. Facultativement, saisissez un **ID de collection**.
   4. Facultativement, ![\[Toggle on\]](https://paligoapp-cdn-eu1.s3.eu-west-1.amazonaws.com/impact/attachments/f01cdffa431a4d75ff09c130b66974d4-84d1224fd3bb6ba94b899febe2021eaa.svg) **\[Activer]** **Inclure les variantes de produits** pour filtrer les variantes.

   **Magento**

   1. Saisissez le **URL de base** de votre boutique.
      * Par exemple, `https://www.acmeacademy.com`.
   2. Pour la **clé consommateur**, **secret consommateur**, **jeton d’accès**, et **secret du jeton d’accès**, accédez à vos [clés et jetons d’authentification](https://devdocs.magento.com/guides/v2.3/get-started/authentication/gs-authentication-token.html).

   **BigCommerce**

   1. Saisissez votre **Store Hash**.
   2. Saisissez votre **jeton d’accès**.
      * Vous devrez [créer un compte API au niveau de la boutique](https://support.bigcommerce.com/s/article/Store-API-Accounts) dans BigCommerce et utiliser le jeton d’accès généré pour connecter votre catalogue de produits. Voici un exemple des identifiants de l’API BigCommerce que vous obtiendrez :

        ```programlisting
        ID client : h81bpnt123hrx3crd219ebxyr3dsou1
        Secret client : edbdc3c61dd6030909a5ea6a4c8123456a2824b41536bee6274b27a17fcbe5f8
        Jeton d’accès : mv05yxg8ji49cdboa5wc8vpx1un1234
        ```
      * Pour les portées API au niveau de la boutique, définissez les deux paramètres *Produits* et *Informations et paramètres* sur lecture seule. Toutes les autres portées peuvent être laissées telles quelles.

   **WooCommerce**

   1. Saisissez le **URL de base** de votre boutique.
      * Par exemple, `https://www.acmeacademy.com`.
   2. Saisissez votre **Nom d’utilisateur API** et **Mot de passe**.

      * **nom d’utilisateur API** — saisissez votre *clé consommateur* ici
      * **mot de passe API** — saisissez votre *secret consommateur* ici

      Apprenez à [générer vos clés](https://woocommerce.com/document/woocommerce-rest-api/#generate-api-keys). Vous devrez également activer l’API REST [legacy](https://woocommerce.com/document/woocommerce-rest-api/#enable-legacy-rest-api).

   **Demandware**

   1. Saisissez votre **URL de base** et **ID du site**. Ils seront identiques. Apprenez à obtenir votre [ID du site](https://documentation.b2c.commercecloud.salesforce.com/DOC1/index.jsp?topic=%2Fcom.demandware.dochelp%2FDWAPI%2Fscriptapi%2Fhtml%2Fapi%2Fclass_dw_system_Site.html).
      * Par exemple, `https://www.acmeacademy.com`.
   2. Apprenez à obtenir les [identifiants nom d’utilisateur et mot de passe de l’API](https://developer.salesforce.com/docs/commerce/b2c-commerce/references/b2c-commerce-ocapi/get-started-with-ocapi.html).

   **Shoplazza**

   1. Saisissez le **URL de base** de votre boutique.
      * Par exemple, `https://www.acmeacademy.com`.
   2. Saisissez votre **jeton d’accès**.
      * Apprenez à obtenir votre [jeton d’accès](https://www.shoplazza.dev/reference/overview-23).
   3. Facultativement, indiquez un **ID de collection** pour n’ajouter que des produits provenant d’une [collection de produits Shoplazza](https://www.shoplazza.dev/reference/collection-list).

   **Amazon**

{% hint style="warning" %}
**Avertissement :** L’intégration du panier d’achat Amazon est actuellement réservée aux marques disposant d’un [abonnement Seller](/brand/fr/what-would-you-like-to-learn-about/seller-program/amazon-seller-program/amazon-seller-program-explained.md) et n’est pas une fonctionnalité en libre-service.
{% endhint %}

Si votre catalogue Seller contient plus de 1 000 produits, utilisez plutôt l’une des méthodes manuelles de [téléversement de fichiers](https://help.impact.com/brand/what-would-you-like-to-learn-about/platform-features/product-catalogs/add-product-catalogs-as-a-brand#format) . L’ingestion automatique du catalogue est limitée à 1 000 produits en raison des restrictions de l’API Amazon.
{% endtab %}
{% endtabs %}

8. Dans les ![](/files/b04f0278cecdb6d4cd1acab522796f8fbdcb0fa1) **\[Menus déroulants],** sélectionnez la **Langue** et **Devise** dans laquelle le catalogue sera affiché pour les partenaires.
9. Utilisez les ![](/files/b04f0278cecdb6d4cd1acab522796f8fbdcb0fa1) **\[Menu déroulant]** pour sélectionner **Zones de service** pour le ciblage géographique.

   * Vos *zones disponibles* sont les zones de service ciblées par votre programme. Vous pouvez modifier cela dans les paramètres de votre programme comme suit :<br>

   ### Gérer les zones de service disponibles

   * Dans la barre de navigation supérieure, sélectionnez ![](/files/287922c6cc6ea3fb3d302b92b68b352b27fd336d) **\[Profil utilisateur]** **→ Paramètres**.
   * Sous *Général* dans la colonne de droite, sélectionnez [**Profil Marketplace**](https://app.impact.com/secure/advertiser/campaign/view-edit-campaign-flow.ihtm).
   * Sous *Informations du programme*, accédez à *Zones de service*.
   * Utilisez les ![](/files/b04f0278cecdb6d4cd1acab522796f8fbdcb0fa1) **\[Menu déroulant]** et ![](/files/a6147e219aaa575a1ac4f75027aa2e2024584bdd) **\[Cases non cochées]** pour sélectionner ou désélectionner les zones de service selon vos besoins.
   * Une fois terminé, sélectionnez **Enregistrer**.<br>
10. Facultativement, vous pouvez gérer votre catalogue de produits via l’API. Reportez-vous à [vue d’ensemble des catalogues](https://integrations.impact.com/brand-api-reference/reference/catalogs).
11. Facultativement, configurez un plan de secours mobile.<br>

    ### Configurer le plan de secours mobile

    Vous pouvez configurer un plan de secours mobile sur vos catalogues de produits. Cette option vous permet d’envoyer du trafic vers vos applications mobiles, ce qui permet aux partenaires d’utiliser des annonces génériques pour une seule application sur de nombreuses plateformes.

    1. Dans la *Plan de secours de l’application mobile* section, ![](/files/305a4944a71dea362e7149113d0a2b30f3a73a14) **\[Activer] le secours mobile**.
       * Sinon, trouvez un catalogue de produits existant et sélectionnez **Modifier**.
    2. Dans les ![](/files/b04f0278cecdb6d4cd1acab522796f8fbdcb0fa1) **\[Menu déroulant]** options sous *Android* et *iOS*, sélectionnez une option de secours pour chaque plateforme. Cette sélection sera ensuite renseignée avec l’URL de téléchargement de votre application.
       * impact.com détectera automatiquement le type d’appareil du consommateur et l’orientera vers la boutique d’applications appropriée pour télécharger votre application une fois le secours mobile configuré.
    3. Sélectionnez **Enregistrer**.<br>
12. Sélectionnez **Enregistrer**.
13. Facultativement, pour restreindre les partenaires pouvant accéder à ce catalogue de produits, ![](/files/305a4944a71dea362e7149113d0a2b30f3a73a14) **\[Activer] Restreindre l’accès des partenaires**, puis saisissez les noms des *partenaires* et des *groupes* partenaires qui doivent avoir accès.
14. Sélectionnez les *Options de téléchargement des partenaires* que vous souhaitez rendre disponibles pour ce catalogue. Les options que vous pouvez activer incluent **FTP**, **API**, ou **Téléchargement via le navigateur du portail partenaire**
15. Sélectionnez **Enregistrer** pour créer l’entrée du catalogue de produits et passer à l’écran de téléversement (pour les téléversements directs).
    * Sinon, si vous n’ajoutez pas votre catalogue via *Téléversement direct*, vous reviendrez à l’écran *Catalogues de produits* et poursuivrez le processus ci-dessous.
      {% endstep %}

{% step %}

### Examiner et résoudre les problèmes d’état du catalogue

Chaque catalogue de produits dispose d’un score d’état qui met en évidence les éventuels problèmes. Pour atteindre le niveau *excellent* , résolvez les erreurs, avertissements et doublons.

1. Dans le menu de navigation de gauche, sélectionnez ![](/files/15f4c8f88cb75624c1f6a18cb768e8f494128ac4) **\[Engage] → Contenu → Produits →** [**Catalogues de produits**](https://app.impact.com/secure/advertiser/engage/ads/productcatalogs/manage-ads-product-catalog-flow.ihtml).
2. Si un catalogue contient des erreurs, des avertissements ou des lignes en double, vous verrez combien de chacun sont présents dans la colonne *État* .
   * **En attente** - Votre catalogue est en cours de téléversement.
   * **Traitement** - Votre catalogue est en cours de traitement.
   * **Excellent** - Votre catalogue est sain. Cet ensemble de données produit est complet et bien structuré, ce qui lui donne les meilleures chances d’obtenir de bonnes performances.
   * **Bon** - Certains champs essentiels, comme la catégorie ou le statut, peuvent manquer. Corriger cela est nécessaire pour améliorer la qualité globale du catalogue.
   * **Médiocre** - Plus de 10 % des informations requises sont manquantes. Le catalogue doit être corrigé puis téléversé à nouveau.
3. Sélectionnez *erreurs*, *avertissements*, ou *doublons* pour afficher les lignes présentant des problèmes.
   * Seul le premier élément d’un ensemble de doublons sera représenté dans impact.com ; tous les éléments dupliquant le premier seront ignorés.
4. Résolvez les problèmes en vous appuyant sur [Résoudre les erreurs et avertissements du catalogue de produits](/brand/fr/what-would-you-like-to-learn-about/platform-features/product-catalogs/troubleshoot-product-catalog-errors-and-warnings.md) comme guide. Téléversez ensuite à nouveau le catalogue vers impact.com en utilisant la même méthode que celle utilisée pour téléverser le catalogue d’origine.
   * Les méthodes de téléversement qui récupèrent automatiquement le catalogue devraient se mettre à jour automatiquement lors du prochain événement de récupération.

{% hint style="warning" %}
**Conseil important :** Pour vous assurer que votre catalogue est configuré pour obtenir la meilleure visibilité et les meilleures performances possibles, consultez [Bonnes pratiques pour les catalogues de produits](/brand/fr/what-would-you-like-to-learn-about/platform-features/product-catalogs/product-catalog-best-practices.md).
{% endhint %}
{% endstep %}

{% step %}

### Rendre les catalogues disponibles aux partenaires

Après avoir ajouté le catalogue et examiné son état, passez à l’étape finale pour le rendre disponible pour vos partenaires et vous assurer que vos produits sont présentés dans le Product Marketplace. Cela pourrait attirer davantage de candidatures au programme. Pensez à [créer des workflows](/brand/fr/what-would-you-like-to-learn-about/platform-features/review-partner-applications/automate-partner-application-processing/create-workflows-to-automatically-process-partner-applications.md) pour automatiser le traitement des candidatures à votre programme.

1. Dans les [*Catalogues de produits*](https://app.impact.com/secure/advertiser/engage/ads/productcatalogs/manage-ads-product-catalog-flow.ihtml) écran, trouvez le catalogue que vous venez d’ajouter.
2. Survolez le catalogue que vous venez d’ajouter, à droite sélectionnez ![](/files/8fc46368ded1f34376787abf9e1ea28872383d82) **\[Plus]** → **Rendre disponible pour utilisation**.<br>

   <div data-gb-custom-block data-tag="hint" data-style="success" data-icon="circle-info" class="hint hint-success"><p><strong>Remarque :</strong> Pour activer les liens directs vers les produits, ajoutez le domaine de la page de destination du produit en tant que domaine pouvant être lié en profondeur dans la <a href="/pages/5d1104aa5473f3fd07374c705f0d612280e6daa6"><em>Autoriser les partenaires à créer des liens profonds vers des pages spécifiques de mon site</em></a> section de vos paramètres de suivi.</p></div>

{% endstep %}
{% endstepper %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://help.impact.com/brand/fr/what-would-you-like-to-learn-about/platform-features/product-catalogs/add-product-catalogs-as-a-brand.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
