Analytics.click

기능 설명

터치나 클릭이 발생하면 분석 로그를 남겨요. 구매 버튼 클릭처럼 중요한 사용자 액션을 기록할 때 사용해요. event 유형의 로그에 event_type: 'click' 파라미터가 함께 기록돼요.

log_name을 지정하지 않으면 현재 경로를 기반으로 <pathname>::click 형식의 이름이 자동으로 사용돼요. 로그 파라미터에는 전달한 값 외에도 현재 페이지의 쿼리 스트링(search), 진입 경로(referrer), 배포 정보(deployment_id, deployment_timestamp)가 자동으로 포함돼요.

현재 페이지 URL이 https가 아니면 로그를 보내지 않아요.

타입

Analytics.click(params?: { log_name?: string } & { [key: string]: LogParam }): Promise<void> | undefined;

Params

// log_name 외의 키는 로그 파라미터로 함께 기록돼요.
type LogParam = string | number | boolean | null | undefined;

Response

현재 페이지 URL이 https가 아니면 로그를 보내지 않고 undefined를 반환해요.

예시 코드

JavaScript

import { Analytics } from "@apps-in-toss/web-framework";

const button = document.querySelector("#buy-button");

button.addEventListener("click", () => {
  Analytics.click({ log_name: "buy_button", text: "구매하기" });
});