Datos del Perfil de Usuario

Los datos pueden almacenarse en el Perfil de un usuario y luego utilizarse en todo el sistema. Estos atributos pueden incluir Atributos de Usuario Semánticos.

Las operaciones sobre los datos del Perfil de usuario utilizan el tipo de mensaje userDataOps.

Operaciones

El parámetro operations acepta un arreglo de operaciones. Estas pueden ser de los siguientes tipos:

• set - establece un atributo del Perfil a un valor dado
• setOnce - establece un atributo del Perfil a un valor dado si actualmente no existe
• unset - elimina un atributo del Perfil
• increment - incrementa un atributo del Perfil en una cantidad entera dada

Puede enviar tantas operaciones como sea necesario a la vez, y pueden ser de más de un tipo.

Caducidad

Tanto set como setOnce permiten proporcionar una propiedad expiresOn. Esta debe ser un número entero de tiempo epoch UTC en milisegundos.

Set

Utilice esto para establecer un atributo en un Perfil.

Ejemplo

Este ejemplo establece el atributo favoriteColor a red. Esta propiedad del Perfil caducará a principios de 2024.

{
  "type": "userDataOps",
  // las operaciones
  "operations": [{
    "type": "set",
    "key": "favoriteColor",
    "value": "red",
    "expiresOn": 1704139200000
  }],
  // propiedades generales del mensaje
  "writeKey": "<WRITE_KEY>",
  "messageId": "213d7f53-ffac-4a58-a20b-5d609455d64c",
  "timestamp": "2022-11-15T04:31:44Z",
  "userId": "5.wBOQ7hKNVgIUcJn5IbX.1670273082",
  "sessionId": "28eef5c8-1098-4f76-abe9-58a921cabfaf",
  "pageId": "eca34e0f-4802-4fa4-8db1-11c727839dbd"
  "context": {
    "page": {
      "url": "https://www.weather-station.com/",
      "path": "/",
      "referrer": "",
      "title": "Weather Station - Get Weather"
    },
  }
}

Set Once

Utilice esto para establecer un atributo en un Perfil solo si aún no se ha establecido.

Ejemplo

Este ejemplo, si se ejecuta después del ejemplo set, no cambiará el atributo del Perfil, ya que el valor ya ha sido establecido.

{
  "type": "userDataOps",
  // las operaciones
  "operations": [{
    "type": "setOnce",
    "key": "favoriteColor",
    "value": "green"
  }],
  // propiedades generales del mensaje
  "writeKey": "<WRITE_KEY>",
  "messageId": "213d7f53-ffac-4a58-a20b-5d609455d64c",
  "timestamp": "2022-11-15T04:31:44Z",
  "userId": "5.wBOQ7hKNVgIUcJn5IbX.1670273082",
  "sessionId": "28eef5c8-1098-4f76-abe9-58a921cabfaf",
  "pageId": "eca34e0f-4802-4fa4-8db1-11c727839dbd"
  "context": {
    "page": {
      "url": "https://www.weather-station.com/",
      "path": "/",
      "referrer": "",
      "title": "Weather Station - Get Weather"
    },
  }
}

Unset

Utilice esto para eliminar un atributo de un Perfil.

Ejemplo

Este ejemplo eliminó el atributo favoriteColor.

{
  "type": "userDataOps",
  // las operaciones
  "operations": [{
    "type": "unset",
    "key": "favoriteColor"
  }],
  // propiedades generales del mensaje
  "writeKey": "<WRITE_KEY>",
  "messageId": "213d7f53-ffac-4a58-a20b-5d609455d64c",
  "timestamp": "2022-11-15T04:31:44Z",
  "userId": "5.wBOQ7hKNVgIUcJn5IbX.1670273082",
  "sessionId": "28eef5c8-1098-4f76-abe9-58a921cabfaf",
  "pageId": "eca34e0f-4802-4fa4-8db1-11c727839dbd"
  "context": {
    "page": {
      "url": "https://www.weather-station.com/",
      "path": "/",
      "referrer": "",
      "title": "Weather Station - Get Weather"
    },
  }
}

Increment

Utilice esto para incrementar un valor en un atributo del Perfil.

WARNING

Si ya existe un atributo con ese nombre, y no es un número entero, el valor también se establecerá en 1. Esto es cierto incluso si el valor es una cadena de "1" en lugar del valor real de 1. Además, los valores flotantes como 10.5 se restablecerán a 1 en la primera llamada de incremento.

Ejemplo

Este ejemplo incrementará el atributo numberOfLoginAttempts en 1.

{
  "type": "userDataOps",
  // las operaciones
  "operations": [{
    "type": "increment",
    "key": "numberOfLoginAttempts",
    "value": 1
  }],
  // propiedades generales del mensaje
  "writeKey": "<WRITE_KEY>",
  "messageId": "213d7f53-ffac-4a58-a20b-5d609455d64c",
  "timestamp": "2022-11-15T04:31:44Z",
  "userId": "5.wBOQ7hKNVgIUcJn5IbX.1670273082",
  "sessionId": "28eef5c8-1098-4f76-abe9-58a921cabfaf",
  "pageId": "eca34e0f-4802-4fa4-8db1-11c727839dbd"
  "context": {
    "page": {
      "url": "https://www.weather-station.com/",
      "path": "/",
      "referrer": "",
      "title": "Weather Station - Get Weather"
    },
  }
}