> 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/de/feature-integrations/pagination.md). # Paginierung
Verbessern Sie Ihr Kundenerlebnis beim Durchsuchen mehrerer Seiten. Bei der Generierung von Produkt-Anzeigen erhalten Sie ein `memoryToken` , das in nachfolgenden Anfragen gesendet werden kann, um zuvor ausgelieferte Anzeigen auszuschließen. {% hint style="warning" %} Nur Produkt-Anzeigen! Diese Funktion wird derzeit nur für Epsilon Retail Medias Produkt-Anzeigen unterstützt. {% endhint %} ## So implementieren Sie die Paginierung auf Ihrer Website Bei der Generierung von Produkt-Anzeigen erhalten Sie in der Antwort ein `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=" } ``` Wenn ein Kunde zur nächsten Seite navigiert, sollten Sie dieses Token in Ihrer nächsten Anzeigenanfrage senden. ```http POST $BASE_URL/v1/ads/generate HTTP/1.1 accept: application/json content-type: application/json Authorization: Basic { "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 } ``` Verwendung dieses Tokens, Epsilon Retail Media schließt alle zuvor an den Kunden ausgelieferten Anzeigen aus, wenn die **sessionId** identisch mit der Anfrage des Tokens sind. {% hint style="warning" %} Standard-Integration! Diese Funktion wird derzeit nur für Epsilon Retail Medias Produkt-Anzeigen unterstützt. {% endhint %} ## Wie funktioniert es? Wenn Epsilon Retail Media ein `memoryToken` in der Anzeigenanfrage erhält, werden alle zuvor ausgelieferten Anzeigen für die **sessionId** aus der Anzeigenantwort ausgeschlossen. Dies gewährleistet eine größere Vielfalt an Anzeigen, die Ihrem Kunden auf einer mehrseitigen Reise zurückgegeben werden. Wenn dieses Token in der Anfrage nicht vorhanden ist, erfolgt die Anzeigengenerierung gemäß dem aktuellen Prozess ohne angewendete Ausschlüsse. Nach der Anzeigengenerierung wird immer ein Token bereitgestellt, dessen Nutzung der Händler aktivieren kann. Das Speicher-Token enthält codierte Informationen, die es Epsilon Retail Media ermöglichen, die zuvor ausgelieferten Anzeigen zu bestimmen (entweder in einer einzelnen Anfrage oder über einen Zeitraum mehrerer verketteter Anfragen). Falls ein irrelevantes Token an Epsilon Retail Media gesendet wird (z. B. ein anderer Kontext), werden Anzeigen so zurückgegeben, als ob kein Token in der Anzeigenanfrage bereitgestellt wurde. {% hint style="warning" %} ️ Fordern Sie mehr Anzeigen an, als auf Ihrer Website ausgeliefert werden? Wenn Sie ein Händler sind, der mehr Anzeigen von Epsilon Retail Media anfordert, als an Ihren Kunden ausgeliefert werden, erhalten Sie auf nachfolgenden Seiten möglicherweise nicht viele Anzeigen. Wenn Sie 15 Anzeigen anfordern und nur 4 an Ihren Kunden ausliefern, wird bei Erhalt des `memoryToken`, Epsilon Retail Media alle 15-20 zuvor an Sie ausgelieferten Anzeigen in der nachfolgenden Anzeigenantwort ausschließen. {% endhint %} ### Beispiel für den Anfrageablauf
## Häufig gestellte Fragen **Kann ich dieses Token über mehrere Kunden-Suchanfragen hinweg verwenden, um Produkte auf der größeren Kundenreise auszuschließen?** Nein, wenn Epsilon Retail Media eine Anzeigenanfrage erhält, die nicht mit der Anzeigenanfrage des Tokens übereinstimmt, wird sie ignoriert und die Anzeigen werden so generiert, als ob kein Token bereitgestellt wurde. **Was passiert, wenn ich ein memoryToken sende und es fehlerhaft ist?** Epsilon Retail Media wird das Token ignorieren und die Anfrage so verarbeiten, als wäre es eine normale Anfrage. **Für wie viele Seiten kann ich paginieren?** Standardmäßig sind dies 5, was das beste Verhältnis von Leistung und Sättigung darstellt, das Epsilon Retail Media über mehrere Kunden hinweg gesehen hat. Seit Epsilon Retail Medias Release 39.0 kann dies über Ihren Technical Account Manager konfiguriert werden. **Was passiert, wenn keine Anzeigen mehr ausgeliefert werden können, wie z. B. auf Seite 5-10 in der Standardkonfiguration?** Das memoryToken ist auf der Seite von Epsilon Retail Mediaso konfiguriert, dass Anzeigen aus der Anzahl der Seiten in der Konfiguration gespeichert werden. Wenn die Konfiguration beispielsweise dem Standard von 5 Seiten entspricht, Epsilon Retail Media wird ab Seite 7 wieder Anzeigen ausliefern. Paginierungsanfrage 6 (Seite 6): Das memoryToken enthält Informationen zu den Anzeigen der vorherigen 5 Seiten, daher werden keine Anzeigen der vorherigen 5 Seiten ausgeliefert. Paginierungsanfrage 7 (Seite 7): Die Anzeigen von Seite 1 können ausgeliefert werden. **Was passiert, wenn mir vor Seite 5 in der Standardkonfiguration die Anzeigen ausgehen?** Wenn Ihnen beispielsweise bis Seite 3 die Anzeigen ausgehen, beginnen wir ab Seite 7 mit der Auslieferung von Anzeigen, da wir die Gesamtzahl der Seiten in der Konfiguration als die zuvor ausgelieferten Anzeigen speichern, die nicht erneut ausgeliefert werden sollten. --- # 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/de/feature-integrations/pagination.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.