이벤트

이 문서는 Adbrix SDK를 사용하여 사용자의 동작을 분석하기 위해 수행해야 할 작업에 대해 설명합니다. 이를 사용하기 위해서는 SDK 연동이 선행되어야 합니다.

유의사항

커스텀 이벤트 이름 설정 시 유의 사항

• 문자 타입(String) 이어야 하며, 최소 2자 이상 최대 32자까지 입력할 수 있습니다.

• 영문 소문자와 숫자, - 그리고 _만 사용 가능합니다.

이벤트 속성 설정 시 유의 사항

1. 최대 100개까지만 처리 가능

   • 한 번에 100개 이상의 속성을 설정하면 적용되지 않습니다.

2. Key 값 제한

   • 문자 타입(String) 이어야 하며, 최소 2자 이상 최대 32자까지 입력할 수 있습니다.

   • 영문 소문자와 숫자 그리고 _만 사용 가능합니다.

3. Value 값 제한

   • 최대 1024바이트까지 입력할 수 있습니다.

   • 값으로 null을 사용할 수 없습니다.

   • 가능한 타입: Long, Double, Boolean, String.

4. 표준 이벤트 속성 타입 제한

   • 정해진 타입만 사용할 수 있으며, 임의 변경은 불가능합니다.

5. 검증 실패 시 적용 불가

   • 조건을 충족하지 않은 속성은 이벤트에 자동으로 제외됩니다.

이벤트 기록

logEvent 메소드를 사용하여 사용자의 이벤트를 기록합니다. 표준 이벤트는 상수를 제공합니다.

void logEvent(String eventName)
void logEvent(String eventName, JSONObject properties)

각각의 매개변수는 다음을 의미합니다.

• eventName : 이벤트 이름

• properties : 이벤트 속성

이벤트 기록 예시

Java

// 속성이 없을 경우
Adbrix.getInstance().logEvent(ABEvent.SIGN_UP);

// 속성이 있을 경우
JSONObject properties = new JSONObject();
properties.put(ABEventProperty.SHARING_CHANNEL, ABSharingChannel.KAKAOTALK);
Adbrix.getInstance().logEvent(ABEvent.SIGN_UP, properties);

Kotlin

// 속성이 없을 경우
Adbrix.getInstance().logEvent(ABEvent.SIGN_UP)

// 속성이 있을 경우
val properties = JSONObject()
properties.put(ABEventProperty.SHARING_CHANNEL, ABSharingChannel.KAKAOTALK)
Adbrix.getInstance().logEvent(ABEvent.SIGN_UP, properties)

표준 이벤트 및 속성

표준 이벤트와 표준 이벤트 속성, 상품 속성은 아래와 같습니다.

표준 이벤트

표준 이벤트 이름은 다음과 같이 사전 정의된 정적 상수로 제공됩니다.

상수	이벤트명	표기명
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"	Bool	튜토리얼 skip 여부
ABEventProperty.LEVEL	"abx:level"	Int	레벨
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	공유 SNS
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 내에 배열로 적재되는 상품에 대한 표준 이벤트 속성에 대한 정보입니다.

상수	이벤트 속성명	타입	설명	필수
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"	Int	상품 수량	✅
ABEventProperty.ITEM_DISCOUNT	"abx:discount"	Double	상품 할인가	✅
ABEventProperty.ITEM_CURRENCY	"abx:currency"	String	화폐 단위
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

표준 유저 분석 이벤트 사용 예시

로그인

사용자가 서비스에 회원으로 가입하는 동작을 나타내는 이벤트입니다.

Java

Adbrix.getInstance().logEvent(ABEvent.LOGIN);

Kotlin

Adbrix.getInstance().logEvent(ABEvent.LOGIN)

로그아웃

사용자가 앱에서 로그아웃하는 동작을 나타내는 이벤트입니다.

Java

Adbrix.getInstance().logEvent(ABEvent.LOGOUT);

Kotlin

Adbrix.getInstance().logEvent(ABEvent.LOGOUT)

표준 공통 이벤트 사용 예시

회원가입

사용자가 회원으로 가입하는 동작을 나타내는 이벤트입니다.

Java

JSONObject properties = new JSONObject();
try {
    properties.put(ABEventProperty.SIGN_CHANNEL, ABSignUpChannel.KAKAO);
} catch (JSONException e) {
    e.printStackTrace();
}
Adbrix.getInstance().logEvent(ABEvent.SIGN_UP, properties);

Kotlin

val properties = JSONObject()
try {
    properties.put(ABEventProperty.SIGN_CHANNEL, ABSignUpChannel.KAKAO)
} catch (e: JSONException) {
    e.printStackTrace()
}
Adbrix.getInstance().logEvent(ABEvent.SIGN_UP, properties)

