Transmisión de parámetros de usuario
Aviso
Para trabajar con la API de JavaScript se requieren conocimientos de HTML y JavaScript. Si no conoce estos idiomas, contacte a su desarrollador web o webmaster.
La mayoría de los datos de la sesión se recopilan automáticamente por la etiqueta de Yandex Metrica. Para complementarlos con sus propios datos, transmita los parámetros de sesión. Sin embargo, quizás descubra que la información sobre los propios usuarios es más útil que las estadísticas de la sesión.
Yandex Metrica le permite enviar cualquier dato personalizado, denominado parámetros de usuario. Para los parámetros de usuario, recomendamos transmitir características del usuario que no cambien de sesión a sesión y que no contengan datos personales como el nombre del usuario. Para obtener más información sobre la diferencia entre parámetros de sesión y parámetros de usuario, consulte Procesamiento y almacenamiento de datos.
Si desea que los parámetros que pasó se reflejen en los informes, Yandex Metrica debe vincularlos a los usuarios del sitio web. Para hacer esto, se utilizan los siguientes IDs especiales: ID de cliente e ID de usuario. Los parámetros están vinculados a sesiones para usuarios que visitaron el sitio web dentro de los 90 días antes de que los datos fueran enviados a Yandex Metrica.
Nota
Al transmitir parámetros de usuario especificando el ID de cliente e ID de usuario, el número total de usuarios en los informes de Yandex Metrica puede diferir del número de IDs pasados debido a la forma en que el ID de usuario está vinculado al ID de cliente.
Los informes se actualizarán con la nueva información dentro de unas pocas horas. Para ver estadísticas, use el informe Parámetros de usuario. También puede usar estos datos para crear segmentos para listas de retargeting en Yandex Direct o Yandex Audience (ver el ejemplo).
Nota
Los parámetros enviados a Yandex Metrica se almacenan durante dos años desde la última carga. Cuando finaliza el período de almacenamiento, el informe ya no mostrará los datos.
Cuándo debe transmitirse el ClientID
Recomendamos usar el ID de cliente en los datos transmitidos si no necesita obtener sus propios IDs en un informe.
Cuándo debe transmitirse el UserID
Recomendamos usar el UserID si, por ejemplo, su sitio ya tiene un sistema de ID de usuarios y necesita obtener un informe que las incluya.
Puede enviar parámetros de usuario a Yandex Metrica de varias maneras:
Transmisión de datos durante una sesión del sitio
Este método es útil cuando se genera un informe a partir de los datos recibidos mientras el usuario está visualizando el sitio.
Los parámetros de usuario se transmiten a Yandex Metrica a través de la API de JavaScript. La información enviada usando este método no se puede eliminar de Yandex Metrica.
Para transmitir los parámetros en cualquier otro momento, utilice el método userParams. Para transmitir parámetros durante la inicialización de la etiqueta, especifique datos en el parámetro userParams. La información se transmite como objeto de JavaScript y se transmite de la siguiente manera.
El valor del campo se procesa de la siguiente manera, según el tipo:
-
objeto — Crea una nueva rama del árbol para cada clave del objeto e invoca el algoritmo recursivamente para cada valor.
-
string — cuenta la cantidad de veces que aparece cada valor diferente de la cadena.
-
number — calcula el valor total y promedio de todos los números.
-
true, false o null — calcula la cantidad de veces que aparece cada valor.
Los datos se vincularán al ID de cliente solo si el método userParams
fue llamado durante la sesión del usuario. Para obtener estadísticas más completas, espere hasta que se haya transmitido un mayor volumen de datos a Yandex Metrica.
Ejemplo
Veamos una tienda en línea que tiene dos tipos de clientes: “normal” y “VIP”. Los datos de estado del cliente se almacenan en la base de datos propia del sitio. Después de que los usuarios inician sesión en el sitio, ven sus nombres de usuario en lugar del enlace Iniciar sesión en cada página. Si un usuario tiene un estado especial, se muestra junto a su nombre: Jane/VIP. Junto con el estado, también puede transmitir el ID de usuario que está almacenado en su base de datos.
Para enviar datos a Yandex.Metrica, agregue código a todas las páginas del sitio que llamarán al método
userParams
.Para enviar datos sobre usuarios con estado especial, el código tendrá un aspecto similar al siguiente:
En cualquier momentoAl inicializar una etiqueta
ym(XXXXXX, 'userParams', { vip_status: true, child: 1, child_age: 13, UserID: 12345 });
ym(XXXXXX, 'init', { clickmap: true, webvisor: true, userParams: { vip_status: true, child: 1, child_age: 13, UserID: 12345 } });
Si se está transmitiendo información sobre un usuario “normal”, el código se verá así:
En cualquier momentoAl inicializar una etiqueta
ym(XXXXXX, 'userParams', { vip_status: false, child: 1, child_age: 13, UserID: 12345 });
ym(XXXXXX, 'init', { clickmap: true, webvisor: true, userParams: { vip_status: false, child: 1, child_age: 13, UserID: 12345 } });
donde
XXXXXX
es su número de etiqueta.Si un cliente regular obtiene estado VIP, el método
userParams
enviará los datos nuevos a Yandex Metrica la próxima vez que el usuario inicie sesión en su sitio. Este nuevo estado se aplicará a todo el historial de sesiones de este usuario, como si el cliente siempre hubiera sido VIP.
Transmisión de datos en un archivo CSV en cualquier momento
Con este método, Yandex Metrica recibe los datos recopilados tanto durante la sesión del sitio como después de que el usuario haya dejado el sitio.
Especificación para el formato del archivo .csv
Nombre del campo |
Descripción |
Ejemplo |
|
ID del usuario del sitio |
P12345 |
|
ID de usuario. Máximo de 1000 por usuario |
edad | cliente.edad |
|
Valor de la ID del usuario |
40 |
Para enviar una estructura jerárquica de parámetros, use el símbolo “.” (punto). Por ejemplo, para transmitir múltiples valores del campo key
, especifique cliente.demografía.edad
.
El número máximo de caracteres en los campos mostrados en los informes de Yandex Metrica:
key
: 255;valor
: 50.
Para pasar información con un parámetro:
- Obtenga el ID de cliente usando el método getClientID.
- Genere un archivo CSV especificando el ID de cliente y envíelo en la interfaz de Yandex Metrica.
- Envíe su ID de usuario usando el método setUserID.
- Genere un archivo CSV especificando el ID de usuario y envíelo en la interfaz de Yandex Metrica.
Cómo trabajar con un archivo
La interfaz de Yandex Metrica le permite cargar datos y eliminarlos. Puedes gestionar el archivo en Configuraciones (encuentre la pestaña Cargar datos y elija Parámetros de usuario).
Para enviar un archivo CSV generado a Yandex Metrica:
- Haga clic en Cargar datos.
- En la ventana que aparece, seleccione el tipo de archivo dependiendo del tipo de ID que desea cargar (ID de usuario o ID de cliente).
- Seleccione el archivo en su equipo y agregue comentarios para la carga, si lo considera necesario.
- Haga clic en Cargar datos.
Para eliminar datos o partes de datos cargados previamente del servicio, prepare un archivo CSV. El archivo solo debe contener el campo key
para los datos que desea eliminar. A continuación, siga estos pasos:
-
Haga clic en Eliminar datos.
-
En la ventana que aparece, seleccione el tipo de archivo al que desea aplicar cambios, dependiendo del ID (ID de usuario o ID de cliente).
-
Seleccione el archivo en su equipo y agregue comentarios para la carga, si lo considera necesario.
-
Haga clic en Cargar datos.
El servicio tarda un tiempo en procesar el archivo. Una vez completado el procesamiento, la información que envió estará disponible en el informe de Parámetros de usuario. También puede usar estos datos para crear segmentos para listas de retargeting en Yandex Direct o Yandex Audience (ver el ejemplo).
Enlaces útiles |
Capacitación en línea |
Identificador único de sesión del sitio web creado automáticamente por Yandex Metrica.
ID de usuario establecido por el propietario del sitio (por ejemplo, cuando el usuario del sitio inicia sesión en su cuenta personal).
ID de usuario establecido por el propietario del sitio (por ejemplo, cuando el usuario del sitio inicia sesión en su cuenta personal).
Identificador único de sesión del sitio web creado automáticamente por Yandex Metrica.