> For the complete documentation index, see [llms.txt](https://marketing-help.nhn-commerce.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://marketing-help.nhn-commerce.com/conversion-tracking-setup/shopby-ads-script/naver-ads-script.md).

# 샵바이 - 네이버 프리미엄 로그 분석 및 광고 스크립트

## 관련 문서 <a href="#undefined" id="undefined"></a>

* 네이버 프리미엄 로그분석 문서: [https://naver.github.io/conversion-tracking/pages/01\_script\_guide\_wcstrans/ <br>](<https://naver.github.io/conversion-tracking/pages/01_script_guide_wcstrans/&#xD;&#xA;&#xD;&#xA;>)
* 샵바이 변수 조회 가이드: <https://admin-remote.shopby.co.kr/popup/variable-guide><br>

## 공통인증키 적용 방법 <a href="#undefined-1" id="undefined-1"></a>

{% hint style="danger" %}
샵바이 관리자페이지([https://admin.shopby.co.kr/pro](https://admin.shopby.co.kr/pro/))를 사용하지 않고,

서비스 관리자페이지([https://service.e-ncp.com](https://service.e-ncp.com/))를 사용하는 경우에는 반드시 공통 스크립트를 별도로 추가해주시기 바랍니다.
{% endhint %}

샵바이 관리자페이지에 로그인 후 하기를 확인해주세요

<figure><img src="/files/4B2fySU8X1Pc7jmoa8gR" alt=""><figcaption><p>샵바이 관리자 페이지 화면</p></figcaption></figure>

{% hint style="info" %}
네이버공통인증키는

"네이버쇼핑파트너존 > 정보관리 > 정보수정"에서 확인하실 수 있습니다.

만일 네이버공통인증키를 확인하실 수 없으시다면 네이버쇼핑파트너센터 측으로

네이버공통인증키의 확인 방법에 대하여 문의 주시기 바랍니다
{% endhint %}

{% hint style="info" %}
\[쇼핑광고 고객센터]1599-1598

\[검색광고 고객센터]1588-5896
{% endhint %}

## 스크립트 예시 <a href="#undefined-2" id="undefined-2"></a>

{% hint style="info" %}
샵바이 관리자페이지([https://admin.shopby.co.kr/pro](https://admin.shopby.co.kr/pro/))를 사용하는 경우 공통키 설정을 마친 상태로 진행해주세요
{% endhint %}

## 네이버 스크립트 전환 유형 <a href="#undefined-3" id="undefined-3"></a>

총 5개의 전환 유형이 존재 하며, 각각 1\~5의 값을 wcs.cnv의 전환 유형 값에 넣어주시면 됩니다.

| 전환유형        | 값 | 샵바이, 외부서비스 설정 삽입 위치         |
| ----------- | - | --------------------------- |
| **구매 완료**   | 1 | 주문 완료 페이지                   |
| **회원 가입**   | 2 | 회원가입 완료 페이지                 |
| **장바구니 담기** | 3 | 장바구니 페이지 또는 상품 상세 페이지       |
| **신청 / 예약** | 4 | 고객이 원하는 위치에 적용 또는 주문 상세 페이지 |
| **기타**      | 5 | 고객이 원하는 위치에 적용              |

### 공통 스크립트 예시

{% hint style="warning" %}
샵바이 관리자페이지에서 공통키를 설정하지 않고 광고 스크립트를 별도로 사용 하시거나,

서비스 관리자페이지를 사용할 경우에만 적용 하시기 바랍니다.
{% endhint %}

{% hint style="info" %}
공통 스크립트는 반드시 장바구니, 구매 등의 전환 스크립트 보다 하단에 위치 해야 합니다.

(wcs\_do 함수 호출을 해야 최종 데이터 전송이 되기 때문에)
{% endhint %}

```javascript
<!-- 예시 코드 -->
<script type="text/javascript">
    if(!globalThis.wcs_add) {
      globalThis.wcs_add = {}
    };

    globalThis.wcs_add["wa"] = "{{공통키 입력}}";
    
    if (!globalThis._nasa) {
      globalThis._nasa = {};
    }

    globalThis.wcs?.inflow?.(); 
    globalThis.wcs_do?.(_nasa);
</script>
```

### 장바구니 페이지 예시

상세페이지에 별도로 web API 등을 사용하여, 장바구니 담기 버튼 클릭 시 적용하셔도 됩니다.

```javascript
<!-- 예시 코드 -->
<script type="text/javascript">
    try {
      if(sb.cart?.deliveryGroups?.length > 0){
      if (!globalThis?._nasa) {
        globalThis._nasa = {};
        }
        globalThis._nasa["cnv"] = wcs.cnv("3", String(sb.cart.price.buyAmt));
      }
    } catch (error) {
        console.error("An error occurred:", error);
    }
</script>
```

### 회원가입 완료 페이지 예시

```javascript
<!-- 예시 코드 -->
<script>
  try {
    var _nasa = {};
    _nasa["cnv"] = wcs.cnv("2", "1");
  } catch (error) {
    console.error("An error occurred:", error);
  }
</script>
```

### 구매완료 페이지 예시

```javascript
<!-- 예시 코드 -->
<script type="text/javascript">
    try {
        const { orderOptionsGroupByPartner = [] }  = sb.order;
        const orderProducts = orderOptionsGroupByPartner.flatMap( ({ orderOptionsGroupByDelivery }) => 
            orderOptionsGroupByDelivery.flatMap( ({orderOptions}) => orderOptions)
        );
    
        const totalPrice = orderProducts.reduce((accumulator, product) => {
            return accumulator + (product.orderCnt * product.price.buyPrice);
        }, 0);

	    if (!globalThis?._nasa) {
            globalThis._nasa = {};
        }

        globalThis._nasa["cnv"] = wcs.cnv("1", String(totalPrice));
    } catch (error) {
        console.error("error has been occurred", error);
    }
</script>
```