Gestiona contactos y visitas
Introducción
Cuando los usuarios buscan en los artículos clasificados, pueden contactar al propietario del artículo a través de un formulario que se muestra en la publicación o pueden ver el teléfono del propietario. Existe una diferencia respecto del funcionamiento entre los usuarios que iniciaron sesión y los usuarios invitados. Cuando los usuarios invitados realizan una pregunta sobre tu artículo, el contacto se dirige directamente al buzón de entrada de tu correo electrónico y se mostrará en nuestro recurso de contacts, porque no sigue el flujo de preguntas habitual. Cuando un usuario que tiene cuenta en nuestro sitio e inició sesión realiza una pregunta, sigue el flujo de preguntas habitual y puedes utilizar el recurso de questions. Para ver cómo trabajar con preguntas de usuarios que iniciaron sesión, consulta nuestra guía de Administración de preguntas y respuestas.Guía de contactos clasificados
Esta guía te ayudará a recolectar datos sobre preguntas y visualizaciones del teléfono en tus artículos clasificados. Se trata de una API de solo lectura, muy útil para llevar métricas de tus artículos clasificados. Puedes consultar datos sobre preguntas y llevar un registro de cuántas veces se hizo clic en la opción ‘Ver teléfono’. Puedes consultar por usuario, artículo, fechas y períodos de tiempo.Contenidos:
- Descripción de parámetros
- Preguntas totales
- Preguntas con fecha
- Clicks en teléfonos de contacto
- Clicks en teléfonos de contacto con fecha
Descripción de parámetros
Tipo | Parámetro | Descripción |
---|---|---|
Entero | {userId} | ID de usuario. |
Entero | {itemId} | ID de artículo. |
Fecha | {dateFrom} | Fecha, en formato ISO, que define el inicio de la consulta. |
Fecha | {dateTo} | Fecha, en formato ISO, que define el fin de la consulta. |
Entero | {limit} | Opcional. Cantidad máxima de artículos a devolver. |
Entero | {offset} | Opcional. Paginación. |
Entero | {last} | Opcional. Denota cuántas horas/días atrás cubrirá la muestra. |
Cadena | {unit} | Unidad de consulta, valores posibles: [“día”, “hora”]. |
Fecha | {ending} | Opcional. Fecha, en formato ISO, que establece el tiempo de finalización de la muestra; por defecto es la fecha y hora actuales. |
Cadena | {order} | Opcional. Clasifica los resultados por fecha: [“desc”, “asc”] (por defecto es “asc”). |
Preguntas totales
Puedes acceder a las preguntas totales que tuvo un artículo o las preguntas totales que tuvo un vendedor en todos sus artículos en un rango de fechas.Por artículo
curl -X GET https://api.mercadolibre.com/items/{Item_id}/contacts/questions?date_from={Date_from}&date_to={Date_to}
Por usuario
curl -X GET https://api.mercadolibre.com/users/{User_id}/contacts/questions?date_from={Date_from}&date_to={Date_to}Ejemplo:
curl -X GET https://api.mercadolibre.com/items/MLV421672596/contacts/questions?date_from=2014-08-01T00:00:00.000-03:00&date_to=2014-08-02T23:59:59.999Respuesta:
{ "date_from": "2014-08-01T00:00:00.000-03:00", "date_to": "2014-08-02T23:59:59.999", "item_id": "MLV421672596", "total": 9 }
Preguntas con fecha
Este recurso te permite acceder a las preguntas sobre un artículo específico o por vendedor para un período de tiempo específico. Además, accedes a detalles sobre contactos realizados en modo invitado (usuarios que no iniciaron sesión o que no están registrados) entre intervalos de tiempo, por hora o por día.Por artículo
curl -X GET https://api.mercadolibre.com/items/{Item_id}/contacts/questions/time_window?last={Last}&unit={Unit}Si necesitas concatenar artículos, haz lo siguiente:
curl -X GET https://api.mercadolibre.com/items/{Item_id}/contacts/questions/time_window?ids={id1,id2}&last={Last}&unit={Unit}&ending={Ending_date}
Por usuario
curl -X GET https://api.mercadolibre.com/users/{User_id}/contacts/questions/time_window?last={Last}&unit={Unit}Ejemplo:
curl -X GET https://api.mercadolibre.com/items/MLA510272257/contacts/questions/time_window?last=2&unit=hourRespuesta:
{ "item_id": "MLA510272257", "total": 0, "date_from": "2014-08-06T12:00:00Z", "date_to": "2014-08-06T14:00:00Z", "last": 2, "unit": "hour", "results": [ { "date": "2014-08-06T12:00:00Z", "total": 0 }, { "date": "2014-08-06T13:00:00Z", "total": 0 } ] }
Clicks en teléfonos de contacto
Puedes acceder a la cantidad total de veces que se hizo clic en la opción ‘Ver teléfono’ de un artículo o para cada artículo de un usuario en rangos de fechas.Por artículo
curl -X GET https://api.mercadolibre.com/items/{Item_id}/contacts/phone_views?date_from={Date_from}&date_to={Date_to}
Por usuario
curl -X GET https://api.mercadolibre.com/users/{User_id}/contacts/phone_views?date_from={Date_from}&date_to={Date_to}Ejemplo:
curl -X GET https://api.mercadolibre.com/users/52366166/contacts/phone_views?date_from=2014-05-28T00:00:00.000-03:00&date_to=2014-05-29T23:59:59.999Respuesta:
{ "date_from": "2014-05-28T00:00:00.000-03:00", "date_to": "2014-05-29T23:59:59.999", "total": 71, "user_id": "52366166" }
Clicks en teléfonos de contacto con fecha
Puedes acceder a la cantidad total de veces que se hizo clic en la opción ‘Ver teléfono’ de un artículo o para cada artículo de un usuario durante cierto período de tiempo. Además de entregar las visitas totales, la información se detalla y agrupa por intervalo de tiempo.Por artículo
curl -X GET https://api.mercadolibre.com/items/{Item_id}/contacts/phone_views/time_window?last={Last}&unit={Unit}Si necesitas concatenar artículos:
curl -X GET https://api.mercadolibre.com/items/contacts/phone_views/time_window?ids={Id1,Id2}&last={Last}&unit={Unit}&ending={Ending_date}
Por usuario
curl -X GET https://api.mercadolibre.com/users/{User_id}/contacts/phone_views/time_window?last={Last}&unit={Unit}Ejemplo:
curl -X GET https://api.mercadolibre.com/items/contacts/phone_views/time_window?ids=MLA510272257,MLA489747739&last=2&unit=hour&ending=2014-05-28T00:00:00.000-03:00Respuesta:
[ { "item_id": "MLA510272257", "total": 0, "date_from": "2014-05-28T02:00:00Z", "date_to": "2014-05-28T04:00:00Z", "last": 2, "unit": "hour", "results": [ { "date": "2014-05-28T02:00:00Z", "total": 0 }, { "date": "2014-05-28T03:00:00Z", "total": 0 } ] }, { "item_id": "MLA489747739", "total": 0, "date_from": "2014-05-28T02:00:00Z", "date_to": "2014-05-28T04:00:00Z", "last": 2, "unit": "hour", "results": [ { "date": "2014-05-28T02:00:00Z", "total": 0 }, { "date": "2014-05-28T03:00:00Z", "total": 0 } ] } ]Siguiente: Recibe notificaciones.
Ingrese o regístrate para recibir las últimas novedades sobre nuestra API