> 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-3-sync-audiences-only.md).
# Option 3 : Synchroniser uniquement les audiences
### Présentation
Pour les organisations incapables de partager des identifiants clients, l'activation d'audience peut être réalisée en synchronisant les flux de segments et en transmettant les ID de segment dans les demandes d'annonce. Cette approche respectueuse de la vie privée permet un ciblage d'audience personnalisé et général sans exposer les données au niveau du client. Les demandes d'annonce doivent inclure des identifiants de segment pour prendre en charge l'activation ciblée.
### Exigences d'intégration
* Le flux de segments doit spécifier quels segments d'audience sont disponibles pour les équipes d'annonceurs désignées.
* Les demandes d'annonce doivent inclure le ou les ID de segment pertinents pour chaque client.
### Comment ça fonctionne
La CDP ou plateforme d'audience fournit Epsilon un flux de segments via un téléchargement de fichier ou une API. Les ID de segment inclus dans les demandes d'annonce sont utilisés pour faire correspondre les audiences aux campagnes. La correspondance entre les clients et les segments est gérée en interne dans les systèmes backend du distributeur.
### Exemples d'intégration
**Exemple de demande d'annonce** : demande d'annonce contenant des ID de segment :
```http
POST $BASE_URL/v1/ads/generate HTTP/1.1
accept: application/json
content-type: application/json
Authorization: Basic
{
"audience": {
"segments": [
{
"segmentIds": [
"segment-1"
]
},
{
"sourceId": "RETAILER_SOURCE_2",
"segmentIds": [
"general-segment-4","general-segment-3"
]
}
]
},
"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" %}
Vous synchronisez des segments à partir de plusieurs sources ?
Si oui, vous devrez également fournir le `sourceId` dans l'objet segment. Cette valeur est convenue entre vous et Epsilon pour référencer la source du segment. Un exemple pourrait être `customer-cdp-1`.
Si vous synchronisez uniquement à partir d'une seule source/CDP, vous devez seulement envoyer le `segmentIds` dans le tableau `segment` .
{% endhint %}
### Synchronisation via fichier de flux (recommandée)
Lors de la synchronisation de segments, nous ne requérons qu'un seul fichier.
#### Fichier de segment
Un fichier de segment est utilisé pour fournir un ID de segment affiché dans l'interface utilisateur, un nom et une description. Il peut également être utilisé pour spécifier des 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 avec un panier hebdomadaire moyen situé dans les 15 % supérieurs. | |
| general-segment-2 | Acheteurs économes | Acheteurs ayant un pourcentage de panier plus élevé en produits à forte valeur relative. | |
| general-segment-3 | Acheteurs récurrents | Acheteurs qui font leurs achats chaque semaine en moyenne. | |
| custom-segment-1 | Personnalisé : 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"] |
Consultez le guide de référence des segments ici
### Synchronisation via API
Lors de la synchronisation des clients et des segments par API, une ou deux opérations doivent être effectuées.
1. Créer des segments
2. Optionnel : gérer l'accès aux segments
#### Créer des segments via l'API
Comme vous gérez la relation client-segment avant la demande d'annonce, vous devez uniquement envoyer des segments.
Vous devez fournir un ID de segment qui est affiché dans l'UI, un nom, une description, ainsi que votre équipe distributeur.
{% hint style="info" %}
L'API de segments utilise l'autorisation bearer utilisée par l'API Partenaire. 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).
En cas de synchronisation des segments via API. Ce `sourceId` s'aligne avec la demande d'annonce.
{% hint style="info" %}
Maximum de 100 segments par demande d'annonce.
Si vous synchronisez plus de 100 segments, veuillez contacter Epsilon. Si vous dépassez 100 segments par client, les demandes d'annonce peuvent avoir un regroupement de segments réduit et tronquer les segments dans la demande.
En cas de troncature, vous verrez le champ `metadata.warnings`apparaître et se remplir dans la réponse d'annonce, comme ci-dessous :
```
"metadata": {
"warnings": [
"Audience Segment IDs exceeded the limit of 100 and were truncated"
]
}
```
{% endhint %}
#### Optionnel : gérer l'accès aux segments
Vous pouvez utiliser la fonction manage-access pour donner accès aux 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).
---
# 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-3-sync-audiences-only.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.