> 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/feature-integrations/category-cross-sell/integration-requirements.md).

# Integrationskrav

## Övergripande översikt

Som en del av denna integration behöver du göra följande

1. Implementera en ytterligare annonsbegäran för korsförsäljningskategoriplaceringen.
   1. Detta inkluderar arbetet med att placera och rendera annonser på din webbplats, samt rapportera klick och visningar
   2. Beställningar behöver tillhandahållas till Epsilon Retail Media som en del av din standardintegration
2. Om du synkroniserar kategori-ID:n med Epsilon Retail Mediabehöver du använda [filterMapping](/retail-media-interface/integration/sv/citrus-filter-mapping-api/filtermapping.md) API för att tillhandahålla läsbara värden för kategorivalet i användargränssnittet
   1. Detta gäller endast om du är integrerad med kategori-ID:n i stället för namn. (till exempel när du begär annonser är dina filter `category:123j-dsef-er` i stället för `category:Milk`
3. (Rekommenderas) – synkronisera korsförsäljningsmappingar för kategorier för att automatisera godkännande och minska belastningen på kampanjhanteringen.

## Annonsbegäran och webbplatsintegration

### Annonsbegäran

Eftersom korsförsäljning av kategorier kräver en fristående placering måste du integrera en ytterligare annonsbegäran per annonstyp som du integrerar korsförsäljning av kategorier för.

Formatet på din begäran bör matcha annonsbegäran för korsförsäljningskategori som listas nedan

* [Produktannons - begär annonser för korsförsäljning av kategorier](/retail-media-interface/integration/sv/generating-ads/product-ads/requesting-product-ads-1.md#cross-sell-category-placements)
* [Bannerannons - begär annonser för korsförsäljning av kategorier](/retail-media-interface/integration/sv/generating-ads/banner-ads-static/requesting-banner-ads.md#cross-sell-category-placements)
* Banner X – begär annonser för korsförsäljning av kategorier

### Rapportera visningar och klick

När du har integrerat din annonsbegäran måste du också se till att du rapporterar klick och visningar korrekt för varje annons som visas. Se till att läsa [Rapportera visningar & klick](/retail-media-interface/integration/sv/data-api/api-overview/reporting-impressions-clicks.md).

### Rapportera beställningar

Generellt rapporterar de flesta integrationer all beställningsinformation till Epsilon Retail Media enligt en standardintegration. Du måste se till att du rapporterar alla beställningar korrekt till Epsilon Retail Media enligt [Beställningsdata](/retail-media-interface/integration/sv/data-api/order-data-1.md).

## Filtermappingar

Slutpunkten för filtermapping kan användas för att mappa dina kategori-ID:n till läsbara värden. Detta krävs om du synkroniserar kategori-ID:n eftersom användargränssnittet visar värdena för dina användare.

{% hint style="info" %}
Om du synkroniserar läsbara kategorier i din produktkatalog med Epsilon Retail Mediakommer detta steg inte att krävas.
{% endhint %}

Användare kommer inte att förstå vad `category:12345-abcde` är. filterMapping API kan användas för att mappa värdet till det relevanta kategorinamnet på din webbplats, till exempel `category:Pantry`.

Det finns ingen filbaserad metod för att synkronisera denna information, det måste göras via [filterMapping](/retail-media-interface/integration/sv/citrus-filter-mapping-api/filtermapping.md) API.

{% hint style="warning" %}
När du skapar ytterligare kategorier på din webbplats måste du se till att filterMapping API används för att uppdatera kategorier.
{% endhint %}

## Korsförsäljningsmappingar för kategorier (rekommenderas)

Det rekommenderas starkt när du integrerar denna typ av placering att tillhandahålla en mapping av vilka kategorier som tillåts rikta sig mot varandra. Detta kan effektivisera din verksamhet efter det inledande integrationsarbetet. Annonsörens upplevelse effektiviseras till att endast tillåta kategorier som redan är tillåtna att väljas.

Dessutom är det också möjligt att konfigurera automatiskt godkännande för kampanjer med korsförsäljningskategorier när korsförsäljningsmappingar tillhandahålls.

### Integrationsmetoder

* Du kan använda [crossSellCategory](/retail-media-interface/integration/sv/crosssellcategory-api/crosssellcategory.md) API för att skapa och hantera mappingar efter behov.
* Alternativt kan du tillhandahålla en TSV-fil till en GCS-bucket som värdhanteras av Epsilon Retail Media med formatet som listas nedan.

#### API-integration

All nödvändig information kan ses i [crossSellCategory](/retail-media-interface/integration/sv/crosssellcategory-api/crosssellcategory.md) API-referens.

#### Filintegration

Vid integration via fil kräver Epsilon Retail Media en fil per katalog över vilka kategorier som tillåts rikta sig mellan varandra.

Varje rad i filen representerar en enskild mapping av en kategori och den kategori som den kan rikta sig mot. Varje mapping är enkelriktad (om du synkroniserar choklad -> mjölk kan chokladprodukter visas i kategorin mjölk. Om mjölkprodukter ska kunna visas på choklad krävs en ytterligare rad).

Vi behöver ett dataflöde i TSV-format som överensstämmer med nedanstående specifikationer:

| kolumnnamn          | Krävs | Datatyp | Beskrivning                                                                                                           | Exempel            |
| ------------------- | ----- | ------- | --------------------------------------------------------------------------------------------------------------------- | ------------------ |
| `category`          | Krävs | Text    | Detta är ett unikt kategori-ID som identifierar kategorin för den annonserade produkten.                              | `category:cookies` |
| `cross_category_id` | Krävs | Text    | Detta är ett unikt kategori-ID som identifierar en behörig kategori som produkter i category\_id kan korssäljas till. | `category:milk`    |

Ytterligare filspecifikationer finns nedan:

* Endast TSV-filer stöds
* TSV ska vara i LF inte CRLF
* TSV ska vara UTF-8-kodad, alla typer kommer att göra att flödet misslyckas
* Namnkonvention krävs: `^cross_sell_category.*.tsv$`

Ett exempelutdrag ser ut som nedan:

| category         | cross\_category\_id |
| ---------------- | ------------------- |
| category:cookies | kategori:mjölk      |
| category:cookies | kategori:choklad    |
| kategori:mjölk   | category:cookies    |

Det här avsnittet ovan gör det möjligt för kategorin **kakor** att korssälja till kategorierna **mjölk** och **choklad**. Kategorin **mjölk** kan korssälja till kategorin **kakor**. Kategorin **choklad** kan målinriktas, men kan inte målinrikta sig mot några andra kategorier.

{% hint style="danger" %}
️ Varje rad är en unik mappningskombination

Du måste synkronisera unika rader för varje unik mappning av korssäljningskategorier. Om du försöker synkronisera flera cross\_category\_id i en enda rad kommer filinläsningen att misslyckas.
{% endhint %}

{% hint style="warning" %}
Kolumnordning

Se till att din fil har `category` kolumnen som första kolumn. Om du synkroniserar `cross_category_id` som första kolumn kommer inläsningen att misslyckas.
{% endhint %}

## Process för aktivering av funktioner

När du är redo att börja synkronisera ditt flöde med förslagna söktermer, Epsilon Retail Media konfigurerar en GCS-bucket där du kan släppa dina filer.

Denna funktion stöds endast på GCS-buckets. Externa buckets som AWS/Azure/andra stöds inte.

Din Technical Account Manager kommer att kunna vägleda dig genom aktiveringen av denna funktion. Eftersom Epsilon Retail Medias plattformsdriftteam måste utföra en konfiguration, vänligen observera att det finns en ytterligare handläggningstid för aktivering.


---

# 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/feature-integrations/category-cross-sell/integration-requirements.md?ask=<question>&goal=<endgoal>
```

`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.