Establecer atributos de usuario en el SDK de Capacitor

Puedes establecer atributos opcionales como email, número de teléfono, etc., para el usuario de tu app. Luego puedes usar estos atributos para crear segmentos de usuarios o simplemente verlos en el CRM.

Establecer atributos de usuario

Para establecer atributos de usuario, llama al método .updateProfile():


const params = {
  email: '[email protected]',
  phoneNumber: '+18888888888',
  firstName: 'John',
  lastName: 'Appleseed',
  gender: 'other',
  birthday: new Date().toISOString(),
};

try {
  await adapty.updateProfile(params);
  console.log('Profile updated successfully');
} catch (error) {
  console.error('Failed to update profile:', error);
}

Ten en cuenta que los atributos que hayas establecido previamente con el método updateProfile no se restablecerán.

¿Quieres ver un ejemplo real de cómo se integra el SDK de Adapty en una app móvil? Echa un vistazo a nuestras apps de ejemplo, que muestran la configuración completa, incluyendo la visualización de paywalls, la realización de compras y otras funcionalidades básicas.

Lista de claves permitidas

A continuación se muestran las claves permitidas de AdaptyProfileParameters y sus valores:

ClaveValor
emailString
phoneNumberString
firstNameString
lastNameString
genderEnum, los valores permitidos son: 'female', 'male', 'other'
birthdayCadena de fecha en formato ISO

Atributos de usuario personalizados

Puedes definir tus propios atributos personalizados. Generalmente están relacionados con el uso de tu app. Por ejemplo, en aplicaciones de fitness podrían ser el número de ejercicios por semana; en apps de aprendizaje de idiomas, el nivel de conocimiento del usuario, etc. Puedes usarlos en segmentos para crear paywalls y ofertas personalizadas, y también en análisis para identificar qué métricas de producto influyen más en los ingresos.


try {
  await adapty.updateProfile({
    codableCustomAttributes: {
      key_1: 'value_1',
      key_2: 2,
    },
  });
  console.log('Custom attributes updated successfully');
} catch (error) {
  console.error('Failed to update custom attributes:', error);
}

Para eliminar claves existentes, pasa null como sus valores:


try {
  // to remove keys, pass null as their values
  await adapty.updateProfile({
    codableCustomAttributes: {
      key_1: null,
      key_2: null,
    },
  });
  console.log('Custom attributes removed successfully');
} catch (error) {
  console.error('Failed to remove custom attributes:', error);
}

En ocasiones necesitas saber qué atributos personalizados ya están configurados. Para ello, utiliza el campo customAttributes del objeto AdaptyProfile.

Ten en cuenta que el valor de customAttributes puede estar desactualizado, ya que los atributos de usuario pueden enviarse desde distintos dispositivos en cualquier momento, por lo que los atributos en el servidor podrían haber cambiado desde la última sincronización.

Límites

  • Hasta 30 atributos personalizados por usuario
  • Los nombres de clave tienen un máximo de 30 caracteres. El nombre de la clave puede incluir caracteres alfanuméricos y cualquiera de los siguientes: _ - .
  • El valor puede ser una cadena o un número flotante con un máximo de 50 caracteres.