User Profile Settings

Profile information for users managed by the DFINERY server. All of this information is optional and is not stored on the terminal. SDK integration must be done first.

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 StringYou can create up to 10 user profile properties of a type.

• Array of Long, Array of Doubleyou 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 user profiles using the Dfinery.setUserProfile() method or Dfinery.setUserProfiles().

User profile properties

Constant	User profile attribute 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

setUserProfile(key, value);

Each parameter means:

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

• value: The value of the user profile to be set. nullYou can also enter it.

Set up multiple items at once

setUserProfiles(profiles)

Each parameter means:

• profiles: Dictionary with keys and values ​​of user profile attribute information

const profiles = {};
profiles[DFUserProfile.NAME] =  "TestName";
profiles[DFUserProfile.GENDER] = DFGender.MALE;
profiles[DFUserProfile.BIRTH] = "2014-05-14";
profiles[DFUserProfile.MEMBERSHIP] = "VIP";
Dfinery.setUserProfiles(profiles);

Example of use

Set a name

• Support Type

  • value : String

Javascript

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

Set gender

• Parameter Support Type

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

Javascript

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

Set up your membership

• Support Type

  • value : String

Javascript

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

Set your date of birth

• Support Type

  • value : String(yyyy-MM-dd)

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

Javascript

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

Javascript

// Set advertising notification consent for push channel
Dfinery.setUserProfile( DFUserProfile.PUSH_ADS_OPTIN, true);

Types of consent to receive notifications

Between 9 PM and 8 AM, separate nighttime advertising notification consent is required to send advertising notifications, so if you want to send messages during that time, please use the PUSH_NIGHT_ADS_OPTIN value to obtain consent. (Guide to the Information and Communications Network Act to Prevent 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 up a custom user profile

If you want to set up a custom user profile, you can do so by creating a property for the custom user profile in the DFINERY console and entering it as a key value.

• Support Type

  • key : String

  • value : String, Boolean, Number, Date, Array of String, Array of Number

Javascript

Dfinery.setUserProfile("{CUSTOM_PROFILE_KEY}", "{CUSTOM_PROFILE_VALUE}");