顧客がより快適に複数のページを閲覧できるようにします。商品広告を生成する際に memoryToken が届くので、これを送信すれば、すでに配信済みの広告を除外するよう要求することができます。
商品広告のみ！
この機能は現在、CitrusAdの商品広告でのみサポートされています。
サイトにページネーションを実装する方法
商品広告を生成すると、レスポンスで次を受信します： memoryToken.
{
"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="
}
顧客が次のページに移動しているときに、次の広告リクエストでこのトークンを送信する必要があります。
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
}
このトークンを使用して、SessionIDがトークンのリクエストと同一である場合に、CitrusADは顧客に配信済みの広告をすべて除外します。
標準的な統合
この機能は現在、CitrusAdの商品広告でのみサポートされています。
仕組み
CitrusAdが広告リクエストで memoryToken 広告リクエストにおいて、以前に配信されたSessionIDの広告は広告レスポンスから除外されます。これにより、複数のページを移動していく顧客に対し、広告を幅広く提供できるようになります。
このトークンがリクエストに存在しない場合、広告の生成は現在のプロセスに従って実行され、除外は適用されません。小売業者が利用を選択できるよう、トークンは常に、広告の生成後に提供されます。
メモリトークンには、（1つのリクエストでも、複数のチェーンリクエストの期間でも）以前に配信された広告をCitrusAdが判別できるようにする、エンコードされた情報が格納されています。
無関係なトークン（別のコンテキストなど）がCitrusAdに送信された場合、広告リクエストにてトークンが提供されなかった場合と同じように広告が返却されます。
ウェブサイトに配信されるよりも多くの広告をリクエストしていますか？
顧客に配信されるよりも多くの広告をCitrusAdにリクエストしている小売業者の場合、以降のページで受信されない広告が多く出る可能性があります。15個の広告をリクエストしたものの顧客に配信する広告は4つだけである場合、CitrusAdは、
memoryTokenを受信すると、配信済みの15〜20個の広告すべてを以降の広告レスポンスにて除外します。
リクエストフローの例
よくある質問
より広範囲のカスタマージャーニーで製品を除外するために、このトークンを複数の顧客検索で使用できますか？
いいえ、CitrusAdがトークンの広告リクエストと一致しない広告リクエストを受信した場合、それは無視され、トークンが提供されていない場合と同様に広告が生成されます。
不正な形式のmemoryTokenを送信した場合はどうなりますか？
CitrusAdはトークンを無視し、通常のリクエストであるかのようにリクエストを処理します。
何ページまでページ付けできますか？
デフォルトでは5ページまでページ付け可能です。CitrusAdが複数のクライアントにわたって確認したパフォーマンスとサチュレーションで最適なバランスを実現できるページ数です。
CitrusAd のリリース 39.0 以降、これはテクニカルアカウントマネージャーを通じて設定できます。
デフォルト設定で 5 ～ 10 ページなど、配信する広告がなくなった場合はどうなりますか？
memoryTokenは、設定内のページ数から広告を保存するように CitrusAd 側で構成されます。たとえば、設定がデフォルトの 5 ページの場合、CitrusAd は 7 ページ目から広告の再提供を開始します。
ページネーションリクエスト 6 (ページ 6): memoryToken には前の 5 ページの広告に関する情報が含まれているため、前の 5 ページの広告は配信されません。
ページネーションリクエスト 7 (ページ 7): ページ 1 の広告が配信対象です。
初期設定で 5 ページ目までに広告がなくなった場合はどうなりますか？
例えば、3 ページ目までに広告が表示されなければ、再度配信すべきでない過去に配信した広告として設定に総ページ数を保存するため、7 ページ目までに広告の配信を開始することになります。