---
metadata:
- name: generator
content: Diplodoc Platform v5.50.6
alternate:
- https://yandex.com.tr/support/metrica/en/data/chat.md
- https://yandex.com.tr/support/metrica/es/data/chat.md
- https://yandex.com.tr/support/metrica/pt/data/chat.md
- https://yandex.com.tr/support/metrica/ru/data/chat.md
- https://yandex.com.tr/support/metrica/tr/data/chat.md
title: Importar chats
description: Si los usuarios prefieren obtener información o realizar pedidos mediante mensajería (WhatsApp, Telegram o Viber) cuando interactúan con su sitio web, puede rastrear dicho contacto a través de eventos de chat y vincularlos a las acciones del usuario en el sitio.
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com.tr/support/metrica/es/llms.txt
# Importar chats
Si los usuarios prefieren obtener información o realizar pedidos mediante mensajería (WhatsApp, Telegram o Viber) cuando interactúan con su sitio web, puede rastrear dicho contacto a través de eventos de chat y vincularlos a las acciones del usuario en el sitio.
Importar chats le ayuda a:
- Descubrir cuántas conversiones de chat ha tenido.
- Evaluar su calidad: por ejemplo, darse cuenta de cuántos chats no se han respondido.
- Evaluar los resultados. Por ejemplo, puede ver si una conversación resultó en una compra.
- Obtener una mejor imagen de sus interacciones con los clientes y ver si los canales publicitarios que generan conversaciones en los mensajes son efectivos.
## Cómo rastrear chats en Yandex Metrica {#follow}
Para recopilar datos, use los [servicios de seguimiento de chat](https://metrika.yandex.ru/r/marketplace?filter=68ffa9395e9a080015db1866) o una solución a la medida, y luego transmita los datos del chat a Yandex Metrica usando el [API](https://yandex.com.tr/dev/metrika/ru/data-import/).
{% note info %}
Si utiliza una solución personalizada y transmite los datos a través de la API, su sitio web debe tener un sistema para recopilar los ID de usuarios (`ClientID`, `ID de usuario`, `Yclid`, `EPurchaseID`) en funcionamiento, de modo que pueda vincular chats sin conexión a sesiones específicas del sitio web.
{% endnote %}
Yandex Metrica rastrea los chats usando [metas](https://yandex.com.tr/support/metrica/es/general/goals.md): cuando carga datos de conversión de chat por primera vez, el servicio crea automáticamente una meta de **chat** especial. Esta meta automática aparece luego en la página de administración de metas en la interfaz de Yandex Metrica.
No es necesario crear una meta separada manualmente: Yandex Metrica reconocerá los eventos de chat cargados y comenzará a contar las conversiones.
Puede agregar la meta de **chat** a todos los informes de Yandex Metrica. Podrá ver las métricas de conversión (conversiones, metas alcanzadas, etc.) para esta meta. También es posible utilizar la meta y sus conversiones para optimizar sus anuncios, ajustar esta meta y sus conversiones para que solo se activen para chats específicos y agregar nuevas metas de este tipo.
## ¿Qué datos de chat puede transmitir? {#info}
{% note warning %}
Los datos de chat cargados aparecen en los informes de Yandex Metrica en no más de 2 horas.
{% endnote %}
Puede usar el API o los [servicios de seguimiento de mensajería](https://metrika.yandex.ru/r/marketplace?filter=68ffa9395e9a080015db1866) para transmitir información básica y adicional sobre chats a Yandex Metrica. Los datos obligatorios incluyen los datos que permiten identificar un evento de chat por hora y mensajería, así como los ID de una conversación. Además, puede transmitir métricas usadas para evaluar la calidad y el valor de los chats.
Para información sobre los datos disponibles y cómo se utilizan en los informes, lea a continuación.
**Campos de carga de chat**
#|
|| **Información** | **¿Obligatorio?** | **Descripción** ||
|| Fecha y hora del chat (hora de Unix, UTC) | Sí | Usado para grabar el evento de chat. Debe especificarse en el formato de marca de tiempo de Unix (UTC). ||
|| Plataforma de chat (mensajería: `whatsapp`, `telegram`, `viber`) | Sí | El nombre de un mensajero. Valores aceptables: `whatsapp`, `telegram` y `viber`. ||
|| ID de chat (nombre de usuario, ID, número de teléfono) | Sí (al menos un ID) | Debe completarse al menos uno de los siguientes campos: `ChatUsername`, `ChatUserID` o `PhoneNumber`. ||
|| Respuesta del chat (si el usuario recibió una respuesta) | No | Registra si un operador respondió al chat. Valor: `1` o `0`. ||
|| Etiquetas del chat | No | Una etiqueta de texto de hasta 100 caracteres. Se usa para la segmentación del chat. ||
|| Monto de conversión (valor del chat) y moneda | No | Úselo para transmitir datos de ingresos para un chat: un valor numérico y un código de moneda ISO 4217. ||
|| URL de la página web desde la que se inició el chat | No | La URL de la página desde la cual el usuario inició la conversación. ||
|| Enlace de un servicio de seguimiento de mensajería | No | Un enlace técnico al chat en el sistema de seguimiento, usado para análisis interno. ||
|#
## Cómo transmitir datos de chat {#how-send}
Hay dos formas de realizar la integración:
- **Uso de [servicios de seguimiento de chat](https://metrika.yandex.ru/r/marketplace?filter=68ffa9395e9a080015db1866)**
El proveedor proporciona un código, como un widget o script, que usted agrega a su sitio web. El fragmento de código recopila automáticamente los ID necesarios y prepara los eventos para importarlos a Yandex Metrica.
- **Directamente a través de la API**
Para este método, siga las recomendaciones a continuación.
### Paso 1. Recopile ID de usuarios {#step-1}
**Meta**: garantizar que los chats estén vinculados a sesiones del sitio web o clics en anuncios.
- **Si utiliza un [servicio de seguimiento de chat](https://metrika.yandex.ru/r/marketplace?filter=68ffa9395e9a080015db1866)**
Simplemente instale el fragmento de código que se le proporcionó. Recupera y transmite automáticamente los ID necesarios a Yandex Metrica, entre ellos:
- **ClientID** de `_ym_uid`.
- **UserID**, si se requiere.
- **Yclid** para el tráfico de Yandex Direct.
- **Si utiliza una integración personalizada**
Transmita uno o varios de los siguientes ID:
- **ClientID**: el identificador principal de un usuario en Yandex Metrica. Le recomendamos que lo envíe si un chat se originó en una sesión de sitio web.
- **UserID**: su ID de usuario interno si la función ID de usuario está habilitada.
- **Yclid**: el ID de un clic usado en Yandex Direct. Útil cuando un usuario accede directamente a algún mensajero, sin visitar el sitio web.
- **PurchaseID**: el ID del pedido que se usa si un chat está vinculado a una transacción específica. Este es un caso inusual.
Si no se transmite ningún ID, el evento cargado se considera **no atribuido** y no está vinculado a ninguna sesión o clic.
### Paso 2. Añada su propio ID de chat a los enlaces del mensajero {#step-2}
**Meta**: hacer coincidir explícitamente el chat con los ID de Yandex Metrica del paso 1 cuando se inicia una nueva conversación.
Recomendamos el siguiente algoritmo, que es usado por los [servicios de seguimiento de chat](https://metrika.yandex.ru/r/marketplace?filter=68ffa9395e9a080015db1866) y también funciona con integraciones personalizadas:
1. Generar un **ID de chat único**. Por ejemplo, `CT8F2A9`.
2. El fragmento de código instalado en su sitio web **agregará esta ID a cada enlace de Messenger:**
- **Bot de Telegram**: a través de un enlace profundo (parámetro de inicio). El usuario no verá el ID, pero el bot lo recibirá cuando sea contactado por primera vez.
- **Cuentas personales en Telegram, WhatsApp o Viber**: a través de **una primera plantilla de mensaje** precargada con el ID. Por ejemplo, el ID se puede pasar como una etiqueta técnica al final de un mensaje.
3. Una vez que comienza una conversación, el servicio recupera el ID del chat del enlace profundo o del primer mensaje y lo **compara** con los ID de Yandex Metrica recopilados previamente: `ClientID`, `UserID`, `Yclid`.
4. El servicio establece entonces un vínculo sólido entre el **ID de chat ↔ ID de Yandex Metrica**, que es suficiente para una atribución correcta.
### Paso 3. Importar eventos a Yandex Metrica {#step-3}
Una vez establecido el enlace, puede comenzar a transmitir eventos de chat a través de la [API de importación de chat de Yandex Metrica](https://yandex.com.tr/dev/metrika/ru/management/chats). Los requisitos de formato de datos (la hora del evento, los valores de la plataforma aceptables, la estructura del campo, etc.) se describen en la especificación de API.
[Chatee con nosotros](https://yandex.com.tr/chat/#/user/036e6a02-3620-9cdc-4c5e-a34667a7379e?utm_source=spravka){.button}
- - -
#|
||
Enlaces útiles
- [Etiqueta de demostración](https://metrica.yandex.com.tr/r/dashboard?)
- [Agregar una etiqueta](https://metrica.yandex.com.tr/add/)
- [Configuración gratuita de etiquetas](https://yandex.com.tr/promo/freeservice/metrica?utm_source=help_metrica_tr&utm_medium=cpc&utm_campaign=1)
- [Yandex Metrica API](https://tech.yandex.com.tr/metrika/)
- [Sugiera su idea](https://yandex.com.tr/support/metrica/troubleshooting/idea.html)
- [Discutir en Telegram](https://t.me/yandexmetrika)
|
Capacitación en línea
- [Obtener un certificado de Yandex Metrica](https://yandex.ru/adv/expert/exam/metrika/?utm_source=metrika_help&utm_medium=web&utm_campaign=static&utm_content=useful_links)
- [Tomar un curso de capacitación](https://yandex.com/adv/edu/online/metrika?utm_source=metrika_help&utm_medium=web&utm_campaign=static&utm_content=useful_links)
||
|#