네이버 전환 스크립트 어시스턴트 가이드

1. 개요

1.1. 대상 서비스 및 목적

네이버 검색광고(SA)의 프리미엄로그분석, 네이버 성과형디스플레이광고(GFA)의 전환추적 서비스를 이용하기 위하여 광고주는 본인의 사이트에 네이버 광고 전환 추적 스크립트를 설치합니다.
본 문서는 사이트에 설치되는 네이버 광고 전환 추적 스크립트가 정상적으로 설치/작동되었는지를 용이하게 파악하기 위하여 네이버에서 개발한 크롬확장프로그램(=Chrome Extension)인 네이버 전환 스크립트 어시스턴트(이하 어시스턴트)에 대해 가이드 하는 것을 목적으로 합니다.

WARNING

본 어시스턴트는 네이버 광고 전환스크립트 중, 신규버전스크립트(wcs.trans 버전)에 대해서만 지원을 합니다.
구버전(wcs.cnv 버전) 에 대해서는 지원을 하지 않습니다.

1.2. 어시스턴트 설치 방법

(1) 크롬브라우저를 준비합니다.
(2) 크롬 웹스토어(https://chromewebstore.google.com/)에 들어갑니다.
(3) 네이버 전환 스크립트 어시스턴트 를 검색하고, 검색결과에서 프로그램을 선택합니다.
(4) 앱 상세 화면에서 우측 상단에 Chrome에 추가버튼을 클릭합니다.

WARNING

네이버 전환 스크립트 어시스턴트는 크롬확장프로그램(=Chrome Extension)의 일종으로, 크롬브라우저에서 정상적으로 동작합니다. (크롬브라우저 외의 브라우저에서는 적절한 테스트가 되어 있지 않습니다)
본 어시스턴트 사용시 크롬브라우저 사용을 강력하게 추천드립니다.

1.3. 어시스턴트 사용방법

(1) 브라우저 창을 새로 엽니다.
(2) 어시스턴트 앱을 엽니다.
(3) 광고를 클릭하고, 사이트에 들어갑니다.
(광고플랫폼에서 전환추적서비스에 신청이 되어 있고, 사이트에 광고 스크립트가 설치되어 있다면) 어시스턴트 화면에 로그, 쿠키(※), NaPm 정보가 보여지고, 페이지뷰(PV: Page View)로그가 발생됨을 확인할 수 있습니다.
(4) 사이트에서 전환이벤트가 발생하는 행동(예: 장바구니 담기)을 하면 어시스턴트에 발생한 로그가 기록됩니다.
(5) 현재 페이지에서 다른 페이지로 이동을 하면 앱에서 보여지던 내용은 사라지고, 새로운 페이지에서 발생한 로그 / 존재하는 쿠키 등의 정보가 보여집니다.

※[참고] 쿠키 관련
. 네이버 검색광고(SA)를 클릭하고 사이트에 들어왔다면 어시스턴트 화면의 ‘쿠키’ 부분에는 최소한 NA_SA, NVADID, NA_CO 3개의 쿠키가 존재해야 합니다.
. 네이버 성과형 디스플레이 광고(GFA)를 클릭하고 사이트에 들어왔다면 어시스턴트 화면의 ‘쿠키’ 부분에는 최소한 NA_DA, NVADID, NA_CO 3개의 쿠키가 존재해야 합니다.
. 네이버 검색광고도 클릭을 했었고, 네이버 성과형 디스플레이광고도 클릭을 했다면, ‘쿠키’ 부분에는 위에 언급한 쿠키의 합집합인 총 4개 쿠키 NA_SA, NA_DA, NVADID, NA_CO가 존재해야 합니다.

TIP

로그는 창/탭 단위로만 보여줍니다 (다른 탭이나 다른 창에서 발생한 내용은 보여지지 않습니다. 특정 링크를 클릭 후 새로운 창이 열린다면, 어시스턴트에서는 앱이 열려 있는 창/탭에서 발생한 내용만 보여줍니다)
어시스턴트을 미리 열어두지 않아도, 어시스턴트를 설치한 이후라면 페이지를 연 뒤에 어시스턴트를 열어도 해당 페이지에서 발생한 로그를 살펴볼 수 있습니다.
어시스턴트에서 보여지는 로그/정보들은 페이지가 바뀌면 리셋이 되고, 새로운 페이지에서 발생한 정보를 보여줍니다. (페이지 URL이 변경되지 않은 상태에서 버튼 클릭 등으로 발생한 로그라면 화면이 리셋되지 않고 계속 로그가 쌓여서 보여집니다)
스크립트 신규설치 후 전환로그를 전달할 때에는 테스트(광고클릭 & 전환발생)를 하고, 어시스턴트의 다운로드기능을 통해 파일을 다운로드 받아서 그대로 보내주시기 바랍니다.

TIP

NHN Data에 전환 검수 신청시 구매(purchase), 회원가입(sign_up) 전환 이벤트 타입에 대한 테스트 결과를 파일로 보내주세요.
‘무통장입금’이 없는 사이트의 구매(purchase) 및 ‘휴대폰 인증/SNS인증가입/사업자등록번호’ 등이 필요한 사이트의 회원가입(sign_up)은 전환 검수 테스트가 어렵습니다.
네이버 광고 전환 스크립트를 설치하신 뒤 위와 같은 구매(purchase) 및 회원가입(sign_up)전환에 대해서는 어시스턴트를 실행하시고, 직접 전환테스트를 하신 뒤 파일을 다운로드 받으셔서 전달해주시기 바랍니다.

※ 전환테스트 & 파일 전달 방법
  . 네이버 전환 스크립트 어시스턴트 설치 & 앱 실행
  . 광고 클릭 & 사이트 진입
  . 회원가입(sign_up) 진행 & 어시스턴트 화면 우측 상단에 전체 다운로드버튼 클릭 및 파일 다운로드 받음
  . 구매(purchase) 진행 & 어시스턴트 화면 우측 상단에 전체 다운로드버튼 클릭 및 파일 다운로드 받음
  . 위에서 다운로드 받은 파일 각각을 NHN Data에 전달 ( 채널 톡(채팅) 상담 : https://navercts.channel.io/home , 공용 Email : navercts@nhndata.com )

2. 광고 전환추적 서비스 흐름 및 어시스턴트의 기능 개요

전환 추적을 위한 전체 흐름은 다음과 같습니다.

(a)네이버매체 (클릭)
➜ (b) 랜딩페이지에 NaPm파라미터와 함께 랜딩 & 쿠키 생성
➜ (c) 전환행동 발생시 전환로그 발생 & 네이버 수집서버로 전송
➜ (d) 네이버 자체 가공 & 전환보고서 제공

이와같은 일련의 전환추적 흐름이 정상적으로 진행되기 위해, 광고주사이트에 네이버 광고 전환 추적 스크립트 설치가 필요합니다.

네이버 전환 스크립트 어시스턴트는
  . (b) 랜딩페이지에 NaPm파라미터가 있었는지 보여주기. 전환 추적에 필요한 쿠키가 생성되었는지 보여주기
  . (c) 전환행동 발생시 전환로그가 발생하는지 보여주기. 발생한 전환로그의 내용은 스펙에 맞게 구성되어 있는지를 보여줌으로써
네이버 광고 전환추적 스크립트가 정상적으로 설치 되었는지를 쉽게 파악할 수 있게 합니다.

3. 어시스턴트 기능 상세 가이드

광고 전환 추적을 위한 설정 (광고설정 및 스크립트 설치)이 잘 완료가 되기 위해서는
광고클릭 ~ 광고보고서 생성의 과정에서, 다음과 같은 것들이 필요하거나, 정상적으로 작동을 해야 합니다.

▶ 올바른 전환 보고서 생성을 위한 필수요소

(1) 광고 클릭시 사이트 랜딩페이지까지 네이버 매체에서 발행한 NaPm 파라미터가 전달 되어야 함
(2) 랜딩페이지에서 광고전환추적에 필요한 쿠키가 정상적으로 생성되어야 함
(3) 전환페이지가 아닌 곳에서는 페이지뷰(PV)로그가 발생해야 함
(4) 전환스크립트가 설치된 페이지가 열려 전환이벤트가 발생하거나 혹은 버튼 클릭으로 전환이벤트가 발생하는 경우, 해당 이벤트 발생시 전환 로그가 발생하고, 전환 로그에는 스크립트에 넣은 정보가 스펙에 맞게 정상적으로 들어 있어야 함

어시스턴트 를 통해 위 (1)~(4) 에 해당되는 정보를 모두 살펴볼 수 있습니다.

▶ 어시스턴트 화면 간단 설명

① 결과 요약
  . 본 앱에서 발생한 사이트 ID 건수, 로그 건수, 쿠키 건수, 네이버 파라미터 발생 여부를 요약하여 보여줍니다.

② 페이지 발생 로그
현재 페이지에서 발생한 로그에 대한 여러가지 정보를 보여줍니다.
  . 사이트 ID, 로그 건수
  . 로그의 검증 결과 (정상, 주의, 오류)
  . 현재 페이지 URL 과 Referer
  . 발생한 로그(페이지뷰(PV) 와 전환) 목록 및 그 상세내역(상세보기 클릭 후 볼 수 있음)
➜ 위 필수요소의 (3)번 페이지뷰(PV) 로그, (4)번 전환로그의 내용을 보여줍니다.

③ 네이버 광고 쿠키
  . 광고 전환추적을 위해 필요한 다양한 쿠키 중 기여 광고에 대한 정보를 담고 있는 쿠키를 보여줍니다.
➜ 위 필수요소의 (2)번 쿠키 관련 내용을 보여줍니다.

④ 네이버 파라미터
  . 광고 전환추적을 위해 네이버 매체에서 발행하는 파라미터(NaPm)을 보여줍니다.
➜ 위 필수요소의 (1)번 NaPm파라미터의 내용을 보여줍니다.

⑤ 가이드
  . 스크립트 설치가이드: 네이버 광고 전환 추적 서비스를 이용하기 위해 사이트에 설치해야 하는 스크립트 관련 가이드로 가는 링크 입니다.
  . 어시스턴트 가이드: 네이버 전환 스크립트 어시스턴트 가이드로 가는 링크 입니다.

⑥ 전체 다운로드
  . 본 어시스턴트 에서 가지고 있는 모든 네이버 광고 전환 추적 관련 정보를 1개의 파일로 다운로드 합니다.

어시스턴트 화면에 대한 보다 자세한 내용을 다음 챕터에서 설명드립니다.

3.1. ① 결과 요약 부분

① 결과 요약
네이버 광고 전환 추적을 위해 필요한 요소들의 건수 혹은 발생여부에 대해 종합적으로 보여줍니다.

페이지발생로그
  . 사이트ID: 네이버에서 발행하는 사이트별 식별자
  . 로그: 현재 페이지에서 발생한 페이지뷰(PV)로그, 전환로그 수의 합계

네이버 광고 쿠키
  . 네이버 광고 추적을 위해 필요한 쿠키 중, 기여 광고에 대한 정보를 담고 있는 쿠키를 보여줍니다. 최대 4건까지 보여집니다.

네이버 파라미터
  . 광고 전환추적을 위해 네이버 매체에서 발행하는 파라미터(NaPm)을 보여줍니다. 현재 페이지에 NaPm 파라미터가 있는 경우 ‘발생함’, 없는 경우 ‘미발생’ 으로 보여줍니다.

⑥ 전체 다운로드
  . 본 어시스턴트 에서 가지고 있는 모든 네이버 광고 전환 추적 관련 정보를 1개의 파일로 다운로드 합니다.
  . 결과 요약, 페이지 발생 로그(각 개별 로그의 상세보기 내역 포함), 네이버 광고 쿠키, 네이버 파라미터 모든 내용을 1개의 파일로 다운로드 합니다.
  . 현재 페이지에서 전환 관련 상황을 전달하기 위해, 전환 추적 관련 발생한 정보, 접근 가능한 정보들을 한번에 다른 사람에게 전달할 때 유용하게 사용할 수 있습니다.

3.2. ② 페이지 발생 로그 부분

현재 페이지에서 발생한 네이버 광고 전환추적 관련 로그를 보여줍니다.

3.2.1. 상단

. 사이트ID/로그
  . 사이트ID: 네이버에서 발행하는 사이트 식별자의 개수 (네이버 공통키라고 부르기도 함) (사이트에 여러개의 스크립트가 심어져 있는 경우 2개 이상의 사이트 ID 가 보일 수도 있습니다.)
  . 로그: 현재 페이지에서 발생한 페이지뷰(PV)로그, 전환로그 수의 합계
. 사이트 ID (정상/주의/오류): 현재 페이지에서 발생한 로그에서 발견된 모든 사이트 ID에 대한 검증(validation) 결과별 건수를 표시합니다.
. 로그 (정상/주의/오류): 현재 페이지에서 발생한 페이지뷰(PV)로그. 전환로그에 대한 검증(validation) 결과별 건수를 표시합니다.
. URL: 현재 페이지 URL 입니다.
. Referer: 현재 페이지에 대한 Referer(일반적으로 직전 페이지)URL 입니다.

3.2.2. 하단

. 사이트 ID 별 로그(페이지뷰(PV), 전환)를 목록으로 보여주는 표
  . (표 첫째 행) 사이트 ID (네이버 공통키라고 부르기도 함)   . 각 로그별 좌측 숫자는 로그발생시각을 보여줍니다.
  . 목록에 있는 로그 오른쪽의 상세보기 버튼을 클릭하면, 해당 로그의 상세한 내역과 검증(validation) 결과를 볼 수 있습니다.

3.2.2.1. 페이지뷰(PV) 상세보기

특정 페이지뷰(PV)로그 1개에 대한 정보를 상세히 볼 수 있습니다.

① 상세보기 최상단
  . 사이트 ID 및 로그 발생 시각, 로그 종류를 표시함
  . 로그에 일부라도 오류가 있으면 오류표시
  . 로그에 오류 없이 주의만 있으면 주의 표시
  . 로그에 아무런 오류, 주의가 없으면 정상 표시
   (주의 와 오류가 섞여 있는 경우, 오류로 표시함)

② 전송 항목(일반)
  . 페이지뷰(PV)로그 전송되는 일반적인 항목들을 보여줍니다.

③ 네이버 광고 쿠키
  . 현재 페이지에서 접근 가능한 네이버 광고 전환 관련 쿠키들을 보여줍니다.

④ 파일 다운로드
  . 현재 로그 정보를 파일로 다운로드 받을 수 있는 기능입니다.
  . 현재 로그의 상황을 다른 사람에게 전달할 경우 유용하게 사용할 수 있습니다.

3.2.2.2. 전환 상세보기

특정 전환로그 1개에 대한 정보를 상세히 볼 수 있습니다.

① 상세보기 최상단
  . 사이트 ID 및 로그 발생 시각, 로그 종류, 전환 이벤트 타입을 표시함
  . 로그에 일부라도 오류가 있으면 오류표시
  . 로그에 오류 없이 주의만 있으면 주의 표시
  . 로그에 아무런 오류, 주의가 없으면 정상 표시
   (주의 와 오류가 섞여 있는 경우, 오류로 표시함)

② 전송 항목(일반)
로그에서 기본적으로 전송되는 항목 외에, 전환로그일 경우, 전송될 수 있는 다음과 같은 추가 항목들이 있습니다.
  . type: 전환 이벤트 타입
  . id: 전환 행동에 대한 ID(구매의 경우 주문번호)
  . value: item(상품)(별) payAmount의 합 (개별 상품 결제금액의 합계)
  . currency: 통화

③ 전송 항목(items)
전환의 행동의 대상이 되는 item 들에 대한 상세한 정보들입니다.
  . id: item ID (상품 ID)
  . name:item(상품) 명
  . payAmount: item(상품) 결제금액
  . category: item(상품) 카테고리
  . quantity: item(상품) 수량
  . option: item(상품) 옵션

④ 전송 항목(기여광고)
  . 현재의 전환로그 발생에 기여한 광고의 정보들 입니다.
  . 시스템에서 자체적으로 생성되는 정보로 별도로 조치할 것은 없습니다.

⑤ 네이버 광고 쿠키
  . 현재 페이지에서 접근 가능한 네이버 광고 전환 관련 쿠키들을 보여줍니다.

⑥ 파일 다운로드
  . 현재 로그 정보를 파일로 다운로드 받을 수 있는 기능입니다.
  . 현재 로그의 상황을 다른 사람에게 전달할 경우 유용하게 사용할 수 있습니다.

3.3. ③ 네이버 광고 쿠키

  . 네이버 광고 전환 추적을 위해 필요한 쿠키들 중, 기여 광고에 대한 정보를 담고 있는 쿠키를 보여줍니다.
  . 현재 페이지에서 접근 가능한 쿠키에 대한 정보만 보여주며, 각 쿠키별로 이름(Name), 유효기간, 도메인(Domain), 경로(Path), 값(Value) 5가지 정보를 보여줍니다.

3.4. ④ 네이버 파라미터 (NaPm)

  . 광고 전환추적을 위해 네이버 매체에서 발행하는 파라미터(NaPm)을 보여줍니다.
  . 광고 클릭시 이 정보가 랜딩페이지까지 유지되어야 광고 전환 추적에 필요한 쿠키생성등이 정상적으로 되어 광고 전환 추적이 가능해집니다.

4. FAQ

FAQ목록

• Q1. 사이트에 네이버 광고 전환 추적 스크립트와 네이버 애널리틱스 스크립트 두개를 삽입하면 어떻게 보이나요?
  
• Q2. 전환로그가 발생하고 다른 페이지로 바로 이동하는 페이지의 경우 어시스턴트에서는 어떻게 보여지나요?
  
• Q3. 스크립트 설치 관련 문의 또는 지원을 받고 싶으면 어디에 연락하면 되나요?
  
• Q4. 모바일용 사이트에 대해 테스트를 해보고 싶습니다. 어떻게 하면 될까요?
  

Q1

Q: 사이트에 네이버 광고 전환 추적 스크립트와 네이버 애널리틱스 스크립트 두개를 삽입하면 어떻게 보이나요?
A: 어시스턴트는 네이버 광고 전환 추적 스크립트의 로그와 네이버 애널리틱스 스크립트 로그에 대한 정보를 모두 보여줄 수 있습니다.
두개의 서비스에 각각 다른 사이트 ID(혹은 네이버 공통키)를 사용하신다면, 발생되는 로그 정보는 페이지 발생 로그 부분에서 각각의 사이트 ID 정보 하위에 보여집니다.

Q2

Q: 전환로그가 발생하고 다른 페이지로 바로 이동하는 페이지의 경우 어시스턴트에서는 어떻게 보여지나요?
A: 어시스턴트는 현재 페이지에서 발생하는 로그를 보여줍니다. 페이지 변경이 발생하면 현재 정보가 사라지고, 새로운 페이지에서 발생하는 로그를 보여주게 됩니다.
전환로그가 발생하고, 다른 페이지로 바로 이동한다면, 전환로그가 보여지는 시각이 매우 짧을 것이므로, 로그를 확인하기는 어려울 것으로 보입니다.
로그 히스토리를 쌓아두는 기능은 제공되지 않습니다.

Q3

Q: 스크립트 설치 관련 문의 또는 지원을 받고 싶으면 어디에 연락하면 되나요?
A: 네이버 광고 전환 스크립트에 대한 문의 또는 설치 지원은 NHN Data에서 받고 있습니다.

연락채널은 다음과 같습니다.

네이버 광고 전환 스크립트 설치 지원 업체 NHN Data 연락 채널
. 고객센터(전화): 1877-7035
. 채널 톡(채팅) 상담 : https://navercts.channel.io/home
. 공용 Email : navercts@nhndata.com

Q4

Q: 모바일용 사이트에 대해 테스트를 해보고 싶습니다. 어떻게 하면 될까요?
A: 최근 많이 사용되는 브라우저들은 ‘모바일기기’로 보이도록 설정을 할 수 있습니다.
브라우저의 이 기능을 이용하면 사이트에 접속할 때, 웹서버에서는 모바일기기로 인식하여 모바일기기용 화면을 단말기에 보여주는 경우가 많습니다.
크롬 브라우저에도 유사한 기능이 있으며 다음 도움말을 참고하시기 바랍니다.
https://developer.chrome.com/docs/devtools/device-mode

Ver: 251027_01