> 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/brand-pages/brand-page-retailer-integration-guide/overview-1.md).

# Översikt

## Vad är varumärkessidor?

Varumärkessidor är anpassade målsidesupplevelser som finns på din webbplats och visar upp specifikt varumärkesinnehåll. De värdhanteras på din domän och återges med hjälp av dina UI-komponenter.

Varumärkessidor hanteras separat från vanliga annonskampanjer i Epsilon plattformen.\
Även om de använder ett liknande arbetsflöde för skapande och granskning representerar de varumärkesprofilerade målsidesupplevelser på en återförsäljares webbplats, inte traditionella annonser.

**Exempel:** En användare besöker `yoursite.com/brands/nike` och ser en Nike-märktsida med Nike-produkter, men den ser ut och känns som en del av din webbplats.

## Vad du kommer att bygga

Som återförsäljartekniker kommer du att:

* Lägga till en rutt för URL:er för varumärkessidor (till exempel, `/brands/{slug}`).

{% hint style="info" %}
Återförsäljare behöver inte tillhandahålla en URL för varje varumärkessida. URL:er hanteras automatiskt av plattformen.

Bas-URL:en för varumärkessidan (inklusive prefixet) måste dock konfigureras under onboarding (till exempel i återförsäljarens stilguide). Om den fullständiga URL:en eller prefixet inte anges kommer URL:en för varumärkessidan inte att fyllas i på inställningssidan.
{% endhint %}

* Anropa Brand Pages API med den extraherade sluggen.
* Återge de returnerade innehållsmodulerna.
* Implementera spårning av visningar, klick och lägg‑i‑varukorg.
* Konfigurera en omvänd proxy för förstpartsspårning.

{% hint style="info" %}
Detta steg krävs endast för spårning på klientsidan.
{% endhint %}

### Dina ansvarsområden jämfört med Epsilon's

| Du hanterar                                | Epsilon Tillhandahåller                   |
| ------------------------------------------ | ----------------------------------------- |
| ✅ API-integration för att hämta innehåll   | ✅ Innehåll och mallar för varumärkessidor |
| ✅ Återgivning av innehåll på din webbplats | ✅ Spårningsinfrastruktur                  |
| ✅ Konfiguration av omvänd proxy            | ✅ Analys och rapportering                 |
| ✅ Tillhandahållande av din stilguide       | ✅ Verktyg för kampanjhantering            |
| ✅ Testning och validering                  | ✅ Teknisk support                         |

## Hur varumärkessidor fungerar

### End-to-end-flöde

{% hint style="info" %}
Innehåll för varumärkessidor konfigureras och förhandsgranskas i Epsilon användargränssnittet. Återförsäljare integrerar varumärkessidor exklusivt via API:er och ansvarar för att återge den slutliga upplevelsen på sina webbplatser.
{% endhint %}

Under granskningsprocessen kan återförsäljare förhandsgranska det konfigurerade innehållet för varumärkessidan före godkännande.

### Mallar & moduler

Under onboarding, Epsilon arbetar med ditt team för att skapa mallar som definierar:

* De tillgängliga innehållsmodulerna (som hero, produktrutnät, text och bilder), med modulnamn som kan konfigureras i användargränssnittet för att anpassas till din återförsäljartaxonomi.
* Begränsningarna för varje modul (teckengränser, bilddimensioner osv.).
* Stil som är i linje med dina varumärkesriktlinjer.

Varumärken väljer en mall när de skapar sin kampanj och fyller sedan i innehållet inom dessa begränsningar.

{% hint style="info" %}
Brand Pages API returnerar innehållsmoduler och spårnings-URL:er. Återförsäljare ansvarar för att tillämpa stil med hjälp av sina egna UI-komponenter och sitt designsystem.
{% endhint %}

**Exempel**

Följande exempel illustrerar hur varumärken kan fylla i vanliga innehållsmoduler när de skapar en varumärkessida. Dessa är endast exempel på indata och kan justeras baserat på den valda mallen och kampanjmålen.

**HERO-modul**

* **Rubrik:** Upptäck den senaste sommarkollektionen
* **Underrubrik:** Fräscha stilar för varje tillfälle
* **CTA:** Handla nu

**TEXT-modul**

Utforska våra senaste nyheter designade för komfort, stil och prestanda - perfekta för vardagsbruk.

**BILD-modul**

