> 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/validation-troubleshooting.md).
# Validering och felsökning
## Testning och validering
### Checklista för validering före lansering
**Teknisk integration**
* [ ] API:`POST /ads/v3/brand-pages` returnerar 200 med `contentData`.
* [ ] Rendrering: Innehållsmoduler rendreras korrekt på din webbplats i rätt ordning.
* [ ] Tema: `theme` -fälten tillämpas korrekt; `null` -värden faller tillbaka på standardvärdena i återförsäljarens stilguide.
* [ ] Valfria fält: Rendrerings- och spårningslogik måste tåla utelämnade, null- eller tomma valfria modulfält, samt utelämnade spårningsnoder, utan fel (validera med hjälp av flera aktiva mallar, inte bara en enda demovarumärkessida).
* [ ] Styling: Varumärkessidan matchar din webbplats designsystem.
* [ ] Mobil: Varumärkessidan visas korrekt på mobila enheter.
* [ ] Cache-busting: `{TS}` -värdet ändras vid varje begäran.
**Validering av spårning**
* [ ] Exponeringspixel (C2S): Varje post i `trackingTemplates.client.impressionPixelUrls` fyrar av och returnerar 200 `image/gif`
* [ ] Exponeringsmeddelande (S2S): Sammansatt server-exponerings-URL; **GET** eller **POST** direkt till Epsilon spårningsvärden returnerar 204 No Content.
* [ ] Klickspårning (C2S): Antingen returnerar den sammansatta `client.clickRedirect` -URL-adressen 302 till rätt destination, eller så returnerar den sammansatta `client.clickEvent` 204 No Content (beroende på vilket alternativ ditt flöde använder - inte båda)
* [ ] Klickmeddelande (S2S): **GET** eller **POST** direkt till den sammansatta server-URL-adressen returnerar 204 No Content
* [ ] Lägg i varukorgen (C2S): Sammansatt `client.addToCartEvent` som avfyras som händelse-beacon returnerar 204 No Content
* [ ] Lägg i varukorgen (S2S): Sammansatt `server.addToCartEvent` som anropas direkt till spårningsvärden returnerar 204 No Content
**Infrastruktur och integritet**
* [ ] Reverse proxy: C2S-spårningsbegäranden vidarebefordras via din domän; S2S skickas inte via proxyn
* [ ] Rubriker: `RP-Host`, `X-Forwarded-For`, `X-Forwarded-Request-Path`, `Referer` finns på proxierade begäranden
* [ ] Integritet: Ingen PII finns i något parameter eller URL
* [ ] HTTPS: Alla begäranden använder säkra anslutningar
* [ ] Produktsidor: Sidor rendreras korrekt efter klickomdirigering
### Rekommenderade verktyg
* Webbläsarens utvecklarverktyg: Nätverksfliken för att inspektera pixelladdningar och omdirigeringar.
* Fiddler eller Charles Proxy: Inspektera beteendet för reverse proxy och vidarebefordran av rubriker.
### Felsökning
| Problem | Kontrollera |
| ----------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Pixlar kan inte läsas in | Verifiera DNS/SSL, bekräfta omskrivning av proxysökväg, kontrollera nåbarhet till Epsilon spårningsvärden. |
| Omdirigeringar vidarebefordras inte | Säkerställ att `{RURL}` är URL-kodad, verifiera att proxyn bevarar frågesträngen. |
| API returnerar inget innehåll | Verifiera att `catalogId` och `urlSlug` matchar en aktiv kampanj för varumärkessidan. |
| Spårning blockeras av annonsblockerare | Bekräfta att reverse proxy är konfigurerad - spårningen bör dirigeras via din domän. |
| Lägg i varukorgen spåras inte | Säkerställ att du avfyrar den sammansatta klient- eller server-URL-adressen för lägg i varukorgen efter varukorgshändelsen. |
| Sidan kraschar vid inläsning av vissa varumärkessidor | Behandlar sannolikt doc/example-fält som alltid obligatoriska. Logga rå modul-JSON, lägg till skydd för valfria nycklar och saknad spårning, samt bekräfta att mallen tillåter eller inaktiverar dessa fält. |
| Temafärger tillämpas inte korrekt | Kontrollera att `null` temafält faller tillbaka på standardvärdena i din stilguide, snarare än att rendreras som bokstavliga null-värden eller tomma strängar. |
## Ordlista
**Viktiga termer för integration av varumärkessidor**
| Term | Definition | Exempel |
| -------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------- |
| API-nyckel | Din autentiseringsuppgift för Epsilon tjänster | `Basic abc123xyz...` |
| Varumärkessida | En varumärkt landningssidesupplevelse på din webbplats | yoursite.com/brands/nike |
| C2S-spårning | Klient-till-server: Webbläsarbaserad spårning. Exponeringar använder 1x1-pixlar; klick använder en 302-omdirigering eller en händelse-beacon; lägg-i-varukorg använder en händelse-beacon. | `
, navigator.sendBeacon(clickEvent)` |
| S2S-spårning | Server-till-server: Backend-spårning (GET eller POST till de sammansatta spårnings-URL:erna) | Din server → Epsilon server |
| Innehållsmodul | Individuella innehållsblock (hero, text, produkter, osv.) | Hero-banner, produktrutnät |
| Modultaggar | Valfria strängetiketter på en modul (t.ex. `["header"]`) inställda i mallen. Används av återförsäljare för layoutdirigering, analys eller mappning till sina egna komponenter. Utesluts från svaret när den är tom. | `"tags": ["header"]` |
| Tema | Alltid närvarande vid framgång i API-svaret: nästlad `colors` (bakgrund + sju textroller) och `buttons` (`primary` / `secondary` med `background` och `text`). Alla temafärgfält krävs (hex6). Se [Temaobjekt](/retail-media-interface/integration/sv/brand-pages/brand-page-retailer-integration-guide/brand-page-apis.md#theme-object). | "theme": { "colors": { ... }, "buttons": { ... } } |
| Exponering | När en varumärkessida visas av en användare | Sidvisning = 1 exponering |
| Klick | När en användare klickar på innehåll på en varumärkessida | CTA-knappklick |
| Konvertering | När en användare lägger till en produkt i varukorgen från en varumärkessida | Lägg i varukorg-åtgärd |
| Omvänd proxy | Dirigerar spårning via din domän för att undvika annonsblockerare | `yoursite.com/epsilon/` → Epsilon |
| URL-slutdel | Varumärkesidentifieraren i URL-sökvägen | `nike` in `/brands/nike` |
| Katalog-ID | Din unika produktkatalogsidentifierare | Tillhandahålls av Epsilon |
| Makro | Svarsplatshållare (`{TS}`, `{RURL}`) in `tracking.params` som du ersätter vid körning; | `{TS} → 1737485823910` |
| IAB TCF | Interactive Advertising Bureau Transparency & Consent Framework | Standard för efterlevnad av GDPR |
| PII | Personligt identifierbar information (skicka aldrig detta!) | E-post, telefon, riktigt namn |
| Cache-busting | Tillägg av tidsstämplar för att förhindra cachade svar | `?ts=1737485823910` |
### Tekniska akronymer
| Akronym | Fullständig term | Vad det betyder |
| ------- | ------------------------------- | ---------------------------------- |
| RMN | Retail Media Nätverk | Epsilons annonsplattform |
| CTA | Uppmaning till handling (CTA) | Klickbara knappar/länkar |
| JSON | JavaScript Object Notation | Dataformat för API-begäranden/svar |
| HTTPS | HTTP Secure | Krypterat webbprotokoll |
| GDPR | Allmänna dataskyddsförordningen | EU:s integritetslagstiftning |
| TLS | Transport Layer Security | Krypteringsprotokoll |
| DNS | Domain Name System | Internetadressystem |
| SSL | Secure Sockets Layer | Krypteringsprotokoll |
| RFC | Request for Comments | Dokument för tekniska standarder |
---
# 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/validation-troubleshooting.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.