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

# Pagination

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

Améliorez votre expérience client lors de la navigation sur plusieurs pages. Lors de la génération d'annonces de produits, vous recevrez un `memoryToken` qui peut être envoyé dans les demandes ultérieures pour exclure les annonces précédemment diffusées.

{% hint style="warning" %}
Annonces de produits uniquement !

Cette fonctionnalité n'est actuellement prise en charge que pour Epsilon Retail Mediales annonces de produits de.
{% endhint %}

## Comment mettre en œuvre la pagination sur votre site ?

Lors de la génération d'annonces de produits, vous recevrez dans la réponse un `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="
}
```

Lorsqu'un client navigue vers la page suivante, vous devez envoyer ce jeton dans votre prochaine demande d'annonce.

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

```

En utilisant ce jeton, Epsilon Retail Media exclura toutes les annonces précédemment diffusées au client si les **sessionId** sont identiques à la demande du jeton.

{% hint style="warning" %}
Intégration standard !

Cette fonctionnalité n'est actuellement prise en charge que pour Epsilon Retail Mediales annonces de produits de.
{% endhint %}

## Comment cela fonctionne-t-il ?

Lorsque Epsilon Retail Media reçoit un `memoryToken` dans la demande d'annonce, toutes les annonces précédemment diffusées pour les **sessionId** seront exclues de la réponse d'annonce. Cela garantit une plus grande variété d'annonces diffusées à votre client lors d'un parcours sur plusieurs pages.

Lorsque ce jeton n'existe pas dans la demande, la génération d'annonces se fera selon le processus actuel sans aucune exclusion appliquée. Un jeton sera toujours fourni après la génération d'annonces pour qu'un détaillant puisse choisir de l'utiliser.

Le jeton mémoire contient des informations codées qui permettent à Epsilon Retail Media de déterminer les annonces qui ont été diffusées précédemment (soit dans une seule demande, soit sur une période de plusieurs demandes enchaînées).

Dans le cas où un jeton non pertinent est envoyé à Epsilon Retail Media (comme un contexte différent), les annonces sont renvoyées comme si aucun jeton n'avait été fourni dans la demande d'annonce.

{% hint style="warning" %}
️ Demandez-vous plus d'annonces que celles diffusées sur votre site web ?

Si vous êtes un détaillant qui demande plus d'annonces à Epsilon Retail Media que ce qui est diffusé à votre client, vous ne recevrez peut-être pas beaucoup d'annonces sur les pages suivantes. Si vous demandez 15 annonces et n'en diffusez que 4 à votre client, lors de la réception du `memoryToken`, Epsilon Retail Media exclura toutes les 15 à 20 annonces précédemment diffusées pour vous dans la réponse d'annonce ultérieure.
{% endhint %}

### Exemple de flux de demande

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

## Foire aux questions

**Puis-je utiliser ce jeton sur plusieurs recherches de clients pour exclure des produits sur le parcours client plus large ?**

Non, si Epsilon Retail Media reçoit une demande d'annonce qui ne correspond pas à la demande d'annonce du jeton, elle est ignorée et les annonces sont générées comme s'il n'y avait pas de jeton fourni.

**Que se passe-t-il si j'envoie un memoryToken et qu'il est mal formé ?**

Epsilon Retail Media ignorera le jeton et traitera la demande comme s'il s'agissait d'une demande normale.

**Pour combien de pages puis-je faire une pagination ?**

Par défaut, la limite est de 5 pages, ce qui constitue le meilleur équilibre entre performance et saturation que Epsilon Retail Media a constaté chez plusieurs clients.

À compter de Epsilon Retail Mediala version 39.0, cela peut être configuré via votre Technical Account Manager.

**Que se passe-t-il lorsque vous n'avez plus d'annonces à diffuser, comme sur les pages 5 à 10 de la configuration par défaut ?**

Le memoryToken est configuré du côté de Epsilon Retail Mediapour stocker les annonces du nombre de pages défini dans la configuration. Par exemple, si la configuration par défaut est de 5 pages, Epsilon Retail Media recommencera à diffuser des annonces à partir de la page 7.

Demande de pagination 6 (page 6) : le memoryToken contient des informations sur les annonces des 5 pages précédentes, par conséquent aucune annonce des 5 pages précédentes ne sera diffusée.

Demande de pagination 7 (page 7) : les annonces de la page 1 sont éligibles pour être diffusées.

**Que se passe-t-il si je n'ai plus d'annonces avant la page 5 sur la configuration par défaut ?**

Si par exemple, à la page 3 vous n'avez plus d'annonces, nous commencerons à diffuser des annonces à partir de la page 7, car nous stockons le nombre total de pages de la configuration comme étant les annonces précédemment diffusées qui ne doivent plus l'être.


---

# 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/fr/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.
