# 이벤트 택소노미 설계하기

<figure><img src="/files/ZNI2lW7jtmipygBdvDRJ" alt=""><figcaption></figcaption></figure>

## **택소노미란?**

택소노미(Taxonomy)란 디파이너리에서 <mark style="background-color:green;">**정의한 바에 따라 데이터를 분류하는 일관된 체계**</mark>를 의미합니다.\
이는 데이터를 체계적으로 분류하고 관리하는 것을 목적으로 하는 기준입니다.\
체계적인 이벤트 및 속성 데이터의 택소노미를 설계하는 것은 DFINERY를 이용하기 위한 <mark style="background-color:purple;">**'첫 단추'**</mark>입니다.\
서비스 초기 단계부터 어떤 데이터를 연동할지 명확히 결정하고, 이를 분석과 CRM에 효과적으로 활용할 수 있도록 계획하는 것이 중요합니다.

## **택소노미 설계가 중요한 이유**

* 사전에 정의된 체계를 통해 데이터를 수집하면, 내부에서 혼선이 발생할 가능성을 줄일 수 있습니다.
* 명확한 기준과 합의 없이 데이터가 연동되면 문제가 발생할 수 있으며, 이를 사전에 방지하는 것으로 자칫 번거롭고 복잡할 수 있는 재연동 작업을 피할 수 있습니다.
* 데이터를 어떤 기준과 방식으로 수집하는지 명확히 알 수 있어, CRM 캠페인 등 추가적인 활용 계획을 세우는 데 도움을 줍니다.

## **택소노미 설계 및 연동의 기본 순서**

<figure><img src="/files/TdPGT4GIapNNVbNDvY95" alt=""><figcaption></figcaption></figure>

### **1단계**

<table data-view="cards"><thead><tr><th></th><th></th><th></th></tr></thead><tbody><tr><td>표준 이벤트</td><td>필요한 이벤트 선택하여 생성</td><td></td></tr><tr><td>표준 이벤트 속성</td><td>필요한 이벤트 속성 선택하여 생성</td><td></td></tr><tr><td>표준 유저 프로필 속성</td><td>필요한 표준 유저 프로필 속성 선택하여 생성</td><td></td></tr></tbody></table>

### **2단계**

<table data-view="cards"><thead><tr><th></th><th></th><th></th></tr></thead><tbody><tr><td>필요에 따라 자사 서비스에 맞는 커스텀 이벤트 생성</td><td></td><td></td></tr><tr><td>필요에 따라 자사 서비스에 맞는 커스텀 이벤트 속성 생성</td><td></td><td></td></tr><tr><td>필요에 따라 자사 서비스에 맞는 커스텀 유저 프로필 속성 생성</td><td></td><td></td></tr></tbody></table>

### **3단계**

<table data-view="cards"><thead><tr><th></th><th></th><th></th></tr></thead><tbody><tr><td>1단계와 2단계에서 등록한 이벤트 및 속성들을 개발팀을 통해 실제 데이터연동</td><td></td><td></td></tr></tbody></table>

## **디파이너리 제공 이벤트 및 속성 항목**

### **표준 이벤트**

