> 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/partner/fr/partner-api-overview/epsilon-retail-media-partner-apis-overview-1.md).

# Présentation des API Partenaire Epsilon Retail Media

Bienvenue dans l'API Epsilon Retail Media Partner. Ce guide vous aide à vous intégrer à notre plateforme publicitaire pour gérer vos campagnes, portefeuilles, équipes et utilisateurs de manière programmatique. Vous pouvez également suivre les performances et développer efficacement votre activité.

## Qu'est-ce qu'une API ?

API signifie Application Programming Interface (Interface de Programmation d'Application). Une API agit comme un intermédiaire permettant à deux composants logiciels de communiquer à l'aide d'un ensemble de fonctions et de procédures. Les API sont couramment utilisées pour obtenir ou envoyer des données, en accédant aux fonctionnalités et services d'autres applications.

## Qu'est-ce que l'API Partner ?

Notre API Partner vous donne un accès programmatique à presque tout ce que vous pouvez faire dans l'interface utilisateur des plateformes de gestion de campagnes Epsilon Sur site. Cela signifie qu'au lieu de cliquer manuellement dans l'application, vos systèmes ou développeurs peuvent se connecter directement à notre plateforme et automatiser, personnaliser ou intégrer ses fonctionnalités dans vos propres outils ou flux de travail.

L'API Partner est utilisée par de nombreux distributeurs et partenaires, y compris des agrégateurs comme Pacvue, Skai et Commerce IQ.

## Présentation de l'API

L'API Epsilon Retail Media Partner permet la gestion programmatique du retail media [Campagnes](/retail-media-interface/partner/fr/campaign-management-api/productcampaign-1/createproductcampaign.md), [Équipe](/retail-media-interface/partner/fr/team-user-api/team.md) & [Utilisateur](/retail-media-interface/partner/fr/team-user-api/user-1/createuserteaminvite.md), et [Portefeuilles](/retail-media-interface/partner/fr/billing-api/wallet.md). Utilisez-la pour créer et mettre à jour des campagnes sur plusieurs formats publicitaires, notamment les Sponsored Product Ads (SPA), les bannières statiques et les créations Banner X responsive.

Notre API Partner est une API REST utilisant les protocoles courants GET, POST, PATCH et DELETE via des charges utiles JSON.

## Principaux avantages

* Automatisez les opérations sur les campagnes, les équipes, les utilisateurs et les portefeuilles via des points de terminaison d'API REST.
* Gérez efficacement plusieurs campagnes et ressources grâce à la prise en charge des opérations groupées.
* Vous permet d'orchestrer les appels d'API pour les adapter à votre flux de travail et à l'architecture de votre système existants.
* Créez et gérez des campagnes sur les formats Sponsored Product Ads, Bannière et Banner X .
* Authentification basée sur une clé utilisateur avec des jetons à durée limitée pour des interactions API sécurisées.

## Conditions préalables

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

Avant d'utiliser l'API Partner, assurez-vous que les conditions suivantes sont remplies :

### Accès au namespace

Vous devez avoir accès à votre namespace désigné, qui sert de conteneur pour vos données et configurations. Contactez l'équipe de Epsilon Support pour obtenir les détails de configuration du namespace spécifiques à vos distributeurs.

### Appartenance à une équipe

Vous devez faire partie d'une équipe de fournisseur ou de distributeur principal avec les autorisations appropriées au sein de votre namespace.

### Demande d'accès à l'API

Les agrégateurs publicitaires, les agences et les marques partenaires doivent formuler une demande d'accès à l'API avant d'utiliser les API Partner. Utilisez le formulaire de demande officiel référencé dans [KB0040933](https://citrusad.service-now.com/now/nav/ui/classic/params/target/kb_view.do%3Fsysparm_article%3DKB0040933)pour initier une nouvelle connexion API.

### Accès à l'API de suivi des performances

Vous devez avoir accès à l'API de suivi des performances (entrepôt de données BigQuery) pour interroger les tables pertinentes telles que dim\_product, dim\_catalog et dim\_placement. Cela permet de valider la préparation de l'intégration et d'explorer les métadonnées.

### Métadonnées requises

Assurez-vous que votre catalogue de produits, vos emplacements et les informations sur vos équipes sont créés et disponibles sous votre namespace. Vous pouvez le vérifier en interrogeant les tables BigQuery appropriées.

Si vous n'avez pas accès à BigQuery, demandez-le via le formulaire officiel de demande d'accès à l'API. Selon vos besoins, veuillez vous référer à l'article approprié de la base de connaissances :

* **Modifier/Supprimer le point de terminaison d'API Reporting BigQuery** : Besoin de modifier un point de terminaison d'API existant - [KB0040934](https://citrusad.service-now.com/now/nav/ui/classic/params/target/kb_view.do%3Fsysparm_article%3DKB0040934).
* NOUVELLE API Partner (API de suivi des performances)\*\* - [KB0040947](https://citrusad.service-now.com/now/nav/ui/classic/params/target/kb_view.do%3Fsysparm_article%3DKB0040947).

{% hint style="info" %}
Remarque sur l'accès : Certains liens contenus dans ce document renvoient vers des ressources internes ou restreintes. Assurez-vous d'être connecté avec les identifiants appropriés pour accéder au contenu.
{% endhint %}

## Mise en route avec les API Partner

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

### Exigences d'authentification

L'API Partner utilise un processus d'autorisation nécessitant une clé utilisateur (User Key). Les jetons d'accès sont récupérés en appelant l'API d'authentification par clé utilisateur :

* La User Key que vous avez récupérée est transmise dans l'en-tête de cette requête.
* Le jeton d'accès récupéré est ensuite utilisé dans tous les appels de méthode à l'API Partner.
* Les jetons expirent un peu moins de 24 heures après leur génération.

{% hint style="info" %}
Un nouveau jeton doit être demandé lorsque le précédent expire. Un client ne doit pas générer un nouveau jeton à chaque requête envoyée à notre API.
{% endhint %}

### Obtenir vos identifiants d'API

Pour commencer à utiliser les API Epsilon Retail Media Partner, vous avez besoin des informations suivantes. Si vous n'êtes pas sûr de l'un des détails, contactez votre Support ou créez un ticket pour obtenir de l'aide.

* Votre clé utilisateur pour l'authentification.
* L'URL de base pour passer des appels d'API.

### Récupérer votre User key

1. Connectez-vous à votre compte d'équipe Epsilon Retail Media .
2. Choisissez une équipe.
3. Dans le menu déroulant du profil, sélectionnez **Paramètres utilisateur**.
4. Accédez à l'onglet **User key**.
5. Cliquez sur **Afficher** pour révéler votre clé d'API.

Utilisez cette clé pour authentifier vos requêtes d'API. Epsilon Retail Media utilise une authentification basée sur une clé utilisateur. Échangez votre clé utilisateur contre un jeton d'accès à durée limitée pour autoriser les requêtes d'API. Pour plus d'informations, voir [Demandes d'authentification](/retail-media-interface/partner/fr/partner-api-authentication/authenticating-requests.md).

### Obtenir votre URL de base

Contactez votre Support pour obtenir l'URL de base correcte pour votre environnement. Exemple de point de terminaison :

```
https://campaign.<env>.citrusad.com/v3/campaigns
```

Une fois que vous avez votre clé utilisateur, vous pouvez vous authentifier et commencer à passer des appels d'API pour :

* Afficher et gérer vos campagnes publicitaires.
* Gérer vos budgets publicitaires et vos dépenses.
* Gérer les détails de votre équipe et de vos utilisateurs.

## Configurer l'environnement

Epsilon Retail Media fournit deux environnements distincts pour chaque distributeur : Production et Sandbox. Les deux environnements sont créés par défaut lorsqu'un distributeur est intégré.

### Environnement Sandbox

{% hint style="info" %}
L'accès à la Sandbox est généralement fourni uniquement aux distributeurs et aux agrégateurs. Si vous n'êtes pas sûr de votre éligibilité, contactez le Support.
{% endhint %}

Utilisez cet environnement sécurisé pour tester votre intégration avant le lancement. Les distributeurs doivent utiliser cet environnement pour valider les appels d'API, tester les importations de catalogues, simuler la création de campagnes et garantir la fonctionnalité de bout en bout avant le lancement. Utilisez la sandbox pour toutes les activités de développement, de test et d'assurance qualité. Chaque distributeur dispose d'une URL de sandbox unique, généralement au format :

```
https://<retailer>-sandbox.citrusad.com
```

L'environnement sandbox comprend :

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

### Environnement de production

Passez en production uniquement après une validation réussie dans la sandbox. L'environnement de production est utilisé pour les campagnes en direct et la diffusion d'annonces en temps réel. Il prend en charge les opérations à grande échelle, notamment les mises à jour de catalogues, la synchronisation des commandes et le suivi des performances publicitaires. L'URL de production suit ce format :

```
https://<namespace>.citrusad.com
```

Assurez-vous que toutes les données (catalogues, produits, commandes) sont exactes et complètes avant d'utiliser cet environnement.

{% hint style="info" %}
Vérifiez toujours le bon environnement avant de passer des appels d'API, en particulier lors de l'utilisation d'identifiants et d'URL de base. L'URL de base peut ne pas toujours correspondre à l'espace de noms, selon la configuration d'intégration du distributeur.
{% endhint %}

## Endpoints de l'API partenaire

Epsilon Retail Media L'API offre un ensemble de fonctionnalités clés regroupées en catégories fonctionnelles, chacune prise en charge par des endpoints dédiés. Le tableau ci-dessous résume les principales API destinées aux partenaires, leur objectif et les méthodes HTTP utilisées.

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

### Gestion des campagnes

**Qu'est-ce qu'une Sponsored Product Ad ?** Les Sponsored Product Ads (SPA) sont des annonces placées dans les grilles de produits sur le site du distributeur, généralement présentes sur les pages de recherche et de catégorie ainsi que sur les PDP et la page d'accueil, superposées aux résultats organiques.

**Qu'est-ce qu'un Banner X Ad?** Banner X les annonces sont des unités publicitaires entièrement réactives qui s'adaptent et changent selon la zone d'affichage de l'utilisateur. Elles sont composées de nombreux éléments de création, allant des images principales et d'arrière-plan au texte d'accroche et aux boutons d'appel à l'action.

**Qu'est-ce qu'une Banner Ad ?** Une bannière standard est une image statique associée à une URL de redirection.

#### Campagne de produits

| Endpoint                                                                                                                                                                                        | Description                                                                                          | Méthode |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- | ------- |
| [Créer une campagne de produits](/retail-media-interface/partner/fr/campaign-management-api/productcampaign-1/createproductcampaign.md)                                                         | Crée une nouvelle campagne de produits en utilisant les détails fournis dans le corps de la requête. | POST    |
| [Récupérer la liste de toutes les campagnes de produits](/retail-media-interface/partner/fr/campaign-management-api/productcampaign-1/listproductcampaigns.md)                                  | Récupère une liste de toutes les campagnes de produits en fonction des paramètres fournis.           | GET     |
| [Mettre à jour une campagne de produits](/retail-media-interface/partner/fr/campaign-management-api/productcampaign-1/updateproductcampaign.md)                                                 | Met à jour une campagne de produits existante en utilisant l'ID de campagne                          | PATCH   |
| [Obtenir la campagne de produits par ID](/retail-media-interface/partner/fr/campaign-management-api/productcampaign-1/getproductcampaign-1.md)                                                  | Récupère les détails de la campagne de produits pour l'ID de campagne spécifié.                      | GET     |
| [Changer l'état d'approbation d'une campagne de produits](/retail-media-interface/partner/fr/campaign-management-api/productcampaign-1/approveproductcampaign-1.md)                             | Met à jour l'état d'approbation d'une campagne de produits spécifiée.                                | POST    |
| [Vérifier la faisabilité de la réservation pour les campagnes à Emplacement fixe](/retail-media-interface/partner/fr/campaign-management-api/productcampaign-1/checkfixedtenancyavailable-1.md) | Vérifie si la réservation est réalisable pour les campagnes d'emplacement fixe.                      | POST    |

#### Banner X Campagne

| Endpoint                                                                                                                                                               | Description                                                                                                                                                                                          | Méthode |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------- |
| [Créer une campagne Banner X](/retail-media-interface/partner/fr/campaign-management-api/bannerxcampaign-1/createbannerxcampaign-1.md)                                 | Crée une nouvelle campagne bannière X en utilisant les détails fournis dans le corps de la requête.                                                                                                  | POST    |
| [Obtenir les détails de la campagne Banner X](/retail-media-interface/partner/fr/campaign-management-api/bannerxcampaign-1/getbannerxcampaign-1.md)                    | Récupère les détails de la campagne bannière X pour l'ID de campagne spécifié.                                                                                                                       | GET     |
| [Mettre à jour la campagne Banner X](/retail-media-interface/partner/fr/campaign-management-api/bannerxcampaign-1/updatebannerxcampaign.md)                            | Met à jour une campagne Banner X existante en fournissant l'ID de campagne et les données de campagne mises à jour dans le corps de la requête.                                                      | PATCH   |
| [Mettre à jour l'état d'approbation de la campagne Banner X](/retail-media-interface/partner/fr/campaign-management-api/bannerxcampaign-1/approvebannerxcampaign-1.md) | Met à jour l'état d'approbation d'une campagne bannière X spécifiée.                                                                                                                                 | POST    |
| [Récupérer la liste de toutes les campagnes Banner X](/retail-media-interface/partner/fr/campaign-management-api/bannerxcampaign-1/listbannerxcampaigns.md)            | Récupère une liste de campagnes bannière X en fonction de filtres et paramètres spécifiés, notamment le nom de la campagne, l'ID d'emplacement, l'ID d'équipe, l'état d'approbation, et plus encore. | GET     |

#### Campagne de bannière

| Endpoint                                                                                                                                                             | Description                                                                                          | Méthode |
| -------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- | ------- |
| [Créer une campagne de bannière](/retail-media-interface/partner/fr/campaign-management-api/bannercampaign/createbannercampaign-1.md)                                | Crée une nouvelle campagne de bannière en utilisant les détails fournis dans le corps de la requête. | POST    |
| [Obtenir les détails de la campagne de bannières](/retail-media-interface/partner/fr/campaign-management-api/bannercampaign/getbannercampaign-1.md)                  | Récupère les détails de la campagne de bannière pour l'ID de campagne spécifié.                      | GET     |
| [Mettre à jour la campagne de bannières](/retail-media-interface/partner/fr/campaign-management-api/bannercampaign/updatebannercampaign.md)                          | Met à jour une campagne de bannière existante en utilisant l'ID de campagne.                         | PATCH   |
| [Mettre à jour l'état d'approbation de la campagne de bannières](/retail-media-interface/partner/fr/campaign-management-api/bannercampaign/approvebannercampaign.md) | Met à jour l'état d'approbation d'une campagne de bannière spécifiée                                 | POST    |

#### Fichiers de campagne

| Endpoint                                                                                                                                  | Description                                                                                           | Méthode |
| ----------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- | ------- |
| [Téléverser un fichier de campagne](/retail-media-interface/partner/fr/campaign-management-api/creativeassets/uploadfile.md)              | Télécharge différents types de fichiers de campagne                                                   | POST    |
| [Récupérer l'URL du fichier de campagne](/retail-media-interface/partner/fr/campaign-management-api/creativeassets/getcampaignfileurl.md) | Récupère l'URL d'un fichier de campagne en utilisant l'ID de fichier et le type de fichier spécifiés. | POST    |

#### Norme de contenu

| Endpoint                                                                                                                                                                                   | Description                                                                                                                                                                 | Méthode |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------- |
| [Obtenir les détails des normes de contenu Banner X](/retail-media-interface/partner/fr/campaign-management-api/bannerxcontentstandard/getbannerxcontentstandard-1.md)                     | Récupère Banner X les détails de la norme de contenu pour l'ID de norme de contenu spécifié.                                                                                | GET     |
| [Récupérer la liste des normes de contenu pour les campagnes Banner X](/retail-media-interface/partner/fr/campaign-management-api/bannerxcontentstandard/listbannerxcontentstandard.md)    | Récupère la liste des normes de contenu pour Banner X les campagnes en fonction des paramètres spécifiés, tels que l'espace de noms, le nom et l'ID de norme de contenu.    | GET     |
| [Obtenir les détails des normes de contenu de bannière](/retail-media-interface/partner/fr/campaign-management-api/bannerxcontentstandard/getbannercontentstandard.md)                     | Récupère les détails de la norme de contenu de bannière pour l'ID de norme de contenu spécifié.                                                                             | GET     |
| [Récupérer la liste des normes de contenu pour les campagnes de bannières](/retail-media-interface/partner/fr/campaign-management-api/bannerxcontentstandard/listbannercontentstandard.md) | Récupère la liste des normes de contenu pour les campagnes de bannière en fonction des paramètres spécifiés, tels que l'espace de noms, le nom et l'ID de norme de contenu. | GET     |

#### Campagne

| Endpoint                                                                                                                                                        | Description                                                                                                                                                                                                                 | Méthode |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------- |
| [Récupérer la liste de toutes les campagnes](/retail-media-interface/partner/fr/campaign-management-api/campaign/listcampaigns-1.md)                            | Récupère une liste de campagnes en fonction de filtres et de paramètres spécifiés, notamment le nom de la campagne, le type de campagne, l'ID d'emplacement, l'ID d'équipe, l'état d'approbation, et plus encore.           | POST    |
| [Récupérer l'historique de la campagne](/retail-media-interface/partner/fr/campaign-management-api/campaign/getcampaignhistory.md)                              | Récupère l'historique d'une campagne à l'aide de son ID de campagne.                                                                                                                                                        | GET     |
| [Récupérer les détails de l'enchère minimale pour les mots-clés](/retail-media-interface/partner/fr/campaign-management-api/campaign/retrievekeywordsminbid.md) | Récupère les détails des enchères minimales individuelles et l'enchère minimale globale de la campagne pour un ensemble de mots-clés spécifiés dans les campagnes de type d'emplacement Recherche et Catégorie & Recherche. | POST    |
| [Récupérer les détails de l'enchère minimale pour la catégorie](/retail-media-interface/partner/fr/campaign-management-api/campaign/retrievecategoryminbid.md)  | Récupère les détails des enchères minimales individuelles et l'enchère minimale globale de la campagne pour les campagnes de type d'emplacement catégorie.                                                                  | POST    |

## Gestion des éléments de création

### Qu'est-ce qu'un élément de création ?

Les éléments de création sont des images utilisées dans les campagnes de bannière et Banner X de campagne. Ces éléments doivent répondre à des exigences techniques spécifiques pour garantir un affichage et des performances appropriés.

### Directives de téléchargement :

* Taille du fichier < 4 Mo
* Types de fichiers : PNG, JPEG, JPG, GIF, SVG et PDF
* Un seul fichier à la fois
* L'ID d'équipe, l'ID d'emplacement et l'ID de norme de contenu sont obligatoires
* Fournir un chemin d'accès absolu complet vers le fichier

{% hint style="info" %}
Les téléchargements d'éléments de création sont gérés via les endpoints de fichiers de campagne répertoriés dans la section Gestion des campagnes ci-dessus.
{% endhint %}

## Gestion des normes de contenu

### Qu'est-ce qu'une norme de contenu ?

Les normes de contenu sont des directives et des paramètres techniques qui dictent la manière dont une bannière ou une annonce Banner X doit être affichée dans un espace désigné sur un site web ou une plateforme numérique. Les normes incluent des paramètres tels que les dimensions et la taille, le format et la taille des fichiers, la résolution et la qualité, le positionnement et l'alignement, les restrictions de contenu et l'interactivité.

### Gestion des équipes et des utilisateurs

#### Qu'est-ce qu'une équipe ?

Une équipe est un ensemble d'utilisateurs et est classée soit comme une équipe fournisseur (annonceur), soit comme une équipe distributeur. Les équipes fournisseurs créent généralement des campagnes, tandis que les distributeurs examinent les campagnes et exécutent des tâches administratives. Un utilisateur du système peut appartenir à plusieurs équipes ou à une seule. En règle générale, des utilisateurs, des campagnes et des portefeuilles sont associés à une équipe.

#### Équipe

| Endpoint                                                                                                  | Description                                                                                            | Méthode |
| --------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------ | ------- |
| [Créer une équipe](/retail-media-interface/partner/fr/team-user-api/team/createteam-1.md)                 | Crée une nouvelle équipe.                                                                              | POST    |
| Mettre à jour une équipe                                                                                  | Met à jour les détails d'une équipe spécifiée par le team\_id.                                         | PATCH   |
| Lister toutes les équipes                                                                                 | Récupère une liste d'équipes en fournissant des paramètres tels que name, namespace\_id et seller\_id. | GET     |
| [Obtenir l'équipe pour l'ID spécifié](/retail-media-interface/partner/fr/team-user-api/team/getteam-1.md) | Récupère des informations détaillées sur une équipe spécifique, y compris ses membres.                 | GET     |
| Rejoindre une équipe avec un jeton d'invitation                                                           | Permet aux utilisateurs de rejoindre une équipe à l'aide d'un jeton d'invitation valide et non expiré. | POST    |

#### Utilisateur

| Endpoint                                                                                                                          | Description                                                                                               | Méthode |
| --------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------- | ------- |
| [Inviter un utilisateur dans l'équipe](/retail-media-interface/partner/fr/team-user-api/user-1/createuserteaminvite.md)           | Envoie une invitation à un utilisateur pour rejoindre une équipe spécifiée.                               | POST    |
| Récupérer les détails de l'utilisateur à l'aide de l'ID utilisateur                                                               | Récupère les détails de l'utilisateur actuellement connecté à la Epsilon Retail Media plateforme.         | GET     |
| [Récupérer les détails de l'utilisateur](/retail-media-interface/partner/fr/team-user-api/user-1/getusersforteam.md)              | Récupère les détails de l'utilisateur en fonction de l'ID d'équipe fourni.                                | GET     |
| [Mettre à jour les détails de l'utilisateur actuel](/retail-media-interface/partner/fr/team-user-api/user-1/updateuserprofile.md) | Modifie les détails de l'utilisateur actuellement connecté sur la Epsilon Retail Media plateforme.        | PATCH   |
| [Modifier les autorisations de l'utilisateur](/retail-media-interface/partner/fr/team-user-api/user-1/modifyuserpermission.md)    | Met à jour les autorisations d'un utilisateur en fournissant à la fois l'ID utilisateur et l'ID d'équipe. | PATCH   |
| [Téléverser un fichier](/retail-media-interface/partner/fr/team-user-api/user-1/uploadfile-1.md)                                  | Télécharge des logos pour les profils d'utilisateurs et les équipes.                                      | POST    |
| [Récupérer l'URL du fichier](/retail-media-interface/partner/fr/team-user-api/user-1/getfileurl.md)                               | Récupère l'URL d'un logo d'équipe ou d'utilisateur à l'aide de l'ID de fichier spécifié.                  | POST    |
| Supprimer un utilisateur                                                                                                          | Supprime un utilisateur de l'équipe.                                                                      | DELETE  |

### Facturation et gestion du portefeuille

#### Qu'est-ce qu'un portefeuille ?

Un portefeuille stocke les fonds d'un annonceur à des fins de paiement (par exemple, payer pour des annonces diffusées).

#### Portefeuille

| Endpoint                                                                                                                   | Description                                                                                                                                                                                 | Méthode |
| -------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------- |
| [Créer un portefeuille](/retail-media-interface/partner/fr/billing-api/wallet/createwallet.md)                             | Crée un portefeuille dans un namespace spécifié et l'associe à une équipe à l'aide de l'ID d'équipe.                                                                                        | POST    |
| [Mettre à jour un portefeuille](/retail-media-interface/partner/fr/billing-api/wallet/updatewallet-1.md)                   | Met à jour un portefeuille dans un namespace et un teamId spécifiés.                                                                                                                        | PATCH   |
| [Récupérer le portefeuille par son ID](/retail-media-interface/partner/fr/billing-api/wallet/getwallet-1.md)               | Récupère les détails d'un portefeuille spécifique à l'aide de son identifiant unique, {id}.                                                                                                 | GET     |
| [Lister tous les portefeuilles](/retail-media-interface/partner/fr/billing-api/wallet/listwallets.md)                      | Récupère une liste de portefeuilles en fonction de filtres et de paramètres spécifiés, notamment l'ID d'équipe, le nom du portefeuille, l'ID du portefeuille, l'ID externe, et plus encore. | GET     |
| [Obtenir le solde d'un portefeuille spécifique](/retail-media-interface/partner/fr/billing-api/wallet/getwalletbalance.md) | Récupère le solde actuel d'un portefeuille spécifié.                                                                                                                                        | GET     |
| [Gérer les fonds d'un portefeuille spécifique](/retail-media-interface/partner/fr/billing-api/wallet/managefunds.md)       | Gère les opérations de fonds pour un portefeuille spécifique.                                                                                                                               | POST    |

#### Dépense

| Endpoint                                                                                                                      | Description                                                                                                                    | Méthode |
| ----------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ | ------- |
| [Récupérer les détails des dépenses de la campagne](/retail-media-interface/partner/fr/billing-api/spend/getcampaignspend.md) | Calcule le budget restant pour des campagnes spécifiques en fonction de leur solde disponible et de leurs limites de dépenses. | POST    |

### Opération en masse

#### Campagne

| Endpoint                                                                                                                                                  | Description                                                                                                   | Méthode |
| --------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------- | ------- |
| [Créer des campagnes en masse](/retail-media-interface/partner/fr/bulk-operation-api/bulkcampaignoperations/bulkcreatecampaign.md)                        | Crée simultanément plusieurs campagnes (jusqu'à 1 000) en fonction du type de campagne.                       | POST    |
| [Mettre à jour des campagnes en masse](/retail-media-interface/partner/fr/bulk-operation-api/bulkcampaignoperations/bulkupdatecampaign-1.md)              | Met à jour les campagnes dans un namespace spécifié.                                                          | PATCH   |
| [Mettre à jour l'état d'approbation de la campagne](/retail-media-interface/partner/fr/bulk-operation-api/bulkcampaignoperations/bulkcampaignapproval.md) | Approuve ou rejette les campagnes dans un namespace spécifié.                                                 | POST    |
| Récupérer le statut d'une opération en masse                                                                                                              | Récupère le statut et les détails d'une opération de campagne en masse à l'aide de l'ID d'opération en masse. | GET     |

#### Portefeuille

| Endpoint                                                                                                                                                      | Description                                                                              | Méthode |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------- | ------- |
| [Créer des portefeuilles en masse](/retail-media-interface/partner/fr/bulk-operation-api/bulkwalletoperations/bulkcreatewallet.md)                            | Créez plusieurs portefeuilles à la fois au sein de votre organisation (jusqu'à 1 000).   | POST    |
| [Récupérer le statut de l'opération de portefeuille en masse](/retail-media-interface/partner/fr/bulk-operation-api/bulkwalletoperations/bulkwalletstatus.md) | Récupère le statut d'une opération de portefeuille en masse à l'aide de son ID en masse. | GET     |
| [Mettre à jour des portefeuilles en masse](/retail-media-interface/partner/fr/bulk-operation-api/bulkwalletoperations/bulkupdatewallet.md)                    | Met à jour plusieurs portefeuilles simultanément.                                        | PATCH   |

#### Équipe

| Endpoint                                                                                                                                               | Description                                                                       | Méthode |
| ------------------------------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------- | ------- |
| [Créer des équipes en masse](/retail-media-interface/partner/fr/bulk-operation-api/bulkwalletoperations-1/bulkcreateteam.md)                           | Crée des équipes en masse pour une organisation.                                  | POST    |
| [Mettre à jour des équipes en masse](/retail-media-interface/partner/fr/bulk-operation-api/bulkwalletoperations-1/bulkupdateteam.md)                   | Met à jour plusieurs équipes simultanément.                                       | PATCH   |
| [Récupérer le statut de l'opération d'équipe en masse](/retail-media-interface/partner/fr/bulk-operation-api/bulkwalletoperations-1/bulkteamstatus.md) | Récupère le statut d'une opération d'équipe en masse à l'aide de son ID en masse. | GET     |

### Terme de recherche suggéré

#### Que sont les termes de recherche suggérés ?

Les termes de recherche suggérés sont une collection de termes fournis via un fichier par le distributeur associant des produits à des termes spécifiques qui sont présentés à l'utilisateur lors de la création d'une campagne à l'étape des termes de recherche. Pour plus d'informations, voir Termes de recherche suggérés.

| Endpoint                                                                                                                                                            | Description                                                                                                                                                            | Méthode |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------- |
| [Laste toutes les suggestions de termes de recherche](/retail-media-interface/partner/fr/suggested-search-term-api/suggestedsearchterm/listsuggestedsearchterms.md) | Récupère les termes de recherche suggérés pour le ciblage de catalogue basés sur des paramètres spécifiés tels que l'ID de catalogue, le code produit, et plus encore. | GET     |

## Bonnes pratiques

Suivez ces bonnes pratiques pour garantir une intégration fluide, efficace et fiable avec les Epsilon Retail Media API partenaires :

* Toujours tester dans la sandbox avant le déploiement en production.
* Utilisez les points de terminaison en masse pour les opérations multiples.
* Vérifiez les problèmes de données spécifiques dans les réponses d'erreur.
* Utilisez des fichiers compressés pour un téléchargement plus rapide des données.
* Ne rafraîchissez les jetons d'accès que lorsqu'ils sont expirés.
* Validez les champs requis avant de soumettre les requêtes.

## Gestion des erreurs

Nos API partenaires renvoient des réponses d'erreur JSON structurées pour prendre en charge une gestion robuste des exceptions.

* **Code de statut HTTP** : Codes d'erreur standards (400, 401, 403, 500, etc.)
* **Code d'erreur** : Identifiant d'erreur spécifique.
* **Message** : Description de l'erreur lisible par l'homme.
* **Violations de champs** : Erreurs de validation de champs spécifiques pour les problèmes de saisie de données.

Pour des informations détaillées sur la gestion des erreurs, voir [Gestion des erreurs](/retail-media-interface/partner/fr/partner-api-overview/error-handling.md).

## Support et ressources

| Ressource                                                                                                    | Description                                                                             |
| ------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------- |
| [Foire aux questions](/retail-media-interface/partner/fr/partner-api-overview/frequently-asked-questions.md) | Questions et réponses fréquentes relatives à l'utilisation et à l'intégration de l'API. |
| Notes de version                                                                                             | Résumé des récentes mises à jour ou modifications apportées à l'API.                    |
| [Glossaire](https://developers.citrusad.com/partner/docs/createupdate-campaign-fields-1)                     | Définitions des termes clés utilisés dans la documentation de l'API.                    |


---

# 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/partner/fr/partner-api-overview/epsilon-retail-media-partner-apis-overview-1.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.