# SDK 연동 테스트하기

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

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

{% hint style="info" %}

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

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

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

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

## **SDK 기본 연동 상태 확인**

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

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

**경로**

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

### **‘리포트 생성’ 버튼 클릭**

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

### **메트릭, 그룹바이 설정**

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

<figure><img src="https://851339439-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fw80cM0G3UdX6uGwQB5zz%2Fuploads%2FbvGKNLYRLLr6xM2Bkeua%2Fimage.png?alt=media&#x26;token=677d3623-4f4a-4b22-bb75-58a8476df0dd" alt=""><figcaption><p>예시 화면</p></figcaption></figure>

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

{% hint style="success" %}
💡 **참고사항**

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

### **적용 버튼 클릭**

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

### **세션 실행 이벤트 확인**

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

## **이벤트 연동 확인**

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

**경로**

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

### **‘리포트 생성’ 버튼 클릭**

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

### **메트릭, 그룹바이 설정**

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

<figure><img src="https://851339439-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fw80cM0G3UdX6uGwQB5zz%2Fuploads%2FOFM88NRt9SsaEQhDBa59%2Fimage.png?alt=media&#x26;token=807b48bc-cf08-4211-af0e-7092eb138f8c" alt=""><figcaption><p>예시 화면</p></figcaption></figure>

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

{% hint style="success" %}
그룹바이는 최대 3개까지 설정할 수 있습니다.
{% endhint %}

### **적용 버튼 클릭**

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

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

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

## **유저 식별 정보 확인**

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

**경로**

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

### **유저 식별 정보 검색**

**키워드 입력 > 필터 전체 > 설정한 식별자 입력**

앱 또는 웹에서 설정한 유저 식별 정보를 검색합니다.\
예를 들어, 외부ID를 *'DFNuser'*&#xB85C; 설정했다면 *'DFNuser'* 키워드로 검색합니다.

<figure><img src="https://851339439-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fw80cM0G3UdX6uGwQB5zz%2Fuploads%2FA66kgPhuanBibSzruAOx%2Fimage.png?alt=media&#x26;token=c4f0f19f-2be6-4301-9d90-4024109c5082" alt=""><figcaption></figcaption></figure>

### **유저 식별자 확인**

검색 키워드와 일치한 목록을 확인합니다.

<figure><img src="https://851339439-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fw80cM0G3UdX6uGwQB5zz%2Fuploads%2FRxCTgRG2g5sPMsHI6yho%2Fimage.png?alt=media&#x26;token=f1f659f4-5ddd-404e-b4ce-04aab83465a3" alt=""><figcaption></figcaption></figure>

## **유저 프로필 속성 정보 확인**

유저 프로필 속성은 이름, 성별과 같은 유저 속성 정보입니다.\
앱 또는 웹에서 설정한 유저 프로필 정보를 콘솔에서 확인할 수 있습니다.\
유저 프로필 속성 데이터는 설정 시점으로부터 **약 10분 이내**로 확인할 수 있습니다.

{% hint style="warning" %}
**사전 조건**

설정하려는 유저 프로필 속성은 반드시 콘솔에서 **활성화 상태**로 변경해야 합니다.\
[\[유저 프로필 속성 생성\]](https://docs.dfinery.ai/user-guide/begin-to-use-dfinery/event-and-property#undefined-16)
{% endhint %}

**경로**

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

### **유저 식별 정보 검색**

유저 프로필을 설정한 유저 식별 정보를 키워드로 검색합니다.\
ex) **외부ID :&#x20;*****DFNuser***&#xC5D0; **유저 프로필** **이름**을 ***디파이너리***&#xB85C; 설정한 경우, ***DFNuser*** 키워드 검색

{% hint style="danger" %} <mark style="color:red;">**※ 보안을 위해 내부에서 관리 목적으로 활용하는 고유 번호를 연동해주시기 바랍니다.**</mark>\ <mark style="color:red;">( ex. 외부 ID가 dfinery123이더라도, 1230102301과 같이 데이터 연동이 필요함)</mark>
{% endhint %}

### **기본 정보 페이지 진입**

키워드 검색 결과의 통합ID를 선택해 **기본 정보** 페이지로 진입합니다.

<figure><img src="https://851339439-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fw80cM0G3UdX6uGwQB5zz%2Fuploads%2FDLsTDshz26GmBfONs8Ix%2Fimage.png?alt=media&#x26;token=3db1023a-1542-49a8-a862-056696077b52" alt=""><figcaption></figcaption></figure>

### **유저 프로필 정보 확인**

앱 또는 웹페이지에서 설정한 유저 프로필 정보를 확인합니다.\
ex) 표준 유저 속성 - **이름:&#x20;*****디파이너리***

<figure><img src="https://851339439-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fw80cM0G3UdX6uGwQB5zz%2Fuploads%2FDIaWnwC212VNF1TS04mb%2Fimage.png?alt=media&#x26;token=9c0cdeb6-3c02-4715-a878-dccf0381396e" alt=""><figcaption></figcaption></figure>