Verada Docs

Identidad del usuario ​

Gestión de identidades de usuario para mejorar la capacidad de identificar usuarios recurrentes.

Introducción ​

Verada identifica a los usuarios asignando un identificador anónimo único en su navegador. Los usuarios recurrentes se detectan cuando regresan a su sitio web en el mismo navegador.

Los usuarios pueden usar diferentes navegadores, pasar de un dispositivo móvil a un portátil o borrar periódicamente los datos de navegación. Verada ofrece la capacidad de vincular los movimientos de los usuarios a través de diferentes plataformas, brindando una vista holística del recorrido del usuario. Esto se logra al proporcionar una o más identidades conocidas a Verada.

Cuando proporciona una identidad conocida a la integración de Verada, Verada puede vincular y fusionar usuarios que comparten la misma identidad. Esto amplía en gran medida su capacidad para obtener información procesable de los datos de comportamiento que Verada captura.

Identificación de Usuarios ​

Las identidades de usuario se comparten con Verada al proporcionar un objeto de mapa de identidad a través de las integraciones de Seguimiento de Página y Seguimiento de Pedidos.

Ejemplo ​

El siguiente es un ejemplo de una estructura de datos de mapa de identidad que proporciona detalles para dos identidades llamadas $user y crm1.

  • Cada objeto de identidad tiene una propiedad userId obligatoria que especifica un identificador de usuario único para el tipo de identidad.
  • La identidad especial $user se utiliza para especificar el ID de un usuario autenticado en el sitio web o la aplicación.
  • Los nombres de los tipos de identidad utilizados son arbitrarios y pueden ser cualquier nombre alfanumérico que sea significativo para su entorno. En este ejemplo, crm1 se utiliza para asociar el ID del usuario en un sistema de gestión de relaciones con clientes con la identidad de usuario de Verada. También asocia atributos adicionales a través del objeto data.
json
{
  "$user": {
    "userId": "23872392383"
  },
  "crm1": {
    "userId": "b70115f2-aea8-456a-ab07-f9152257df4d",
    "data": {
      "key1": "value1",
      "key2": "value2"
    }
  }
}

Tipos de datos ​

IdentityMap ​

typescript
// Un objeto con claves que coinciden con cada
interface IdentityMap {
  [providerId: string]: Identity;
  // Una identidad especial opcional soportada por Verada para representar un
  // ID de usuario autenticado para el sitio web.
  $user?: Identity;
}

Identity ​

typescript
interface Identity {
  // El identificador único de usuario.
  userId: string;
  // Un objeto opcional de datos arbitrarios.
  data: {
    [key: string]: any;
  };
}

Identificación de usuarios a través de la etiqueta de Seguimiento de Página ​

La etiqueta JavaScript de seguimiento de página admite una propiedad identities que acepta un mapa de identidad:

json
{
  "version": 3,
  "accountKey": "...",
  "data": {
    "pageType": "..."
  },
  "identities": {
    "$user": {
      "userId": "23872392383"
    },
    "crm1": {
      "userId": "b70115f2-aea8-456a-ab07-f9152257df4d",
      "data": {
        "key1": "value1",
        "key2": "value2"
      }
    }
  }
}

Identificación de usuarios a través de la Capa de Datos de Verada ​

La Capa de Datos de Verada se puede utilizar para enviar identidades a Verada sin necesidad de predefinirlas en su etiqueta de Seguimiento de Página.

Después de definir la capa de datos en su sitio web, simplemente envíe identidades a ella de la siguiente manera:

html
<!--
  Este ejemplo asume que ha definido el array de la Capa de Datos de Verada
  en algún lugar anterior del documento de la siguiente manera:
-->
<script>
  var fanplayr_api = [];
</script>

<script>
  fanplayr_api.push({
    _type: 'identities',
    $user: {
      userId: '23872392383'
    },
    crm1: {
      userId: 'b70115f2-aea8-456a-ab07-f9152257df4d',
      data: {
        "key1": "value1",
        "key2": "value2"
      }
    }
  });
</script>

Gestión de Proveedores de Identidad ​

El área de Gestión de Identidades del Portal de Verada le permite definir y gestionar proveedores de identidad. Esta información es utilizada por el servicio Streams de Verada para entender qué identidad de usuario debe ser transmitida con datos a los puntos finales externos que usted haya definido.

Por ejemplo, si ha conectado Verada a un CRM y desea compartir el ID de CRM del usuario con los datos que Verada transmite a su CRM, crearía un proveedor de identidad para el CRM, y luego proporcionaría la identidad relevante a través de uno de los métodos anteriores. Cuando Verada transmita datos al CRM, incluirá la identidad asociada a ellos.

Cada identidad proporcionada tiene las siguientes propiedades:

  • key - Un identificador único que puede ser cualquier valor de cadena. Esta clave se utiliza en el objeto JavaScript del mapa de identidad. Por ejemplo, "crm1".
  • name - Un nombre de visualización único para la identidad. Esto solo es visible en el portal de Verada. Por ejemplo, "Salesforce".

Identidad de Usuario Autenticado ​

Verada soporta una clave de proveedor de identidad especial $user que puede ser utilizada para pasar la identidad de un usuario autenticado para el sitio web.

Por ejemplo, después de que un usuario inicie sesión en el sitio web, puede usar la variable de la capa de datos de Verada para asociar la identidad del usuario autenticado con el usuario de Verada:

javascript
fanplayr_api.push({
  _type: 'identities',
  $user: {
    userId: '234902834211'
  }
});

Nota: Este método para especificar la identidad de usuario autenticado es equivalente a especificar la propiedad customerId en la etiqueta de Seguimiento de Página. Este método es el preferido; sin embargo, la propiedad customerId seguirá funcionando por compatibilidad con versiones anteriores.

Fusión de Identidades de Usuario ​

Es importante entender que Verada fusionará automáticamente a los usuarios individuales que vea que tienen cualquier identidad que se superponga.

Por ejemplo:

  • Un usuario anónimo visita su sitio web por primera vez. Verada asocia una clave de usuario única con su navegador, por ejemplo, "User_1234".
  • Verada continuará identificando al usuario siempre y cuando regrese con la misma clave de usuario.
  • Más tarde, el usuario inicia sesión en el sitio web y este utiliza el sistema de gestión de identidades de Verada para informar a Verada de la identidad de usuario autenticado para el sitio web.
javascript
fanplayr_api.push({
  _type: 'identities',
  $user: {
    userId: '234902834211'
  }
});
  • A partir de este momento, Verada vinculará su clave de usuario "User_1234" con la identidad de usuario autenticado del sitio web "234902834211".
  • Más tarde, si el usuario regresa al sitio web en un dispositivo diferente o después de borrar sus datos de navegación, Verada asignará una nueva clave de usuario al usuario, por ejemplo, "User_5678".
  • Finalmente, si el usuario inicia sesión en el sitio web de nuevo y se proporciona a Verada la misma identidad de usuario autenticado de "234902834211", Verada entenderá que los usuarios "User_1234" y "User_5678" son el mismo y los fusionará para formar un único perfil e historial.

Copyright © 2011-present Verada