Mobility : 모빌리티

모빌리티 앱에서 측정을 권장하는 인앱 이벤트 API와 적용 예시를 안내합니다.

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

차량 등록

차량이 등록된 시점에 아래 코드를 추가합니다.

선택 속성

Key

Value 예시

Type

설명

car_name

레이

string

차량 명칭

car_type

소형

string

차량 유형

car_subtype_a

하이패스

string

차량 기타 속성

Map<String, Object> eventMap = new HashMap<>();
eventMap.put("event", "w_add_car_info");
eventMap.put("car_name", "레이");
eventMap.put("car_type", "소형");
eventMap.put("car_subtype_a", "하이패스");
DOT.logEvent(eventMap);

북마크 등록

특정 위치가 북마크로 등록된 시점에 아래 코드를 추가합니다.

선택 속성

Key

Value 예시

Type

설명

bookmark_type

string

북마크 명칭 또는 유형

city

서울시

string

등록된 위치의 도시 정보

Map<String, Object> eventMap = new HashMap<>();
eventMap.put("event", "w_bookmarked");
eventMap.put("bookmark_type", "집");
eventMap.put("city", "서울시");
DOT.logEvent(eventMap);

결제 수단 등록

결제 수단이 등록 완료된 시점에 아래 코드를 추가합니다.

선택 속성

Key

Value 예시

Type

설명

payment_name

현대카드

string

결제수단 명칭

payment_type

신용카드

string

결제수단 유형

Map<String, Object> eventMap = new HashMap<>();
eventMap.put("event", "w_add_payment_info");
eventMap.put("payment_name", "현대카드");
eventMap.put("payment_type", "신용카드");
DOT.logEvent(eventMap);

목적지 검색

목적지 검색이 완료된 시점에 아래 코드를 추가합니다.

선택 속성

Key

Value 예시

Type

설명

destination_a

선릉역

string

출발 지역

destination_b

올림픽공원

string

도착 지역

g20

2

float

검색 결과로 출력된 아이템 개수

출발지와 목적지를 함께 검색하는 경우

Map<String, Object> eventMap = new HashMap<>();
eventMap.put("event", "w_search_destination");
eventMap.put("destination_a", "선릉역");
eventMap.put("destination_b", "올림픽공원");
eventMap.put("g20", 2);
DOT.logEvent(eventMap);

목적지만 검색하는 경우

Map<String, Object> eventMap = new HashMap<>();
eventMap.put("event", "w_search_destination");
eventMap.put("destination_b", "올림픽공원");
eventMap.put("g20", 2);
DOT.logEvent(eventMap);

차량 호출

차량 호출이 완료된 시점에 아래 코드를 추가합니다.

선택 속성

Key

Value 예시

Type

설명

destination_a

선릉역

string

차량이 출발하는 지역명

destination_b

올림픽공원

string

차량이 도착할 지역명

distance

5.8

float

목적지까지의 거리

city

서울

string

차량을 호출하는 위치가 속한 도시

price

31500

double

운행요금

currency

KRW

string

통화코드

product_id

C30403

string

요청한 상품코드

product_name

베이직

string

요청한 상품명칭

Map<String, Object> eventMap = new HashMap<>();
eventMap.put("event", "w_request_ride");
eventMap.put("destination_a", "선릉역");
eventMap.put("destination_b", "올림픽공원");
eventMap.put("distance", 5.8);
eventMap.put("city", "서울");
eventMap.put("price", 31500);
eventMap.put("currency", "KRW");
Map<String, Object> productMap = new HashMap<>();
productMap.put("product_id", "C30403");
productMap.put("product_name", "베이직");
eventMap.put("product", productMap);
DOT.logEvent(eventMap);

차량 호출 승인

호출이 승인되어 배차가 완료된 시점에 아래 코드를 추가합니다.

선택 속성

Key

Value 예시

Type

설명

destination_a

선릉역

string

차량이 출발하는 지역명

destination_b

올림픽공원

string

차량이 도착할 지역명

distance

5.8

float

목적지까지의 거리

city

서울

string

차량을 호출한 위치가 속한 도시

car_id

V39849

string

배차된 차량 ID

car_type

sedan

string

배차된 차량 유형

driver_id

DR3020

string

배차된 운전자 ID

price

31500

string

운행요금

currency

KRW

string

통화코드

product_id

C30403

string

배차된 상품코드

product_name

베이직

string

배차된 상품명칭

Map<String, Object> eventMap = new HashMap<>();
eventMap.put("event", "w_ride_approved");
eventMap.put("destination_a", "선릉역");
eventMap.put("destination_b", "올림픽공원");
eventMap.put("distance", 5.8);
eventMap.put("city", "서울");
eventMap.put("car_id", "V39849");
eventMap.put("car_type", "sedan");
eventMap.put("driver_id", "DR3020");
eventMap.put("price", 31500);
eventMap.put("currency", "KRW");
Map<String, Object> productMap = new HashMap<>();
productMap.put("product_id", "C30403");
productMap.put("product_name", "베이직");
eventMap.put("product", productMap);
DOT.logEvent(eventMap);

