User GuideDeveloper GuideAPI Guide🏠

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

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.

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);

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

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

Set gender

  • Support Type

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

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

Set your membership level

  • Support Type

    • value : String

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"

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

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.

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.

//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);
PreviousSet User Identification InformationNextAction

Last updated