> 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/ja/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" %} ️ Webサイトに配信されるよりも多くの広告をリクエストしていますか？ 以下からリクエストする広告数が、 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以降、テクニカルアカウントマネージャー経由でこれを設定できます。 **デフォルト設定の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/ja/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.