유저 프로필 설정

DFINERY SDK를 사용하여 유저 속성 정보를 설정하는 방법입니다. SDK 연동이 선행되어야 합니다

유저 속성 정보

시작하기 전에

유저 속성 정보를 설정하기 전에 DFINERY 콘솔에 유저 프로필 속성을 생성 후 연동해 주세요. 유저 프로필 속성은 부가 설정 / 데이터 연동 / 속성 관리 / 유저 프로필 속성 목록에서 생성할 수 있습니다.

유의사항

• 등록되지 않은 유저 프로필, 잘못된 타입의 유저 프로필 속성이 기록될 경우, 유저 프로필은 설정되지 않습니다.

• 알림 수신 동의 정보에 대한 유저 프로필은 예외적으로 DFINERY에서 서비스 생성 시 이미 자동으로 등록되어 있어 DFINERY 콘솔에서 설정하지 않아도 설정이 가능합니다.

• Array of String 타입의 유저 프로필 속성은 최대 10개까지 생성할 수 있습니다.

• Array of Long, Array of Double 타입은 최대 5개까지 생성할 수 있습니다.

• value의 입력 개수 제한은 없으나 전체 크기는 8KB를 초과할 수 없습니다.

유저 속성 정보 설정

setUserProfile

Swift

다음 메소드중 하나를 호출하여 유저 속성 정보를 설정합니다.

func set(userProfiles: [String: Any])

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

각각의 매개변수는 다음을 의미합니다.

• userProfiles : 유저 속성 정보명과 값을 갖는 딕셔너리

• key : 유저 속성 정보 명

• value : 유저 속성 정보 값

사용 예시

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)

각각의 매개변수는 다음을 의미합니다.

• Dict : 유저 속성 정보명과 값을 갖는 딕셔너리

• Key : 유저 속성 정보 명

• value : 유저 속성 정보 값

사용 예시

[[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"
}];

표준 속성 중 성별(df_gender)의 경우 다음의 사전 정의된 상수를 사용해 값을 입력해주세요

• DFGender.MALE

• DFGender.FEMALE

• DFGender.NONBINARY

• DFGender.OTHER

표준 유저 속성 정보

표준 유저 속성 정보의 경우 다음과 같이 프로필명이 사전 정의된 정적 상수로 제공됩니다.

상수명	유저 속성 정보	입력 값 타입
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)

유저 프로필 속성 중 df_birth(생년월일)의 경우 입력 값 타입을 yyyy-MM-dd의 String 타입으로 입력해 주세요. 예시: "1999-01-01"

알림 채널 수신 동의 설정

알림 채널 수신 동의 정보는 유저 속성 정보를 통해 설정합니다.

알림 수신 동의 정보를 설정해주지 않는 경우 해당 값은 null이며, null과 true일 때 발송이 가능하고, false 일 때 발송되지 않습니다. 자세한 사항은 이용 가이드 참고해주시기 바랍니다.

알림 채널 수신 동의 정보는 유저 프로필에 속해있으며 다양한 채널에 대한 수신 동의 정보 값을 설정할 수 있습니다.

다음의 사전 정의된 상수를 키로, 값은 Bool 타입으로 설정해주세요.

상수명	설명
DFUserProfile.PUSH_OPTIN	푸시 수신 동의
DFUserProfile.PUSH_ADS_OPTIN	푸시 수신 동의 (광고)
DFUserProfile.KAKAO_ADS_OPTIN	카카오 친구톡 수신 동의 (광고)
DFUserProfile.SMS_ADS_OPTIN	문자 수신 동의 (광고)
DFUserProfile.PUSH_NIGHT_ADS_OPTIN	야간 푸시 수신 동의(광고)

사용 예시

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
}];