<table><thead><tr><th width="227">이벤트/속성명</th><th width="144">표기명</th><th width="424">설명 </th></tr></thead><tbody><tr><td>df_sign_up</td><td>회원가입</td><td>유저가 서비스에 회원으로 가입하는 동작</td></tr><tr><td>df_logout</td><td>로그아웃</td><td>유저가 앱에서 로그아웃하는 동작</td></tr><tr><td>df_login</td><td>로그인</td><td>유저가 앱에 로그인하는 동작</td></tr><tr><td>df_add_payment_info</td><td>구매 정보 입력</td><td>유저가 구매 정보를 입력하는 동작</td></tr><tr><td>df_view_cart</td><td>장바구니 조회</td><td>유저가 장바구니를 조회하는 동작</td></tr><tr><td>df_remove_cart</td><td>장바구니 삭제</td><td>유저가 장바구니에서 상품을 삭제하는 동작</td></tr><tr><td>df_view_list</td><td>상품 목록 조회</td><td>유저가 상품 목록을 조회하는 동작</td></tr><tr><td>df_share_product</td><td>상품 공유하기</td><td>상품유저가 상품을 공유하는 동작</td></tr><tr><td>df_view_search_result</td><td>상품 검색하기</td><td>상유저가 상품을 검색하여 결과를 확인하는 동작</td></tr><tr><td>df_refund</td><td>주문 취소하기</td><td>유저가 주문을 취소하는 동작</td></tr><tr><td>df_add_to_wishlist</td><td>관심 상품 추가</td><td>유저가 상품을 관심 목록에 추가하는 동작</td></tr><tr><td>df_add_to_cart</td><td>장바구니 담기</td><td>유저가 상품을 장바구니에 담는 동작</td></tr><tr><td>df_view_product_details</td><td>상품 상세 보기</td><td>유저가 특정 상품의 상세 정보를 조회하는 동작</td></tr><tr><td>df_view_home</td><td>홈 화면 조회</td><td>유저가 앱 또는 웹의 홈 화면을 조회하는 동작</td></tr><tr><td>df_purchase</td><td>구매</td><td>유저가 상품이나 서비스를 구매하는 동작</td></tr><tr><td>df_end_session</td><td>세션 종료</td><td>세션이 종료되는 동작(SDK 전용)</td></tr><tr><td>df_start_session</td><td>세션 실행</td><td>세션이 실행되는 동작(SDK 전용)</td></tr></tbody></table>

### **표준 이벤트 속성**

<table><thead><tr><th width="180">이벤트/속성명</th><th width="149">표기명</th><th width="114">데이터 타입</th><th>설명 </th></tr></thead><tbody><tr><td>df_delivery_charge </td><td>배송료</td><td>Double</td><td>주문에 부과된 배송료</td></tr><tr><td>df_payment_method</td><td>결제 방법</td><td>String</td><td>주문에 사용된 결제 방법</td></tr><tr><td>df_order_id </td><td>주문 번호(ID)</td><td>String</td><td>주문을 식별하는 고유한 번호 또는 ID</td></tr><tr><td>df_sign_channel</td><td>회원가입 채널</td><td>String</td><td>회원가입에 사용된 채널</td></tr><tr><td>df_total_purchase_amount</td><td>주문 총액</td><td>Double</td><td>주문의 총액</td></tr><tr><td>df_total_refund_amount</td><td>환불(취소) 총액</td><td>Double</td><td>주문에 대한 총 환불 또는 취소 금액</td></tr><tr><td>df_discount</td><td>상품 할인가</td><td>Double</td><td>상품에 적용된 할인가</td></tr><tr><td>df_sharing_channel</td><td>상품공유 채널</td><td>String</td><td>상품 공유에 사용된 채널</td></tr><tr><td>df_keyword </td><td>검색 키워드</td><td>String</td><td>주문이 이뤄진 시점에 사용된 검색 키워드</td></tr><tr><td><em><mark style="color:green;"><strong>df_items</strong></mark></em></td><td>상품</td><td>List of Object</td><td>각 상품의 정보를 담고 있는 배열</td></tr><tr><td>df_items.[n].df_item_id</td><td>상품 번호(ID)</td><td>String</td><td><em><mark style="color:green;">df_items의 하위 속성</mark></em><br>각 상품을 식별하는 고유한 번호 또는 ID</td></tr><tr><td>df_items.[n].df_item_name</td><td>상품명</td><td>String</td><td><em><mark style="color:green;">df_items의 하위 속성</mark></em><br>각 상품의 이름</td></tr><tr><td>df_items.[n].df_quantity</td><td>상품 수량</td><td>Long</td><td><em><mark style="color:green;">df_items의 하위 속성</mark></em><br>각 상품의 주문 수량</td></tr><tr><td>df_items.[n].df_price</td><td>상품 단가</td><td>Double</td><td><em><mark style="color:green;">df_items의 하위 속성</mark></em><br>각 상품의 단가</td></tr><tr><td>df_items.[n].df_discount</td><td>상품 할인가</td><td>Double</td><td><em><mark style="color:green;">df_items의 하위 속성</mark></em><br>상품에 적용된 할인가</td></tr><tr><td>df_items.[n].df_category1</td><td>상품 카테고리1</td><td>String</td><td><em><mark style="color:green;">df_items의 하위 속성</mark></em><br>상품의 다중 카테고리 분류를 위한 속성</td></tr><tr><td>df_items.[n].df_category2</td><td>상품 카테고리2</td><td>String</td><td><em><mark style="color:green;">df_items의 하위 속성</mark></em><br>상품의 다중 카테고리 분류를 위한 속성</td></tr><tr><td>df_items.[n].df_category3</td><td>상품 카테고리3</td><td>String</td><td><em><mark style="color:green;">df_items의 하위 속성</mark></em><br>상품의 다중 카테고리 분류를 위한 속성</td></tr><tr><td>df_items.[n].df_category4</td><td>상품 카테고리4</td><td>String</td><td><em><mark style="color:green;">df_items의 하위 속성</mark></em><br>상품의 다중 카테고리 분류를 위한 속성</td></tr><tr><td>df_items.[n].df_category5</td><td>상품 카테고리5</td><td>String</td><td><em><mark style="color:green;">df_items의 하위 속성</mark></em><br>상품의 다중 카테고리 분류를 위한 속성</td></tr></tbody></table>