차량 호출 취소

호출이 취소된 시점에 아래 코드를 추가합니다.

선택 속성

Key

Value 예시

Type

설명

destination_a

선릉역

string

차량이 출발하는 지역명

destination_b

올림픽공원

string

차량이 도착할 지역명

distance

5.8

float

목적지까지의 거리

city

서울

string

차량을 호출한 위치가 속한 도시

car_id

V39849

string

배차된 차량 ID

car_type

sedan

string

배차된 차량 유형

driver_id

DR3020

string

배차된 운전자 ID

price

31500

string

운행요금

currency

KRW

string

통화코드

product_id

C30403

string

배차된 상품코드

product_name

베이직

string

배차된 상품명칭

Map<String, Object> eventMap = new HashMap<>();
eventMap.put("event", "w_ride_cancelled");
eventMap.put("destination_a", "선릉역");
eventMap.put("destination_b", "올림픽공원");
eventMap.put("distance", 5.8);
eventMap.put("city", "서울");
eventMap.put("car_id", "V39849");
eventMap.put("car_type", "sedan");
eventMap.put("driver_id", "DR3020");
eventMap.put("price", 31500);
eventMap.put("currency", "KRW");
Map<String, Object> productMap = new HashMap<>();
productMap.put("product_id", "C30403");
productMap.put("product_name", "베이직");
eventMap.put("product", productMap);
DOT.logEvent(eventMap);

운행 종료

차량이 목적지까지 운행을 마치고 비용이 결제된 시점에 아래 코드를 추가합니다.

선택 속성

Key

Value 예시

Type

설명

transaction_id

CL39932003

string

주문번호

destination_a

선릉역

string

차량이 출발한 지역명

destination_b

올림픽공원

string

차량이 도착한 지역명

distance

5.8

float

목적지까지의 거리

city

서울

string

차량을 호출한 위치가 속한 도시

car_id

V39849

string

배차된 차량 ID

car_type

sedan

string

배차된 차량 유형

driver_id

DR3020

string

배차된 운전자 ID

price

31500

string

운행요금

currency

KRW

string

통화코드

riding_time

21

float

운행 시작부터 운행 완료까지의 시간을 분단위로 입력

product_id

C30403

string

배차된 상품코드

product_name

베이직

string

배차된 상품명칭

quantity

1

string

호출한 차량 대수

revenue

31500

double

유저가 결제한 금액

Map<String, Object> purchaseMap = new HashMap<>();
purchaseMap.put("transaction_id", "CL39932003");
purchaseMap.put("destination_a", "선릉역");
purchaseMap.put("destination_b", "올림픽공원");
purchaseMap.put("distance", 5.8);
purchaseMap.put("city", "서울");
purchaseMap.put("car_id", "V39849");
purchaseMap.put("car_type", "sedan");
purchaseMap.put("driver_id", "DR3020");
purchaseMap.put("price", 31500);
purchaseMap.put("currency", "KRW");
purchaseMap.put("riding_time", 21);
Map<String, Object> productMap = new HashMap<>();
productMap.put("product_id", "C30403");
productMap.put("product_name", "베이직");
productMap.put("quantity", 1);
productMap.put("revenue", 31500);
purchaseMap.put("product", productMap);
DOT.logPurchase(purchaseMap);

네비게이션 시작

목적지와 코스가 설정되어 주행안내가 시작된 시점에 아래 코드를 추가합니다.

선택 속성

Key

Value 예시

Type

설명

destination_a

선릉역

string

차량이 출발하는 지역명

destination_b

올림픽공원

string

차량이 도착할 지역명

distance

5.8

float

목적지까지의 거리를 km 단위로 입력

est_arrival_time

20

float

예상되는 주행시간을 분단위로 입력

Map<String, Object> eventMap = new HashMap<>();
eventMap.put("event", "w_navigate");
eventMap.put("destination_a", "선릉역");
eventMap.put("destination_b", "올림픽공원");
eventMap.put("distance", 5.8);
eventMap.put("est_arrival_time", 20);
DOT.logEvent(eventMap);

네비게이션 종료

목적지에 도착하여 주행안내가 종료된 시점에 아래 코드를 추가합니다.

선택 속성

Key

Value 예시

Type

설명

destination_a

선릉역

string

차량이 출발하는 지역명

destination_b

올림픽공원

string

차량이 도착할 지역명

distance

5.8

float

실제 주행거리를 km 단위로 입력

riding_time

21

float

실제 주행시간을 분단위로 입력

Map<String, Object> eventMap = new HashMap<>();
eventMap.put("event", "w_end_navigation");
eventMap.put("destination_a", "선릉역");
eventMap.put("destination_b", "올림픽공원");
eventMap.put("distance", 5.8);
eventMap.put("riding_time", 21);
DOT.logEvent(eventMap);

Last updated