Pagination

Améliorez l'expérience de vos clients lorsqu'ils parcourent plusieurs pages. Lors de la génération d'annonces de produits, vous recevrez un memoryToken qui pourra être envoyé lors de demandes ultérieures afin d'exclure les publicités précédemment diffusées.

🚧

Annonces de produits uniquement !

Cette fonctionnalité n'est actuellement prise en charge que pour les annonces de produits Epsilon Retail Media.

Comment intégrer la pagination sur votre site ?

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

Lorsqu'un client accède à la page suivante, vous devez envoyer ce jeton dans votre prochaine requête d'annonce.

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 toute annonce précédemment diffusée au client si l'identifiant de session est identique à celui de la demande du jeton.

🚧

Intégration standard !

Cette fonctionnalité n'est actuellement prise en charge que pour les annonces de produits Epsilon Retail Media.

Comment ça marche ?

Lorsqu'Epsilon Retail Media reçoit une memoryToken dans la requête d'annonce, toutes les annonces précédemment diffusées pour le sessionId sont exclues de la réponse publicitaire. Cela garantit la diversité des annonces diffusées à votre client lorsque ce dernier navigue sur plusieurs pages.

Lorsque la requête ne contient aucun jeton, la génération d'annonces sera effectuée conformément au processus en cours sans aucune exclusion appliquée. Un jeton sera toujours fourni après la génération d'annonces pour que le détaillant ait le choix de l'utiliser ou non.

Le jeton en mémoire contient des informations codées qui permettent à Epsilon Retail Media d'identifier les annonces qui ont été diffusées précédemment (soit dans le cadre d'une requête unique, soit dans le cadre de plusieurs requêtes en chaîne).

Dans le cas où un jeton non pertinent est envoyé à Epsilon Retail Media (comme un contexte différent), les publicités sont diffusées comme si aucun jeton n'avait été fourni dans la requête de publicité.

️ Vous émettez plus de requêtes 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, il se peut que vous ne receviez pas beaucoup d'annonces sur les pages suivantes. Si vous demandez 15 annonces et que vous en proposez seulement 4 à vos clients, lorsque vous recevrez le memoryTokenEpsilon Retail Media exclura les 15 à 20 annonces qui vous ont été proposées précédemment dans la réponse publicitaire suivante.

Exemple de flux de requêtes

Foire aux questions

Puis-je utiliser ce jeton pour plusieurs recherches du client afin d'exclure des produits dans le cadre du parcours global du client ?

Non, si Epsilon Retail Media reçoit une requête d'annonce qui ne correspond pas à celle du jeton, elle sera ignorée et les annonces seront générées comme si aucun jeton n'était fourni.

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

Epsilon Retail Media ne tiendra pas compte du jeton et traitera la demande comme s'il s'agissait d'une demande normale.

Combien de pages puis-je paginer ?

Par défaut, c'est 5, ce qui représente le meilleur équilibre entre performance et saturation qu'Epsilon Retail Media ait observé chez plusieurs clients.

Depuis la version 39.0 d’Epsilon Retail Media, cette configuration peut se faire via votre responsable de compte technique.

Que se passe-t-il lorsque vous n'avez plus d'annonces à diffuser, par exemple aux pages 5 à 10, dans le cadre de la configuration par défaut ?

Le memoryToken est configuré du côté d’Epsilon Retail Media pour stocker les annonces selon le nombre de pages dans la configuration. Par exemple, si la configuration par défaut est de 5 pages, Epsilon Retail Media commencera à rediffuser 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. Aucune annonce des 5 pages précédentes ne sera donc diffusée.

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

Que se passe-t-il si je n'ai plus d'annonces avant la page 5 dans le cadre de la configuration par défaut ?

Si, par exemple, à la page 3, vous n'avez plus d'annonces à diffuser, nous commencerons à diffuser des annonces à la page 7, car nous enregistrons le nombre total de pages prévu dans le cadre de la configuration comme des annonces déjà diffusées qui ne doivent pas l'être à nouveau.