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 CitrusAd.

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    
}

Grâce à ce jeton, CitrusAd exclura toute annonce précédemment diffusée au client si le sessionId est identique à la requête du jeton.

🚧

Intégration standard !

Cette fonctionnalité n’est actuellement prise en charge que pour les annonces de produits CitrusAd.

Comment ça marche ?

Lorsque CitrusAd reçoit un 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 à CitrusAd 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).

En cas d'envoi d'un jeton non pertinent à CitrusAd (par exemple, un contexte différent), les annonces sont ajustées comme si aucun jeton n'était fourni dans la requête d'annonce.

⚠

️ Vous émettez plus de requêtes d'annonces que celles diffusées sur votre site Web ?

Si vous êtes détaillant et que vous demandez plus d'annonces à CitrusAd que ce qui est diffusé à vos clients, il se peut que vous ne receviez pas beaucoup d'annonces sur les pages par la suite. Si vous demandez 15 annonces et que vous en proposez seulement 4 à vos clients, lorsque vous recevrez le memoryToken, CitrusAd 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 CitrusAd 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é ?

CitrusAd ignorera le jeton et traitera la demande comme s'il s'agissait d'une demande normale.

Combien de pages puis-je paginer ?

Par défaut, cette valeur est de 5. Il s'agit du meilleur équilibre entre performance et saturation observé par CitrusAd chez de nombreux clients.

Depuis la version 39.0 de CitrusAd, 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é par CitrusAd pour stocker les annonces à partir du nombre de pages indiquées dans le cadre de la configuration. Par exemple, si la configuration est de 5 pages par défaut, CitrusAd commencera à rediffuser les mêmes 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.