e-Commerce : 이커머스

이커머스 앱에서 측정을 권장하는 인앱 이벤트 API와 적용 예시를 안내합니다.

☑️속성 중 Key 이름은 가이드에 나와있는 Key 이름을 그대로 사용 해 주세요. (임의로 변경시 대시보드에서 데이터 확인이 어렵습니다. > product_id , product_name 등)

상품 조회

상품 상세 화면에 아래 코드를 추가합니다.

선택 속성

Key

Value 예시

Type

설명

product_id

2007289429

string

상품 고유코드

product_name

플랩 더블 버튼 트렌치코트

string

상품명

category_id_a

00100

string

대 카테고리 코드

category_name_a

여성패션

string

대 카테고리 명칭

category_id_b

2984

string

중 카테고리 코드

category_name_b

트렌치코드

string

중 카테고리 명칭

brand_name

STUDIO TOMBOY

string

브랜드 명칭

Map<String, Object> pageMap = new HashMap<>();
pageMap.put("event", "w_view_product");
Map<String, Object> productMap = new HashMap<>();
productMap.put("product_id", "2007289429");
productMap.put("product_name", "플랩 더블 버튼 트렌치코트");
productMap.put("category_id_a", "00100");
productMap.put("category_name_a", "여성패션");
productMap.put("category_id_b", "2984");
productMap.put("category_name_b", "트렌치코드");
productMap.put("brand_name", "STUDIO TOMBOY");
pageMap.put("product", productMap);
DOT.logScreen(pageMap);

상품 리스트 조회

상품 리스트 상세 화면에 아래 코드를 추가합니다.

Map<String, Object> pageMap = new HashMap<>();
pageMap.put("event", "w_view_product_list");
DOT.logScreen(pageMap);

상품 공유

상품 공유 버튼이 클릭되는 시점에 아래 코드를 추가합니다.

선택 속성

Key

Value 예시

Type

설명

share_type

kakao

string

상품이 공유된 미디어

product_id

2007289429

string

상품 고유코드

product_name

플랩 더블 버튼 트렌치코트

string

상품명

category_id_a

00100

string

대 카테고리 코드

category_name_a

여성패션

string

대 카테고리 명칭

category_id_b

2984

string

중 카테고리 코드

category_name_b

트렌치코드

string

중 카테고리 명칭

brand_name

STUDIO TOMBOY

string

브랜드 명칭

Map<String, Object> eventMap = new HashMap<>();
eventMap.put("event", "w_share");
eventMap.put("share_type", "kakao");
Map<String, Object> productMap = new HashMap<>();
productMap.put("product_id", "2007289429");
productMap.put("product_name", "플랩 더블 버튼 트렌치코트");
productMap.put("category_id_a", "00100");
productMap.put("category_name_a", "여성패션");
productMap.put("category_id_b", "2984");
productMap.put("category_name_b", "트렌치코드");
productMap.put("brand_name", "STUDIO TOMBOY");
eventMap.put("product", productMap);
DOT.logEvent(eventMap);

쿠폰 다운로드

쿠폰이 다운로드된 시점에 아래 코드를 추가합니다.

선택 속성

Key

Value 예시

Type

설명

coupon_name

신규가입기념 20% 할인

string

쿠폰의 명칭이나 ID

Map<String, Object> eventMap = new HashMap<>();
eventMap.put("event", "w_download_coupon");
eventMap.put("coupon_name", "신규가입기념 20% 할인");
DOT.logEvent(eventMap);

쿠폰 사용하기

쿠폰을 사용 완료하는 시점에 아래 코드를 추가합니다.

선택 속성

Key

Value 예시

Type

설명

coupon_name

신규가입기념 20% 할인

string

쿠폰의 명칭이나 ID

g1

5000

float

쿠폰 할인 금액

Map<String, Object> eventMap = new HashMap<>();
eventMap.put("event", "w_use_coupon");
eventMap.put("coupon_name", "신규가입기념 20% 할인");
eventMap.put("g1", 5000);
DOT.logEvent(eventMap);

크레딧 사용하기

크레딧을 사용 완료하는 시점에 아래 코드를 추가합니다.

선택 속성

Key

Value 예시

Type

설명

credit_name

네이버페이 크레딧

string

크레딧의 명칭이나 ID

g3

7500

float

크레딧 할인금액

Map<String, Object> eventMap = new HashMap<>();
eventMap.put("event", "w_use_credit");
eventMap.put("credit_name", "네이버페이 크레딧");
eventMap.put("g3", 7500);
DOT.logEvent(eventMap);

기타 할인 사용하기

쿠폰 및 크레딧 이외 기타 할인을 사용 완료하는 시점에 아래 코드를 추가합니다.

