Shoplive Developers
한국어KOEnglishEN日本語JA
Deprecated

지난 가이드

예전 설치 · 연동 방식을 모아 둔 페이지입니다. 새로 연동할 때는 쓰지 않습니다. 이 방식으로 이미 연동해 둔 사이트를 확인할 때 참고하세요. 지금 방식은 Web Player SDK 연동 가이드를 보세요.

Shopify — 테마에 코드 직접 넣기

새로 설치하는 스토어는 이 방법을 쓰지 않습니다. 부록 G · Shopify의 ShopliveAssistant 앱 방식으로 설치합니다. 이 절은 예전 방식으로 테마에 코드를 넣어 둔 스토어를 위한 내용입니다.

테마와 페이지에 코드 넣기

부록 G · Shopify 1부(앱 설치 · 상품 동기화)를 마친 뒤 진행합니다.

  1. 테마 코드 편집을 엽니다. Shopify 관리자 온라인 스토어 › 테마 에서 현재 테마의 작업(…) › 코드 편집 을 누릅니다.
    Shopify 온라인 스토어 테마의 코드 편집 메뉴
  2. 코드 ①을 붙입니다. 왼쪽 파일 목록에서 theme.liquid 를 열고 <body 로 시작하는 줄의 바로 아랫줄에 아래 코드를 붙입니다. YOUR_ACCESS_KEY 를 바꾸고 저장합니다.
    <!-- Shoplive 시작 -->
    <script src="https://static.shoplive.cloud/shoplive.js"></script>
    <script>
      cloud.shoplive.initPlugin({ accessKey: 'YOUR_ACCESS_KEY', platform: 'SHOPIFY' });   // ← 이 자리만 내 Access Key 로 바꿉니다
      {% if customer %}
      cloud.shoplive.setUserObject({ userId: "{{ customer.id }}", userName: "{{ customer.first_name }}" });
      {% endif %}
    </script>
    <!-- Shoplive 끝 -->

    {% if customer %} 부분은 Shopify 가 로그인한 고객의 번호 · 이름으로 바꿔 줍니다. platform: 'SHOPIFY' 를 넣으면 플레이어 안 장바구니 담기까지 SDK 가 처리합니다(부록 A · 장바구니 담기).

    Shopify 코드 편집기에서 theme.liquid 에 코드 ①을 붙인 화면
    왼쪽 파일 목록의 theme.liquid · 보라색 상자가 붙여 넣은 코드 ① 자리입니다. (캡처의 코드는 옛 이름 cloud.shoplive.init 이고, 위 코드를 그대로 붙이면 됩니다)
  3. 미니 프리뷰를 확인합니다. 스토어 미리보기를 엽니다. 진행 중인 방송이 있으면 구석에 미니 프리뷰가 뜹니다. 안 뜨면 준비물 3의 API · 플러그인 스위치를 확인하세요.
    Shopify 스토어 미리보기 — 미니 프리뷰가 뜬 화면
  4. 방송 목록 페이지를 만듭니다. 온라인 스토어 › 페이지 › 페이지 추가 에서 제목(예: LIVE)을 넣습니다.
    Shopify 온라인 스토어의 페이지 추가 화면
  5. 코드 ②를 붙입니다. 내용 편집기 오른쪽 위 </>(HTML 보기) 버튼을 누른 뒤 아래 코드를 넣습니다. 공개 여부를 Visible 로 두고 저장합니다.
    <div id="shoplive-overall"></div>
    <script defer>
      document.addEventListener('DOMContentLoaded', function () {
        cloud.shoplive.setOverall('shoplive-overall');
      });
    </script>
    Shopify 페이지 내용을 HTML 보기로 바꾸고 코드 ②를 넣은 화면
  6. 메뉴에 연결합니다. 온라인 스토어 › 탐색 에서 메뉴(예: 메인 메뉴)를 열고 메뉴 항목 추가 로 방금 만든 페이지를 넣은 뒤 저장합니다.
    Shopify 탐색 메뉴에 LIVE 페이지를 추가하는 화면

구매 전환 — 사용자 지정 픽셀

주문 완료 화면에 스크립트를 직접 넣을 수 없으므로, 설정 › 고객 이벤트 › 사용자 지정 픽셀에 등록해 checkout_completed 시점에 호출합니다. 이 코드는 개발자와 함께 넣는 것을 권합니다.

const script = document.createElement('script');
script.src = 'https://static.shoplive.cloud/shoplive.js';
script.async = true;
document.head.appendChild(script);

script.onload = function () {
  cloud.shoplive.initPlugin({ accessKey: 'YOUR_ACCESS_KEY' });

  analytics.subscribe('checkout_completed', function (event) {
    const checkout = event.data.checkout;

    // 회원 주문이면 시청할 때와 같은 기준으로 userId 를 넣습니다
    const customerId = checkout.order.customer && checkout.order.customer.id;
    if (customerId) {
      cloud.shoplive.setUserObject({ userId: String(customerId) });
    }

    cloud.shoplive.sendConversionEvent({
      accessKey: 'YOUR_ACCESS_KEY',
      eventType: 'purchase',
      orderId: checkout.order.id,
      products: checkout.lineItems.map(function (item) {
        return {
          // Shopify 연동으로 가져온 상품은 Shopify 상품 ID 가 customerProductId 로 등록됩니다
          customerProductId: String(item.variant.product.id),
          purchaseUnitPrice: parseFloat(item.variant.price.amount),
          purchaseQuantity: item.quantity,
          currency: item.variant.price.currencyCode
        };
      })
    });
  });
};

완료 확인

  • 방송 중일 때 스토어 아무 페이지에서나 구석에 미니 프리뷰가 뜬다
  • LIVE 메뉴를 누르면 대표 방송과 방송 목록이 그려진다
  • 로그인한 채로 방송에 들어가 채팅을 보면 고객 이름으로 표시되고, 상품의 장바구니 담기가 Shopify 장바구니로 들어간다

← Web Player SDK 연동 가이드