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:

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í:

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

Descripción del formato CSV

Nombre del campo

Descripción

Ejemplo

ID de cliente | ID de usuario

ID del usuario del sitio

P12345

key

ID de usuario. Máximo de 1000 por usuario

edad | cliente.edad

valor

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:

  1. Obtenga el ID de cliente usando el método getClientID.
  2. Genere un archivo CSV especificando el ID de cliente y envíelo en la interfaz de Yandex Metrica.
  1. Envíe su ID de usuario usando el método setUserID.
  2. 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:

  1. Haga clic en Cargar datos.
  2. 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).
  3. Seleccione el archivo en su equipo y agregue comentarios para la carga, si lo considera necesario.
  4. Haga clic en Cargar datos.

Archivo CSV de muestra para 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:

  1. Haga clic en Eliminar datos.

  2. 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).

  3. Seleccione el archivo en su equipo y agregue comentarios para la carga, si lo considera necesario.

  4. Haga clic en Cargar datos.

Archivo CSV de muestra para eliminar 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).

Chatee con nosotros

Escriba un correo electrónico

Tome en cuenta: Nuestro equipo de soporte nunca iniciará llamadas hacia usted. No siga las instrucciones de personas que le llamen y se presenten como el equipo de soporte de Yandex Metrica.


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.