> 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/data-api/api-overview/integration-workflow-options-1.md).
# Options de flux de travail d'intégration des annonces pour les distributeurs
Epsilon's Retail Media L'intégration standard garantit que votre site Web offre une expérience utilisateur fluide en présentant rapidement des publicités pertinentes aux clients. En tant que commerçant, il vous suffit de synchroniser votre catalogue de produits et vos données clients avec Epsilon's Retail Media. Il est important de noter que Epsilon Retail Media est intégré via le backend du commerçant. L'intégration garantit que les publicités pertinentes sont affichées sur votre site Web, améliorant ainsi l'expérience d'achat de l'utilisateur en fusionnant les annonces publicitaires avec le contenu organique. Voici quelques-uns des principaux avantages :
1. **Expérience utilisateur améliorée** : Les publicités s'intègrent de manière transparente au contenu organique, offrant une expérience de navigation fluide.
2. **Pertinence** : Les publicités sont contextuellement pertinentes, ce qui augmente l'engagement des utilisateurs.
3. **Efficacité** : La diffusion rapide du contenu publicitaire améliore les temps de chargement des pages.
4. **Rapports** : Obtenez des informations détaillées sur les impressions publicitaires, les clics et les commandes.
## Intégration standard
Le flux de travail d'intégration standard comprend les étapes suivantes :
1. Synchroniser les données
2. Diffuser des publicités
3. Signaler les actions
{% hint style="info" %}
Les clients ne voient pas les annonces tant qu'elles ne sont pas fusionnées dans une liste finale. Cela permet de s'assurer qu'ils obtiennent des informations complètes et précises.
{% endhint %}
### Flux de travail
Voici la série d'événements :
#### Avant la diffusion des publicités
**Synchroniser les données produits** : Synchronisez votre catalogue de produits avec Epsilon Retail Media en utilisant le [API](https://developers.citrusad.com/integration/docs/use-apis) ou un fichier quotidien [synchronisation de fichiers](https://developers.citrusad.com/integration/docs/use-apis). Facultativement, synchronisez vos données clients avec Epsilon Retail Media en utilisant l'API ou une synchronisation quotidienne par fichier.
#### Lorsque les publicités sont diffusées
1. **Le client visite votre site Web** : Un client ouvre votre site Web et navigue vers une page spécifique où Epsilon’s Retail Media est intégré.
2. **Le site Web demande des données** : Votre site Web demande des données à votre serveur backend en fonction du contexte de la page (par exemple, `customerId`, `sessionId`, `dtmCookieID`, `productFilters`).
3. Le backend demande des publicités à Epsilon Retail Media: Votre serveur backend appelle l'API Epsilon Retail Media , en demandant des publicités pertinentes selon le contexte de la page du client.
4. **Epsilon Retail Media Renvoie des publicités pertinentes** : Epsilon Retail Media renvoie les publicités les plus pertinentes pour la demande, y compris les codes produits et les URL pour les bannières publicitaires.
5. **Fusionner les publicités avec le contenu organique** : Votre serveur backend fusionne la réponse publicitaire de Epsilon Retail Media avec le contenu organique de votre site Web.
6. **Servir tout le contenu au client** : Votre serveur envoie les annonces et le contenu organique combinés au navigateur du client en une seule réponse.
#### Après la diffusion des annonces
1. **Signaler les impressions** : Lorsque le client consulte une annonce, une impression est signalée à Epsilon Retail Media pour l'individuel adId.
2. **Signaler les clics** : Lorsque le client clique sur une annonce, un clic est signalé à Epsilon Retail Media pour l'individuel `adId`.
3. **Signaler les commandes** : Lorsque le client effectue un achat, les détails de la commande (articles, prix, quantités) ainsi que `customerId`, `sessionId`, `dtmCookieId` sont signalés à Epsilon Retail Media.
## Options d'intégration flexibles
Epsilon Retail Media propose également deux méthodes d'intégration supplémentaires adaptées aux différents besoins et préférences des distributeurs. Chaque méthode présente ses avantages et ses inconvénients propres, permettant aux distributeurs de choisir l'approche la plus appropriée en fonction de leurs exigences spécifiques et de leurs capacités techniques.
### Approche 1 : Requêtes de navigateur individuelles
Cette approche implique des appels backend distincts pour les produits organiques et les annonces, ce qui réduit les modifications du backend et garantit que les utilisateurs voient toujours les annonces les plus récentes. Voici quelques-uns des avantages de cette approche pour les distributeurs :
* **Temps de développement réduit** : Plus facile à mettre en œuvre avec un minimum de modifications du backend, économisant ainsi du temps et des ressources de développement.
* **Annonces à jour** : Garantit l'affichage du contenu publicitaire le plus récent, ce qui peut augmenter la pertinence des annonces et l'engagement des utilisateurs.
#### Flux de travail
Voici la série d'événements :
#### Lorsque les annonces sont diffusées
Dans le cas de requêtes provenant du navigateur, la diffusion d'annonces diffère de l'intégration standard de la manière suivante :
**Gestion des requêtes**
* Les listes de produits sont masquées pour l'utilisateur jusqu'à ce que les listes organiques soient fusionnées avec les Epsilon Retail Media annonces.
* Au lieu de demander directement des données depuis votre service backend existant à Epsilon Retail Media, vous utilisez désormais un nouveau service distributeur.
* Le service distributeur effectue l'appel backend vers Epsilon Retail Media avec les informations d'emplacement pertinentes.
* Même si vous contactez votre serveur backend et Epsilon Retail Media séparément avant la fusion, vous devez toujours collecter tous les détails de produit nécessaires pour les codes produits fournis dans la réponse de Epsilon Retail Media .
**Fusion et diffusion du contenu**
* Le navigateur fusionne les annonces organiques et les Epsilon Retail Media annonces.
* Après la fusion, le navigateur diffuse le contenu combiné au client.
### Approche 2 : Fusion après affichage au client
Cette approche affiche d'abord le contenu organique et fusionne les annonces ensuite, nécessitant des modifications minimales du backend et garantissant aux utilisateurs un accès ininterrompu aux annonces organiques.
#### Flux de travail
Dans cette approche, vous suivez un flux de travail similaire à celui d'auparavant ; cependant, vous diffusez les résultats de produits organiques au client dès qu'ils sont disponibles. Une fois les résultats organiques affichés, vous fusionnez et réordonnez les résultats dès que vous recevez le contenu de Epsilon Retail Media. Cette méthode d'intégration est susceptible de prendre le moins de temps à mettre en œuvre, car elle nécessite des ressources de développement minimales.
#### Lorsque les annonces sont diffusées
Les annonces organiques sont affichées au départ, et les Epsilon Retail Media la réponse est fusionnée une fois que le navigateur la reçoit. De temps en temps, les annonces organiques sont présentées à l'utilisateur avant la fusion et le réordonnancement des annonces de produits. Lorsque Epsilon Retail Media vous fournit une liste de codes produits, vous devez toujours récupérer toutes les informations détaillées pertinentes pour chacun de ces produits.
## Comparaison des méthodes d'intégration
Voici une comparaison rapide de toutes les différentes méthodes d'intégration que vous pouvez utiliser :
| | Intégration standard | Requêtes individuelles du navigateur | Fusion après affichage au client |
| ------------------------ | ------------------------------------------------------------------ | ---------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------- |
| Flux de travail | Requête unique au backend, fusion avant l'affichage | Requêtes distinctes pour les produits organiques et les annonces | Contenu organique affiché en premier, annonces fusionnées ensuite |
| Modifications du backend | Le service backend existant gère les Epsilon Retail Media requêtes | Nouveau service backend pour Epsilon Retail Media requêtes | Modifications minimales des services backend existants |
| Effort de développement | Modéré | Plus faible | Le plus bas |
| Fusion des annonces | Le backend fusionne les annonces avec le contenu organique | Le navigateur fusionne les annonces avec le contenu organique | Le navigateur fusionne les annonces avec le contenu organique |
| Affichage des annonces | Annonces affichées avec le contenu organique | Annonces affichées avec le contenu organique | Annonces affichées avec le contenu organique |
| Avantages | - Intégration fluide - Traitement backend unifié | - Moins de modifications du backend - Logique d'annonce séparée | - Intégration rapide - Modifications minimales du backend |
| Inconvénients | - Effort de développement modéré - Logique d'annonce unifiée | - Service backend supplémentaire - Logique d'annonce séparée | - Retard potentiel dans l'affichage des annonces - Les annonces se fusionnent après le contenu organique |
---
# 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/data-api/api-overview/integration-workflow-options-1.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.