표준 이벤트 속성

이름	타입	설명	필수
ABEventProperty.SIGN_CHANNEL	String	회원가입 채널	✅

앱 업데이트

앱에서 발생한 앱 업데이트 이벤트입니다.

Java

JSONObject properties = new JSONObject();
try {
    properties.put(ABEventProperty.PREV_VER, "1.0.0");
    properties.put(ABEventProperty.CURR_VER, "1.0.1");
} catch (JSONException e) {
    e.printStackTrace();
}
Adbrix.getInstance().logEvent(ABEvent.APP_UPDATE, properties);

Kotlin

val properties = JSONObject()
try {
    properties.put(ABEventProperty.PREV_VER, "1.0.0")
    properties.put(ABEventProperty.CURR_VER, "1.0.1")
} catch (e: JSONException) {
    e.printStackTrace()
}
Adbrix.getInstance().logEvent(ABEvent.APP_UPDATE, properties)

표준 이벤트 속성

이름	타입	설명	필수
ABEventProperty.PREV_VER	String	이전 앱 버전	✅
ABEventProperty.CURR_VER	String	현재 앱 버전	✅

사용자 초대

앱에서 발생한 앱 초대 이벤트입니다.

Java

JSONObject properties = new JSONObject();
try {
    properties.put(ABEventProperty.INVITE_CHANNEL, ABInviteChannel.KAKAO);
} catch (JSONException e) {
    e.printStackTrace();
}
Adbrix.getInstance().logEvent(ABEvent.INVITE, properties);

Kotlin

val properties = JSONObject()
try {
    properties.put(ABEventProperty.INVITE_CHANNEL, ABInviteChannel.KAKAO)
} catch (e: JSONException) {
    e.printStackTrace()
}
Adbrix.getInstance().logEvent(ABEvent.INVITE, properties)

표준 이벤트 속성

이름	타입	설명	필수
ABEventProperty.INVITE_CHANNEL	String	초대 채널	✅

크레딧 사용

앱에서 발생한 현금성 화폐 사용 이벤트입니다.

Java

Adbrix.getInstance().logEvent(ABEvent.USE_CREDIT);

Kotlin

Adbrix.getInstance().logEvent(ABEvent.USE_CREDIT)

구매

사용자가 상품이나 서비스를 구매하는 동작을 나타내는 이벤트입니다.

Java

JSONObject item = new JSONObject();
try {
    item.put(ABEventProperty.ITEM_PRODUCT_ID, "상품번호");
    item.put(ABEventProperty.ITEM_PRODUCT_NAME, "상품이름");
    item.put(ABEventProperty.ITEM_CATEGORY1, "식품");
    item.put(ABEventProperty.ITEM_CATEGORY2, "과자");
    item.put(ABEventProperty.ITEM_PRICE, 5000.0);
    item.put(ABEventProperty.ITEM_DISCOUNT, 500.0);
    item.put(ABEventProperty.ITEM_QUANTITY, 5L);
} catch (JSONException e) {
    e.printStackTrace();
}
JSONArray items = new JSONArray();
items.put(item);
JSONObject properties = new JSONObject();
try {
    properties.put(ABEventProperty.ITEMS, items);
    properties.put(ABEventProperty.ORDER_ID, "주문번호");
    properties.put(ABEventProperty.ORDER_SALES, 10000);
    properties.put(ABEventProperty.PAYMENT_METHOD, ABPaymentMethod.CREDIT_CARD);
    properties.put(ABEventProperty.DELIVERY_CHARGE, 3000.0);
    properties.put(ABEventProperty.DISCOUNT, 0);
} catch (JSONException e) {
    e.printStackTrace();
}
Adbrix.getInstance().logEvent(ABEvent.PURCHASE, properties);

Kotlin

val item = JSONObject()
try {
    item.put(ABEventProperty.ITEM_PRODUCT_ID, "상품번호")
    item.put(ABEventProperty.ITEM_PRODUCT_NAME, "상품이름")
    item.put(ABEventProperty.ITEM_CATEGORY1, "식품")
    item.put(ABEventProperty.ITEM_CATEGORY2, "과자")
    item.put(ABEventProperty.ITEM_PRICE, 5000.0)
    item.put(ABEventProperty.ITEM_DISCOUNT, 500.0)
    item.put(ABEventProperty.ITEM_QUANTITY, 5L)
} catch (e: JSONException) {
    e.printStackTrace()
}
val items = JSONArray()
items.put(item)
val properties = JSONObject()
try {
    properties.put(ABEventProperty.ITEMS, items)
    properties.put(ABEventProperty.ORDER_ID, "주문번호")
    properties.put(ABEventProperty.ORDER_SALES, 10000);
    properties.put(ABEventProperty.PAYMENT_METHOD, ABPaymentMethod.CREDIT_CARD)
    properties.put(ABEventProperty.DELIVERY_CHARGE, 3000.0)
    properties.put(ABEventProperty.ITEM_DISCOUNT, 0)
} catch (e: JSONException) {
    e.printStackTrace()
}
Adbrix.getInstance().logEvent(ABEvent.PURCHASE, properties)

표준 이벤트 속성

이름	타입	설명	필수
ABEventProperty.ITEMS	Array	상품	✅
ABEventProperty.ORDER_ID	String	주문 번호(ID)	✅
ABEventProperty.ORDER_SALES	Double	판매가격	✅
ABEventProperty.PAYMENT_METHOD	String	결제 방법	✅
ABEventProperty.DELIVERY_CHARGE	Double	배송료	✅
ABEventProperty.DISCOUNT	Double	상품할인가	✅

표준 커머스 이벤트 사용 예시

홈 화면 진입

사용자가 앱의 홈 화면을 진입하는 동작을 나타내는 이벤트입니다.

Java

Adbrix.getInstance().logEvent(ABEvent.VIEW_HOME);

Kotlin

Adbrix.getInstance().logEvent(ABEvent.VIEW_HOME)

카테고리 진입

사용자가 카테고리(기획전) 화면으로 진입한 이벤트입니다.

Java

JSONObject item = new JSONObject();
try {
    item.put(ABEventProperty.ITEM_PRODUCT_ID, "상품번호");
    item.put(ABEventProperty.ITEM_PRODUCT_NAME, "상품이름");
    item.put(ABEventProperty.ITEM_CATEGORY1, "식품");
    item.put(ABEventProperty.ITEM_CATEGORY2, "과자");
    item.put(ABEventProperty.ITEM_PRICE, 5000.0);
    item.put(ABEventProperty.ITEM_DISCOUNT, 500.0);
    item.put(ABEventProperty.ITEM_QUANTITY, 5L);
} catch (JSONException e) {
    e.printStackTrace();
}
JSONArray items = new JSONArray();
items.put(item);
JSONObject properties = new JSONObject();
try {
    properties.put(ABEventProperty.ITEMS, items);
    properties.put(ABEventProperty.CATEGORY1, "식품");
} catch (JSONException e) {
    e.printStackTrace();
}
Adbrix.getInstance().logEvent(ABEvent.CATEGORY_VIEW, properties);

Kotlin

val item = JSONObject()
try {
    item.put(ABEventProperty.ITEM_PRODUCT_ID, "상품번호")
    item.put(ABEventProperty.ITEM_PRODUCT_NAME, "상품이름")
    item.put(ABEventProperty.ITEM_CATEGORY1, "식품")
    item.put(ABEventProperty.ITEM_CATEGORY2, "과자")
    item.put(ABEventProperty.ITEM_PRICE, 5000.0)
    item.put(ABEventProperty.ITEM_DISCOUNT, 500.0)
    item.put(ABEventProperty.ITEM_QUANTITY, 5L)
} catch (e: JSONException) {
    e.printStackTrace()
}
val items = JSONArray()
items.put(item)
val properties = JSONObject()
try {
    properties.put(ABEventProperty.ITEMS, items)
    properties.put(ABEventProperty.CATEGORY1, "식품")
} catch (e: JSONException) {
    e.printStackTrace()
}
Adbrix.getInstance().logEvent(ABEvent.CATEGORY_VIEW, properties)

표준 이벤트 속성

이름	타입	설명	필수
ABEventProperty.CATEGORY1	String	상품 카테고리	✅
ABEventProperty.CATEGORY2	String	상품 카테고리
ABEventProperty.CATEGORY3	String	상품 카테고리
ABEventProperty.CATEGORY4	String	상품 카테고리
ABEventProperty.CATEGORY5	String	상품 카테고리
ABEventProperty.ITEMS	Array	상품	✅

상품 상세 보기

사용자가 특정 상품의 상세 정보를 조회하는 동작을 나타내는 이벤트입니다.

Java

JSONObject item = new JSONObject();
try {
    item.put(ABEventProperty.ITEM_PRODUCT_ID, "상품번호");
    item.put(ABEventProperty.ITEM_PRODUCT_NAME, "상품이름");
    item.put(ABEventProperty.ITEM_CATEGORY1, "식품");
    item.put(ABEventProperty.ITEM_CATEGORY2, "과자");
    item.put(ABEventProperty.ITEM_PRICE, 5000.0);
    item.put(ABEventProperty.ITEM_DISCOUNT, 500.0);
    item.put(ABEventProperty.ITEM_QUANTITY, 5L);
} catch (JSONException e) {
    e.printStackTrace();
}
JSONArray items = new JSONArray();
items.put(item);
JSONObject properties = new JSONObject();
try {
    properties.put(ABEventProperty.ITEMS, items);
} catch (JSONException e) {
    e.printStackTrace();
}
Adbrix.getInstance().logEvent(ABEvent.PRODUCT_VIEW, properties);

Kotlin

val item = JSONObject()
try {
    item.put(ABEventProperty.ITEM_PRODUCT_ID, "상품번호")
    item.put(ABEventProperty.ITEM_PRODUCT_NAME, "상품이름")
    item.put(ABEventProperty.ITEM_CATEGORY1, "식품")
    item.put(ABEventProperty.ITEM_CATEGORY2, "과자")
    item.put(ABEventProperty.ITEM_PRICE, 5000.0)
    item.put(ABEventProperty.ITEM_DISCOUNT, 500.0)
    item.put(ABEventProperty.ITEM_QUANTITY, 5L)
} catch (e: JSONException) {
    e.printStackTrace()
}
val items = JSONArray()
items.put(item)
val properties = JSONObject()
try {
    properties.put(ABEventProperty.ITEMS, items)
} catch (e: JSONException) {
    e.printStackTrace()
}
Adbrix.getInstance().logEvent(ABEvent.PRODUCT_VIEW, properties)

표준 이벤트 속성

이름	타입	설명	필수
ABEventProperty.ITEMS	Array	상품	✅

장바구니 담기

사용자가 상품을 장바구니에 담는 동작을 나타내는 이벤트입니다.

Java

JSONObject item = new JSONObject();
try {
    item.put(ABEventProperty.ITEM_PRODUCT_ID, "상품번호");
    item.put(ABEventProperty.ITEM_PRODUCT_NAME, "상품이름");
    item.put(ABEventProperty.ITEM_CATEGORY1, "식품");
    item.put(ABEventProperty.ITEM_CATEGORY2, "과자");
    item.put(ABEventProperty.ITEM_PRICE, 5000.0);
    item.put(ABEventProperty.ITEM_DISCOUNT, 500.0);
    item.put(ABEventProperty.ITEM_QUANTITY, 5L);
} catch (JSONException e) {
    e.printStackTrace();
}
JSONArray items = new JSONArray();
items.put(item);
JSONObject properties = new JSONObject();
try {
    properties.put(ABEventProperty.ITEMS, items);
} catch (JSONException e) {
    e.printStackTrace();
}
Adbrix.getInstance().logEvent(ABEvent.ADD_TO_CART, properties);

Kotlin

val item = JSONObject()
try {
    item.put(ABEventProperty.ITEM_PRODUCT_ID, "상품번호")
    item.put(ABEventProperty.ITEM_PRODUCT_NAME, "상품이름")
    item.put(ABEventProperty.ITEM_CATEGORY1, "식품")
    item.put(ABEventProperty.ITEM_CATEGORY2, "과자")
    item.put(ABEventProperty.ITEM_PRICE, 5000.0)
    item.put(ABEventProperty.ITEM_DISCOUNT, 500.0)
    item.put(ABEventProperty.ITEM_QUANTITY, 5L)
} catch (e: JSONException) {
    e.printStackTrace()
}
val items = JSONArray()
items.put(item)
val properties = JSONObject()
try {
    properties.put(ABEventProperty.ITEMS, items)
} catch (e: JSONException) {
    e.printStackTrace()
}
Adbrix.getInstance().logEvent(ABEvent.ADD_TO_CART, properties)

표준 이벤트 속성

이름	타입	설명	필수
ABEventProperty.ITEMS	Array	상품	✅

관심 상품 추가

사용자가 상품을 관심 목록에 추가하는 동작을 나타내는 이벤트입니다.

Java

JSONObject item = new JSONObject();
try {
    item.put(ABEventProperty.ITEM_PRODUCT_ID, "상품번호");
    item.put(ABEventProperty.ITEM_PRODUCT_NAME, "상품이름");
    item.put(ABEventProperty.ITEM_CATEGORY1, "식품");
    item.put(ABEventProperty.ITEM_CATEGORY2, "과자");
    item.put(ABEventProperty.ITEM_PRICE, 5000.0);
    item.put(ABEventProperty.ITEM_DISCOUNT, 500.0);
    item.put(ABEventProperty.ITEM_QUANTITY, 5L);
} catch (JSONException e) {
    e.printStackTrace();
}
JSONArray items = new JSONArray();
items.put(item);
JSONObject properties = new JSONObject();
try {
    properties.put(ABEventProperty.ITEMS, items);
} catch (JSONException e) {
    e.printStackTrace();
}
Adbrix.getInstance().logEvent(ABEvent.ADD_TO_WISHLIST, properties);

Kotlin

