이벤트

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

유의사항

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

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

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

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

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

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

2. Key 값 제한

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

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

3. Value 값 제한

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

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

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

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

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

5. 검증 실패 시 적용 불가

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

이벤트 기록

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

logEvent(_ name: String)
logEvent(name: String, properties: [String: Any])

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

• eventName : 이벤트 이름

• properties : 이벤트 속성

이벤트 기록 예시

Objective-C

// 속성이 없을 경우
[[Adbrix shared] logEvent:ABEvent.SIGN_UP];

// 속성이 있을 경우
NSDictionary *properties = @{
    ABEventProperty.SHARING_CHANNEL: ABSharingChannel.KAKAOTALK
};
[[Adbrix shared] logEvent:ABEvent.SIGN_UP withProperties:properties];

Swift

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

// 속성이 있을 경우
let properties: [String: Any] = [
    ABEventProperty.SHARING_CHANNEL: ABSharingChannel.KAKAOTALK
]
Adbrix.shared().logEvent(name: ABEvent.SIGN_UP, properties: 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 내에 배열로 적재되는 상품에 대한 표준 이벤트 속성에 대한 정보입니다. ITEM_PRODUCT_ID, ITEM_PRODUCT_NAME, ITEM_PRICE, ITEM_QUANTITY, ITEM_DISCOUNT는 필수 값으로 반드시 포함해야 합니다.

상수	이벤트 속성명	타입	설명	필수
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

이벤트 속성 타입 주의사항

이벤트 속성 및 상품 속성 입력 시 정의된 타입과 다른 타입의 값을 전달하면 해당 속성이 적재되지 않습니다. 예를 들어, ABEventProperty.LEVEL은 Int 타입으로 정의되어 있는데 String 타입으로 값을 전달하면 해당 속성은 무시됩니다.

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

로그인

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

Objective-C

[[Adbrix shared] logEvent:ABEvent.LOGIN];

Swift

Adbrix.shared().logEvent(ABEvent.LOGIN)

로그아웃

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

Objective-C

[[Adbrix shared] logEvent:ABEvent.LOGOUT];

Swift

Adbrix.shared().logEvent(ABEvent.LOGOUT)

회원가입

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

Objective-C

NSDictionary *properties = @{
    ABEventProperty.SIGN_CHANNEL: ABSignUpChannel.KAKAO
};
[[Adbrix shared] logEvent:ABEvent.SIGN_UP withProperties:properties];

Swift

let properties: [String: Any] = [
    ABEventProperty.SIGN_CHANNEL: ABSignUpChannel.KAKAO
]
Adbrix.shared().logEvent(name: ABEvent.SIGN_UP, properties: properties)

표준 이벤트 속성

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

앱 업데이트

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

Objective-C

NSDictionary *properties = @{
    ABEventProperty.PREV_VER: @"1.0.0",
    ABEventProperty.CURR_VER: @"1.0.1"
};
[[Adbrix shared] logEvent:ABEvent.SIGN_UP withProperties:properties];

Swift

let properties: [String: Any] = [
    ABEventProperty.PREV_VER: "1.0.0",
    ABEventProperty.CURR_VER: "1.0.1"
]
Adbrix.shared().logEvent(name: ABEvent.SIGN_UP, properties: properties)

표준 이벤트 속성

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

사용자 초대

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

Objective-C

NSDictionary *properties = @{
    ABEventProperty.INVITE_CHANNEL: ABInviteChannel.KAKAO
};
[[Adbrix shared] logEvent:ABEvent.INVITE withProperties:properties];

Swift

let properties: [String: Any] = [
    ABEventProperty.INVITE_CHANNEL: ABInviteChannel.KAKAO
]
Adbrix.shared().logEvent(name: ABEvent.INVITE, properties: properties)

표준 이벤트 속성

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

크레딧 사용

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

Objective-C

[[Adbrix shared] logEvent:ABEvent.USE_CREDIT];

Swift

Adbrix.shared().logEvent(ABEvent.USE_CREDIT)

구매

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

Objective-C

NSDictionary *item = @{
    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
};
NSArray *items = @[item];
NSDictionary *properties = @{
    ABEventProperty.ITEMS: items,
    ABEventProperty.ORDER_ID: @"상품번호",
    ABEventProperty.ORDER_SALES: @10000.0,
    ABEventProperty.PAYMENT_METHOD: ABPaymentMethod.CREDIT_CARD,
    ABEventProperty.DELIVERY_CHARGE: @3000.0,
    ABEventProperty.DISCOUNT: @0
};
[[Adbrix shared] logEvent:ABEvent.PURCHASE withProperties:properties];

Swift

let item: [String: Any] = [
    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
]
let items = [item]
let properties: [String: Any] = [
    ABEventProperty.ITEMS: items,
    ABEventProperty.ORDER_ID: "상품번호",
    ABEventProperty.ORDER_SALES: 10000.0,
    ABEventProperty.PAYMENT_METHOD: ABPaymentMethod.CREDIT_CARD,
    ABEventProperty.DELIVERY_CHARGE: 3000.0,
    ABEventProperty.DISCOUNT: 0
]
Adbrix.shared().logEvent(name: ABEvent.PURCHASE, properties: properties)

표준 이벤트 속성

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

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

홈 화면 진입

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

Objective-C

[[Adbrix shared] logEvent:ABEvent.VIEW_HOME];

Swift

Adbrix.shared().logEvent(ABEvent.VIEW_HOME)

카테고리 진입

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

Objective-C

NSDictionary *item = @{
    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
};
NSArray *items = @[item];
NSDictionary *properties = @{
    ABEventProperty.ITEMS: items,
    ABEventProperty.CATEGORY1: @"식품"
};
[[Adbrix shared] logEvent:ABEvent.CATEGORY_VIEW withProperties:properties];

Swift

let item: [String: Any] = [
    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
]
let items = [item]
let properties: [String: Any] = [
    ABEventProperty.ITEMS: items,
    ABEventProperty.CATEGORY1: "식품"
]
Adbrix.shared().logEvent(name: ABEvent.CATEGORY_VIEW, properties: properties)

표준 이벤트 속성

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

상품 상세 보기

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

Objective-C

NSDictionary *item = @{
    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
};
NSArray *items = @[item];
NSDictionary *properties = @{
    ABEventProperty.ITEMS: items
};
[[Adbrix shared] logEvent:ABEvent.PRODUCT_VIEW withProperties:properties];

Swift

let item: [String: Any] = [
    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
]
let items = [item]
let properties: [String: Any] = [
    ABEventProperty.ITEMS: items
]
Adbrix.shared().logEvent(name: ABEvent.PRODUCT_VIEW, properties: properties)

표준 이벤트 속성

이름	타입	설명	필수
ABEventProperty.ITEMS	Array<[String: Any]>	상품	✅

장바구니 담기

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

Objective-C

NSDictionary *item = @{
    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
};
NSArray *items = @[item];
NSDictionary *properties = @{
    ABEventProperty.ITEMS: items
};
[[Adbrix shared] logEvent:ABEvent.ADD_TO_CART withProperties:properties];

Swift

let item: [String: Any] = [
    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
]
let items = [item]
let properties: [String: Any] = [
    ABEventProperty.ITEMS: items
]
Adbrix.shared().logEvent(name: ABEvent.ADD_TO_CART, properties: properties)

표준 이벤트 속성

이름	타입	설명	필수
ABEventProperty.ITEMS	Array<[String: Any]>	상품	✅

관심 상품 추가

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

Objective-C

NSDictionary *item = @{
    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
};
NSArray *items = @[item];
NSDictionary *properties = @{
    ABEventProperty.ITEMS: items
};
[[Adbrix shared] logEvent:ABEvent.ADD_TO_WISHLIST withProperties:properties];

Swift

let item: [String: Any] = [
    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
]
let items = [item]
let properties: [String: Any] = [
    ABEventProperty.ITEMS: items
]
Adbrix.shared().logEvent(name: ABEvent.ADD_TO_WISHLIST, properties: properties)

표준 이벤트 속성

이름	타입	설명	필수
ABEventProperty.ITEMS	Array<[String: Any]>	상품	✅

주문 확인하기

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

Objective-C

NSDictionary *item = @{
    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
};
NSArray *items = @[item];
NSDictionary *properties = @{
    ABEventProperty.ITEMS: items
};
[[Adbrix shared] logEvent:ABEvent.REVIEW_ORDER withProperties:properties];

Swift

let item: [String: Any] = [
    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
]
let items = [item]
let properties: [String: Any] = [
    ABEventProperty.ITEMS: items
]
Adbrix.shared().logEvent(name: ABEvent.REVIEW_ORDER, properties: properties)

표준 이벤트 속성

이름	타입	설명	필수
ABEventProperty.ITEMS	Array<[String: Any]>	상품	✅

주문 취소하기

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

Objective-C

NSDictionary *item = @{
    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
};
NSArray *items = @[item];
NSDictionary *properties = @{
    ABEventProperty.ITEMS: items
};
[[Adbrix shared] logEvent:ABEvent.REFUND withProperties:properties];

Swift

let item: [String: Any] = [
    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
]
let items = [item]
let properties: [String: Any] = [
    ABEventProperty.ITEMS: items
]
Adbrix.shared().logEvent(name: ABEvent.REFUND, properties: properties)

표준 이벤트 속성

이름	타입	설명	필수
ABEventProperty.ITEMS	Array<[String: Any]>	상품	✅

상품 검색하기

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

Objective-C

NSDictionary *item = @{
    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)
};

