> 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/sv/data-api/audience-targeting-new/integration-option-2-sync-customers-audience.md).
# Alternativ 2: Synkronisera kunder och målgrupp
### Översikt
Återförsäljare med clean rooms eller självhanterade målgruppssegment kan synkronisera kund- och segmentdata för att möjliggöra leverans till anpassade målgrupper för toppannonsörer och generella målgrupper. Denna integration innebär att du använder din CDP för att tillhandahålla kund-/segmentinformation till Epsilon. Antingen via API eller fil.
### Integrationskrav
* Standardintegration på webbplatsen måste innehålla kund-ID över alla relevanta beröringspunkter (där det finns tillgängligt).
* Kund-ID-flöde av kunder, via API eller filflöde.
* Segmentflöde via API eller filflöde.
### Så fungerar det
CDP- eller målgruppsplattformen tillhandahåller kund- och segmentdata till Epsilon med hjälp av filuppladdning eller API. Kund-ID:n som ingår i annonsanrop matchas mot målgruppssegment och associerade kampanjer. Detta möjliggör exakt targeting baserat på anpassade eller generella målgruppsdefinitioner.
### Integrationsexempel
**Exempel på annonsanrop**: Annonsanrop som innehåller kund-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" %}
Ditt annonsanrop måste innehålla `customerId`, oavsett om du integrerar via fil eller API.
{% endhint %}
### Filflödessynkroniseringsintegration (rekommenderas)
När du synkroniserar kunder och segment per fil kräver vi två filer:
* Segmentfil
* Kundfil
#### Segmentfil
En segmentfil används för att tillhandahålla ett segment-ID som visas i användargränssnittet, ett namn och en beskrivning. Den kan också användas för att ange specifika team\_ids som kan visa ett segment, vilket gör att du kan kurera segment för specifika annonsörer.
| segment\_id | name | description | team\_ids |
| ----------------- | --------------------------------- | ----------------------------------------------------------------- | -------------------------------------------------------------------------------- |
| general-segment-1 | Kunder med höga utgifter | Kunder med ett genomsnittligt veckohandlande i de översta 15 %. | |
| general-segment-2 | Värdesökande kunder | Kunder som har en högre andel värdedrivna produkter i varukorgen. | |
| general-segment-3 | Återkommande kunder | Kunder som handlar i genomsnitt varje vecka. | |
| custom-segment-1 | Anpassad: Hög köpfrekvens BrandCo | Kunder som köpt BrandCo under de senaste 30 dagarna. | \["a5166fc4-f874-4741-a721-c05ffd9941a5","92f4b91f-0089-4102-b13b-6015da8e0174"] |
Visa referensguiden för segment [här](/retail-media-interface/integration/sv/references/audience-targeting-reference.md#segment-feed-required-when-syncing-your-own-segments).
#### Kundfil
Din kundfil används för att skapa en enskild kund och länka denne till segment, du behöver bara ange `customer_id` och `segment_ids`
| customer\_id | segments |
| ------------ | ------------------------------------------- |
| cust\_12345 | \["general-segment-3", "general-segment-4"] |
| cust\_67890 | \["general-segment-3"] |
Visa referensguiden för kunder [här](/retail-media-interface/integration/sv/references/audience-targeting-reference.md#customer-feed-required-when-syncing-your-own-segments-and-customers).
{% hint style="info" %}
Maximalt 100 segment per kund.
Om du synkroniserar mer än 100 segment för en kund, vänligen kontakta Epsilon. Om du överskrider 100 segment per kund kan annonsanrop få minskad segmentpoolning och trunkera segment i anropet.
{% endhint %}
### API-synkroniseringsintegration
När du synkroniserar kunder och segment via API finns det tre åtgärder som måste slutföras.
1. Skapa segment
2. Valfritt: hantera segmentåtkomst
3. Skapa kunder
4. Hantera koppling mellan kund och segment
#### Skapa segment via API
Det första du vill göra är att skapa dina segment som du kan länka kunder till.
Du måste ange ett segment-ID som visas i användargränssnittet, ett namn, en beskrivning samt ditt återförsäljarteam.
{% hint style="info" %}
Viktigt: Segment-API:et använder bearer-autentisering som används av Partner API. Du måste generera en bearer-token och använda den. Läs mer: [Autentiseringsanrop](https://help.citrusad.com/retail-media-interface/partner/sv/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"
}
}
```
Visa referensen för slutpunkten Skapa ett segment [här](https://help.citrusad.com/retail-media-interface/partner/sv/audience-segment-api/segment/createsegment).
#### Valfritt: hantera segmentåtkomst
Du kan använda funktionen manage-access för att ge valda annonsörer åtkomst att se segmentet, vilket gör att du kan kurera segment för specifika annonsörer.
```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"
]
}
```
Visa referensen för slutpunkten Hantera åtkomst till ett specifikt segment [här](https://help.citrusad.com/retail-media-interface/partner/sv/audience-segment-api/segment/manageaccess).
#### Skapa kunder via API
{% hint style="info" %}
Kund-API:et använder grundläggande auktorisering som används av Integration API.
{% 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"
}
}
]
}
```
När det är klart måste du också skapa segment att länka kunder till. Du kan skapa upp till 100 kunder per anrop.
Visa specifikationen för API:et för att Skapa eller uppdatera en kund [här](/retail-media-interface/integration/sv/integration/create-or-update-a-customer.md).
#### Länka kunder till segment via API
När du har skapat segmenten använder du API:et /customers/manage-segments för att länka kunder till segment
```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 i den här begäran är ditt återförsäljar-team-ID.
{% endhint %}
Visa specifikationen för API:et för att hantera segment och kunder här.
---
# 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/sv/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.