선택 속성

Key

Value 예시

Type

설명

g5

10000

float

기타 할인 금액

Map<String, Object> eventMap = new HashMap<>();
eventMap.put("event", "w_other_discounts");
eventMap.put("g1", 10000);
DOT.logEvent(eventMap);

상품 리뷰조회

상품의 리뷰를 조회하는 시점 또는 리뷰 상세화면에 아래 코드를 추가합니다.

선택 속성

Key

Value 예시

Type

설명

product_id

2007289429

string

상품 고유코드

product_name

플랩 더블 버튼 트렌치코트

string

상품명

category_id_a

00100

string

대 카테고리 코드

category_name_a

여성패션

string

대 카테고리 명칭

category_id_b

2984

string

중 카테고리 코드

category_name_b

트렌치코드

string

중 카테고리 명칭

brand_name

STUDIO TOMBOY

string

브랜드 명칭

Map<String, Object> eventMap = new HashMap<>();
eventMap.put("event", "w_see_review");
Map<String, Object> productMap = new HashMap<>();
productMap.put("product_id", "2007289429");
productMap.put("product_name", "플랩 더블 버튼 트렌치코트");
productMap.put("category_id_a", "00100");
productMap.put("category_name_a", "여성패션");
productMap.put("category_id_b", "2984");
productMap.put("category_name_b", "트렌치코드");
productMap.put("brand_name", "STUDIO TOMBOY");
eventMap.put("product", productMap);
DOT.logEvent(eventMap);

기획전 조회

기획전 상세 화면에 아래 코드를 추가합니다.

선택 속성

Key

Value 예시

Type

설명

exhibition_id

2009022840

string

기획전 고유번호

exhibition_name

MD PICK! 내 피부를 위한 건강한 선택

string

기획전 명칭

Map<String, Object> eventMap = new HashMap<>();
eventMap.put("event", "w_view_exhibition");
eventMap.put("exhibition_id", "2009022840");
eventMap.put("exhibition_name", "MD PICK! 내 피부를 위한 건강한 선택");
DOT.logEvent(eventMap);

이벤트 조회

이벤트 상세화면에 아래 코드를 추가합니다.

선택 속성

Key

Value 예시

Type

설명

event_id

E200905605

string

이벤트 고유번호

event_name

10월 COUPON PACK

string

이벤트 명칭

Map<String, Object> eventMap = new HashMap<>();
eventMap.put("event", "w_view_event");
eventMap.put("event_id", "E200905605");
eventMap.put("event_name", "10월 COUPON PACK");
DOT.logEvent(eventMap);

이벤트 참여 완료

이벤트 참여 완료 시점에 아래 코드를 추가합니다.

선택 속성

Key

Value 예시

Type

설명

event_id

E200905605

string

이벤트 고유번호

event_name

10월 COUPON PACK

string

이벤트 명칭

Map<String, Object> eventMap = new HashMap<>();
eventMap.put("event", "w_event_participated");
eventMap.put("event_id", "E200905605");
eventMap.put("event_name", "10월 COUPON PACK");
DOT.logEvent(eventMap);

위시리스트에 추가

상품이 위시리스트에 추가된 시점에 아래 코드를 추가합니다.

선택 속성

Key

Value 예시

Type

설명

product_id

301056226

string

상품 고유코드

product_name

wool cropped vest (navy)

string

상품명

category_id_a

c294

string

대 카테고리 코드

category_name_a

women

string

대 카테고리 명칭

category_id_b

d3775

string

중 카테고리 코드

category_name_b

니트웨어

string

중 카테고리 명칭

brand_name

blank03

string

브랜드 명칭

Map<String, Object> eventMap = new HashMap<>();
eventMap.put("event", "w_add_to_wishlist");
Map<String, Object> productMap = new HashMap<>();
productMap.put("product_id", "301056226");
productMap.put("product_name", "wool cropped vest (navy)");
productMap.put("category_id_a", "c294");
productMap.put("category_name_a", "women");
productMap.put("category_id_b", "d3775");
productMap.put("category_name_b", "니트웨어");
productMap.put("brand_name", "blank03");
eventMap.put("product", productMap);
DOT.logEvent(eventMap);

위시리스트에서 제거

상품이 위시리스트에 제거된 시점에 아래 코드를 추가합니다.

선택 속성

Key

Value 예시

Type

설명

product_id

301056226

string

상품 고유코드

product_name

wool cropped vest (navy)

string

상품명

category_id_a

c294

string

대 카테고리 코드

category_name_a

women

string

대 카테고리 명칭

category_id_b

d3775

string

중 카테고리 코드

category_name_b

니트웨어

string

중 카테고리 명칭