NSArray *items = @[item];

NSDictionary *properties = @{
    ABEventProperty.ITEMS: items,
    ABEventProperty.KEYWORD: @"삼겹살"
};

[[Adbrix shared] logEvent:ABEvent.SEARCH withProperties:properties];

Swift

let item: [String: Any] = [
    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
]

let items = [item]

let properties: [String: Any] = [
    ABEventProperty.ITEMS: items,
    ABEventProperty.KEYWORD: "삼겹살"
]

Adbrix.shared().logEvent(name: ABEvent.SEARCH, properties: properties)

표준 이벤트 속성

이름	타입	설명	필수
ABEventProperty.ITEMS	Array<[String: Any]>	상품	✅
ABEventProperty.KEYWORD	String	검색 키워드	✅

상품 공유하기

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

Objective-C

NSDictionary *item = @{
    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)
};

NSArray *items = @[item];

NSDictionary *properties = @{
    ABEventProperty.ITEMS: items,
    ABEventProperty.SHARING_CHANNEL: ABSharingChannel.FACEBOOK
};

[[Adbrix shared] logEvent:ABEvent.SHARE withProperties:properties];

Swift

let item: [String: Any] = [
    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
]

let items = [item]

let properties: [String: Any] = [
    ABEventProperty.ITEMS: items,
    ABEventProperty.SHARING_CHANNEL: ABSharingChannel.FACEBOOK
]

