
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 Epsilon Retail Media.
¿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, Epsilon Retail Media excluirá cualquier anuncio previamente proporcionado al cliente si la sessionId es idéntica a la solicitud del token.
¡Integración estándar!
Actualmente, esta funcionalidad solo está disponible para anuncios de productos de Epsilon Retail Media.
¿Cómo funciona?
Cuando Epsilon Retail Media 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 Epsilon Retail Media 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 Epsilon Retail Media (por ejemplo, para otro contexto), 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 Epsilon Retail Media 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
, Epsilon Retail Media excluirá los 15 o 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 Epsilon Retail Media recibe una solicitud de anuncio que no coincida con la solicitud de anuncio del token, este se ignorará y los anuncios se generarán como si no se hubiera proporcionado ningún token.
¿Qué pasa si envío un MemoryToken y está mal formado?
Epsilon Retail Media 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 Epsilon Retail Media ha visto en varios clientes.
A partir de la versión 39.0 de Epsilon Retail Media, 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 Epsilon Retail Media 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, Epsilon Retail Media empezará a publicar anuncios de nuevo desde 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.