> 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/cs/feature-integrations/pagination.md).

# Stránkování

<figure><img src="/files/KgthSO4hFd2qfBx2TK2d" alt="" width="100%"><figcaption></figcaption></figure>

Zlepšete zákaznickou zkušenost při procházení více stránek. Při generování produktových reklam obdržíte `memoryToken` který lze odeslat v následných požadavcích za účelem vyloučení dříve zobrazených reklam.

{% hint style="warning" %}
Pouze pro produktové reklamy!

Tato funkce je v současné době podporována pouze pro Epsilon Retail Mediaproduktové reklamy.
{% endhint %}

## Jak implementovat stránkování na vašem webu?

Při generování produktových reklam obdržíte v odpovědi `memoryToken`.

```http
{
    "ads": [
        {
            "id": "display_3rGiryPskhQusmsf43nghbQwnqo3NzMzNjU3",
            "gtin": "7733657",
            "discount": {
                "amount": 0,
                "minPrice": 0,
                "maxPerCustomer": 0
            },
            "expiry": "2021-05-12T04:17:50.400917769Z",
            "position": 1
        }
    ],
    "banners": [],
    "products": [],
    "memoryToken":"85ykKVv-luDHMWLZx2d6xcPq6sF7CgkJCSJDb3VudGVyIjogIjIiLAoJCQkiQWRzIjogWwoJCQkJImRpc3BsYXlfV05VV0NwQkRKMUpKNm5wdVZSVExvOU40TUxzNE1UWTBOemt5TWc9PSIsCgkJCQkiZGlzcGxheV9MME5NUHRxNmdCcVFvREJOd3J0dE9UTGJoWk0xTVRFeU9UYzRPUT09IiwKCQkJCSJkaXNwbGF5XzlCcEpmdUpaWk9VXzgyaWpFM3VCczgxd3VVczRNekkwTnpVeE5nPT0iLAoJCQkJImRpc3BsYXlfcW1VU1p4TkpMQ0lqeWQwdTFJRDk0RmxVZ0pnNE16STBOelV4Tnc9PSIsCgkJCQkiZGlzcGxheV9oeHlFZktCUnRrNWlxMThMQzE1SDJHcEN3QjgxTVRFeU9UYzVNQT09IiwKCQkJCSJkaXNwbGF5X1NkcjFEcU5aUEFtcGh0Q1FIUndoYUxFT1B0RXhNamsxT1RJNE5BPT0iLAoJCQkJImRpc3BsYXlfeVlSai1qV2Ntc2ozNzhrel9PMm0yOVlwTjhJeE5EazNPRE00TXc9PSIsCgkJCQkiZGlzcGxheV9Xbm9NZGZuLTRTVmhxcF9xQzVvLWxoT0paNm8xTkRJeE1UUTROdz09IgoJCQldLAoJCQkiVFRMIjogMTYyODk4NTYwMAoJCX0="
}
```

Když zákazník přechází na další stránku, měli byste tento token odeslat v dalším požadavku na reklamu.

```http
POST $BASE_URL/v1/ads/generate HTTP/1.1
accept: application/json
content-type: application/json
Authorization: Basic <API_KEY>
{
    "customerId": "wertg5432a",
    "sessionId": "ec9-4e07-881d-3e9",
    "placement": "search",
    "catalogId": "628dbe95-2ec9-4e07-881d-3e9f92ab2e0b",
    "searchTerm": "chocolate",
    "memoryToken":"85ykKVv-luDHMWLZx2d6xcPq6sF7CgkJCSJDb3VudGVyIjogIjIiLAoJCQkiQWRzIjogWwoJCQkJImRpc3BsYXlfV05VV0NwQkRKMUpKNm5wdVZSVExvOU40TUxzNE1UWTBOemt5TWc9PSIsCgkJCQkiZGlzcGxheV9MME5NUHRxNmdCcVFvREJOd3J0dE9UTGJoWk0xTVRFeU9UYzRPUT09IiwKCQkJCSJkaXNwbGF5XzlCcEpmdUpaWk9VXzgyaWpFM3VCczgxd3VVczRNekkwTnpVeE5nPT0iLAoJCQkJImRpc3BsYXlfcW1VU1p4TkpMQ0lqeWQwdTFJRDk0RmxVZ0pnNE16STBOelV4Tnc9PSIsCgkJCQkiZGlzcGxheV9oeHlFZktCUnRrNWlxMThMQzE1SDJHcEN3QjgxTVRFeU9UYzVNQT09IiwKCQkJCSJkaXNwbGF5X1NkcjFEcU5aUEFtcGh0Q1FIUndoYUxFT1B0RXhNamsxT1RJNE5BPT0iLAoJCQkJImRpc3BsYXlfeVlSai1qV2Ntc2ozNzhrel9PMm0yOVlwTjhJeE5EazNPRE00TXc9PSIsCgkJCQkiZGlzcGxheV9Xbm9NZGZuLTRTVmhxcF9xQzVvLWxoT0paNm8xTkRJeE1UUTROdz09IgoJCQldLAoJCQkiVFRMIjogMTYyODk4NTYwMAoJCX0=",
    "options": {
                         "filterMode": "AndOr"
                             },
    "maxNumberOfAds": 3
}

```

