> 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/audience-targeting-new/integration-option-2-sync-customers-audience.md).
# Option 2 : Synchroniser les clients et l'audience
### Présentation
Les distributeurs disposant de clean rooms ou de segments d'audience gérés en autonomie peuvent synchroniser les données clients et de segments afin de permettre la diffusion d'audiences personnalisées pour les grands annonceurs et les audiences générales. Cette intégration implique l'utilisation de votre CDP pour fournir les informations clients/segments à Epsilon, soit par API, soit par fichier.
### Exigences d'intégration
* L'intégration sur site standard doit inclure l'identifiant client sur tous les points de contact pertinents (lorsqu'il est disponible).
* Flux d'identifiants clients, par API ou par flux de fichiers.
* Flux de segments par API ou par flux de fichiers.
### Fonctionnement
La CDP ou la plateforme d'audience fournit les données clients et de segments à Epsilon , par téléversement de fichier ou par API. Les identifiants clients inclus dans les demandes de publicité sont mis en correspondance avec les segments d'audience et les campagnes associées. Cela permet un ciblage précis basé sur des définitions d'audiences personnalisées ou générales.
### Exemples d'intégration
**Exemple de demande de publicité** : Demande de publicité contenant un identifiant client :
```http
POST $BASE_URL/v1/ads/generate HTTP/1.1
accept: application/json
content-type: application/json
Authorization: Basic
{
"customerId": "wertg5432a",
"sessionId": "ec9-4e07-881d-3e9",
"dtmCookieId": "AAAF8xLBTA968AB6TOthAAAAAAE",
"placement": "search",
"catalogId": "628dbe95-2ec9-4e07-881d-3e9f92ab2e0b",
"searchTerm": "chocolate",
"options": {
"filterMode": "AndOr"
},
"maxNumberOfAds": 3
}
```
{% hint style="info" %}
Votre demande de publicité doit contenir `customerId`, que vous vous intégriez par fichier ou par API.
{% endhint %}
### Intégration de la synchronisation par fichier de flux (recommandée)
Lors de la synchronisation des clients et des segments par fichier, nous exigeons deux fichiers :
* Fichier de segments
* Fichier de clients
#### Fichier de segments
Un fichier de segments est utilisé pour fournir un identifiant de segment qui s'affiche dans l'interface utilisateur, un nom et une description. Il peut également être utilisé pour spécifier tous les team\_ids spécifiques pouvant afficher un segment, vous permettant de sélectionner des segments pour des annonceurs spécifiques.
| segment\_id | name | description | team\_ids |
| ----------------- | ---------------------------------------- | --------------------------------------------------------------------------------- | -------------------------------------------------------------------------------- |
| general-segment-1 | Acheteurs à fortes dépenses | Acheteurs ayant un panier hebdomadaire moyen se situant dans les 15 % supérieurs. | |
| general-segment-2 | Acheteurs économes | Acheteurs ayant un pourcentage de panier plus élevé en produits économiques. | |
| general-segment-3 | Acheteurs récurrents | Acheteurs qui font leurs achats toutes les semaines en moyenne. | |
| custom-segment-1 | Custom : MarqueCo récence d'achat élevée | Clients ayant acheté MarqueCo au cours des 30 derniers jours. | \["a5166fc4-f874-4741-a721-c05ffd9941a5","92f4b91f-0089-4102-b13b-6015da8e0174"] |
Consulter le guide de référence des segments [ici](/retail-media-interface/integration/fr/references/audience-targeting-reference.md#segment-feed-required-when-syncing-your-own-segments).
#### Fichier de clients
Votre fichier de clients est utilisé pour créer un client unique et le lier à des segments, vous devez seulement fournir `customer_id` et `segment_ids`
| customer\_id | segments |
| ------------ | ------------------------------------------- |
| cust\_12345 | \["general-segment-3", "general-segment-4"] |
| cust\_67890 | \["general-segment-3"] |
Consulter le guide de référence des clients [ici](/retail-media-interface/integration/fr/references/audience-targeting-reference.md#customer-feed-required-when-syncing-your-own-segments-and-customers).
{% hint style="info" %}
Maximum 100 segments par client.
Si vous synchronisez plus de 100 segments pour un client, veuillez contacter Epsilon. Si vous dépassez 100 segments par client, les demandes de publicité peuvent présenter un regroupement de segments réduit et tronquer les segments dans la demande.
{% endhint %}
### Intégration de la synchronisation par API
Lors de la synchronisation des clients et des segments par API, trois opérations doivent être effectuées.
1. Créer des segments
2. Optionnel : gérer l'accès aux segments
3. Créer des clients
4. Gérer la liaison client-segment
#### Création de segments via l'API
La première chose à faire est de créer vos segments auxquels lier les clients.
Vous devez fournir un identifiant de segment qui s'affiche dans l'interface utilisateur, un nom, une description, ainsi que l'équipe de votre distributeur.
{% hint style="info" %}
Important : L'API de segments utilise l'autorisation bearer utilisée par l'API Partner. Vous devrez générer un jeton bearer et l'utiliser. En savoir plus : [Demandes d'authentification](https://help.citrusad.com/retail-media-interface/partner/fr/partner-api-authentication/authenticating-requests).
{% endhint %}
```http
POST $BASE_URL/v1/segments HTTP/1.1
accept: application/json
content-type: application/json
Authorization: Bearer
{
"segment":{
"segmentId": "general-segment-4",
"sourceId": "DEFAULT_SOURCE_ID",
"name": "Value Shoppers",
"description": "Shoppers that have a higher basket % of value driven products.",
"retailerTeamId": "13c84def-41cb-4f99-a3fc-6788264f79fe"
}
}
```
Consulter la référence pour le point de terminaison Créer un segment [ici](https://help.citrusad.com/retail-media-interface/partner/fr/audience-segment-api/segment/createsegment).
#### Optionnel : gérer l'accès aux segments
Vous pouvez utiliser la fonction manage-access pour donner l'accès à des annonceurs sélectionnés afin qu'ils voient le segment, ce qui vous permet de sélectionner des segments pour des annonceurs spécifiques.
```http
POST $BASE_URL/v1/segments/{id}:manage-access HTTP/1.1
accept: application/json
content-type: application/json
Authorization: Bearer
{
"accessTeamIds":[
"90d5f138-2090-412b-a397-1f59ea6a31b3","1439f6f2-8c43-4ec5-b511-fc153f7d8119"
]
}
```
Consulter la référence pour le point de terminaison Gérer l'accès à un segment spécifique [ici](https://help.citrusad.com/retail-media-interface/partner/fr/audience-segment-api/segment/manageaccess).
#### Création de clients via l'API
{% hint style="info" %}
L'API clients utilise l'autorisation basique utilisée par l'API Integration.
{% endhint %}
```http
POST $BASE_URL/v1/customers HTTP/1.1
accept: application/json
content-type: application/json
Authorization: Basic
{
"customers": [
{
"id": "cust_12345"
},
{
"id": "cust_67890"
}
}
]
}
```
Une fois terminé, vous devez également créer des segments auxquels lier les clients. Vous pouvez créer jusqu'à 100 clients par demande.
Consulter les spécifications de l'API pour Créer ou mettre à jour un client [ici](/retail-media-interface/integration/fr/integration/create-or-update-a-customer.md).
#### Lier des clients à des segments via l'API
Après avoir créé les segments, utilisez l'API /customers/manage-segments pour lier les clients aux segments
```http
POST $BASE_URL/v1/customers/manage-segments HTTP/1.1
accept: application/json
content-type: application/json
Authorization: Basic
{
"customerId": "cust_12345",
"teamId":"13c84def-41cb-4f99-a3fc-6788264f79fe",
"segments": {
"segmentIds":[
"general-segment-4","general-segment-3"
]
}
}
```
{% hint style="info" %}
teamId dans cette demande est l'identifiant de l'équipe de votre distributeur.
{% endhint %}
Consultez la spécification de l'API pour gérer les segments et les clients ici.
---
# 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/audience-targeting-new/integration-option-2-sync-customers-audience.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.