> 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-3-sync-audiences-only.md).
# Alternativ 3: Synkronisera endast målgrupper
### Översikt
För organisationer som inte kan dela kundidentifierare kan målgruppsaktivering uppnås genom att synkronisera segmentflöden och skicka segment-ID:n i annonsanrop. Detta integritetsfokuserade tillvägagångssätt möjliggör både anpassad och allmän målgruppsanpassning utan att exponera data på kundnivå. Annonsanrop måste innehålla segmentidentifierare för att stödja riktad aktivering.
### Krav för integration
* Segmentflödet måste ange vilka segment som är tillgängliga för angivna annonsörsteam.
* Annonsanrop måste innehålla relevanta segment-ID:n för varje kund.
### Hur det fungerar
CDP:n eller målgruppsplattformen tillhandahåller Epsilon med ett segmentflöde via filuppladdning eller API. Segment-ID:n som ingår i annonsanrop används för att matcha målgrupper med kampanjer. Mappningen mellan kunder och segment upprätthålls internt i återförsäljarens backend-system.
### Integrationsexempel
**Exempel på annonsanrop**: Annonsanrop som innehåller segment-ID:n:
```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" %}
Synkroniserar du segment från flera källor?
Om du gör det måste du också ange `sourceId` i segmentobjektet. Detta värde avtalas mellan dig och Epsilon för att referera till segmentets källa. Ett exempel kan vara `customer-cdp-1`.
Om du bara synkroniserar från en källa/CDP behöver du bara skicka `segmentIds` i `segment` -matrisen.
{% endhint %}
### Synkroniseringsintegration via flödesfil (rekommenderas)
När du synkroniserar segment kräver vi bara en fil.
#### 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 anpassa segment för specifika annonsörer.
| segment\_id | name | description | team\_ids |
| ----------------- | -------------------------------------------------- | ------------------------------------------------------------------- | -------------------------------------------------------------------------------- |
| general-segment-1 | Storköpare | Kunder med ett genomsnittligt veckohandlande i de översta 15 %. | |
| general-segment-2 | Prismedvetna kunder | Kunder som har en högre varukorgsandelsprocent av lågprisprodukter. | |
| general-segment-3 | Återkommande kunder | Kunder som handlar varje vecka i genomsnitt. | |
| custom-segment-1 | Anpassat: BrandCo-kunder med nyligen genomfört köp | 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
### API-synkroniseringsintegration
När du synkroniserar kunder och segment via API finns det en eller två åtgärder som behöver slutföras.
1. Skapa segment
2. Valfritt: hantera segmentåtkomst
#### Skapa segment via API
Eftersom du hanterar relationen mellan kund och segment före annonsanropet behöver du bara skicka segment.
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" %}
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).
Vid synkronisering av segment via API. Detta `sourceId` stämmer överens med annonsanropet.
{% hint style="info" %}
Maximalt 100 segment per annonsanrop.
Om du synkroniserar mer än 100 segment, vänligen kontakta Epsilon. Om du överskrider 100 segment per kund kan annonsanrop få minskad segmentpoolning och avkorta segment i anropet.
I händelse av avkortningar kommer du att se att fältet `metadata.warnings`i annonssvaret visas och fylls i, enligt nedan:
```
"metadata": {
"warnings": [
"Audience Segment IDs exceeded the limit of 100 and were truncated"
]
}
```
{% endhint %}
#### Valfritt: hantera segmentåtkomst
Du kan använda funktionen manage-access för att ge utvalda annonsörer åtkomst att se segmentet, vilket gör att du kan anpassa 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).
---
# 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-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.