brand_name

blank03

string

브랜드 명칭

Map<String, Object> eventMap = new HashMap<>();
eventMap.put("event", "w_remove_from_wishlist");
Map<String, Object> productMap = new HashMap<>();
productMap.put("product_id", "301056226");
productMap.put("product_name", "wool cropped vest (navy)");
productMap.put("category_id_a", "c294");
productMap.put("category_name_a", "women");
productMap.put("category_id_b", "d3775");
productMap.put("category_name_b", "니트웨어");
productMap.put("brand_name", "blank03");
eventMap.put("product", productMap);
DOT.logEvent(eventMap);

장바구니 조회

장바구니 화면에 아래 코드를 추가합니다.

Map<String, Object> pageMap = new HashMap<>();
pageMap.put("event", "w_view_cart");
DOT.logScreen(pageMap);

장바구니에 추가

상품이 장바구니에 추가되는 시점에 아래 코드를 추가합니다.

선택 속성

Key

Value 예시

Type

설명

product_id

301056226, 301053552

string

상품 고유코드

product_name

wool cropped vest (navy), white calf_Libra

string

상품명

category_id_a

c294, c493

string

대 카테고리 코드

category_name_a

women, men

string

대 카테고리 명칭

category_id_b

d3775, d5783

string

중 카테고리 코드

category_name_b

니트웨어, 스니커즈

string

중 카테고리 명칭

brand_name

blank03, IMMATERIAL

string

브랜드 명칭

quantity

1, 2

integer

상품 개수

한가지 상품이 장바구니에 추가된 경우

Map<String, Object> eventMap = new HashMap<>();
eventMap.put("event", "w_add_to_cart");
Map<String, Object> productMap = new HashMap<>();
productMap.put("product_id", "301056226");
productMap.put("product_name", "wool cropped vest (navy)");
productMap.put("category_id_a", "c294");
productMap.put("category_name_a", "women");
productMap.put("category_id_b", "d3775");
productMap.put("category_name_b", "니트웨어");
productMap.put("brand_name", "blank03");
productMap.put("quantity", 1);
eventMap.put("product", productMap);
DOT.logEvent(eventMap);

두가지 이상의 상품이 장바구니에 추가된 경우

Map<String, Object> eventMap = new HashMap<>();
eventMap.put("event", "w_add_to_cart");
Map<String, Object> productMap1 = new HashMap<>();
productMap1.put("product_id", "301056226");
productMap1.put("product_name", "wool cropped vest (navy)");
productMap1.put("category_id_a", "c294");
productMap1.put("category_name_a", "women");
productMap1.put("category_id_b", "d3775");
productMap1.put("category_name_b", "니트웨어");
productMap1.put("brand_name", "blank03");
productMap1.put("quantity", 1);
Map<String, Object> productMap2 = new HashMap<>();
productMap2.put("product_id", "301053552");
productMap2.put("product_name", "white calf_Libra");
productMap2.put("category_id_a", "c493");
productMap2.put("category_name_a", "men");
productMap2.put("category_id_b", "d5783");
productMap2.put("category_name_b", "스니커즈");
productMap2.put("brand_name", "IMMATERIAL");
productMap2.put("quantity", 2);
List<Map<String, Object>> productList = new ArrayList<>();
productList.add(productMap1);
productList.add(productMap2);
eventMap.put("product", productList);
DOT.logEvent(eventMap);

장바구니에서 제거

상품이 장바구니에서 제거되는 시점에 아래 코드를 추가합니다.

선택 속성

Key

Value 예시

Type

설명

product_id

301056226, 301053552

string

상품 고유코드

product_name

wool cropped vest (navy), white calf_Libra

string

상품명

category_id_a

c294, c493

string

대 카테고리 코드

category_name_a

women, men

string

대 카테고리 명칭

category_id_b

d3775, d5783

string

중 카테고리 코드

category_name_b

니트웨어, 스니커즈

string

중 카테고리 명칭

brand_name

blank03, IMMATERIAL

string

브랜드 명칭

quantity

1, 2

integer

상품 개수

한가지 상품이 장바구니에서 제거된 경우

Map<String, Object> eventMap = new HashMap<>();
eventMap.put("event", "w_remove_from_cart");
Map<String, Object> productMap = new HashMap<>();
productMap.put("product_id", "301056226");
productMap.put("product_name", "wool cropped vest (navy)");
productMap.put("category_id_a", "c294");
productMap.put("category_name_a", "women");
productMap.put("category_id_b", "d3775");
productMap.put("category_name_b", "니트웨어");
productMap.put("brand_name", "blank03");
productMap.put("quantity", 1);
eventMap.put("product", productMap);
DOT.logEvent(eventMap);