val item = JSONObject()
try {
    item.put(ABEventProperty.ITEM_PRODUCT_ID, "상품번호")
    item.put(ABEventProperty.ITEM_PRODUCT_NAME, "상품이름")
    item.put(ABEventProperty.ITEM_CATEGORY1, "식품")
    item.put(ABEventProperty.ITEM_CATEGORY2, "과자")
    item.put(ABEventProperty.ITEM_PRICE, 5000.0)
    item.put(ABEventProperty.ITEM_DISCOUNT, 500.0)
    item.put(ABEventProperty.ITEM_QUANTITY, 5L)
} catch (e: JSONException) {
    e.printStackTrace()
}
val items = JSONArray()
items.put(item)
val properties = JSONObject()
try {
    properties.put(ABEventProperty.ITEMS, items)
} catch (e: JSONException) {
    e.printStackTrace()
}
Adbrix.getInstance().logEvent(ABEvent.ADD_TO_WISHLIST, properties)

표준 이벤트 속성

이름	타입	설명	필수
ABEventProperty.ITEMS	Array	상품	✅

주문 확인하기

사용자가 상품을 결제하기 전 최종 확인하는 이벤트입니다.

Java

JSONObject item = new JSONObject();
try {
    item.put(ABEventProperty.ITEM_PRODUCT_ID, "상품번호");
    item.put(ABEventProperty.ITEM_PRODUCT_NAME, "상품이름");
    item.put(ABEventProperty.ITEM_CATEGORY1, "식품");
    item.put(ABEventProperty.ITEM_CATEGORY2, "과자");
    item.put(ABEventProperty.ITEM_PRICE, 5000.0);
    item.put(ABEventProperty.ITEM_DISCOUNT, 500.0);
    item.put(ABEventProperty.ITEM_QUANTITY, 5L);
} catch (JSONException e) {
    e.printStackTrace();
}
JSONArray items = new JSONArray();
items.put(item);
JSONObject properties = new JSONObject();
try {
    properties.put(ABEventProperty.ITEMS, items);
} catch (JSONException e) {
    e.printStackTrace();
}
Adbrix.getInstance().logEvent(ABEvent.REVIEW_ORDER, properties);

Kotlin

val item = JSONObject()
try {
    item.put(ABEventProperty.ITEM_PRODUCT_ID, "상품번호")
    item.put(ABEventProperty.ITEM_PRODUCT_NAME, "상품이름")
    item.put(ABEventProperty.ITEM_CATEGORY1, "식품")
    item.put(ABEventProperty.ITEM_CATEGORY2, "과자")
    item.put(ABEventProperty.ITEM_PRICE, 5000.0)
    item.put(ABEventProperty.ITEM_DISCOUNT, 500.0)
    item.put(ABEventProperty.ITEM_QUANTITY, 5L)
} catch (e: JSONException) {
    e.printStackTrace()
}
val items = JSONArray()
items.put(item)
val properties = JSONObject()
try {
    properties.put(ABEventProperty.ITEMS, items)
} catch (e: JSONException) {
    e.printStackTrace()
}
Adbrix.getInstance().logEvent(ABEvent.REVIEW_ORDER, properties)

표준 이벤트 속성

이름	타입	설명	필수
ABEventProperty.ITEMS	Array	상품	✅
ABEventProperty.DELIVERY_CHARGE	Double	배송료 설정

주문 취소하기

사용자가 구매한 주문을 취소하고 환불하는 동작을 나타내는 이벤트입니다.

Java

JSONObject item = new JSONObject();
try {
    item.put(ABEventProperty.ITEM_PRODUCT_ID, "상품번호");
    item.put(ABEventProperty.ITEM_PRODUCT_NAME, "상품이름");
    item.put(ABEventProperty.ITEM_CATEGORY1, "식품");
    item.put(ABEventProperty.ITEM_CATEGORY2, "과자");
    item.put(ABEventProperty.ITEM_PRICE, 5000.0);
    item.put(ABEventProperty.ITEM_DISCOUNT, 500.0);
    item.put(ABEventProperty.ITEM_QUANTITY, 5L);
} catch (JSONException e) {
    e.printStackTrace();
}
JSONArray items = new JSONArray();
items.put(item);
JSONObject properties = new JSONObject();
try {
    properties.put(ABEventProperty.ITEMS, items);
} catch (JSONException e) {
    e.printStackTrace();
}
Adbrix.getInstance().logEvent(ABEvent.REFUND, properties);

Kotlin

