이벤트
이 문서는 Adbrix SDK를 사용하여 사용자의 동작을 분석하기 위해 수행해야 할 작업에 대해 설명합니다. 이를 사용하기 위해서는 SDK 연동이 선행되어야 합니다.
유의사항
커스텀 이벤트 이름 설정 시 유의 사항
문자 타입(string) 이어야 하며, 최소 2자 이상 최대 32자까지 입력할 수 있습니다.
영문 소문자와 숫자,
-
그리고_
만 사용 가능합니다.
이벤트 속성 설정 시 유의 사항
최대 100개까지만 처리 가능
한 번에 100개 이상의 속성을 설정하면 적용되지 않습니다.
Key 값 제한
문자 타입(string) 이어야 하며, 최소 2자 이상 최대 32자까지 입력할 수 있습니다.
영문 소문자와 숫자 그리고
_
만 사용 가능합니다.
Value 값 제한
최대 1024바이트까지 입력할 수 있습니다.
값으로
null
을 사용할 수 없습니다.가능한 타입: long, double, bool, string.
표준 이벤트 속성 타입 제한
정해진 타입만 사용할 수 있으며, 임의 변경은 불가능합니다.
검증 실패 시 적용 불가
조건을 충족하지 않은 속성은 이벤트에 자동으로 제외됩니다.
이벤트 기록
LogEvent
메소드를 사용하여 사용자의 이벤트를 기록합니다. 표준 이벤트는 상수를 제공합니다.
void LogEvent(string eventName)
void LogEvent(string eventName, Dictionary<string, object> properties = null)
각각의 매개변수는 다음을 의미합니다.
eventName
: 이벤트 이름properties
: 이벤트 속성
이벤트 기록 예시
// 속성이 없을 경우
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.LOGIN
"abx:login"
로그인
ABEvent.LOGOUT
"abx:logout"
로그아웃
ABEvent.SIGN_UP
"abx:sign_up"
회원가입
ABEvent.USE_CREDIT
"abx:use_credit"
크레딧 사용
ABEvent.APP_UPDATE
"abx:app_update"
앱 업데이트
ABEvent.INVITE
"abx:invite"
사용자 초대
ABEvent.PURCHASE
"abx:purchase"
구매
ABEvent.LEVEL_ACHIEVED
"abx:level_achieved"
레벨 달성
ABEvent.TUTORIAL_COMPLETED
"abx:tutorial_completed"
튜토리얼 완료
ABEvent.CHARACTER_CREATED
"abx:character_created"
캐릭터 생성
ABEvent.STAGE_CLEARED
"abx:stage_cleared"
스테이지 완료
ABEvent.REFUND
"abx:refund"
주문 취소하기(환불하기)
ABEvent.ADD_TO_CART
"abx:add_to_cart"
장바구니 담기
ABEvent.ADD_TO_WISHLIST
"abx:add_to_wishlist"
관심 상품(위시리스트) 추가
ABEvent.PRODUCT_VIEW
"abx:product_view"
상품 상세 보기
ABEvent.CATEGORY_VIEW
"abx:category_view"
카테고리(기획전) 진입
ABEvent.REVIEW_ORDER
"abx:review_order"
주문 확인하기
ABEvent.SEARCH
"abx:search"
상품 검색하기
ABEvent.SHARE
"abx:share"
상품 공유하기
ABEvent.VIEW_HOME
"abx:view_home"
홈(메인) 화면 진입
ABEvent.LIST_VIEW
"abx:list_view"
상품 목록 조회하기
ABEvent.CART_VIEW
"abx:cart_view"
장바구니 조회하기
ABEvent.PAYMENT_INFO_ADDED
"abx:paymentinfo_added"
결제 정보 입력하기
표준 이벤트 속성
표준 이벤트의 속성 명의 경우 다음과 같이 이벤트 속성 명이 사전 정의된 정적 상수로 제공됩니다.
ABEventProperty.IS_SKIP
"abx:is_skip"
Boolean
튜토리얼 skip 여부
ABEventProperty.LEVEL
"abx:level"
Long
레벨
ABEventProperty.STAGE
"abx:stage"
String
스테이지 명
ABEventProperty.PREV_VER
"abx:prev_ver"
String
이전 앱 버전
ABEventProperty.CURR_VER
"abx:curr_ver"
String
현재 앱 버전
ABEventProperty.KEYWORD
"abx:keyword"
String
검색 키워드
ABEventProperty.SHARING_CHANNEL
"abx:sharing_channel"
ABSharingChannel
상품 공유 채널
ABEventProperty.SIGN_CHANNEL
"abx:sign_channel"
ABSignUpChannel
회원가입 채널
ABEventProperty.INVITE_CHANNEL
"abx:invite_channel"
ABInviteChannel
사용자 초대 채널
ABEventProperty.ORDER_ID
"abx:order_id"
String
주문 ID
ABEventProperty.DELIVERY_CHARGE
"abx:delivery_charge"
Double
배송료 설정
ABEventProperty.PENALTY_CHARGE
"abx:penalty_charge"
Double
페널티 가격
ABEventProperty.PAYMENT_METHOD
"abx:payment_method"
ABPaymentMethod
결제 방법
ABEventProperty.ORDER_SALES
"abx:order_sales"
Double
주문가(총액)
ABEventProperty.DISCOUNT
"abx:discount"
Double
할인 가격
ABEventProperty.CATEGORY1
"abx:category1"
String
카테고리1
ABEventProperty.CATEGORY2
"abx:category2"
String
카테고리2
ABEventProperty.CATEGORY3
"abx:category3"
String
카테고리3
ABEventProperty.CATEGORY4
"abx:category4"
String
카테고리4
ABEventProperty.CATEGORY5
"abx:category5"
String
카테고리5
ABEventProperty.ITEMS
"abx:items"
List<Dictionary<string, object>>
상품
상품 속성
ABEventProperty.ITEMS 내에 배열로 적재되는 상품에 대한 표준 이벤트 속성에 대한 정보입니다.
ABEventProperty.ITEM_PRODUCT_ID
"abx:product_id"
String
상품 번호(ID)
✅
ABEventProperty.ITEM_PRODUCT_NAME
"abx:product_name"
String
상품 명
✅
ABEventProperty.ITEM_PRICE
"abx:price"
Double
상품 단가
✅
ABEventProperty.ITEM_QUANTITY
"abx:quantity"
Long
상품 수량
✅
ABEventProperty.ITEM_DISCOUNT
"abx:discount"
Double
상품 할인가
✅
ABEventProperty.ITEM_CURRENCY
"abx:currency"
ABCurrency
화폐 단위
ABEventProperty.ITEM_CATEGORY1
"abx:category1"
String
상품 카테고리1
ABEventProperty.ITEM_CATEGORY2
"abx:category2"
String
상품 카테고리2
ABEventProperty.ITEM_CATEGORY3
"abx:category3"
String
상품 카테고리3
ABEventProperty.ITEM_CATEGORY4
"abx:category4"
String
상품 카테고리4
ABEventProperty.ITEM_CATEGORY5
"abx:category5"
String
상품 카테고리5
표준 유저 분석 이벤트 사용 예시
로그인
사용자가 서비스에 회원으로 가입하는 동작을 나타내는 이벤트입니다.
Adbrix.LogEvent(ABEvent.LOGIN);
로그아웃
사용자가 앱에서 로그아웃하는 동작을 나타내는 이벤트입니다.
Adbrix.LogEvent(ABEvent.LOGOUT);
표준 공통 이벤트 사용 예시
회원가입
사용자가 회원으로 가입하는 동작을 나타내는 이벤트입니다.
Dictionary<string, object> properties = new Dictionary<string, object>
{
{ABEventProperty.SIGN_CHANNEL, ABSignUpChannel.KAKAO}
};
Adbrix.LogEvent(ABEvent.SIGN_UP, properties);
표준 이벤트 속성
ABEventProperty.SIGN_CHANNEL
ABSignUpChannel
회원가입 채널
✅
앱 업데이트
앱에서 발생한 앱 업데이트 이벤트입니다.
Dictionary<string, object> properties = new Dictionary<string, object>
{
{ABEventProperty.PREV_VER, "1.0.0"},
{ABEventProperty.CURR_VER, "1.0.1"}
};
Adbrix.LogEvent(ABEvent.APP_UPDATE, properties);
표준 이벤트 속성
ABEventProperty.PREV_VER
string
이전 앱 버전
✅
ABEventProperty.CURR_VER
string
현재 앱 버전
✅
사용자 초대
앱에서 발생한 앱 초대 이벤트입니다.
Dictionary<string, object> properties = new Dictionary<string, object>
{
{ABEventProperty.INVITE_CHANNEL, ABInviteChannel.KAKAO}
};
Adbrix.LogEvent(ABEvent.INVITE, properties);
표준 이벤트 속성
ABEventProperty.INVITE_CHANNEL
ABInviteChannel
초대 채널
✅
크레딧 사용
앱에서 발생한 현금성 화폐 사용 이벤트입니다.
Adbrix.LogEvent(ABEvent.USE_CREDIT);
구매
사용자가 상품이나 서비스를 구매하는 동작을 나타내는 이벤트입니다.
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, 1500.0},
{ABEventProperty.ITEM_DISCOUNT, 500.0},
{ABEventProperty.ITEM_QUANTITY, 5L}
};
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, 5000.0},
{ABEventProperty.DELIVERY_CHARGE, 3000.0},
{ABEventProperty.DISCOUNT, 0.0},
};
Adbrix.LogEvent(ABEvent.PURCHASE, properties);
표준 이벤트 속성
ABEventProperty.ORDER_ID
string
주문 번호(ID)
✅
ABEventProperty.ORDER_SALES
double
주문가(총액)
✅
ABEventProperty.PAYMENT_METHOD
string
결제 방법
✅
ABEventProperty.DELIVERY_CHARGE
double
배송료
✅
ABEventProperty.DISCOUNT
double
상품할인가
✅
표준 커머스 이벤트 사용 예시
홈 화면 진입
사용자가 앱의 홈 화면을 진입하는 동작을 나타내는 이벤트입니다.
Adbrix.LogEvent(ABEvent.VIEW_HOME);
카테고리 진입
사용자가 카테고리(기획전) 화면으로 진입한 이벤트입니다.
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, 1500.0},
{ABEventProperty.ITEM_DISCOUNT, 500.0},
{ABEventProperty.ITEM_QUANTITY, 5L}
};
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
string
상품 카테고리
✅
ABEventProperty.CATEGORY2
string
상품 카테고리
ABEventProperty.CATEGORY3
string
상품 카테고리
ABEventProperty.CATEGORY4
string
상품 카테고리
ABEventProperty.CATEGORY5
string
상품 카테고리
상품 상세 보기
사용자가 특정 상품의 상세 정보를 조회하는 동작을 나타내는 이벤트입니다.
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, 1500.0},
{ABEventProperty.ITEM_DISCOUNT, 500.0},
{ABEventProperty.ITEM_QUANTITY, 5L}
};
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);
표준 이벤트 속성
장바구니 담기
사용자가 상품을 장바구니에 담는 동작을 나타내는 이벤트입니다.
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, 1500.0},
{ABEventProperty.ITEM_DISCOUNT, 500.0},
{ABEventProperty.ITEM_QUANTITY, 5L}
};
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);
표준 이벤트 속성
관심 상품 추가
사용자가 상품을 관심 목록에 추가하는 동작을 나타내는 이벤트입니다.
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, 1500.0},
{ABEventProperty.ITEM_DISCOUNT, 500.0},
{ABEventProperty.ITEM_QUANTITY, 5L}
};
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);
표준 이벤트 속성
주문 확인하기
사용자가 상품을 결제하기 전 최종 확인하는 이벤트입니다.
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, 1500.0},
{ABEventProperty.ITEM_DISCOUNT, 500.0},
{ABEventProperty.ITEM_QUANTITY, 5L}
};
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.DELIVERY_CHARGE, 0.0}.
{ABEventProperty.DISCOUNT, 0.0}
};
Adbrix.LogEvent(ABEvent.REVIEW_ORDER, properties);
표준 이벤트 속성
ABEventProperty.ORDER_ID
string
주문 번호(ID)
✅
ABEventProperty.DELIVERY_CHARGE
double
배송료
✅
ABEventProperty.DISCOUNT
double
상품할인가
✅
주문 취소하기
사용자가 구매한 주문을 취소하고 환불하는 동작을 나타내는 이벤트입니다.
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, 1500.0},
{ABEventProperty.ITEM_DISCOUNT, 500.0},
{ABEventProperty.ITEM_QUANTITY, 5L}
};
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.PENALTY_CHARGE, 0.0}
};
Adbrix.LogEvent(ABEvent.REFUND, properties);
표준 이벤트 속성
ABEventProperty.ORDER_ID
string
주문 번호(ID)
✅
ABEventProperty.PENALTY_CHARGE
double
페널티 가격
✅
상품 검색하기
사용자가 상품을 검색하여 결과를 확인하는 동작을 나타내는 이벤트입니다.
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, 1500.0},
{ABEventProperty.ITEM_DISCOUNT, 500.0},
{ABEventProperty.ITEM_QUANTITY, 5L}
};
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);
표준 이벤트 속성
ABEventProperty.KEYWORD
string
검색 키워드
✅
상품 공유하기
사용자가 상품을 공유하는 동작을 나타내는 이벤트입니다.
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, 1500.0},
{ABEventProperty.ITEM_DISCOUNT, 500.0},
{ABEventProperty.ITEM_QUANTITY, 5L}
};
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);
표준 이벤트 속성
ABEventProperty.SHARING_CHANNEL
ABSharingChannel
상품 공유 채널
✅
상품 목록 조회
사용자가 상품 목록을 조회하는 동작을 나타내는 이벤트입니다.
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, 1500.0},
{ABEventProperty.ITEM_DISCOUNT, 500.0},
{ABEventProperty.ITEM_QUANTITY, 5L}
};
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);
표준 이벤트 속성
장바구니 조회
사용자가 장바구니를 조회하는 동작을 나타내는 이벤트입니다.
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, 1500.0},
{ABEventProperty.ITEM_DISCOUNT, 500.0},
{ABEventProperty.ITEM_QUANTITY, 5L}
};
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);
표준 이벤트 속성
결제 정보 입력하기
사용자가 결제 정보를 입력한 이벤트입니다.
Adbrix.LogEvent(ABEvent.PAYMENT_INFO_ADDED);
표준 게임 이벤트 사용 예시
튜토리얼 완료
앱에서 발생한 튜토리얼 완료 이벤트입니다.
Dictionary<string, object> properties = new Dictionary<string, object>
{
{ABEventProperty.IS_SKIP, true}
};
Adbrix.LogEvent(ABEvent.TUTORIAL_COMPLETED, properties);
표준 이벤트 속성
ABEventProperty.IS_SKIP
bool
튜토리얼 skip 여부
✅
캐릭터 생성
앱에서 발생한 캐릭터 생성 이벤트입니다.
Adbrix.LogEvent(ABEvent.CHARACTER_CREATED)
스테이지 완료
앱에서 발생한 스테이지 완료 이벤트입니다.
Dictionary<string, object> properties = new Dictionary<string, object>
{
{ABEventProperty.STAGE, "STAGE_NAME"}
};
Adbrix.LogEvent(ABEvent.STAGE_CLEARED, properties);
표준 이벤트 속성
ABEventProperty.STAGE
string
스테이지 이름
✅
레벨 달성
앱에서 발생한 레벨 달성 이벤트입니다.
Dictionary<string, object> properties = new Dictionary<string, object>
{
{ABEventProperty.LEVEL, 50L}
};
Adbrix.LogEvent(ABEvent.LEVEL_ACHIEVED, properties);
표준 이벤트 속성
ABEventProperty.LEVEL
int
사용자 레벨
✅
커스텀 이벤트
사용자가 직접 임의의 이벤트 명칭과 속성을 입력하여 반영하는 이벤트입니다. 표준 이벤트에도 디파이너리 콘솔에서 커스텀 속성을 추가하여 사용할 수 있습니다.
속성이 없을 경우
Adbrix.LogEvent("CUSTOM_EVENT_NAME", null);
속성이 있을 경우
Dictionary<string, object> properties = new Dictionary<string, object>
{
{"CUSTOM_PROPERTY_KEY", "CUSTOM_PROPERTY_VALUE"}//사용자 정의 속성 값(Optional)
};
Adbrix.LogEvent("CUSTOM_EVENT_NAME", properties);
Last updated