이 문서는 Adbrix SDK를 사용하여 사용자의 동작을 분석하기 위해 수행해야 할 작업에 대해 설명합니다. 이를 사용하기 위해서는 이 선행되어야 합니다.
유의사항
커스텀 이벤트 이름 설정 시 유의 사항
문자 타입(String) 이어야 하며, 최소 2자 이상 최대 32자 까지 입력할 수 있습니다.
영문 소문자와 숫자, -
그리고 _
만 사용 가능 합니다.
이벤트 속성 설정 시 유의 사항
최대 100개까지만 처리 가능
한 번에 100개 이상의 속성을 설정하면 적용되지 않습니다.
Key 값 제한
문자 타입(String) 이어야 하며, 최소 2자 이상 최대 32자 까지 입력할 수 있습니다.
영문 소문자와 숫자 그리고 _
만 사용 가능 합니다.
Value 값 제한
가능한 타입: Long, Double, Boolean, String .
표준 이벤트 속성 타입 제한
정해진 타입만 사용할 수 있으며, 임의 변경은 불가능합니다.
검증 실패 시 적용 불가
조건을 충족하지 않은 속성은 이벤트에 자동으로 제외 됩니다.
이벤트 기록
Copy void LogEvent(string eventName)
void LogEvent(string eventName, Dictionary<string, object> properties = null)
각각의 매개변수는 다음을 의미합니다.
이벤트 기록 예시
Copy // 속성이 없을 경우
Adbrix.LogEvent(ABEvent.SIGN_UP);
// 속성이 있을 경우
Dictionary<string, object> param = new Dictionary<string, object>
{
{ABEventProperty.SIGN_CHANNEL, ABSignUpChannel.KAKAO}
};
Adbrix.LogEvent(ABEvent.SIGN_UP, param);
표준 이벤트 및 속성
표준 이벤트와 표준 이벤트 속성, 상품 속성은 아래와 같습니다.
표준 이벤트
표준 이벤트 이름은 다음과 같이 사전 정의된 정적 상수로 제공됩니다.
ABEvent.TUTORIAL_COMPLETED
ABEvent.CHARACTER_CREATED
ABEvent.PAYMENT_INFO_ADDED
표준 이벤트 속성
표준 이벤트의 속성 명의 경우 다음과 같이 이벤트 속성 명이 사전 정의된 정적 상수로 제공됩니다.
ABEventProperty.SHARING_CHANNEL
ABEventProperty.SIGN_CHANNEL
ABEventProperty.INVITE_CHANNEL
ABEventProperty.DELIVERY_CHARGE
ABEventProperty.PENALTY_CHARGE
ABEventProperty.PAYMENT_METHOD
ABEventProperty.ORDER_SALES
상품 속성
ABEventProperty.ITEMS 내에 배열로 적재되는 상품에 대한 표준 이벤트 속성에 대한 정보입니다.
ABEventProperty.ITEM_PRODUCT_ID
ABEventProperty.ITEM_PRODUCT_NAME
ABEventProperty.ITEM_PRICE
ABEventProperty.ITEM_QUANTITY
ABEventProperty.ITEM_DISCOUNT
ABEventProperty.ITEM_CURRENCY
ABEventProperty.ITEM_CATEGORY1
ABEventProperty.ITEM_CATEGORY2
ABEventProperty.ITEM_CATEGORY3
ABEventProperty.ITEM_CATEGORY4
ABEventProperty.ITEM_CATEGORY5
표준 유저 분석 이벤트 사용 예시
로그인
사용자가 서비스에 회원으로 가입하는 동작을 나타내는 이벤트입니다.
Copy Adbrix.LogEvent(ABEvent.LOGIN);
로그아웃
사용자가 앱에서 로그아웃하는 동작을 나타내는 이벤트입니다.
Copy Adbrix.LogEvent(ABEvent.LOGOUT);
표준 공통 이벤트 사용 예시
회원가입
사용자가 회원으로 가입하는 동작을 나타내는 이벤트입니다.
Copy Dictionary<string, object> properties = new Dictionary<string, object>
{
{ABEventProperty.SIGN_CHANNEL, ABSignUpChannel.KAKAO}
};
Adbrix.LogEvent(ABEvent.SIGN_UP, properties);
표준 이벤트 속성
ABEventProperty.SIGN_CHANNEL
앱 업데이트
앱에서 발생한 앱 업데이트 이벤트입니다.
Copy Dictionary<string, object> properties = new Dictionary<string, object>
{
{ABEventProperty.PREV_VER, "1.0.0"},
{ABEventProperty.CURR_VER, "1.0.1"}
};
Adbrix.LogEvent(ABEvent.SIGN_UP, properties);
표준 이벤트 속성
사용자 초대
앱에서 발생한 앱 초대 이벤트입니다.
Copy Dictionary<string, object> properties = new Dictionary<string, object>
{
{ABEventProperty.INVITE_CHANNEL, ABInviteChannel.KAKAO}
};
Adbrix.LogEvent(ABEvent.INVITE, properties);
표준 이벤트 속성
ABEventProperty.INVITE_CHANNEL
크레딧 사용
앱에서 발생한 현금성 화폐 사용 이벤트입니다.
Copy Adbrix.LogEvent(ABEvent.USE_CREDIT);
구매
사용자가 상품이나 서비스를 구매하는 동작을 나타내는 이벤트입니다.
Copy Dictionary<string, object> item = new Dictionary<string, object>
{
{ABEventProperty.ITEM_PRODUCT_ID, "상품번호"},
{ABEventProperty.ITEM_PRODUCT_NAME, "상품이름"},
{ABEventProperty.ITEM_CATEGORY1, "식품"},
{ABEventProperty.ITEM_CATEGORY2, "과자"},
{ABEventProperty.ITEM_PRICE, 5000.0},
{ABEventProperty.ITEM_DISCOUNT, 500.0},
{ABEventProperty.ITEM_QUANTITY, 5}
};
List<Dictionary<string, object>> items = new List<Dictionary<string, object>> { item };
Dictionary<string, object> properties = new Dictionary<string, object>
{
{ABEventProperty.ITEMS, items},
{ABEventProperty.ORDER_ID, "상품번호"},
{ABEventProperty.PAYMENT_METHOD, ABPaymentMethod.CREDIT_CARD},
{ABEventProperty.ORDER_SALES, 25500.0},
{ABEventProperty.DELIVERY_CHARGE, 3000.0},
{ABEventProperty.DISCOUNT, 0},
};
Adbrix.LogEvent(ABEvent.PURCHASE, properties);
표준 이벤트 속성
List<Dictionary<string, object>>
ABEventProperty.ORDER_SALES
ABEventProperty.PAYMENT_METHOD
ABEventProperty.DELIVERY_CHARGE
표준 커머스 이벤트 사용 예시
홈 화면 진입
사용자가 앱의 홈 화면을 진입하는 동작을 나타내는 이벤트입니다.
Copy Adbrix.LogEvent(ABEvent.VIEW_HOME);
카테고리 진입
사용자가 카테고리(기획전) 화면으로 진입한 이벤트입니다.
Copy Dictionary<string, object> item = new Dictionary<string, object>
{
{ABEventProperty.ITEM_PRODUCT_ID, "상품번호"},
{ABEventProperty.ITEM_PRODUCT_NAME, "상품이름"},
{ABEventProperty.ITEM_CATEGORY1, "식품"},
{ABEventProperty.ITEM_CATEGORY2, "과자"},
{ABEventProperty.ITEM_PRICE, 5000.0},
{ABEventProperty.ITEM_DISCOUNT, 500.0},
{ABEventProperty.ITEM_QUANTITY, 5}
};
List<Dictionary<string, object>> items = new List<Dictionary<string, object>> { item };
Dictionary<string, object> properties = new Dictionary<string, object>
{
{ABEventProperty.ITEMS, items},
{ABEventProperty.CATEGORY1, "식품"}
};
Adbrix.LogEvent(ABEvent.CATEGORY_VIEW, properties);
표준 이벤트 속성
ABEventProperty.CATEGORY1
ABEventProperty.CATEGORY2
ABEventProperty.CATEGORY3
ABEventProperty.CATEGORY4
ABEventProperty.CATEGORY5
List<Dictionary<string, object>>
상품 상세 보기
사용자가 특정 상품의 상세 정보를 조회하는 동작을 나타내는 이벤트입니다.
Copy Dictionary<string, object> item = new Dictionary<string, object>
{
{ABEventProperty.ITEM_PRODUCT_ID, "상품번호"},
{ABEventProperty.ITEM_PRODUCT_NAME, "상품이름"},
{ABEventProperty.ITEM_CATEGORY1, "식품"},
{ABEventProperty.ITEM_CATEGORY2, "과자"},
{ABEventProperty.ITEM_PRICE, 5000.0},
{ABEventProperty.ITEM_DISCOUNT, 500.0},
{ABEventProperty.ITEM_QUANTITY, 5}
};
List<Dictionary<string, object>> items = new List<Dictionary<string, object>> { item };
Dictionary<string, object> properties = new Dictionary<string, object>
{
{ABEventProperty.ITEMS, items}
};
Adbrix.LogEvent(ABEvent.PRODUCT_VIEW, properties);
표준 이벤트 속성
List<Dictionary<string, object>>
장바구니 담기
사용자가 상품을 장바구니에 담는 동작을 나타내는 이벤트입니다.
Copy Dictionary<string, object> item = new Dictionary<string, object>
{
{ABEventProperty.ITEM_PRODUCT_ID, "상품번호"},
{ABEventProperty.ITEM_PRODUCT_NAME, "상품이름"},
{ABEventProperty.ITEM_CATEGORY1, "식품"},
{ABEventProperty.ITEM_CATEGORY2, "과자"},
{ABEventProperty.ITEM_PRICE, 5000.0},
{ABEventProperty.ITEM_DISCOUNT, 500.0},
{ABEventProperty.ITEM_QUANTITY, 5}
};
List<Dictionary<string, object>> items = new List<Dictionary<string, object>> { item };
Dictionary<string, object> properties = new Dictionary<string, object>
{
{ABEventProperty.ITEMS, items}
};
Adbrix.LogEvent(ABEvent.ADD_TO_CART, properties);
표준 이벤트 속성
List<Dictionary<string, object>>
관심 상품 추가
사용자가 상품을 관심 목록에 추가하는 동작을 나타내는 이벤트입니다.
Copy Dictionary<string, object> item = new Dictionary<string, object>
{
{ABEventProperty.ITEM_PRODUCT_ID, "상품번호"},
{ABEventProperty.ITEM_PRODUCT_NAME, "상품이름"},
{ABEventProperty.ITEM_CATEGORY1, "식품"},
{ABEventProperty.ITEM_CATEGORY2, "과자"},
{ABEventProperty.ITEM_PRICE, 5000.0},
{ABEventProperty.ITEM_DISCOUNT, 500.0},
{ABEventProperty.ITEM_QUANTITY, 5}
};
List<Dictionary<string, object>> items = new List<Dictionary<string, object>> { item };
Dictionary<string, object> properties = new Dictionary<string, object>
{
{ABEventProperty.ITEMS, items}
};
Adbrix.LogEvent(ABEvent.ADD_TO_WISHLIST, properties);
표준 이벤트 속성
List<Dictionary<string, object>>
주문 확인하기
사용자가 상품을 결제하기 전 최종 확인하는 이벤트입니다.
Copy Dictionary<string, object> item = new Dictionary<string, object>
{
{ABEventProperty.ITEM_PRODUCT_ID, "상품번호"},
{ABEventProperty.ITEM_PRODUCT_NAME, "상품이름"},
{ABEventProperty.ITEM_CATEGORY1, "식품"},
{ABEventProperty.ITEM_CATEGORY2, "과자"},
{ABEventProperty.ITEM_PRICE, 5000.0},
{ABEventProperty.ITEM_DISCOUNT, 500.0},
{ABEventProperty.ITEM_QUANTITY, 5}
};
List<Dictionary<string, object>> items = new List<Dictionary<string, object>> { item };
Dictionary<string, object> properties = new Dictionary<string, object>
{
{ABEventProperty.ITEMS, items}
};
Adbrix.LogEvent(ABEvent.REVIEW_ORDER, properties);
표준 이벤트 속성
List<Dictionary<string, object>>
주문 취소하기
사용자가 구매한 주문을 취소하고 환불하는 동작을 나타내는 이벤트입니다.
Copy Dictionary<string, object> item = new Dictionary<string, object>
{
{ABEventProperty.ITEM_PRODUCT_ID, "상품번호"},
{ABEventProperty.ITEM_PRODUCT_NAME, "상품이름"},
{ABEventProperty.ITEM_CATEGORY1, "식품"},
{ABEventProperty.ITEM_CATEGORY2, "과자"},
{ABEventProperty.ITEM_PRICE, 5000.0},
{ABEventProperty.ITEM_DISCOUNT, 500.0},
{ABEventProperty.ITEM_QUANTITY, 5}
};
List<Dictionary<string, object>> items = new List<Dictionary<string, object>> { item };
Dictionary<string, object> properties = new Dictionary<string, object>
{
{ABEventProperty.ITEMS, items}
};
Adbrix.LogEvent(ABEvent.REFUND, properties);
표준 이벤트 속성
List<Dictionary<string, object>>
상품 검색하기
사용자가 상품을 검색하여 결과를 확인하는 동작을 나타내는 이벤트입니다.
Copy Dictionary<string, object> item = new Dictionary<string, object>
{
{ABEventProperty.ITEM_PRODUCT_ID, "상품번호"},
{ABEventProperty.ITEM_PRODUCT_NAME, "상품이름"},
{ABEventProperty.ITEM_CATEGORY1, "식품"},
{ABEventProperty.ITEM_CATEGORY2, "과자"},
{ABEventProperty.ITEM_PRICE, 5000.0},
{ABEventProperty.ITEM_DISCOUNT, 500.0},
{ABEventProperty.ITEM_QUANTITY, 5}
};
List<Dictionary<string, object>> items = new List<Dictionary<string, object>> { item };
Dictionary<string, object> properties = new Dictionary<string, object>
{
{ABEventProperty.ITEMS, items},
{ABEventProperty.KEYWORD, "삼겹살"}
};
Adbrix.LogEvent(ABEvent.SEARCH, properties);
표준 이벤트 속성
List<Dictionary<string, object>>
상품 공유하기
사용자가 상품을 공유하는 동작을 나타내는 이벤트입니다.
Copy Dictionary<string, object> item = new Dictionary<string, object>
{
{ABEventProperty.ITEM_PRODUCT_ID, "상품번호"},
{ABEventProperty.ITEM_PRODUCT_NAME, "상품이름"},
{ABEventProperty.ITEM_CATEGORY1, "식품"},
{ABEventProperty.ITEM_CATEGORY2, "과자"},
{ABEventProperty.ITEM_PRICE, 5000.0},
{ABEventProperty.ITEM_DISCOUNT, 500.0},
{ABEventProperty.ITEM_QUANTITY, 5}
};
List<Dictionary<string, object>> items = new List<Dictionary<string, object>> { item };
Dictionary<string, object> properties = new Dictionary<string, object>
{
{ABEventProperty.ITEMS, items},
{ABEventProperty.SHARING_CHANNEL, ABSharingChannel.FACEBOOK}
};
Adbrix.LogEvent(ABEvent.SHARE, properties);
표준 이벤트 속성
List<Dictionary<string, object>>
ABEventProperty.SHARING_CHANNEL
상품 목록 조회
사용자가 상품 목록을 조회하는 동작을 나타내는 이벤트입니다.
Copy Dictionary<string, object> item = new Dictionary<string, object>
{
{ABEventProperty.ITEM_PRODUCT_ID, "상품번호"},
{ABEventProperty.ITEM_PRODUCT_NAME, "상품이름"},
{ABEventProperty.ITEM_CATEGORY1, "식품"},
{ABEventProperty.ITEM_CATEGORY2, "과자"},
{ABEventProperty.ITEM_PRICE, 5000.0},
{ABEventProperty.ITEM_DISCOUNT, 500.0},
{ABEventProperty.ITEM_QUANTITY, 5}
};
List<Dictionary<string, object>> items = new List<Dictionary<string, object>> { item };
Dictionary<string, object> properties = new Dictionary<string, object>
{
{ABEventProperty.ITEMS, items}
};
Adbrix.LogEvent(ABEvent.LIST_VIEW, properties);
표준 이벤트 속성
List<Dictionary<string, object>>
장바구니 조회
사용자가 장바구니를 조회하는 동작을 나타내는 이벤트입니다.
Copy Dictionary<string, object> item = new Dictionary<string, object>
{
{ABEventProperty.ITEM_PRODUCT_ID, "상품번호"},
{ABEventProperty.ITEM_PRODUCT_NAME, "상품이름"},
{ABEventProperty.ITEM_CATEGORY1, "식품"},
{ABEventProperty.ITEM_CATEGORY2, "과자"},
{ABEventProperty.ITEM_PRICE, 5000.0},
{ABEventProperty.ITEM_DISCOUNT, 500.0},
{ABEventProperty.ITEM_QUANTITY, 5}
};
List<Dictionary<string, object>> items = new List<Dictionary<string, object>> { item };
Dictionary<string, object> properties = new Dictionary<string, object>
{
{ABEventProperty.ITEMS, items}
};
Adbrix.LogEvent(ABEvent.CART_VIEW, properties);
표준 이벤트 속성
List<Dictionary<string, object>>
결제 정보 입력하기
사용자가 결제 정보를 입력한 이벤트입니다.
Copy Adbrix.LogEvent(ABEvent.PAYMENT_INFO_ADDED);
표준 게임 이벤트 사용 예시
튜토리얼 완료
앱에서 발생한 튜토리얼 완료 이벤트입니다.
Copy Dictionary<string, object> properties = new Dictionary<string, object>
{
{ABEventProperty.IS_SKIP, true}
};
Adbrix.LogEvent(ABEvent.TUTORIAL_COMPLETED, properties);
표준 이벤트 속성
캐릭터 생성
앱에서 발생한 캐릭터 생성 이벤트입니다.
Copy Adbrix.LogEvent(ABEvent.CHARACTER_CREATED)
스테이지 완료
앱에서 발생한 스테이지 완료 이벤트입니다.
Copy Dictionary<string, object> properties = new Dictionary<string, object>
{
{ABEventProperty.STAGE, "STAGE_NAME"}
};
Adbrix.LogEvent(ABEvent.STAGE_CLEARED, properties);
표준 이벤트 속성
레벨 달성
앱에서 발생한 레벨 달성 이벤트입니다.
Copy Dictionary<string, object> properties = new Dictionary<string, object>
{
{ABEventProperty.LEVEL, 50}
};
Adbrix.LogEvent(ABEvent.LEVEL_ACHIEVED, properties);
표준 이벤트 속성
커스텀 이벤트
사용자가 직접 임의의 이벤트 명칭과 속성을 입력하여 반영하는 이벤트입니다. 표준 이벤트에도 디파이너리 콘솔에서 커스텀 속성을 추가하여 사용할 수 있습니다.
속성이 없을 경우
Copy Adbrix.LogEvent("CUSTOM_EVENT_NAME", null);
속성이 있을 경우
Copy Dictionary<string, object> properties = new Dictionary<string, object>
{
{"CUSTOM_PROPERTY_KEY", "CUSTOM_PROPERTY_VALUE"}//사용자 정의 속성 값(Optional)
};
Adbrix.LogEvent("CUSTOM_EVENT_NAME", properties);