자바스크립트 API
다음 가이드에서는 JavaScript API 설정 및 사용 방법을 안내합니다. 전체 전자상거래 통합을 계획하고 있다면 이 가이드를 참조하세요.
참고
아래에 제공된 클라비요 스니펫을 사용하려면 여기에서 찾을 수 있는 공개 API 키로 API_KEY의 자리 표시자를 업데이트해야 합니다.
클라비요 스니펫 추가하기
사람 추적을 시작하려면 웹사이트의 기본 템플릿 오른쪽에 아래 스니펫을 추가하면 웹사이트의 모든 페이지에 자동으로 추가됩니다. 웹사이트에 이 스크립트를 추가할 개발자가 있는 경우 이 가이드 링크를 보내면 됩니다.
스니펫을 한 가지 변경해야 합니다. 이커머스 비즈니스인 경우 "식별" 호출로 네 줄을 제거합니다. 사람들이 로그인하는 웹사이트나 웹 앱인 경우 {{ email }} 자리 표시자 이메일을 로그인한 사용자의 이메일 주소가 있는 적절한 템플릿 변수로 바꾸세요.
클라비요 코드를 사이트 템플릿 하단 또는 그 근처에 배치하는 것이 좋습니다. Google 애널리틱스 또는 기타 타사 서비스를 사용하는 경우 클라비요 코드를 그 바로 위나 아래에 배치할 수 있습니다.
"클라비요를 사용하면 내 사이트 성능에 어떤 영향을 미치나요?" 클라비요는 웹사이트 성능에 전혀 영향을 미치지 않는다는 것이 정답입니다. 웹사이트의 나머지 부분이 로딩이 완료된 후에만 코드가 로드됩니다. 또한 클라비요는 브라우저에 자바스크립트를 캐시하도록 지시하여 방문자가 페이지를 전환할 때마다 자바스크립트를 다운로드할 필요가 없도록 합니다.
스크립트 확인
웹사이트에 JavaScript를 추가한 후 오른쪽에 웹사이트의 URL을 입력하면 제대로 설정되었는지 확인할 수 있습니다.
스크립트가 웹사이트에 설치되면 클라비요는 웹사이트의 방문 및 세션을 실시간으로 추적하기 시작합니다.
API 기본 사항
클라비요 API를 호출하고 사람에 대한 정보를 저장하려면 클라비요 스크립트에 의해 자동으로 추가되는 _learnq 객체를 사용합니다.
클라비요는 스크립트가 아직 페이지에 로드되지 않은 상태에서도 API 호출이 작동할 수 있도록 특별한 구문을 사용합니다. 첫 번째 값은 호출하려는 메서드의 이름이고 그 이후의 값은 해당 메서드에 전달할 인수가 되는 배열을 생성합니다.
사람 식별
식별 방법을 사용하면 개인을 식별하고 개인에 대한 속성을 설정할 수 있습니다. 이 메서드는 프로퍼티의 사전 또는 해시를 허용합니다. 누군가를 식별할 때는 이메일 주소를 $email 키와 함께 포함하거나 사용자 아이디와 같은 고유 식별자를 $id 키와 함께 포함해야 합니다.
이러한 식별자 중 하나 이상을 포함시킨 후에는 원하는 사용자 지정 속성을 자유롭게 추가할 수 있습니다. 사용자 지정 속성은 개인에 대한 사실을 추적하는 데 유용합니다. 그런 다음 클라비요에서는 이러한 속성을 기반으로 사용자 세그먼트를 만들 수 있습니다. 예를 들어 개인의 요금제 유형이나 가입 날짜를 추적하고 싶을 수 있습니다. 클라비요는 사용자가 사용하는 다양한 데이터 유형도 이해하므로 숫자, 부울, 날짜도 자유롭게 사용할 수 있습니다.
클라비요에는 사람에 대한 정보를 표시하는 데 사용되는 몇 가지 특별한 속성이 있습니다. 다음과 같습니다: 이름, $성, $전화 번호, $직위 및 $조직입니다.
추적하는 속성 외에도 클라비요는 어트리뷰션 추적을 위해 각 사용자가 처음 추천된 웹사이트와 웹사이트에 액세스하는 위치를 기반으로 사용자의 위치를 자동으로 결정합니다.
코드 예시:
이벤트 및 작업 추적
추적 방법을 사용하면 사람들이 웹사이트에서 수행하는 이벤트와 행동을 기록할 수 있습니다. 이 메서드는 해당 이벤트에 지정한 이름인 문자열을 받습니다. 이 메서드는 해당 이벤트와 관련된 프로퍼티의 선택적 딕셔너리 또는 해시도 허용합니다.
예를 들어, 누군가가 상품을 구매한 시점을 추적하고 구매 가격과 구매한 상품에 대한 정보를 포함할 수 있습니다. 사람들이 프로필을 가지고 있는 애플리케이션이 있는 경우 누군가가 프로필을 작성할 때 추적할 수 있습니다. 전체 전자상거래 통합을 계획하고 있다면 이 가이드를 참조하세요.
클라비요의 이벤트 추적 및 분석 기능은 매우 유연하기 때문에 비즈니스에 중요한 사항을 추적할 수 있도록 사용자 지정할 수 있습니다. 추적 방식은 다양한 데이터 유형을 이해하므로 숫자, 부울, 날짜를 사용할 수 있으며, 전송한 데이터를 기반으로 지능형 차트와 그래프를 생성합니다.
코드 예시: