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
Was this helpful?