직접 연동

이 연동 방법은 CAFE24나 FLEXG 외의 다른 웹사이트를 사용하시거나, 개발자가 직접 상세한 연동을 원하는 경우에 사용됩니다.

이 방식은 크게 두 가지 스크립트를 고객님의 웹사이트에 추가하는 방식으로 진행됩니다.

이벤트 스크립트 설치에 반드시 필요한 고객님의 고유 ID를 확인하세요.

워크스페이스 아이디는 우리 서비스에 로그인하여 접속했을 때, **웹 브라우저의 주소창(URL)**에서 확인할 수 있습니다.

확인 경로: 우리 서비스 접속 후 주소창 확인
아이디 위치: URL 중 w= 뒤에 있는 값
예시: https://app.atmsads.io/workspace?w=123456789
- 이 경우, 고객님의 워크스페이스 아이디는 123456789 입니다.

이 스크립트는 우리 서비스와 고객님의 웹사이트를 연결하는 '기본 연결 통로' 역할을 합니다. 이 코드가 없으면 어떤 데이터도 수집할 수 없습니다.

설치 위치: 모든 페이지의 <head> 영역

공통 스크립트는 고객님의 웹사이트 모든 페이지가 열릴 때마다 실행되어야 합니다. 따라서 웹페이지의 가장 기본적인 정보가 담겨있는 <head> 태그 안에 설치하는 것이 가장 좋습니다.

<script type="application/javascript" src="https://cdn.atmsads.io/sdk/atomossdk.js"></script>

웹사이트 템플릿 파일 찾기
- 고객님 웹사이트 관리자 페이지에서 HTML 코드를 수정할 수 있는 '공통 레이아웃' 또는 '헤더(Header) 템플릿' 파일을 찾습니다. (이 파일이 모든 페이지의 상단에 공통적으로 적용됩니다.)
- <head>로 시작하여 </head>로 끝나는 영역을 찾으세요.
코드 붙여넣기
- 찾은 <head> 영역 내부의 아무 곳에 복사한 공통 스크립트를 붙여넣고 저장합니다.

공통 스크립트가 연결 통로라면, 이벤트 스크립트는 "어떤 중요한 일이 일어났는지" 우리 서비스에 알려주는 특정 신호입니다. 이 스크립트는 해당 이벤트가 실제로 발생할 때만 실행되도록 설치해야 합니다.

모든 이벤트 스크립트에는 고객님의 워크스페이스 아이디를 반드시 입력해야 합니다.

이벤트 스크립트 목록

목표 이벤트

스크립트 코드

설치 위치

설명

구매 완료 (UTMSALE)

ATOMOS.event('${워크스페이스 아이디}', 'UTMSALE', { sales: 총 구매 금액 });

결제가 완료되었을때

고객이 상품 구매를 완료했을 때 실행되어 총 구매 금액을 우리 서비스에 전송합니다.

장바구니 추가 (ADD_TO_CART)

ATOMOS.event('${워크스페이스 아이디}', 'ADD_TO_CART');

고객이 '장바구니 담기' 를 실행했을때

고객이 상품을 장바구니에 담는 이벤트를 추적합니다.

회원가입 (REGISTER)

ATOMOS.event('${워크스페이스 아이디}', 'REGISTER');

고객이 회원가입을 완료했을때

회원가입 완료 이벤트를 수집합니다.

등록 완료 (COMPLETE_REGISTRATION)

ATOMOS.event('${워크스페이스 아이디}', 'COMPLETE_REGISTRATION');

FORM 수집 완료

고객의 DB 수집이 완료된 이벤트를 수집합니다.

설치 시 주의사항 (구매 이벤트 예시)

구매 이벤트 스크립트 설치 시, { sales: 총 구매 금액 } 부분은 고객이 실제 결제한 금액이 동적으로 입력되도록 설정해야 합니다.
예시: 고객이 5만 원짜리 상품을 구매했다면, 스크립트는 ATOMOS.event('A1B2C3', 'UTMSALE', { sales: 50000 }); 와 같이 실행되어야 합니다.
이 부분은 웹사이트 개발자에게 요청하여 변수(Variable) 처리를 통해 구현해야 합니다.

Last updated 1 month ago