Mejore la experiencia de sus clientes cuando navegan por varias páginas. Al generar anuncios de productos, recibirá un memoryToken que puede enviarse en solicitudes posteriores para excluir los anuncios proporcionados anteriormente.

🚧

¡Solo anuncios de productos!

Actualmente, esta funcionalidad solo está disponible para anuncios de productos de CitrusAd.

¿Cómo aplicar la paginación a su sitio?

Cuando genere anuncios de productos, recibirá en la respuesta 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="
}

Cuando un cliente avanza a la siguiente página, usted debe enviar este token en su próxima solicitud de anuncios.

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    
}

Al usar este token, CitrusAd excluirá cualquier anuncio previamente proporcionado al cliente si el sessionId es idéntico a la solicitud del token.

🚧

¡Integración estándar!

Actualmente, esta funcionalidad solo está disponible para anuncios de productos de CitrusAd.

¿Cómo funciona?

Cuando CitrusAd recibe un memoryToken en la solicitud de anuncio, los anuncios publicados anteriormente para la sessionId se excluirán de la respuesta al anuncio. Esto garantiza una mayor variedad de anuncios que se muestran a su cliente en una navegación por varias páginas.

Cuando la solicitud no incluya el token, la generación de anuncios se realizará según el proceso actual sin aplicar exclusiones. Siempre se proporcionará un token después de la generación de anuncios para que el minorista pueda utilizarlo.

El token de memoria contiene información codificada que permite a CitrusAd discriminar los anuncios que se han mostrado anteriormente (ya sea en una única solicitud o en un período de varias solicitudes encadenadas).

En caso de que se envíe un token irrelevante a CitrusAd (como para un contexto diferente), los anuncios se devolverán como si no se hubiera proporcionado ningún token en la solicitud de anuncio.

⚠

¿Solicita más anuncios de los que se muestran en su sitio web?

Si es usted minorista y solicita más anuncios de CitrusAd de los que se muestran a su cliente, es posible que no reciba muchos anuncios en las páginas siguientes. Si solicita 15 anuncios y solo se muestran 4 a su cliente, al recibir el memoryToken, CitrusAd excluirá los 15-20 anuncios previamente proporcionados en la respuesta del anuncio anterior.

Ejemplo de flujo de solicitudes

Preguntas frecuentes

¿Puedo utilizar este token en varias búsquedas de clientes para excluir productos en una navegación de clientes más amplia?

No, si CitrusAd recibe una solicitud de anuncio que no coincide con la solicitud de anuncio del token, se ignora y los anuncios se generan como si no se hubiera proporcionado ningún token.

¿Qué pasa si envío un MemoryToken y está mal formado?

CitrusAd ignorará el token y procesará la solicitud como si fuera una solicitud normal.

¿Cuántas páginas puedo paginar?

Por defecto, 5, ya que este es el mejor equilibrio entre rendimiento y saturación que CitrusAd ha visto en varios clientes.

A partir de la versión 39.0 de CitrusAd, puede configurar esta opción a través del administrador técnico de su cuenta.

¿Qué sucede cuando no hay anuncios que publicar, como en las páginas 5 a 10 de la configuración predeterminada?

El memoryToken está configurado en CitrusAD para almacenar anuncios del número de páginas en la configuración. Por ejemplo, si la configuración es la predeterminada de 5 páginas, CitrusAD empezará a publicar anuncios a partir de la página 7.

Solicitud de paginación 6 (página 6): memoryToken contiene información sobre los anuncios de las 5 páginas anteriores, por lo que no se publicará ningún anuncio de las 5 páginas anteriores.

Solicitud de paginación 7 (página 7): los anuncios de la página 1 son aptos para su publicación.

¿Qué sucede si me quedo sin anuncios antes de la página 5 en la configuración predeterminada?

Si, por ejemplo, en la página 3 no tiene anuncios, comenzaremos a publicarlos en la página 7, ya que almacenamos el número total de páginas en la configuración como los anuncios publicados anteriormente que no deberían volver a publicarse.