구매전환 트래킹

    구매전환 트래킹


    기사 요약

    샵라이브에서 제공하는 SDK를 통해 구매 전환율을 트래킹할 수 있습니다.

    • 사용자가 라이브(또는 다시보기) 및 숏폼 영상을 3초 이상 시청한 후,

    • 해당 유저가 영상에 등록된 상품을 시청한 날로부터 최대 28일 이내에 구매로 인식된 경우,

    • 이를 구매 전환으로 기록합니다.

    구매 전환은 사용자가 마지막으로 시청한 영상을 기준으로 기록하며, 라이브(다시보기)와 숏폼은 각각 별도로 기록합니다. 따라서 하나의 구매가 발생할 경우, 라이브(다시보기)와 숏폼 각각에 구매 전환으로 기록되어 확인할 수 있습니다.


    sendConversionEvent

    구매 완료 페이지에서 사용하는 sendConversionEvent() 함수는 사용자가 구매한 상품의 product 식별값을 주요 정보로 하여, 상품의 구매 이벤트를 기록하고 시청 정보와 매핑하여 시청과 구매의 연관성을 기록합니다.

    로그인한 사용자의 경우, 시청 시와 동일한 방식으로 사용자 인증 기능을 사용하여 시청과 구매의 사용자를 인식합니다. 비로그인 상태의 사용자는 로컬 스토리지에 저장된 사용자 식별값을 통해 시청과 구매를 연결합니다.

    ShopLiveConversionData

    Property name

    Type

    Description

    type

    String?

    ‘purchase’ (Required)

    products

    List<ShopLiveConversionProductData>?

    구매 상품 목록

    orderId

    Int?

    주문번호

    referrer

    String?

    referrer

    custom

    Map<String, Any>?

    추가 custom field

    ShopLiveConversionProductData

    Property name

    Type

    Description

    productId

    String?

    샵라이브 고유 상품 ID

    customerProductId

    String?

    고객 고유 상품 ID

    sku

    String?

    상품 sku

    url

    String?

    상품 URL

    purchaseQuantity

    int?

    상품 구매 갯수

    purchaseUnitPrice

    double?

    상품 구매 단가

    Sample Code
    import 'package:shoplive_player/shoplive_player.dart';
    
    // 구매 전환 이벤트 전송
    final conversion = ShopLiveConversionData(
      type: 'purchase',
      products: [
        ShopLiveConversionProductData(
          productId: 'productId',
          customerProductId: 'customerProductId',
          sku: 'sku',
          url: 'url',
          purchaseQuantity: 1,
          purchaseUnitPrice: 1000.0,
        ),
      ],
      orderId: 'orderId',
      referrer: 'referrer',
      custom: {'campaignKey': 'campaignKey'},
    );
    
    ShopLiveEvent.sendConversionEvent(conversion);

    사용자 인증

    userId

    일반적으로 사용하는 사용자 인증 기능을 통해 유저인증을 하여 구매/시청 데이터 연관에 사용됩니다.

    // 사용자 설정
    _shopLiveCommon.setUser(
      accessKey: "{AccessKey}",
      user: ShopLiveCommonUser(
        userId: "userId",
        userName: "userName",
      ),
    );
    
    // 또는 JWT 토큰 설정
    _shopLiveCommon.setAuthToken(userJWT: "{USER_JWT}");