> 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-2-sync-customers-audience.md).
# Option 2: Kunden & Zielgruppe synchronisieren
### Übersicht
Händler mit Clean Rooms oder selbstverwalteten Zielgruppensegmenten können Kunden- und Segmentdaten synchronisieren, um eine gezielte Zielgruppenansprache für Top-Werbetreibende und allgemeine Zielgruppen zu ermöglichen. Bei dieser Integration stellt Ihr CDP Kunden-/Segmentinformationen bereit für Epsilon. Entweder per API oder Datei.
### Integrationsanforderungen
* Die Standard-Onsite-Integration muss die Kunden-ID über alle relevanten Touchpoints hinweg enthalten (sofern verfügbar).
* Kunden-ID-Feed von Kunden, per API oder Dateifeed.
* Segment-Feed per API oder Dateifeed.
### So funktioniert es
Die CDP- oder Zielgruppenplattform stellt Kunden- und Segmentdaten bereit für Epsilon mittels Datei-Upload oder API. In Werbeanfragen enthaltene Kunden-IDs werden mit Zielgruppensegmenten und zugehörigen Kampagnen abgeglichen. Dies ermöglicht ein präzises Targeting auf der Grundlage von benutzerdefinierten oder allgemeinen Zielgruppendefinitionen.
### Integrationsbeispiele
**Beispiel für eine Werbeanfrage**: Werbeanfrage mit Kunden-ID:
```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" %}
Ihre Werbeanfrage muss Folgendes enthalten: `customerId`, unabhängig davon, ob Sie über eine Datei oder eine API integrieren.
{% endhint %}
### Feed-Datei-Synchronisationsintegration (Empfohlen)
Beim Synchronisieren von Kunden und Segmenten per Datei benötigen wir zwei Dateien:
* Segmentdatei
* Kundendatei
#### 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 | Käufer mit hohen Ausgaben | Käufer mit einem durchschnittlichen Wöchentlicher Einkauf in den top 15 %. | |
| general-segment-2 | Schäppchenjäger | Käufer, deren Warenkorb einen höheren Prozentanteil an preiswerten Produkten aufweist. | |
| general-segment-3 | Wiederkehrende Käufer | Käufer, die im Durchschnitt jede Woche einkaufen. | |
| custom-segment-1 | Benutzerdefiniert: Hohe Kaufaktualität BrandCo | Kunden, die in den letzten 30 Tagen BrandCo gekauft haben. | \["a5166fc4-f874-4741-a721-c05ffd9941a5","92f4b91f-0089-4102-b13b-6015da8e0174"] |
Segment-Referenzhandbuch anzeigen [hier](/retail-media-interface/integration/de/references/audience-targeting-reference.md#segment-feed-required-when-syncing-your-own-segments).
#### Kundendatei
Ihre Kundendatei wird verwendet, um einen einzelnen Kunden zu erstellen und ihn mit Segmenten zu verknüpfen. Sie müssen nur Folgendes angeben: `customer_id` und `segment_ids`
| customer\_id | segments |
| ------------ | ------------------------------------------- |
| cust\_12345 | \["general-segment-3", "general-segment-4"] |
| cust\_67890 | \["general-segment-3"] |
Kunden-Referenzhandbuch anzeigen [hier](/retail-media-interface/integration/de/references/audience-targeting-reference.md#customer-feed-required-when-syncing-your-own-segments-and-customers).
{% hint style="info" %}
Maximal 100 Segmente pro Kunde.
Wenn Sie mehr als 100 Segmente für einen Kunden synchronisieren, wenden Sie sich bitte an Epsilon. Wenn Sie 100 Segmente pro Kunde überschreiten, kann dies bei Werbeanfragen zu einer reduzierten Segmentbündelung führen und Segmente in der Anfrage kürzen.
{% endhint %}
### API-Synchronisationsintegration
Beim Synchronisieren von Kunden und Segmenten per API müssen drei Vorgänge abgeschlossen werden.
1. Segmente erstellen
2. Optional: Segmentzugriff verwalten
3. Kunden erstellen
4. Verknüpfung von Kunden und Segmenten verwalten
#### Segmente über die API erstellen
Als Erstes sollten Sie Ihre Segmente erstellen, mit denen Kunden verknüpft werden können.
Sie müssen eine Segment-ID, die in der Benutzeroberfläche angezeigt wird, einen Namen, eine Beschreibung sowie Ihr Händler-Team angeben.
{% hint style="info" %}
Wichtig: Die Segmente-API verwendet die Bearer-Autorisierung der Partner-API. Sie müssen ein Bearer-Token generieren und verwenden. Mehr erfahren: [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"
}
}
```
Referenz für den Endpunkt "Segment erstellen" anzeigen [hier](https://help.citrusad.com/retail-media-interface/partner/de/audience-segment-api/segment/createsegment).
#### 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"
]
}
```
Referenz für den Endpunkt "Zugriff auf ein bestimmtes Segment verwalten" anzeigen [hier](https://help.citrusad.com/retail-media-interface/partner/de/audience-segment-api/segment/manageaccess).
#### Kunden über die API erstellen
{% hint style="info" %}
Die Kunden-API verwendet die von der Integrations-API genutzte Basis-Autorisierung.
{% 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"
}
}
]
}
```
Nach dem Abschluss müssen Sie auch Segmente erstellen, mit denen Kunden verknüpft werden können. Sie können bis zu 100 Kunden pro Anfrage erstellen.
Spezifikation für die API zum Erstellen oder Aktualisieren eines Kunden anzeigen [hier](/retail-media-interface/integration/de/integration/create-or-update-a-customer.md).
#### Kunden über die API mit Segmenten verknüpfen
Verwenden Sie nach dem Erstellen der Segmente die API /customers/manage-segments, um Kunden mit Segmenten zu verknüpfen
```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 in dieser Anfrage ist Ihre Händler-Team-ID.
{% endhint %}
Rufen Sie die Spezifikation für die API zur Verwaltung von Segmenten und Kunden hier ab.
---
# 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-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.