유저 프로필 설정

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

유저 속성 정보

시작하기 전에

유저 속성 정보를 설정하기 전에 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 일 때 발송되지 않습니다. 자세한 사항은 이용 가이드 참고해주시기 바랍니다.

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

• 지원 유형

  • key : 알림 수신 동의 유형(DFUserProfile)

  • value : Boolean

사용 예시

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

알림 수신 동의 유형

오후 9시 부터 오전 8시 사이에는 별도의 야간 광고성 알림 동의를 받아야 광고성 알림을 전송할 수 있으므로 해당 시간에 메시지를 발송하고 싶으실 경우 PUSH_NIGHT_ADS_OPTIN 값을 사용하여 동의를 받아 주시기 바랍니다. (불법 스팸 방지를 위한 정보통신망법 안내서, 한국인터넷진흥원, 2020.07)

명칭	채널	설명
DFUserProfile.PUSH_OPTIN	푸시	푸시 채널에 대한 정보성 알림 동의
DFUserProfile.PUSH_ADS_OPTIN	푸시	푸시 채널에 대한 광고성 알림 동의
DFUserProfile.PUSH_NIGHT_ADS_OPTIN	푸시	푸시 채널에 대한 야간 광고성 알림 동의
DFUserProfile.SMS_ADS_OPTIN	문자	문자 채널에 대한 광고성 알림 동의
DFUserProfile.KAKAO_ADS_OPTIN	친구톡	카카오 친구톡 채널에 대한 광고성 알림 동의