- 인쇄
구매 전환 트래킹
- 인쇄
샵라이브에서 제공하는 스크립트를 통해 아래와 같은 조건 하에 구매 전환율을 트래킹할 수 있습니다.
사용자가 라이브(또는 다시보기) 및 숏폼 영상을 3초 이상 시청한 후,
해당 유저가 영상에 등록된 상품을 시청한 날로부터 최대 28일 이내에 구매로 인식된 경우,
이를 구매 전환으로 기록합니다.
구매 전환은 사용자가 마지막으로 시청한 영상을 기준으로 기록하며, 라이브(다시보기)와 숏폼은 각각 별도로 기록합니다. 따라서 하나의 구매가 발생할 경우, 라이브(다시보기)와 숏폼 각각에 구매 전환으로 기록되어 확인할 수 있습니다.
sendConversionEvent
구매 완료 페이지에서 사용하는 sendConversionEvent()
함수는 사용자가 구매한 상품의 product 식별값을 주요 정보로 하여, 상품의 구매 이벤트를 기록하고 시청 정보와 매핑하여 시청과 구매의 연관성을 기록합니다.
로그인한 사용자의 경우, 시청 시와 동일한 방식으로 사용자 인증 기능을 사용하여 시청과 구매의 사용자를 인식합니다. 비로그인 상태의 사용자는 로컬 스토리지에 저장된 사용자 식별값을 통해 시청과 구매를 연결합니다.
conversionConfig
Property name | Type | Description |
---|---|---|
accessKey (필수) | String | 계정 AccessKey |
eventType (필수) | String | ‘purchase’ |
products (필수) | Products | Products object |
사용자 인증
userId
일반적으로 사용하는 사용자 인증 기능을 통해 유저인증을 하여 구매/시청 데이터 연관에 사용됩니다.
User object
사용자의 내용을 기술하는 object입니다.
Property name | Type | Description |
---|---|---|
userId | String | 유저 인증 시 필수값인 사용자 Id (구매 전환 트래킹을 위한 필수값은 아닙니다.) |
userName | String | 사용자 이름 |
anonId
구매전환 트래킹 시 사용할 수 있는 anonymous ID입니다. 별도로 관리하시는 device ID 등의 식별값이 있을 경우, 이 값을 anonId로 입력하면 사용자 인증 없이도 시청/구매 데이터를 연관시킬 수 있습니다. 별도로 관리하는 값이 없다면 사용하지 않으셔도 무방합니다.
<script type="text/javascript" src="https://static.shoplive.cloud/shoplive.js"></script>
<script>
// 액세스 키와 anonID로 Shoplive 초기화
cloud.shoplive.init({
accessKey: 'YOUR_ACCESS_KEY',
anonId: 'USER_ANON_ID'
});
// 여기에 추가 코드를 추가할 수 있습니다.
</script>
구매 상품 정보 (Products)
구매 전환 트래킹 시 사용할 수 있는 구매된 상품 정보 목록입니다.
products
구매된 상품의 내용을 기술하는 object입니다.
Property name | Type | Description |
---|---|---|
sku | productId | customerProductId (필수) | String | 세가지 중 하나의 값은 상품 매칭을 위해 필수 |
purchaseUnitPrice | Int | 구입가격(미기입 시 등록된 상품의 가격을 사용) |
purchaseQuantity | Int | 구매갯수(미기입 시 1개로 인식) |
orderId | String | 주문번호(선택) |
Sample code
SKU 사용 / 로그인 유저
<script type="text/javascript" src="https://static.shoplive.cloud/shoplive.js"></script>
<script>
cloud.shoplive.init({
accessKey: 'YOUR_ACCESS_KEY'
});
// 로그인 사용자일 경우 인증 처리
cloud.shoplive.setUserObject({
userId: 'USER_ID'
});
// 상품 정보 등이 들어있는 conversionConfig 선언
// purchaseUnitPrice, purchaseQuantity는 생략 가능합니다.
var conversionConfig = {
accessKey: 'YOUR_ACCESS_KEY',
eventType: 'purchase',
orderId: 'UNIQUE_ORDER_ID',
products: [
{ sku: '상품코드1', purchaseUnitPrice: 10000, purchaseQuantity: 1 },
{ sku: '상품코드2', purchaseUnitPrice: 15000, purchaseQuantity: 1 }
]
};
cloud.shoplive.sendConversionEvent(conversionConfig);
</script>