User Profile Settings

User profiles are profile information about users managed by the DFINERY server. All of this information is optional and is not stored on the terminal.

Before you start

Before setting up a user profile, create and link user profile properties in the DFINERY console. User profile properties can be created in Additional Settings / Data Linkage / Property Management / User Profile Property List.

Note

• If an unregistered user profile or an incorrect type of user profile property is recorded, the user profile will not be set.

• Array of String You can create up to 10 user profile properties of a type.

• Array of Long, Array of Double you can create up to 5 types.

• There is no limit to the number of values ​​entered, but the total size cannot exceed 8KB.

Set up

You can set up a user profile using the DfineryProperties.setUserProfile() methods or DfineryProperties.setUserProfiles().

User profile properties

Constant	Profile name	Detail
DFUserProfile.BIRTH	df_birth	User's birthday
DFUserProfile.GENDER	df_gender	User gender
DFUserProfile.NAME	df_name	User name
DFUserProfile.MEMBERSHIP	df_membership	User Membership

Set by item

void setUserProfile(String key, String value)

Each parameter means:

• key : The name of the user profile attribute to set. String A value of type can be entered.

• value : The value of the user profile to be set. null The following types can be entered.

  • String, Boolean, Long, Double, java.util.Date, Array of String, Array of Long, Array of Double

Java

DfineryProperties.setUserProfile("CUSTOM_USER_PROFILE", "VALUE");

Kotlin

DfineryProperties.setUserProfile("CUSTOM_USER_PROFILE", "VALUE")

Set up multiple items at once

void setUserProfiles(Map<String, Object> profiles)

• profiles : User profile to set. java.util.Map<String,Object> ou must enter the name and value in the form. profilescannot nullbe entered.

Java

Map<String, Object> profiles = new HashMap<>();
//PredefinedUserProfile
profiles.put(DFUserProfile.NAME, "JACK");//String
profiles.put(DFUserProfile.PUSH_OPTIN, true);//Boolean
//CustomUserProfile
profiles.put("custom1", 34000L);//Long
profiles.put("custom2", 42.195);//Double
profiles.put("custom3", new Date());//Date
profiles.put("custom4", new Long[]{20L,30L});//Array of Long
profiles.put("custom5", new Double[]{1.1,1.2});//Array of Double
profiles.put("custom6", new String[]{"Hello","World"});//Array of String
DfineryProperties.setUserProfiles(profiles);

Kotlin

val profiles = mapOf<String, Any>(
    //PredefinedUserProfile
    DFUserProfile.NAME to "JACK",
    DFUserProfile.PUSH_OPTIN to true,
    //CustomUserProfile
    "custom1" to 34000L,//Long
    "custom2" to 42.195,//Double
    "custom3" to Date(),//Date
    "custom4" to longArrayOf(20L, 30L),//Array of Long
    "custom5" to doubleArrayOf(1.1, 1.2),//Array of Double
    "custom6" to arrayOf<String>("Hello", "World")//Array of String
)
DfineryProperties.setUserProfiles(profiles)

Example of use

User profiles have standard key values, and DFUserProfileyou can apply them by entering constants in the key values.

Set a name

• Support Type

  • value : String

Java

DfineryProperties.setUserProfile(DFUserProfile.NAME, "John");

Kotlin

DfineryProperties.setUserProfile(DFUserProfile.NAME, "John")

Set gender

• Support Type

  • value : DFGender.MALE, DFGender.FEMALE, DFGender.NON_BINARY, DFGender.OTHER

Java

DfineryProperties.setUserProfile(DFUserProfile.GENDER, DFGender.MALE);

Kotlin

DfineryProperties.setUserProfile(DFUserProfile.GENDER, DFGender.MALE)

Set your membership level

• Support Type

  • value : String

Java

DfineryProperties.setUserProfile(DFUserProfile.MEMBERSHIP, "VIP");

Kotlin