val item = JSONObject()
try {
    item.put(ABEventProperty.ITEM_PRODUCT_ID, "상품번호")
    item.put(ABEventProperty.ITEM_PRODUCT_NAME, "상품이름")
    item.put(ABEventProperty.ITEM_CATEGORY1, "식품")
    item.put(ABEventProperty.ITEM_CATEGORY2, "과자")
    item.put(ABEventProperty.ITEM_PRICE, 5000.0)
    item.put(ABEventProperty.ITEM_DISCOUNT, 500.0)
    item.put(ABEventProperty.ITEM_QUANTITY, 5L)
} catch (e: JSONException) {
    e.printStackTrace()
}
val items = JSONArray()
items.put(item)
val properties = JSONObject()
try {
    properties.put(ABEventProperty.ITEMS, items)
} catch (e: JSONException) {
    e.printStackTrace()
}
Adbrix.getInstance().logEvent(ABEvent.REFUND, properties)

표준 이벤트 속성

이름	타입	설명	필수
ABEventProperty.ITEMS	Array	상품	✅
ABEventProperty.PENALTY_CHARGE	Double	페널티 가격

상품 검색하기

사용자가 상품을 검색하여 결과를 확인하는 동작을 나타내는 이벤트입니다.

Java

JSONObject item = new JSONObject();
try {
    item.put(ABEventProperty.ITEM_PRODUCT_ID, "상품번호");
    item.put(ABEventProperty.ITEM_PRODUCT_NAME, "상품이름");
    item.put(ABEventProperty.ITEM_CATEGORY1, "식품");
    item.put(ABEventProperty.ITEM_CATEGORY2, "과자");
    item.put(ABEventProperty.ITEM_PRICE, 5000.0);
    item.put(ABEventProperty.ITEM_DISCOUNT, 500.0);
    item.put(ABEventProperty.ITEM_QUANTITY, 5L);
} catch (JSONException e) {
    e.printStackTrace();
}
JSONArray items = new JSONArray();
items.put(item);
JSONObject properties = new JSONObject();
try {
    properties.put(ABEventProperty.ITEMS, items);
    properties.put(ABEventProperty.KEYWORD, "삼겹살");
} catch (JSONException e) {
    e.printStackTrace();
}
Adbrix.getInstance().logEvent(ABEvent.SEARCH, properties);

Kotlin

val item = JSONObject()
try {
    item.put(ABEventProperty.ITEM_PRODUCT_ID, "상품번호")
    item.put(ABEventProperty.ITEM_PRODUCT_NAME, "상품이름")
    item.put(ABEventProperty.ITEM_CATEGORY1, "식품")
    item.put(ABEventProperty.ITEM_CATEGORY2, "과자")
    item.put(ABEventProperty.ITEM_PRICE, 5000.0)
    item.put(ABEventProperty.ITEM_DISCOUNT, 500.0)
    item.put(ABEventProperty.ITEM_QUANTITY, 5L)
} catch (e: JSONException) {
    e.printStackTrace()
}
val items = JSONArray()
items.put(item)
val properties = JSONObject()
try {
    properties.put(ABEventProperty.ITEMS, items)
    properties.put(ABEventProperty.KEYWORD, "삼겹살")
} catch (e: JSONException) {
    e.printStackTrace()
}
Adbrix.getInstance().logEvent(ABEvent.SEARCH, properties)

표준 이벤트 속성

이름	타입	설명	필수
ABEventProperty.ITEMS	Array	상품	✅
ABEventProperty.KEYWORD	String	검색 키워드	✅

상품 공유하기

사용자가 상품을 공유하는 동작을 나타내는 이벤트입니다.

Java

JSONObject item = new JSONObject();
try {
    item.put(ABEventProperty.ITEM_PRODUCT_ID, "상품번호");
    item.put(ABEventProperty.ITEM_PRODUCT_NAME, "상품이름");
    item.put(ABEventProperty.ITEM_CATEGORY1, "식품");
    item.put(ABEventProperty.ITEM_CATEGORY2, "과자");
    item.put(ABEventProperty.ITEM_PRICE, 5000.0);
    item.put(ABEventProperty.ITEM_DISCOUNT, 500.0);
    item.put(ABEventProperty.ITEM_QUANTITY, 5L);
} catch (JSONException e) {
    e.printStackTrace();
}
JSONArray items = new JSONArray();
items.put(item);
JSONObject properties = new JSONObject();
try {
    properties.put(ABEventProperty.ITEMS, items);
    properties.put(ABEventProperty.SHARING_CHANNEL, ABSharingChannel.FACEBOOK);
} catch (JSONException e) {
    e.printStackTrace();
}
Adbrix.getInstance().logEvent(ABEvent.SHARE, properties);

Kotlin

