개발자 가이드
사용자 가이드개발자 가이드API 가이드🏠
한국어
한국어
  • 홈
  • 공통
    • 통합 ID 연동 시나리오
    • 상수
    • FAQ
  • 플랫폼 별 가이드
    • Android
      • 연동하기
      • 이벤트
      • 유저 식별 정보 설정
      • 유저 프로필 설정
      • 액션
        • 푸시
        • 인앱메시지
        • 알림톡
        • 문자
      • 개인 정보 보호
        • 개인 정보 보호 지원
        • Google Play의 데이터 공개 요건 준비
      • 릴리즈 노트
    • iOS
      • 연동하기
      • 이벤트
      • 유저 식별 정보 설정
      • 유저 프로필 설정
      • 액션
        • 푸시
        • 인앱메시지
        • 알림톡
        • 문자
      • 릴리즈 노트
    • Hybrid App
      • 연동하기
    • Web
      • 연동하기
      • 이벤트
      • 유저 식별 정보 설정
      • 유저 프로필 설정
      • 액션
        • 인앱메시지
        • 알림톡
        • 문자
      • 고급 사용 사례
        • 부가 설정
      • 릴리즈 노트
Powered by GitBook
On this page
  • 유저 속성 정보
  • 시작하기 전에
  • 유의사항
  • 유저 속성 정보 설정
  • 알림 수신 동의 정보 설정하기
  • 사용 예시
  1. 플랫폼 별 가이드
  2. iOS

유저 프로필 설정

Previous유저 식별 정보 설정Next액션

Last updated 4 months ago

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

유저 속성 정보

시작하기 전에

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

유의사항

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

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

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

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

유저 속성 정보 설정

setUserProfile

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

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])
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"

알림 수신 동의 정보 설정하기

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

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

  • 지원 유형

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

    • value : Boolean

사용 예시

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,
])
[[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

친구톡

카카오 친구톡 채널에 대한 광고성 알림 동의

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

SDK 연동
DFINERY 콘솔
이용 가이드