DfineryProperties.setUserProfile(DFUserProfile.MEMBERSHIP, "VIP")

Set your date of birth

• Support Type

  • value : String(yyyy-MM-dd)

For df_birth (date of birth), please enter the input value type as a String type of yyyy-MM-dd. Example: "1999-01-01"

Java

DfineryProperties.setUserProfile(DFUserProfile.BIRTH, "1999-01-01");

Kotlin

DfineryProperties.setUserProfile(DFUserProfile.BIRTH, "1999-01-01")

Set consent information for receiving notifications

Consent to receive notifications is part of the user profile and you can set consent values ​​for various channels.

If you do not set the consent information for receiving notifications, the value is null. When it is null and true, notifications can be sent, and when it is false, notifications cannot be sent. For more information, please refer to the user guide.

User profiles for consent to receive notifications are automatically registered when creating a service in DFINERY, so they can be set up without having to set them in the DFINERY console.

• Support Type

  • key : Notification consent type (DFUserProfile)

  • value : Boolean

Java

DfineryProperties.setUserProfile(DFUserProfile.PUSH_OPTIN, true);

Kotlin

DfineryProperties.setUserProfile(DFUserProfile.PUSH_OPTIN, true)

Types of consent to receive notifications

Please use the value to obtain consent for sending advertising notifications between 9 PM and 8 AM, as separate consent for nighttime advertising notifications is required to send advertising notifications PUSH_NIGHT_ADS_OPTIN. (Information and Communications Network Act Guide for Prevention of Illegal Spam, Korea Internet & Security Agency, July 2020)

Designation	Channel	Explanation
DFUserProfile.PUSH_OPTIN	Push	Consent to receive informational notifications for push channels
DFUserProfile.PUSH_ADS_OPTIN	Push	Consent to receive promotional notifications for push channels
DFUserProfile.PUSH_NIGHT_ADS_OPTIN	Push	Consent to nightly promotional notifications for push channels
DFUserProfile.SMS_ADS_OPTIN	Message	Consent to receive promotional notifications for text channels
DFUserProfile.KAKAO_ADS_OPTIN	Friend Talk	Consent to advertising notifications for Kakao Friends Talk channel

Setting custom user properties

If you want to set a custom user attribute, you can create a custom user attribute in the corresponding user profile in the DFINERY console and set it by entering it as a key value.

Java

DfineryProperties.setUserProfile("CUSTOM_USER_PROFILE", true);

Kotlin

DfineryProperties.setUserProfile("CUSTOM_USER_PROFILE", true)

Setting custom user properties in date and time format

If you need to set the date and time format, java.util.Dateyou must use. The value you enter will be entered including the TimeZone information.

Java

//If you enter 1991.08.26 using Calendar
Calendar registeredDate = Calendar.getInstance();
registeredDate.set(Calendar.YEAR, 1991);
registeredDate.set(Calendar.MONTH, Calendar.AUGUST);
registeredDate.set(Calendar.DATE, 26);
DfineryProperties.setUserProfile("registered_date", registeredDate.getTime());

//If you input 1991.08.26 using SimpleDateFormat
SimpleDateFormat simpleDateFormat = new SimpleDateFormat("yyyy-MM-dd");
Date registeredDate = simpleDateFormat.parse("1991-08-26");
DfineryProperties.setUserProfile("registered_date", registeredDate);

Kotlin

//If you enter 1991.08.26 using Calendar
val registeredDate = Calendar.getInstance()
registeredDate[Calendar.YEAR] = 1991
registeredDate[Calendar.MONTH] = Calendar.AUGUST
registeredDate[Calendar.DATE] = 26
DfineryProperties.setUserProfile("registered_date", registeredDate.time);

//If you input 1991.08.26 using SimpleDateFormat
val simpleDateFormat = SimpleDateFormat("yyyy-MM-dd")
val registeredDate = simpleDateFormat.parse("1991-08-26")
DfineryProperties.setUserProfile("registered_date", registeredDate)