Adbrix.shared().logEvent(name: ABEvent.SHARE, properties: properties)

상품 목록 조회

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

Objective-C

NSDictionary *item = @{
    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
};

NSArray *items = @[item];

NSDictionary *properties = @{
    ABEventProperty.ITEMS: items
};

[[Adbrix shared] logEvent:ABEvent.LIST_VIEW withProperties:properties];

Swift

let item: [String: Any] = [
    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
]

let items = [item]

let properties: [String: Any] = [
    ABEventProperty.ITEMS: items
]

Adbrix.shared().logEvent(name: ABEvent.LIST_VIEW, properties: properties)

표준 이벤트 속성

이름	타입	설명	필수
ABEventProperty.ITEMS	Array<[String: Any]>	상품	✅

장바구니 조회

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

Objective-C

NSDictionary *item = @{
    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
};

NSArray *items = @[item];

NSDictionary *properties = @{
    ABEventProperty.ITEMS: items
};

[[Adbrix shared] logEvent:ABEvent.CART_VIEW withProperties:properties];

Swift

let item: [String: Any] = [
    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
]

let items = [item]

let properties: [String: Any] = [
    ABEventProperty.ITEMS: items
]

Adbrix.shared().logEvent(name: ABEvent.CART_VIEW, properties: properties)

표준 이벤트 속성

이름	타입	설명	필수
ABEventProperty.ITEMS	Array<[String: Any]>	상품	✅

결제 정보 입력하기

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

Objective-C

[[Adbrix shared] logEvent:ABEvent.PAYMENT_INFO_ADDED];

Swift

Adbrix.shared().logEvent(ABEvent.PAYMENT_INFO_ADDED)

표준 게임 이벤트 사용 예시

튜토리얼 완료

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

Objective-C

NSDictionary *properties = @{
    ABEventProperty.IS_SKIP: @(NO)
};

[[Adbrix shared] logEvent:ABEvent.TUTORIAL_COMPLETED withProperties:properties];

Swift

let properties: [String: Any] = [
    ABEventProperty.IS_SKIP: false
]

Adbrix.shared().logEvent(name: ABEvent.TUTORIAL_COMPLETED, properties: properties)

캐릭터 생성

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

Objective-C

[[Adbrix shared] logEvent:ABEvent.CHARACTER_CREATED];

Swift

Adbrix.shared().logEvent(ABEvent.CHARACTER_CREATED)

스테이지 완료

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

Objective-C

NSDictionary *properties = @{
    ABEventProperty.STAGE: @"STAGE_NAME"
};

[[Adbrix shared] logEvent:ABEvent.STAGE_CLEARED withProperties:properties];

Swift

let properties: [String: Any] = [
    ABEventProperty.STAGE: "STAGE_NAME"
]

Adbrix.shared().logEvent(name: ABEvent.STAGE_CLEARED, properties: properties)

레벨 달성

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

Objective-C

NSDictionary *properties = @{
    ABEventProperty.LEVEL: @(50)
};

[[Adbrix shared] logEvent:ABEvent.LEVEL_ACHIVED withProperties:properties];

Swift

let properties: [String: Any] = [
    ABEventProperty.LEVEL: 50
]

Adbrix.shared().logEvent(name: ABEvent.LEVEL_ACHIVED, properties: properties)

커스텀 이벤트

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

속성이 없을 경우

Objective-C

[[Adbrix shared] logEvent:@"CUSTOM_EVENT_NAME"];

Swift

Adbrix.shared().logEvent("CUSTOM_EVENT_NAME")

속성이 있을 경우

Objective-C

NSDictionary *properties = @{
    @"CUSTOM_PROPERTY_KEY": @"CUSTOM_PROPERTY_VALUE"
};

[[Adbrix shared] logEvent:@"CUSTOM_EVENT_NAME" withProperties:properties];

Swift

let properties: [String: Any] = [
    "CUSTOM_PROPERTY_KEY": "CUSTOM_PROPERTY_VALUE"
]

Adbrix.shared().logEvent(name: "CUSTOM_EVENT_NAME", properties: properties)