val item = JSONObject()
try {
    item.put(ABEventProperty.ITEM_PRODUCT_ID, "상품번호")
    item.put(ABEventProperty.ITEM_PRODUCT_NAME, "상품이름")
    item.put(ABEventProperty.ITEM_CATEGORY1, "식품")
    item.put(ABEventProperty.ITEM_CATEGORY2, "과자")
    item.put(ABEventProperty.ITEM_PRICE, 5000.0)
    item.put(ABEventProperty.ITEM_DISCOUNT, 500.0)
    item.put(ABEventProperty.ITEM_QUANTITY, 5L)
} catch (e: JSONException) {
    e.printStackTrace()
}
val items = JSONArray()
items.put(item)
val properties = JSONObject()
try {
    properties.put(ABEventProperty.ITEMS, items)
    properties.put(ABEventProperty.SHARING_CHANNEL, ABSharingChannel.FACEBOOK)
} catch (e: JSONException) {
    e.printStackTrace()
}
Adbrix.getInstance().logEvent(ABEvent.SHARE, properties)

표준 이벤트 속성

이름	타입	설명	필수
ABEventProperty.ITEMS	Array	상품	✅
ABEventProperty.SHARING_CHANNEL	String	상품 공유 채널	✅

상품 목록 조회

사용자가 상품 목록을 조회하는 동작을 나타내는 이벤트입니다.

Java

JSONObject item = new JSONObject();
try {
    item.put(ABEventProperty.ITEM_PRODUCT_ID, "상품번호");
    item.put(ABEventProperty.ITEM_PRODUCT_NAME, "상품이름");
    item.put(ABEventProperty.ITEM_CATEGORY1, "식품");
    item.put(ABEventProperty.ITEM_CATEGORY2, "과자");
    item.put(ABEventProperty.ITEM_PRICE, 5000.0);
    item.put(ABEventProperty.ITEM_DISCOUNT, 500.0);
    item.put(ABEventProperty.ITEM_QUANTITY, 5L);
} catch (JSONException e) {
    e.printStackTrace();
}
JSONArray items = new JSONArray();
items.put(item);
JSONObject properties = new JSONObject();
try {
    properties.put(ABEventProperty.ITEMS, items);
} catch (JSONException e) {
    e.printStackTrace();
}
Adbrix.getInstance().logEvent(ABEvent.LIST_VIEW, properties);

Kotlin

val item = JSONObject()
try {
    item.put(ABEventProperty.ITEM_PRODUCT_ID, "상품번호")
    item.put(ABEventProperty.ITEM_PRODUCT_NAME, "상품이름")
    item.put(ABEventProperty.ITEM_CATEGORY1, "식품")
    item.put(ABEventProperty.ITEM_CATEGORY2, "과자")
    item.put(ABEventProperty.ITEM_PRICE, 5000.0)
    item.put(ABEventProperty.ITEM_DISCOUNT, 500.0)
    item.put(ABEventProperty.ITEM_QUANTITY, 5L)
} catch (e: JSONException) {
    e.printStackTrace()
}
val items = JSONArray()
items.put(item)
val properties = JSONObject()
try {
    properties.put(ABEventProperty.ITEMS, items)
} catch (e: JSONException) {
    e.printStackTrace()
}
Adbrix.getInstance().logEvent(ABEvent.LIST_VIEW, properties)

표준 이벤트 속성

이름	타입	설명	필수
ABEventProperty.ITEMS	Array	상품	✅

장바구니 조회

사용자가 장바구니를 조회하는 동작을 나타내는 이벤트입니다.

Java

JSONObject item = new JSONObject();
try {
    item.put(ABEventProperty.ITEM_PRODUCT_ID, "상품번호");
    item.put(ABEventProperty.ITEM_PRODUCT_NAME, "상품이름");
    item.put(ABEventProperty.ITEM_CATEGORY1, "식품");
    item.put(ABEventProperty.ITEM_CATEGORY2, "과자");
    item.put(ABEventProperty.ITEM_PRICE, 5000.0);
    item.put(ABEventProperty.ITEM_DISCOUNT, 500.0);
    item.put(ABEventProperty.ITEM_QUANTITY, 5L);
} catch (JSONException e) {
    e.printStackTrace();
}
JSONArray items = new JSONArray();
items.put(item);
JSONObject properties = new JSONObject();
try {
    properties.put(ABEventProperty.ITEMS, items);
} catch (JSONException e) {
    e.printStackTrace();
}
Adbrix.getInstance().logEvent(ABEvent.CART_VIEW, properties);

Kotlin

