> 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/de/data-api/audience-targeting-new/integration-option-3-sync-audiences-only.md).
# Option 3: Nur Zielgruppen synchronisieren
### Übersicht
Für Organisationen, die keine Kundenidentifikatoren teilen können, kann die Zielgruppenaktivierung durch die Synchronisierung von Segment-Feeds und die Übergabe von Segment-IDs in Werbeanfragen erreicht werden. Dieser datenschutzfreundliche Ansatz ermöglicht sowohl individuelles als auch allgemeines Zielgruppen-Targeting, ohne Daten auf Kundenebene offenzulegen. Werbeanfragen müssen Segmentidentifikatoren enthalten, um eine zielgerichtete Aktivierung zu unterstützen.
### Integrationsanforderungen
* Der Segment-Feed muss angeben, welche Zielgruppensegmente für festgelegte Werbetreibenden-Teams verfügbar sind.
* Werbeanfragen müssen die relevanten Segment-ID(s) für jeden Kunden enthalten.
### Funktionsweise
Die CDP oder Zielgruppenplattform stellt Epsilon einen Segment-Feed über Datei-Upload oder API zur Verfügung. In Werbeanfragen enthaltene Segment-IDs werden verwendet, um Zielgruppen mit Kampagnen abzugleichen. Die Zuordnung zwischen Kunden und Segmenten wird intern in den Backend-Systemen des Händlers verwaltet.
### Integrationsbeispiele
**Beispiel für Werbeanfrage**: Werbeanfrage mit Segment-IDs:
```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" %}
Synchronisieren Sie Segmente aus mehreren Quellen?
Falls ja, müssen Sie auch Folgendes angeben: `sourceId` im Segment-Objekt. Dieser Wert wird zwischen Ihnen und Epsilon vereinbart, um auf die Quelle des Segments zu verweisen. Ein Beispiel könnte sein: `customer-cdp-1`.
Wenn Sie nur aus einer Quelle/CDP synchronisieren, müssen Sie nur Folgendes senden: `segmentIds` im Array `segment` .
{% endhint %}
### Feed-Datei-Synchronisationsintegration (Empfohlen)
Beim Synchronisieren von Segmenten benötigen wir nur eine Datei.
#### Segmentdatei
Eine Segmentdatei wird verwendet, um eine Segment-ID anzugeben, die in der Benutzeroberfläche angezeigt wird, sowie einen Namen und eine Beschreibung. Sie kann auch verwendet werden, um bestimmte team\_ids anzugeben, die ein Segment anzeigen können, sodass Sie Segmente für bestimmte Werbetreibende kuratieren können.
| segment\_id | name | description | team\_ids |
| ----------------- | ------------------------------------- | -------------------------------------------------------------------------- | -------------------------------------------------------------------------------- |
| general-segment-1 | High Spending Shoppers | Käufer mit einem durchschnittlichen Wocheneinkauf in den obersten 15 %. | |
| general-segment-2 | Value Shoppers | Käufer mit einem höheren Warenkorbprozentsatz an preisbewussten Produkten. | |
| general-segment-3 | Recurring Shoppers | Käufer, die im Durchschnitt jede Woche einkaufen. | |
| custom-segment-1 | Custom: High Purchase Recency BrandCo | Kunden, die in den letzten 30 Tagen BrandCo gekauft haben. | \["a5166fc4-f874-4741-a721-c05ffd9941a5","92f4b91f-0089-4102-b13b-6015da8e0174"] |
Rufen Sie hier den Segment-Referenzleitfaden auf
### API-Synchronisationsintegration
Beim Synchronisieren von Kunden und Segmenten per API müssen ein oder zwei Vorgänge abgeschlossen werden.
1. Segmente erstellen
2. Optional: Segmentzugriff verwalten
#### Erstellen von Segmenten über die API
Da Sie die Kunden-Segment-Beziehung vor der Werbeanfrage verwalten, müssen Sie nur Segmente senden.
Sie müssen eine Segment-ID angeben, die in der Benutzeroberfläche angezeigt wird, einen Namen, eine Beschreibung sowie Ihr Händler-Team.
{% hint style="info" %}
Die Segmente-API verwendet die Bearer-Autorisierung der Partner-API. Sie müssen einen Bearer-Token generieren und verwenden. Weitere Informationen: [Authentifizierungsanfragen](https://help.citrusad.com/retail-media-interface/partner/de/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"
}
}
```
Rufen Sie die Referenz für den Endpunkt "Segment erstellen" auf [hier](https://help.citrusad.com/retail-media-interface/partner/de/audience-segment-api/segment/createsegment).
Bei der Synchronisierung von Segmenten über die API richtet sich diese `sourceId` nach der Werbeanfrage aus.
{% hint style="info" %}
Maximal 100 Segmente pro Werbeanfrage.
Wenn Sie mehr als 100 Segmente synchronisieren, wenden Sie sich bitte an Epsilon. Wenn Sie 100 Segmente pro Kunde überschreiten, kann bei Werbeanfragen das Segment-Pooling reduziert werden und Segmente in der Anfrage abgeschnitten werden.
Im Falle von Abschneidungen sehen Sie, wie das Feld `metadata.warnings`in der Werbeantwort erscheint und befüllt wird, wie unten dargestellt:
```
"metadata": {
"warnings": [
"Audience Segment IDs exceeded the limit of 100 and were truncated"
]
}
```
{% endhint %}
#### Optional: Segmentzugriff verwalten
Sie können die Funktion manage-access verwenden, um ausgewählten Werbetreibenden Zugriff auf das Segment zu gewähren, sodass Sie Segmente für bestimmte Werbetreibende kuratieren können.
```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"
]
}
```
Rufen Sie die Referenz für den Endpunkt "Zugriff auf ein bestimmtes Segment verwalten" auf [hier](https://help.citrusad.com/retail-media-interface/partner/de/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/de/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.