### **표준 유저 프로필 속성**

<table><thead><tr><th width="169">이벤트/속성명</th><th width="102">표기명</th><th width="123">데이터 타입</th><th>설명</th></tr></thead><tbody><tr><td>df_name</td><td>이름</td><td>String</td><td>유저의 이름입니다. 보통 실명 또는 사용자가 지정한 닉네임이 저장됩니다.</td></tr><tr><td>df_gender</td><td>성별</td><td>String<br>(Enum)</td><td>유저의 성별을 의미하며 주로 여성, 남성 혹은 기타와 같은 값이 저장됩니다.<br><br>지원 값:<br>Male, Female, NonBinary, Other</td></tr><tr><td>df_birth</td><td>생년월일</td><td>Datetime</td><td>유저의 생년월일을 의미하며 주로 YYYY-MM-DD 형식이나 일반적인 날짜 형식으로 저장됩니다.</td></tr><tr><td>df_membership</td><td>회원 등급</td><td>String</td><td>주로 유저의 활동이나 구매 이력에 따라 결정되며, 회원에 따라 다양한 혜택을 제공할 수 있습니다.</td></tr><tr><td>df_age</td><td>만 나이</td><td>Long</td><td>생년월일 정보를 사용하여 계산된 값으로, 주로 정수 형태로 저장됩니다.<br>※ 해당 속성은 최초 생년월일 수집 시 계산되며 이후 월마다 자동 계산됩니다.</td></tr><tr><td>df_age_group</td><td>연령대</td><td>String<br>(Enum)</td><td>유저의 연령을 연령대로 그룹화한 정보를 의미합니다.<br>※ 해당 속성은 최초 생년월일 수집 시 계산되며 이후 월마다 자동 계산됩니다.<br><br>지원 값:<br>~12<br>13~18<br>19~24<br>25~29<br>30~34<br>35~39<br>40~44<br>45~49<br>50~54<br>55~59<br>60~64<br>65~</td></tr></tbody></table>

### **표준 유저 식별자 속성**

<table><thead><tr><th width="178">이벤트/속성명</th><th width="119">표기명</th><th width="114">데이터 타입</th><th>설명</th></tr></thead><tbody><tr><td>df_unified_id</td><td>통합 ID</td><td>String</td><td>여러 가지 개인 식별 정보를 하나의 ID로 통합하여 유저를 고유하게 식별하기 위한 식별자</td></tr><tr><td>df_external_id</td><td>외부 ID</td><td>String</td><td>외부의 모든 시스템 형식을 따르는 고유한 ID 식별자<br><mark style="color:red;"><strong>※ 보안을 위해 내부에서 관리 목적으로 활용하는 고유 번호를 연동해주시기 바랍니다.</strong></mark><br><mark style="color:red;">( ex. 외부 ID가 dfinery123이더라도, 1230102301과 같이 데이터 연동이 필요함)</mark></td></tr><tr><td>df_phone_no</td><td>전화번호</td><td>String</td><td>식별자로 사용되는 전화번호</td></tr><tr><td>df_email</td><td>이메일</td><td>String</td><td>식별자로 사용되는 이메일</td></tr><tr><td>df_kakao_user_id</td><td>카카오 ID</td><td>String</td><td>카카오톡 메신저나 다른 카카오 서비스에서 사용되는 고유한 식별자</td></tr><tr><td>df_line_user_id</td><td>라인 ID</td><td>String</td><td>라인 메신저나 다른 라인 서비스에서 사용되는 사용자의 고유한 식별자</td></tr></tbody></table>

