User Profile Settings

How to set user property information using DFINERY SDK. SDK integration must be done first.

User property information

Before you start

Before setting user attribute information, create and link user profile attributes in the DFINERY console. User profile attributes can be created in Additional Settings / Data Linkage / Attribute Management / User Profile Attribute List.

Note

• If an unregistered user profile or an incorrect type of user profile attribute 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.

Setting user property information

setUserProfile

Swift

Set user property information by calling one of the following methods:

func set(userProfiles: [String: Any])

func setUserProfile(key: String, value: Any?)

Each parameter means:

• userProfiles: A dictionary with user attribute information names and values.

• key: User property information name

• value: User property information value

Example of use

Dfinery.shared().setUserProfile(key: DFUserProfile.GENDER, value: DFGender.MALE)
            
Dfinery.shared().setUserProfile(key: "custom_key", value: "custom_value")
            
Dfinery.shared().set(userProfiles: [DFUserProfile.NAME: "Jimmy",
                                    "custom_user_profile": 100])

Objective-C

setUserProfileWithDict:(NSDictionary<NSString *,id> * _Nonnull)

setUserProfileForKey:(NSString * _Nonnull) value:(id _Nullable)

Each parameter means:

• Dict: A dictionary with user attribute information names and values.

• Key: User property information name

• value: User property information value

Example of use

[[Dfinery shared] setUserProfileForKey:DFUserProfile.GENDER  value:DFGender.MALE];
    
[[Dfinery shared] setUserProfileForKey:@"custom_key" value:@"custome_value"];
    
[[Dfinery shared] setUserProfileWithDict:@{
    @"custom_key": @"value",
    DFUserProfile.NAME: @"Jimmy"
}];

For the standard attribute gender (df_gender), please enter a value using the following predefined constants.

• DFGender.MALE

• DFGender.FEMALE

• DFGender.NONBINARY

• DFGender.OTHER

Standard user property information

For standard user property information, the profile name is provided as a predefined static constant as follows:

Constant name	User property information	Input value type
DFUserProfile.NAME	df_name	String
DFUserProfile.BIRTH	df_birth	String(yyyy-MM-dd)
DFUserProfile.MEMBERSHIP	df_membership	String
DFUserProfile.GENDER	df_gender	DFGender.xxxxx(String)

For the user profile attribute df_birth (date of birth), please enter the input value type as a String type of yyyy-MM-dd. Example: "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

Example of use

Swift

Dfinery.shared().setUserProfile(key: DFUserProfile.PUSH_OPTIN, value: true)
Dfinery.shared().setUserProfile(key: DFUserProfile.PUSH_ADS_OPTIN, value: true)
Dfinery.shared().setUserProfile(key: DFUserProfile.PUSH_NIGHT_ADS_OPTIN, value: false)

//or

Dfinery.shared().set(userProfiles: [
    DFUserProfile.PUSH_OPTIN: true,
    DFUserProfile.PUSH_ADS_OPTIN: true,
    DFUserProfile.PUSH_NIGHT_OPTIN: false,
])

Objective-C

[[Dfinery shared] setUserProfileForKey:DFUserProfile.PUSH_OPTIN value:@YES];
[[Dfinery shared] setUserProfileForKey:DFUserProfile.PUSH_ADS_OPTIN value:@YES];
[[Dfinery shared] setUserProfileForKey:DFUserProfile.PUSH_NIGHT_ADS_OPTIN value:@NO];

//or

[[Dfinery shared] setUserProfileWithDict:@{
    DFUserProfile.PUSH_OPTIN: @YES,
    DFUserProfile.PUSH_ADS_OPTIN: @YES,
    DFUserProfile.PUSH_NIGHT_ADS_OPTIN: @NO
}];

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