두가지 이상의 상품이 장바구니에서 제거된 경우

Map<String, Object> eventMap = new HashMap<>();
eventMap.put("event", "w_remove_from_cart");
Map<String, Object> productMap1 = new HashMap<>();
productMap1.put("product_id", "301056226");
productMap1.put("product_name", "wool cropped vest (navy)");
productMap1.put("category_id_a", "c294");
productMap1.put("category_name_a", "women");
productMap1.put("category_id_b", "d3775");
productMap1.put("category_name_b", "니트웨어");
productMap1.put("brand_name", "blank03");
productMap1.put("quantity", 1);
Map<String, Object> productMap2 = new HashMap<>();
productMap2.put("product_id", "301053552");
productMap2.put("product_name", "white calf_Libra");
productMap2.put("category_id_a", "c493");
productMap2.put("category_name_a", "men");
productMap2.put("category_id_b", "d5783");
productMap2.put("category_name_b", "스니커즈");
productMap2.put("brand_name", "IMMATERIAL");
productMap2.put("quantity", 2);
List<Map<String, Object>> productList = new ArrayList<>();
productList.add(productMap1);
productList.add(productMap2);
eventMap.put("product", productList);
DOT.logEvent(eventMap);

구매

구매 완료화면에 아래 코드를 추가합니다.

선택 속성

Key

Value 예시

Type

설명

transaction_id

P20154829420, P20154829421

string

주문번호

currency

KRW

string

결제 통화코드

product_id

301056226, 301053552

string

상품 고유코드

product_name

wool cropped vest (navy), white calf_Libra

string

상품명

category_id_a

c294, c493

string

대 카테고리 코드

category_name_a

women, men

string

대 카테고리 명칭

category_id_b

d3775, d5783

string

중 카테고리 코드

category_name_b

니트웨어, 스니커즈

string

중 카테고리 명칭

brand_name

blank03, IMMATERIAL

string

브랜드 명칭

quantity

1, 2

integer

상품 개수

revenue

84550, 518000

double

유저가 실 결제한 금액

한가지 상품이 구매된 경우

Map<String, Object> purchaseMap = new HashMap<>();
purchaseMap.put("transaction_id", "P20154829420");
purchaseMap.put("currency", "KRW");
Map<String, Object> productMap = new HashMap<>();
productMap.put("product_id", "301056226");
productMap.put("product_name", "wool cropped vest (navy)");
productMap.put("category_id_a", "c294");
productMap.put("category_name_a", "women");
productMap.put("category_id_b", "d3775");
productMap.put("category_name_b", "니트웨어");
productMap.put("brand_name", "blank03");
productMap.put("quantity", 1);
productMap.put("revenue", 84550);
purchaseMap.put("product", productMap);
DOT.logPurchase(purchaseMap);

두가지 이상의 상품이 구매된 경우

Map<String, Object> purchaseMap = new HashMap<>();
purchaseMap.put("transaction_id", "P20154829421");
purchaseMap.put("currency", "KRW");
Map<String, Object> productMap1 = new HashMap<>();
productMap1.put("product_id", "301056226");
productMap1.put("product_name", "wool cropped vest (navy)");
productMap1.put("category_id_a", "c294");
productMap1.put("category_name_a", "women");
productMap1.put("category_id_b", "d3775");
productMap1.put("category_name_b", "니트웨어");
productMap1.put("brand_name", "blank03");
productMap1.put("quantity", 1);
productMap1.put("revenue", 84550);
Map<String, Object> productMap2 = new HashMap<>();
productMap2.put("product_id", "301053552");
productMap2.put("product_name", "white calf_Libra");
productMap2.put("category_id_a", "c493");
productMap2.put("category_name_a", "men");
productMap2.put("category_id_b", "d5783");
productMap2.put("category_name_b", "스니커즈");
productMap2.put("brand_name", "IMMATERIAL");
productMap2.put("quantity", 2);
productMap2.put("revenue", 518000);
List<Map<String, Object>> productList = new ArrayList<>();
productList.add(productMap1);
productList.add(productMap2);
purchaseMap.put("product", productList);
DOT.logPurchase(purchaseMap);

환불

환불이 완료된 시점에 아래 코드를 추가합니다.

선택 속성

Key

Value 예시

Type

설명

refund_id

R44893

string

환불 고유번호

currency

KRW

string

통화코드

g6

518000

float

유저가 환불받은 금액

Map<String, Object> eventMap = new HashMap<>();
eventMap.put("event", "w_refund");
eventMap.put("refund_id", "R44893");
eventMap.put("currency", "KRW");
eventMap.put("g6", 518000);
DOT.logEvent(eventMap);

Last updated