SDK 연동 테스트하기

SDK 연동은 디파이너리 사용의 출발점입니다. 디파이너리 사용을 위해서는 SDK 연동이 반드시 필요합니다.

본 문서에서는 다음 4가지 항목과 관련해 SDK 연동 성공 여부를 확인하는 방법을 단계 별로 안내합니다.

SDK 기본 연동 상태(App/Web) SDK 설치 및 실행이 정상적으로 이루어졌는지 확인합니다.

이벤트 / 이벤트 속성 데이터 발생 여부(App/Web) App이나 Web에서 설정한 이벤트가 정상적으로 수집되었는지 확인합니다.

유저 식별 정보 로그인 또는 회원 가입 과정에서 외부ID(유저ID), 전화번호와 같은 유저 식별 정보가 정상적으로 수집되었는지 확인합니다.

유저 프로필 속성 정보 이름, 성별과 같은 유저 프로필 속성 정보가 정상적으로 수집되었는지 확인합니다.

SDK 기본 연동 상태 확인

SDK가 정상적으로 설치되고 실행된다면 앱을 실행하거나 웹에 접속했을 때 세션 실행(df_start_session) 이벤트가 자동 호출됩니다.

앱 실행 or 웹 접속 후, 아래 절차에 따라 세션 실행(df_start_session) 이벤트 호출 여부를 확인하여 SDK 연동 상태를 확인합니다. 콘솔 내 리포트에서 앱 실행/웹페이지 접속 후 약 30분 이내로 확인할 수 있습니다.

경로

콘솔 좌측 메뉴 : 분석 > 리포트

‘리포트 생성’ 버튼 클릭

우측 상단 ‘+리포트 생성’ 버튼을 클릭해 새로운 리포트를 생성합니다.

메트릭, 그룹바이 설정

리포트 생성 페이지의 우측 영역에서 메트릭, 그룹바이를 아래와 같이 설정합니다.

메트릭 : 전체 이벤트 / 횟수
그룹바이 > 이벤트/이벤트 속성 : DFN 라이브러리 플랫폼, 이벤트 명, 디바이스 모델 예시 화면에서 각 그룹바이 항목에서 확인되는 데이터는 다음과 같습니다.
- DFN 라이브러리 플랫폼 : Android, iOS, Web
- 이벤트명 : 세션 실행
- 디바이스 모델 : ex) SM-G960N / iPhone13,2 / Chrome

💡 참고사항

디바이스 모델은 아래 방법으로 확인할 수 있습니다.
- Android 디바이스 모델 확인 방법 : 설정 > 휴대전화 정보 > 모델명 확인
- iOS 디바이스 모델 확인 방법 :
  1. 설정 > 일반 > 정보 > 모델 번호 확인
  2. [iOS 디바이스 모델] 리스트에서 모델 번호와 Identifier 컬럼 비교
WEB SDK 연동 확인 시 그룹바이에 디바이스 모델 대신 “브라우저”를 추가해 확인합니다.
- 그룹바이 > 이벤트/이벤트 속성 : DFN 라이브러리 플랫폼, 이벤트 명, 브라우저

적용 버튼 클릭

우측 하단에 ‘적용’ 버튼을 클릭해 리포트 데이터를 불러옵니다.

세션 실행 이벤트 확인

생성된 리포트를 시간 별(24시간)로 선택합니다. 테스트를 진행한 시간에 테스트 디바이스 또는 브라우저에서 세션 실행(df_start_session) 이벤트가 수집되었는지 확인합니다.

이벤트 연동 확인

앱 또는 웹에서 발생한 이벤트와 이벤트 속성 데이터를 콘솔 리포트에서 직접 확인할 수 있습니다. 리포트는 앱, 웹에서 이벤트를 호출한 후 약 30분 뒤에 확인할 수 있습니다.

경로

콘솔 좌측 메뉴 : 분석 > 리포트

‘리포트 생성’ 버튼 클릭

우측 상단 ‘+리포트 생성’ 버튼을 클릭해 새로운 리포트를 생성합니다.

메트릭, 그룹바이 설정

리포트 생성 페이지의 우측 영역에서 메트릭, 그룹바이를 아래와 같이 설정합니다.

메트릭 : 전체 이벤트 / 횟수
그룹바이 > 이벤트/이벤트 속성 : DFN 라이브러리 플랫폼, 이벤트 명, 이벤트 속성(ex. 주문 번호(ID)) 예시 화면에서 각 그룹바이 항목에서 확인되는 데이터는 다음과 같습니다.
- DFN 라이브러리 플랫폼 : Android, iOS, Web
- 이벤트 명 : 로그인, 구매, 장바구니 담기 등
- 이벤트 속성 : 이벤트 속성값

그룹바이는 최대 3개까지 설정할 수 있습니다.

적용 버튼 클릭

우측 하단에 ‘적용’ 버튼을 클릭해 리포트 데이터를 불러옵니다.

이벤트명, 이벤트 속성 데이터 확인

생성된 리포트를 시간별(24시간)로 선택합니다. 테스트를 진행한 시간에 호출했던 이벤트와 이벤트 속성 데이터를 확인합니다.

유저 식별 정보 확인

유저 식별 정보는 유저를 구분하는 데이터로, 외부ID(유저ID), 이메일, 핸드폰번호, 카카오ID, 라인ID 등이 해당합니다. 앱 또는 웹에서 설정한 유저 식별 정보는 콘솔 내 유저 프로필 목록에서 유저 식별 정보를 설정한 후 약 5분 이내로 확인할 수 있습니다.

경로

콘솔 좌측 메뉴 : 고객 > 유저 프로필 360