Identidad del usuario

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

Introducción

Fanplayr 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. Fanplayr 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 Fanplayr.

Cuando proporciona una identidad conocida a la integración de Fanplayr, Fanplayr 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 Fanplayr captura.

Identificación de Usuarios

Las identidades de usuario se comparten con Fanplayr 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 Fanplayr. También asocia atributos adicionales a través del objeto data.

{
  "$user": {
    "userId": "23872392383"
  },
  "crm1": {
    "userId": "b70115f2-aea8-456a-ab07-f9152257df4d",
    "data": {
      "key1": "value1",
      "key2": "value2"
    }
  }
}

Tipos de datos

IdentityMap

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

Identity

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:

{
  "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 Fanplayr

La Capa de Datos de Fanplayr se puede utilizar para enviar identidades a Fanplayr 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:

<!--
  Este ejemplo asume que ha definido el array de la Capa de Datos de Fanplayr
  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 Fanplayr le permite definir y gestionar proveedores de identidad. Esta información es utilizada por el servicio Streams de Fanplayr 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 Fanplayr a un CRM y desea compartir el ID de CRM del usuario con los datos que Fanplayr 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 Fanplayr 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 Fanplayr. Por ejemplo, "Salesforce".

Identidad de Usuario Autenticado

Fanplayr 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 Fanplayr para asociar la identidad del usuario autenticado con el usuario de Fanplayr:

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 Fanplayr 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. Fanplayr asocia una clave de usuario única con su navegador, por ejemplo, "User_1234".
• Fanplayr 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 Fanplayr para informar a Fanplayr de la identidad de usuario autenticado para el sitio web.

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

• A partir de este momento, Fanplayr 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, Fanplayr 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 Fanplayr la misma identidad de usuario autenticado de "234902834211", Fanplayr entenderá que los usuarios "User_1234" y "User_5678" son el mismo y los fusionará para formar un único perfil e historial.