val item = JSONObject()
try {
    item.put(ABEventProperty.ITEM_PRODUCT_ID, "상품번호")
    item.put(ABEventProperty.ITEM_PRODUCT_NAME, "상품이름")
    item.put(ABEventProperty.ITEM_CATEGORY1, "식품")
    item.put(ABEventProperty.ITEM_CATEGORY2, "과자")
    item.put(ABEventProperty.ITEM_PRICE, 5000.0)
    item.put(ABEventProperty.ITEM_DISCOUNT, 500.0)
    item.put(ABEventProperty.ITEM_QUANTITY, 5L)
} catch (e: JSONException) {
    e.printStackTrace()
}
val items = JSONArray()
items.put(item)
val properties = JSONObject()
try {
    properties.put(ABEventProperty.ITEMS, items)
} catch (e: JSONException) {
    e.printStackTrace()
}
Adbrix.getInstance().logEvent(ABEvent.CART_VIEW, properties)

표준 이벤트 속성

이름	타입	설명	필수
ABEventProperty.ITEMS	Array	상품	✅

결제 정보 입력하기

사용자가 결제 정보를 입력한 이벤트입니다.

Java

Adbrix.getInstance().logEvent(ABEvent.PAYMENT_INFO_ADDED);

Kotlin

Adbrix.getInstance().logEvent(ABEvent.PAYMENT_INFO_ADDED)

표준 게임 이벤트 사용 예시

튜토리얼 완료

앱에서 발생한 튜토리얼 완료 이벤트입니다.

Java

JSONObject properties = new JSONObject();
try {
    properties.put(ABEventProperty.IS_SKIP, false);
} catch (JSONException e) {
    e.printStackTrace();
}
Adbrix.getInstance().logEvent(ABEvent.TUTORIAL_COMPLETED, properties);

Kotlin

val properties = JSONObject()
try {
    properties.put(ABEventProperty.IS_SKIP, false)
} catch (e: JSONException) {
    e.printStackTrace()
}
Adbrix.getInstance().logEvent(ABEvent.TUTORIAL_COMPLETED, properties)

표준 이벤트 속성

이름	타입	설명	필수
ABEventProperty.IS_SKIP	Boolean	튜토리얼 skip 여부	✅

캐릭터 생성

앱에서 발생한 캐릭터 생성 이벤트입니다.

Java

Adbrix.getInstance().logEvent(ABEvent.CHARACTER_CREATED);

Kotlin

Adbrix.getInstance().logEvent(ABEvent.CHARACTER_CREATED)

스테이지 완료

앱에서 발생한 스테이지 완료 이벤트입니다.

Java

JSONObject properties = new JSONObject();
try {
    properties.put(ABEventProperty.STAGE, "STAGE_NAME");
} catch (JSONException e) {
    e.printStackTrace();
}
Adbrix.getInstance().logEvent(ABEvent.STAGE_CLEARED, properties);

Kotlin

val properties = JSONObject()
try {
    properties.put(ABEventProperty.STAGE, "STAGE_NAME")
} catch (e: JSONException) {
    e.printStackTrace()
}
Adbrix.getInstance().logEvent(ABEvent.STAGE_CLEARED, properties)

표준 이벤트 속성

이름	타입	설명	필수
ABEventProperty.STAGE	String	스테이지 이름	✅

레벨 달성

앱에서 발생한 레벨 달성 이벤트입니다.

Java

JSONObject properties = new JSONObject();
try {
    properties.put(ABEventProperty.LEVEL, 50);
} catch (JSONException e) {
    e.printStackTrace();
}
Adbrix.getInstance().logEvent(ABEvent.LEVEL_ACHIVED, properties);

Kotlin

val properties = JSONObject()
try {
    properties.put(ABEventProperty.LEVEL, 50)
} catch (e: JSONException) {
    e.printStackTrace()
}
Adbrix.getInstance().logEvent(ABEvent.LEVEL_ACHIVED, properties)

표준 이벤트 속성

이름	타입	설명	필수
ABEventProperty.LEVEL	Integer	사용자 레벨	✅

커스텀 이벤트

사용자가 직접 임의의 이벤트 명칭과 속성을 입력하여 반영하는 이벤트입니다. 표준 이벤트에도 디파이너리 콘솔에서 커스텀 속성을 추가하여 사용할 수 있습니다.

속성이 없을 경우

Java

Adbrix.getInstance().logEvent("CUSTOM_EVENT_NAME", null);

Kotlin

Adbrix.getInstance().logEvent("CUSTOM_EVENT_NAME", null)

속성이 있을 경우

Java

JSONObject properties = new JSONObject();
properties.put("CUSTOM_PROPERTY_KEY", "CUSTOM_PROPERTY_VALUE");//사용자 정의 속성 값(Optional)
Adbrix.getInstance().logEvent("CUSTOM_EVENT_NAME", properties);

Kotlin

val properties = JSONObject()
properties.put("CUSTOM_PROPERTY_KEY", "CUSTOM_PROPERTY_VALUE")//사용자 정의 속성 값(Optional)
Adbrix.getInstance().logEvent("CUSTOM_EVENT_NAME", properties)