> For the complete documentation index, see [llms.txt](https://help.citrusad.com/retail-media-interface/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.citrusad.com/retail-media-interface/integration/fr/generating-ads/banner-x-responsive/companion-products-banner-x.md).

# Produits compagnons

{% hint style="info" %}
Fonctionnalité bêta

Cette fonctionnalité est actuellement en version bêta et est susceptible de changer. Nous vous encourageons à nous faire part de vos remarques pour nous aider à l'améliorer.
{% endhint %}

Le composant de produits complémentaires permet aux marques de sélectionner une liste ordonnée de produits achetables avec la bannière. Vous pouvez les afficher dans votre bannière, ce qui permet à vos clients d'acheter directement depuis la bannière. Cela peut entraîner une augmentation de l'interaction avec la bannière et une hausse du CTR.

<figure><img src="/files/WSTMWfOIHflibIpkznqD" alt="" width="100%"><figcaption></figcaption></figure>

## Spécifications

* Les produits disponibles pour la section **Produits complémentaires** sont limités à ceux sélectionnés lors de l'étape précédente de création de campagne **Produits**.
* Le nombre requis de **produits complémentaires** peut être spécifié pour chaque emplacement.
* Les **produits complémentaires** peuvent être triés dans l'ordre souhaité lors de la création de la campagne, ordre qui sera conservé dans la réponse publicitaire.

## Intégrer les produits complémentaires

Les produits complémentaires permettent aux marques de sélectionner une liste ordonnée de produits achetables avec la bannière.

### Avant de procéder à l'intégration

* Mettez à jour la méthode d'analyse synthaxique des nouveaux champs dans la réponse de la bannière X pour prendre en charge les produits complémentaires.
* Lors de l'intégration des produits complémentaires avec les annonces vidéo, sélectionnez ou intégrez le lecteur vidéo de votre choix sur votre site ou votre application mobile.
* Les champs permettant d'ajouter des annonces vidéo et des produits complémentaires ne s'afficheront que pour les campagnes pour lesquelles la vidéo et les produits complémentaires ont été configurés. L'activation n'intervient qu'une fois l'intégration terminée.
* Mettez à jour votre outil de prévisualisation pour afficher les nouvelles fonctionnalités de produits complémentaires et de vidéo.

### Exemple de réponse publicitaire pour les produits complémentaires

Lorsque les campagnes intègrent des produits complémentaires configurés, vous verrez le `companionProducts` objet renvoyé.

```
{
  "ads": [
    {
      "contentStandardId": "c47c9ca2-ad3b-48cc-880b-e899c1661726",
      "slotId": "Top_Banner",
      "banners": [
        {
          "citrusAdId": "shotgun_8SvgA7OvvuwtZkkOKR0vr8AXMvQKFgoURmluZ2VybGltZTI2LWZkeHZxMjcSABoMCO30r70GEKPplJQCIgIIAQ==",
          "citrusCampaignName": "Ads:74-330-96832622ed499dafb3da8de8b76340a2",
          "citrusContentStandardId": "c47c9ca2-ad3b-48cc-880b-e899c1661726",
          "citrusSlotId": "Top_Banner",
          "citrusExpiry": "2025-02-12T01:33:33.579155107Z",
          "headingText": "recusandae 3205",
          "bannerText": "placeat 2825",
          "bannerTextColour": "ffffff",
          "ctaFlag": true,
          "ctaText": "CTA text",
          "ctaTextAccessibility": "call to action accessibility text",
          "ctaLink": http://citrusad.com,
          "backgroundColour": "000000",
          "backgroundImage": https://dev3.flavedo.io./citrus/8de07ed9-60b4-4611-8bd5-3f1f0c0b6be4,
          "secondaryBackgroundImage": https://dev3.flavedo.io./citrus/b7a70785-1366-42c6-8134-c7fe47a30c34,
          "secondaryBackgroundImagePosition": "rightaligned",
          "heroImage": https://dev3.flavedo.io./citrus/26798ca9-1022-422d-9100-1a3687c88372,
          "heroImageAltText": "hero image alt text",
          "secondaryHeroImage": https://dev3.flavedo.io./citrus/c4ee18b4-bf51-44d7-9eb6-eeb1dc4c422f,
          "secondaryHeroImageAltText": "secondary hero image alt text",
          "secondaryHeroMode": "landscape",
          "tags": {},
          "additionalFields": [
            {
              "id": "text-1",
              "value": "sed 5731"
            }
          ],
          "gtins": [
            "Fingerlime26-fdxvq27",
            "Oranges5-qgxeb6",
            "Cherries9-adkoj11",
            "Incaberries20-ppscn21",
            "Banana14-simfk15"
          ],
          "sellerId": "seller_id_772_659",
          "position": 1,
          "metadata": {
            "advertiserInfo": {
             "advertiser": "Bob's advertising agency",
             "onBehalfOf": "Brand company inc"
            }
          },
          "companionProducts": [
            "Banana14-simfk15"
            "Oranges5-qgxeb6",
            "Incaberries20-ppscn21",
          ]
        }
      ]
    }
  ]
}
```


---

# 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.citrusad.com/retail-media-interface/integration/fr/generating-ads/banner-x-responsive/companion-products-banner-x.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.
