> 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/frequently-asked-questions.md). # Foire aux questions ## Opérations en lot avec les API Partenaire ### Que sont les opérations en lot ? Les opérations en lot vous permettent de créer, modifier ou approuver plusieurs campagnes, portefeuilles ou équipes en une seule requête API au lieu d'effectuer des appels individuels. ### Les opérations en lot sont-elles synchrones ou asynchrones ? Asynchrones. Vous soumettez un travail et sondez les résultats à l'aide de l'identifiant en lot (bulk ID). ### Que se passe-t-il si certains éléments de ma requête en lot échouent ? Chaque élément est validé indépendamment. Vous obtiendrez des résultats détaillés indiquant ceux qui ont réussi et ceux qui ont échoué avec des messages d'erreur spécifiques. ## Équipe et utilisateur ### Qu'est-ce qu'une invitation ? Une invitation permet à un utilisateur de rejoindre une équipe dans la Epsilon Retail Media plateforme. Les invitations sont généralement envoyées par les administrateurs d'équipe et doivent être acceptées par e-mail ou au sein de la plateforme avant que l'utilisateur puisse accéder aux ressources de l'équipe. ### Comment créer une nouvelle équipe ? Utilisez le [Créer une équipe](/retail-media-interface/partner/fr/team-user-api/team/createteam-1.md) point de terminaison avec les champs requis tels que le nom de l'équipe, les informations sur l'entreprise et l'ID d'espace de noms. Vous aurez besoin des autorisations appropriées pour créer des équipes au sein de votre organisation. ### Puis-je appartenir à plusieurs équipes ? Oui, les utilisateurs peuvent appartenir à plusieurs équipes simultanément. Chaque adhésion à une équipe peut avoir des niveaux d'autorisation et des rôles différents. ### Quelle est la différence entre les équipes Distributeur et Fournisseur ? Les équipes Distributeur gèrent et examinent les campagnes, tandis que les équipes Fournisseur (annonceurs) créent et gèrent les campagnes. Le type d'équipe détermine les fonctionnalités et les autorisations disponibles. ### Comment modifier mes autorisations d'utilisateur ? Les administrateurs d'équipe peuvent modifier les autorisations des utilisateurs à l'aide du point de terminaison Modify user permission. Les types d'autorisation incluent Accès complet et Affichage de rapport pour les rôles Distributeur et Fournisseur. ### Que se passe-t-il lorsque je retire un utilisateur d'une équipe ? Le retrait d'un utilisateur révoque son accès aux ressources, campagnes et données de cette équipe. L'utilisateur ne recevra plus les notifications de l'équipe et ne pourra plus effectuer d'actions spécifiques à l'équipe. ### Combien de temps les jetons d'invitation sont-ils valides ? Les jetons d'invitation ont une période d'expiration. Contactez votre administrateur d'équipe si votre invitation a expiré et que vous en avez besoin d'une nouvelle. ### Puis-je mettre à jour les informations de l'équipe après sa création ? Oui, utilisez le point de terminaison Update a team pour modifier les détails de l'équipe, notamment le nom, les informations sur l'entreprise, le numéro de téléphone, l'URL du site Web et l'adresse. ### Quels types de fichiers puis-je télécharger pour les logos ? Le [Téléverser un fichier](/retail-media-interface/partner/fr/team-user-api/user-1/uploadfile-1.md) point de terminaison prend en charge les formats d'image courants pour les logos d'équipe et de profil utilisateur. Consultez la documentation de l'API pour connaître les exigences spécifiques relatives à la taille et au format des fichiers. ### Comment trouver les équipes que je peux rejoindre ? Utilisez le point de terminaison Lists all teams avec les filtres appropriés comme le nom, `namespace_id`, or `seller_id` pour découvrir les équipes disponibles au sein de votre organisation. ## Lister les campagnes ### Quand dois-je utiliser `managedOnly` ? Dans le Epsilon Retail Media système, certaines campagnes sont gérées par des distributeurs plutôt que par des fournisseurs. Pour les annonces de produits, le seul type de dépense disponible est l'Emplacement fixe. Utilisez le `managedOnly` paramètre pour récupérer uniquement les campagnes avec Emplacement fixe. ## Créer ou mettre à jour des campagnes ### Quand dois-je utiliser `managerTeamId` ? Utilisez le `managerTeamId` paramètre lors de la création ou de la mise à jour de campagnes avec Emplacement fixe. Lors de la spécification de `managerTeamId`, vous devrez également spécifier les paramètres de stratégie d'Emplacement fixe pertinents. ### Qu'est-ce qu'un `namespaceId` ? Le `namespaceId` est l'identifiant unique de l'espace de noms dans lequel les campagnes sont créées ou mises à jour. Pour plus d'informations, voir Espaces de noms. Vous pouvez également contacter votre ingénieur d'intégration client (CIE) pour obtenir cette valeur. ### Qu'est-ce qu'un `placementId` ? Les emplacements spécifient les endroits où les annonces sont affichées. Chaque emplacement dans le Epsilon Retail Media système a un identifiant unique appelé `placementId`. Utilisez l' [Renoie une liste d'emplacements](/retail-media-interface/partner/fr/global-api/placements/listplacements.md) API pour récupérer le `placementId`. Vous pouvez également contacter votre CIE pour obtenir cette valeur. ### Qu'est-ce qu'un `walletId` ? Un walletId est l'identifiant du portefeuille d'un annonceur. Chaque annonceur peut avoir un ou plusieurs portefeuilles. Chaque portefeuille aura une valeur de crédits qu'il peut dépenser. En définissant le walletId, vous définissez le portefeuille de l'annonceur qui sera débité pour la campagne. ### Qu'est-ce qu'un `templateId` ? Le `templateId` est utilisé dans les implémentations Ad Genius. Il n'est pas couramment utilisé par la plupart des clients et peut généralement être ignoré. ### Que sont les champs personnalisés ? Dans la Epsilon Retail Media plateforme, certains distributeurs ont besoin d'attributs personnalisés pour les campagnes, comme les bons de commande et les détails des acheteurs. Un exemple ci-dessous :
Custom fields.png
Si votre intégration ne les requiert pas, vous pouvez ignorer ce champ. Si c'est le cas, votre CIE vous fournira les identifiants nécessaires. ### Que sont les questions personnalisées ? Dans les espaces de noms avec des données de ciblage client intégrées, les annonceurs peuvent cibler des segments de clients à l'aide d'associations `key:value` . Pour plus d'informations, voir Données client. Dans les espaces de noms avec des questions personnalisées, vous pouvez indiquer aux annonceurs si ces questions sont facultatives ou obligatoires et fournir la configuration correspondante. Votre CIE peut fournir le `customQuestionIds` si elles sont configurées dans votre espace de noms. ### Dois-je spécifier `startTime` et `endTime` ? Vous pouvez omettre cela si la campagne est destinée à être toujours active. Si votre annonceur souhaite définir une période active, vous devez fournir les deux valeurs au format ISO-8601. ### Comment puis-je mettre à jour une propriété spécifique sans envoyer l'ensemble de l'objet campagne lors d'une mise à jour (PATCH) ? Nos API utilisent une `mask` propriété qui vous permet de mettre à jour une propriété spécifique sans envoyer l'ensemble de l'objet campagne. #### Points clés * Emplacement\*\* : Assurez-vous que la `mask` propriété est correctement positionnée dans votre requête. * **Gestion des erreurs :** Si vous rencontrez une erreur d'autorisation, vérifiez le format du masque dans votre requête. #### Exemples **Modification d'une propriété simple** comme le nom de la campagne, utilisez ce qui suit : ```json { "productCampaign": { "name": "new campaign name" }, "mask": "name" } ``` Modification d'une propriété imbriquée\*\* comme le `maxBid`: ```json { "productCampaign": { "strategy": { "auction": { "maxBid": "5" } } }, "mask": "strategy.auction.maxBid" } ``` Modification de plusieurs propriétés\*\* comme `searchTerms` et le `maxBid`, utilisez une liste séparée par des virgules de propriétés que vous mettez à jour dans `mask` propriété : ```json { "productCampaign": { "targeting": { "searchTerms": [ { "matchType": "MATCH_TYPE_EXACT_MATCH", "phrase": "yoghurt_new", "suggested": false }, { "matchType": "MATCH_TYPE_EXACT_MATCH", "phrase": "dairy", "suggested": false }, { "matchType": "MATCH_TYPE_EXACT_MATCH", "phrase": "cheezy_new", "suggested": false } ] }, "strategy": { "auction": { "maxBid": "6.5" } } }, "mask": "targeting.searchTerms,strategy.auction" } ``` ## Portefeuille ### Pourquoi ai-je besoin d'un portefeuille ? Les portefeuilles sont utilisés pour gérer les fonds des campagnes et garantir que les transactions sont traitées dans la bonne devise. Pour plus d'informations, voir Objectif. ### Puis-je avoir plusieurs portefeuilles ? Oui, vous pouvez créer plusieurs portefeuilles pour gérer séparément différentes devises ou différents budgets de campagne. Pour plus d'informations, voir Portefeuilles multiples. ### Où puis-je trouver un identifiant de portefeuille ? Pour trouver un identifiant de portefeuille, vous pouvez suivre ces étapes : **Ancienne plateforme :** Accédez à la page **Facturation de l'équipe** pour afficher votre identifiant de portefeuille. **Nouvelle interface utilisateur :** Ouvrez le **Gestionnaire de portefeuille** pour trouver votre identifiant de portefeuille. {% hint style="info" %} Certaines équipes peuvent avoir plusieurs portefeuilles dans différentes devises, assurez-vous donc de sélectionner le bon. {% endhint %} ### Quel est le solde actuel ? Le solde actuel est le solde du portefeuille sans aucun rechargement de crédit ni aucune limite appliquée. ### Quel est le solde disponible ? Le solde disponible est le montant total du portefeuille disponible pour les dépenses à un moment donné. Il comprend le solde actuel plus toute limite de crédit. ### Qu'est-ce qu'une limite quotidienne ou une dépense quotidienne ? Une limite quotidienne est le montant maximum que votre portefeuille peut dépenser en une seule journée. ### Qu'est-ce que le rythme budgétaire ? Le rythme budgétaire signifie que tous les fonds non dépensés de la limite quotidienne seront reportés sur la limite quotidienne du jour suivant. ### Quelle est la limite quotidienne restante ? La limite quotidienne restante correspond aux fonds non dépensés de la limite quotidienne de la veille. ### Quel est le solde disponible plafonné ? Le solde disponible plafonné est le montant que le portefeuille vous permet de dépenser pour la journée, en tenant compte des limites de dépenses et/ou des crédits de rechargement. Cette valeur est essentielle car elle détermine si de l'argent est disponible pour les dépenses. **Calcul du solde disponible plafonné :** * **Limite de crédit uniquement** : Solde disponible plafonné = Solde disponible. * **Limite quotidienne uniquement** : Solde disponible plafonné = Limite quotidienne + report non dépensé * **La limite de crédit et la limite quotidienne sont toutes deux appliquées** : Minimum de (Solde disponible, Limite quotidienne + report) Voici quelques exemples : * **Exemple 1** : La limite de crédit est de 10, le solde du portefeuille est de 20. * **Exemple 2** : Le budget quotidien est de 1000, le solde du portefeuille est de 10 000. * **Exemple 3** : Le budget quotidien est de 250, la limite de crédit est de 20, le solde du portefeuille est de 200. Dans ce cas, le solde disponible plafonné est de 220 car le solde disponible (solde actuel + limite de crédit) est inférieur à la limite quotidienne plus le report non dépensé (250). {% hint style="info" %} Les limites de crédit sont une fonctionnalité héritée et ne sont pas prises en charge par la plupart des détaillants. {% endhint %} ### Le solde du portefeuille peut-il devenir négatif ? Non. Les soldes des portefeuilles ne peuvent pas être définis intentionnellement sur une valeur négative via l'API Partner. Bien que l'activité de la campagne puisse affecter temporairement les soldes, ce comportement est géré par le système et n'est pas contrôlé par l'utilisateur. ### Pourquoi ne puis-je pas sélectionner un portefeuille lors de la création d'une campagne ? La devise du portefeuille doit correspondre à la devise du catalogue. Par exemple, si votre catalogue est en AUD, vous ne pouvez pas sélectionner un portefeuille en GBP. Pour plus d'informations, voir [Compatibilité des devises avec les catalogues](/retail-media-interface/partner/fr/billing-api/wallet.md#currency-compatibility-with-catalogs). --- # 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/frequently-asked-questions.md?ask=&goal= ``` `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.