Pomocí tohoto tokenu Epsilon Retail Media vyloučí veškeré dříve zobrazené reklamy zákazníkovi, pokud jsou **sessionId** identické s požadavkem tokenu.

{% hint style="warning" %}
Standardní integrace!

Tato funkce je v současné době podporována pouze pro Epsilon Retail Mediaproduktové reklamy.
{% endhint %}

## Jak to funguje?

Když Epsilon Retail Media obdrží v požadavku na reklamu `memoryToken` veškeré dříve zobrazené reklamy pro **sessionId** budou z odpovědi na reklamu vyloučeny. Tím se zajistí širší rozmanitost reklam zobrazovaných zákazníkovi během cesty přes více stránek.

Pokud tento token v požadavku neexistuje, generování reklam proběhne podle aktuálního procesu bez použití jakýchkoli výjimek. Token bude po vygenerování reklamy vždy poskytnut, aby se maloobchodník mohl rozhodnout jej využít.

Paměťový token obsahuje zakódované informace, které umožňují Epsilon Retail Media určit reklamy, které byly dříve zobrazeny (buď v jediném požadavku, nebo během období více řetězených požadavků).

V případě odeslání irelevantního tokenu do Epsilon Retail Media (například s odlišným kontextem) jsou reklamy vráceny tak, jako by v požadavku na reklamu žádný token nebyl poskytnut.

{% hint style="warning" %}
️ Požadujete více reklam, než kolik je zobrazeno na vašem webu?

Pokud jste maloobchodník, který od Epsilon Retail Media požaduje více reklam, než kolik je zobrazeno zákazníkovi, nemusíte na následných stránkách obdržet mnoho reklam. Pokud požadujete 15 reklam a zákazníkovi zobrazíte pouze 4, při obdržení `memoryToken`, Epsilon Retail Media vyloučí v následné odpovědi na reklamu všech 15–20 dříve zobrazených reklam.
{% endhint %}

### Příklad toku požadavků

<figure><img src="/files/sgNAmUQf0J8O4jR1V5qG" alt="" width="100%"><figcaption></figcaption></figure>

## Často kladené otázky

**Mohu tento token použít napříč více vyhledáváními zákazníka k vyloučení produktů na delší cestě zákazníka?**

Ne, pokud Epsilon Retail Media obdrží požadavek na reklamu, který neodpovídá požadavku na reklamu tokenu, je ignorován a reklamy jsou vygenerovány tak, jako by nebyl poskytnut žádný token.

**Co když odešlu memoryToken a ten je neplatný?**

Epsilon Retail Media bude token ignorovat a zpracuje požadavek, jako by šlo o běžný požadavek.

**Pro kolik stránek mohu stránkovat?**

Výchozí hodnota je 5, což je nejlepší rovnováha mezi výkonem a saturací, kterou Epsilon Retail Media zaznamenala napříč více klienty.

Od verze Epsilon Retail Media39.0 to lze nakonfigurovat prostřednictvím vašeho Technical Account Managera.

**Co se stane, když dojdou reklamy k zobrazení, například na stránkách 5–10 při výchozí konfiguraci?**

memoryToken je nakonfigurován na straně Epsilon Retail Mediatak, aby ukládal reklamy z počtu stránek uvedeného v konfiguraci. Pokud je například konfigurace nastavena na výchozích 5 stránek, Epsilon Retail Media začne znovu zobrazovat reklamy od stránky 7.

Požadavek na stránkování 6 (stránka 6): memoryToken obsahuje informace o reklamách z předchozích 5 stránek, takže nebudou zobrazeny žádné reklamy z předchozích 5 stránek.

Požadavek na stránkování 7 (stránka 7): reklamy ze stránky 1 mohou být zobrazeny.

**Co se stane, když mi dojdou reklamy před stránkou 5 při výchozí konfiguraci?**

Pokud vám například do stránky 3 dojdou reklamy, začneme zobrazovat reklamy od stránky 7, protože celkový počet stránek v konfiguraci ukládáme jako dříve zobrazené reklamy, které by se neměly zobrazovat znovu.


---

# 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/cs/feature-integrations/pagination.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.