* Bildtext:\*\* Nya nyheter tillgängliga nu
* **Alt-text:** Modell i sommarkollektionen
* URL: <https://example-cdn.com/summer-collection.jpg>

**PRODUCT\_GRID-modul**

Använd ett produktrutnät för att visa upp storsäljande eller säsongsbetonade produkter och driva engagemang och konverteringar.

#### Modulkonfiguration:

| Modul          | Beskrivning                                  | Konfigurerbara element (sammanfattning)                  |
| -------------- | -------------------------------------------- | -------------------------------------------------------- |
| HERO           | Banners i fullbredd med bild, rubrik och CTA | Rubrik, underrubrik, CTA, bild, överlägg                 |
| PRODUCT\_GRID  | Rutnät eller karusell med produkter          | Produkter, sektionstitel, beskrivning, CTA               |
| TEXT           | Textinnehållsblock (rubrik, brödtext)        | Textfält, CTA                                            |
| IMAGE          | Enskild bild med valfri länk                 | Bild, bildtext, alt-text, valfri länk                    |
| IMAGE\_GALLERY | Flera bilder i rutnätslayout                 | Bilder, bildtexter, alt-text, sektionstitel, beskrivning |
| FILTER\_MENU   | Horisontella filterflikar för produktnät     | Filteretiketter och sortering                            |
| SPLIT\_LAYOUT  | Flerkolumnslayout med nästlade moduler       | Layoutstruktur och nästlade moduler                      |

{% hint style="info" %}
Varje konfigurerbart element kan ställas in som obligatoriskt, valfritt (tillåtet) eller inaktiverat, beroende på modulen och återförsäljarens krav.

Vissa fält kan också tillämpa maximala teckengränser när de markerats som obligatoriska eller tillåtna.
{% endhint %}

### Moduletiketter

Mallar kan innehålla ett valfritt `tags` fält på varje modul – en lista med korta strängetiketter (t.ex. `["header"]`) som din integration kan använda för layoutbeslut, analys eller mappning av moduler till dina egna komponenter.

#### Hur taggar fungerar i API-svaret

* När en modul har taggar visas de som en `tags` array på motsvarande objekt i `contentData`.
* När en modul inte har några taggar utelämnas `tags` egenskapen helt från svaret - den kommer inte att visas som `"tags": []`.
* Behandla ett saknat `tags` fält på samma sätt som "inga taggar" - kasta inte ett fel om det saknas.
* Taggar stöds också på nästlade moduler inom `SPLIT_LAYOUT` – inte bara på rot-split-modulen.

{% hint style="info" %}
Viktigt

Taggar är opaka etiketter som överenskommits mellan återförsäljaren och deras integrationsteam. De är inte relaterade till spårningstaggar för annonser eller något annat system – referera alltid till dessa som *"moduletiketter"* eller *"moduletiketter för varumärkessida"* för att undvika förvirring.
{% endhint %}

Exempelsvarsmodul med en tagg

```json
{
  "id": "image-1",
  "contentType": "IMAGE",
  "order": 1,
  "tags": ["header"],
  "imageUrl": "https://example.com/images/banner.jpg"
}
```

**Exempelsvarsmodul utan tagg (egenskapen tags utelämnad):**

```json
{
  "id": "image-2",
  "contentType": "IMAGE",
  "order": 2,
  "imageUrl": "https://example.com/images/promo.jpg"
}
```

#### Vad detta innebär för API-svaret

Svaret `POST /ads/v3/brand-pages` speglar samma regler: en modultyp visas endast i `contentData` när den ingår i den aktiva mallen och varumärkessidan har konfigurerat innehåll för den modulen.

Fält inuti en modul kan saknas i JSON-koden, `null`eller vara tomma när mallen markerar dem som valfria eller inaktiverade, eller när varumärket lämnar dem inställda - detta är förväntat och indikerar inte en defekt datalast.

Implementera rendering med valfria typer och säkra åtkomstmetoder - till exempel, rendera endast ett CTA-block när `ctaText` och ett navigeringsmål finns; dölj hero-media när `mediaUrl`saknas.

`trackers`på sidnivå eller på en nod kan utelämnas när det inte finns någon spårbar interaktion. Skapa endast URL:er när du har både en tillämpbar mallnyckel från `trackingTypes` och motsvarande `trackers.`\<slot>`.params`, när det tillhandahålls av API:et.


---

# 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/brand-pages/brand-page-retailer-integration-guide/overview-1.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.