### **채널 수신 동의 속성**

{% hint style="danger" %}
**(필독) 마케팅 수신 동의 참고**

* null과 true일 때 발송이 가능합니다.
* false일 경우 발송이 불가합니다.
* *<mark style="color:red;background-color:yellow;">**수신 동의 값이 없을 경우(null) 메시지가 발송될 수 있으므로,**</mark>*\
  *<mark style="color:red;background-color:yellow;">**값(true 또는 false)을 디파이너리로 정확히 전달해주어야 합니다.**</mark>*
* 마케팅 수신 동의 여부 값은 API를 통해 최신화된 상태를 유지해주시기 바랍니다.
* 오프라인 데이터 연동 시에도 마케팅 수신 동의 값에 유의해주시기 바랍니다.
* 연동 시에도 관련 개발 문서를 반드시 참고하여 진행해주시기 바랍니다.\
  [<mark style="color:blue;">**- 알림 수신 동의 정보 설정하기(Android)**</mark>](https://docs.dfinery.ai/developer-guide/platform/android/user-profile#consent)\
  [<mark style="color:blue;">**- 알림 수신 동의 정보 설정하기(iOS)**</mark>](https://docs.dfinery.ai/developer-guide/platform/ios/user-profile#undefined-5)\
  [<mark style="color:blue;">**- 알림 수신 동의 정보 설정하기(Web)**</mark>](https://docs.dfinery.ai/developer-guide/platform/web/user_profile#consent)
  {% endhint %}

<table><thead><tr><th width="154">이벤트/속성명</th><th width="207">표기명</th><th width="114">데이터 타입</th><th>설명 </th></tr></thead><tbody><tr><td>df_push_optin</td><td>푸시 수신 동의</td><td>Boolean</td><td>유저가 애플리케이션 또는 웹사이트로부터 푸시 메세지의 정보성 알림 수신에 대한 동의 여부<br><br><mark style="background-color:yellow;"><strong>기본값 : null</strong></mark></td></tr><tr><td>df_push_ads_optin</td><td>푸시 수신 동의<br>(광고)</td><td>Boolean</td><td>유저가 애플리케이션 또는 웹사이트로부터 푸시 메세지의  광고성 알림 수신에 대한 동의 여부<br><br><mark style="background-color:yellow;"><strong>기본값 : null</strong></mark></td></tr><tr><td>df_sms_ads_optin</td><td>문자 수신 동의<br>(광고)</td><td>Boolean</td><td>유저가 SMS를 통한 광고성 알림 수신에 대한 동의 여부<br><br><mark style="background-color:yellow;"><strong>기본값 : null</strong></mark></td></tr><tr><td>df_kakao_ads_optin</td><td>카카오 친구톡 수신 동의<br>(광고)</td><td>Boolean</td><td>유저가 카카오(Kakao) 메시징 서비스를 통한 광고성 알림 수신에 대한  동의 여부<br><br>카카오 ‘친구톡’만 광고성 수신 동의 flag가 필요<br>→ 명확하게 ‘친구톡’ 채널 명시<br><br><mark style="background-color:yellow;"><strong>기본값 : null</strong></mark></td></tr><tr><td>df_push_night_ads_optin</td><td>야간 푸시 수신 동의<br>(광고)</td><td>Boolean</td><td>유저가 밤 시간에 푸시 메시지 형태의 광고성 알림을 받는 것에 동의 여부<br>(오후 9시 ~ 익일 오전 8시)<br><br><mark style="background-color:yellow;"><strong>기본값 : null</strong></mark></td></tr></tbody></table>

## **커스텀 이벤트 및 속성 예시(분야 별)**

{% tabs %}
{% tab title="커머스" %}
**추천 이벤트 및 속성 예시**

<table><thead><tr><th width="188">이벤트</th><th width="146">표기명</th><th width="221">설명 </th><th>하위 속성</th></tr></thead><tbody><tr><td><em>get_coupon</em></td><td>쿠폰 발급</td><td>유저가 쿠폰을 발급받음</td><td>쿠폰가액</td></tr><tr><td></td><td></td><td></td><td>쿠폰 할인률</td></tr><tr><td><em>remove_from_cart</em></td><td>장바구니 삭제</td><td>유저가 특정 상품을 장바구니에서 삭제하는 동작</td><td>상품명</td></tr><tr><td></td><td></td><td></td><td>상품 가격</td></tr><tr><td></td><td></td><td></td><td>상품 카테고리</td></tr><tr><td></td><td></td><td></td><td>상품 브랜드</td></tr><tr><td></td><td></td><td></td><td>상품 컬러</td></tr></tbody></table>
{% endtab %}

{% tab title="금융" %}
**추천 이벤트 및 속성 예시**

<table><thead><tr><th width="188">이벤트</th><th width="146">표기명</th><th width="221">설명 </th><th>하위 속성</th></tr></thead><tbody><tr><td><em>open_account</em></td><td>계좌 개설</td><td>유저가 계좌 개설을 완료함</td><td>계좌명</td></tr><tr><td></td><td></td><td></td><td>지점명</td></tr><tr><td></td><td></td><td></td><td>카드발급여부</td></tr><tr><td>issue_card</td><td>카드 발급</td><td>유저가 카드를 발급받음</td><td>카드명</td></tr><tr><td></td><td></td><td></td><td>담당자</td></tr><tr><td></td><td></td><td></td><td>지점명</td></tr><tr><td></td><td></td><td></td><td>한도</td></tr></tbody></table>
{% endtab %}

{% tab title="F\&B" %}
**추천 이벤트 및 속성 예시**

<table><thead><tr><th width="140">이벤트</th><th width="113">표기명</th><th width="263">설명 </th><th>하위 속성</th></tr></thead><tbody><tr><td><em>order</em></td><td>음식 주문</td><td>유저가 매장 방문하여 음식 주문</td><td>주문 메뉴</td></tr><tr><td></td><td></td><td></td><td>주문 금액</td></tr><tr><td></td><td></td><td></td><td>매장 위치 지역</td></tr><tr><td></td><td></td><td></td><td>매장명</td></tr><tr><td><em>order_in</em></td><td>배달 주문</td><td>유저가 음식 배달을 주문함</td><td>주문 메뉴</td></tr><tr><td></td><td></td><td></td><td>주문 금액</td></tr><tr><td></td><td></td><td></td><td>주문 지역</td></tr><tr><td></td><td></td><td></td><td>쿠폰 금액</td></tr></tbody></table>
{% endtab %}

{% tab title="건강" %}
**추천 이벤트 및 속성 예시**

<table><thead><tr><th width="149">이벤트</th><th width="181">표기명</th><th width="234">설명 </th><th>하위 속성</th></tr></thead><tbody><tr><td><em>10000_steps</em></td><td>1만보 걷기 완료</td><td>유저가 1만보 걷기를 완료함</td><td>소요 시간</td></tr><tr><td></td><td></td><td></td><td>총 걸음 수</td></tr><tr><td><em>check_up</em></td><td>건강검진</td><td>유저가 건강검진을 받고 그 결과를 동기화함</td><td>주의 항목</td></tr><tr><td></td><td></td><td></td><td>위험 항목</td></tr><tr><td></td><td></td><td></td><td>질병</td></tr><tr><td><em>self_report</em></td><td>셀프 건강 정보 입력</td><td>유저가 직접 자신의 건강 정보를 입력함</td><td>키</td></tr><tr><td></td><td></td><td></td><td>체중</td></tr></tbody></table>
{% endtab %}

{% tab title="게임" %}
**추천 이벤트 및 속성 예시**

<table><thead><tr><th width="215">이벤트</th><th width="156">표기명</th><th width="163">설명 </th><th>하위 속성</th></tr></thead><tbody><tr><td><em>tutorial_complete</em></td><td>튜토리얼 완료</td><td>-</td><td>획득 보상</td></tr><tr><td></td><td></td><td></td><td>소요 시간</td></tr><tr><td><em>party_quest_complete</em></td><td>파티 퀘스트 완료</td><td>-</td><td>획득 보상</td></tr><tr><td></td><td></td><td></td><td>소요 시간</td></tr><tr><td></td><td></td><td></td><td>처치 몬스터 수</td></tr><tr><td></td><td></td><td></td><td>파티원 수</td></tr><tr><td></td><td></td><td></td><td>결과 등급</td></tr></tbody></table>
{% endtab %}
{% endtabs %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.dfinery.ai/user-guide/begin-to-use-dfinery/event-and-property/taxonomy.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.