> 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/ko/feature-integrations/pagination.md). # 페이지네이션
여러 페이지를 탐색할 때 고객 경험을 개선하세요. 상품 광고를 생성할 때 다음을 수신하게 됩니다. `memoryToken` 이 토큰은 이전에 노출된 광고를 제외하기 위해 이후 요청에서 전송될 수 있습니다. {% hint style="warning" %} 상품 광고 전용! 이 기능은 현재 다음 영역에서만 지원됩니다: Epsilon Retail Media의 상품 광고. {% endhint %} ## 사이트에 페이지네이션을 구현하는 방법은 무엇인가요? 상품 광고를 생성할 때 응답으로 다음을 수신하게 됩니다. `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=" } ``` 고객이 다음 페이지로 이동할 때 다음 광고 요청에 이 토큰을 보내야 합니다. ```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 } ``` 이 토큰을 사용하면, Epsilon Retail Media **이 토큰 요청과 동일한 경우 고객에게 이전에 노출된 모든 광고를 제외합니다.sessionId**. {% hint style="warning" %} 표준 연동! 이 기능은 현재 다음 영역에서만 지원됩니다: Epsilon Retail Media의 상품 광고. {% endhint %} ## 어떻게 작동하나요? 다음 경우 Epsilon Retail Media 가 수신될 때 `memoryToken` 광고 요청에서 **에 대해 이전에 노출된 모든 광고는sessionId**가 광고 응답에서 제외됩니다. 이를 통해 다중 페이지 이동 시 고객에게 더 다양한 광고가 노출될 수 있습니다. 요청에 이 토큰이 존재하지 않는 경우 제외 사항을 적용하지 않고 현재 프로세스에 따라 광고가 생성됩니다. 리테일러가 활용할 수 있도록 광고 생성 후 토큰이 항상 제공됩니다. 메모리 토큰에는 인코딩된 정보가 포함되어 있어 다음과 같은 기능을 제공합니다. Epsilon Retail Media 가 이전(단일 요청 또는 연쇄 요청 기간 내)에 노출된 광고를 결정할 수 있도록 합니다. 다음으로 부적절한 토큰이 전송되는 경우 Epsilon Retail Media (다른 컨텍스트 등), 광고 요청에 토큰이 제공되지 않은 것처럼 광고가 반환됩니다. {% hint style="warning" %} ️ 웹사이트에 노출되는 것보다 더 많은 광고를 요청하시나요? 다음에서 더 많은 광고를 요청하는 리테일러인 경우 Epsilon Retail Media 고객에게 노출되는 광고보다 페이지 수가 적으면 이후 페이지에서 광고를 많이 수신하지 못할 수 있습니다. 15개의 광고를 요청하고 고객에게 4개만 노출하는 경우 수신 시 `memoryToken`, Epsilon Retail Media 는 이후 광고 응답에서 이전에 노출된 15-20개의 광고를 모두 제외합니다. {% endhint %} ### 요청 흐름 예시
## 자주 묻는 질문 **더 넓은 고객 여정에서 상품을 제외하기 위해 여러 고객 검색에 걸쳐 이 토큰을 사용할 수 있나요?** 아니요, 만약 Epsilon Retail Media 토큰의 광고 요청과 일치하지 않는 광고 요청을 수신하면 이를 무시하고 토큰이 제공되지 않은 것처럼 광고가 생성됩니다. **memoryToken을 보냈는데 형식이 잘못된 경우는 어떻게 되나요?** Epsilon Retail Media 는 토큰을 무시하고 일반 요청인 것처럼 요청을 처리합니다. **몇 페이지까지 페이지네이션을 수행할 수 있나요?** 기본값은 5페이지이며, 이는 성능과 포화도의 가장 이상적인 균형점입니다. Epsilon Retail Media 가 여러 고객사 사례에서 확인한 바 있습니다. 기준 Epsilon Retail Media의 39.0 릴리스부터는 Technical Account Manager를 통해 설정할 수 있습니다. **기본 설정의 5-10페이지와 같이 노출할 광고가 부족하면 어떻게 되나요?** memoryToken은 다음에 설정되어 있습니다. Epsilon Retail Media의 측면에서 설정 페이지 수만큼 광고를 저장합니다. 예를 들어 설정이 기본값인 5페이지인 경우, Epsilon Retail Media 는 7페이지부터 광고를 다시 노출하기 시작합니다. 페이지네이션 요청 6(페이지 6): memoryToken에 이전 5페이지의 광고 정보가 포함되어 있으므로 이전 5페이지의 광고는 노출되지 않습니다. 페이지네이션 요청 7(페이지 7): 1페이지의 광고를 노출할 수 있습니다. **기본 설정에서 5페이지가 되기 전에 광고가 떨어지면 어떻게 되나요?** 예를 들어 3페이지까지 광고가 모두 소진된 경우, 설정된 총 페이지 수를 다시 노출하지 않아야 할 이전에 노출된 광고로 저장하므로 7페이지부터 광고 노출을 시작합니다. --- # 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/ko/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.