콘텐츠로 이동

사용자 지정 Action 추가¶

addAction(name, context?) 는 페이지 클릭으로 표현할 수 없는 비즈니스 작업(예: 결제 성공, 검색 제출, 기능 스위치 변경 등)을 능동적으로 기록하는 데 사용됩니다.

자동 클릭 수집 및 Action 명명에 대한 자세한 내용은 사용자 작업 추적을 참조하세요.

파라미터¶

파라미터	타입	필수	설명
`name`	String	예	안정적인 비즈니스 작업 이름 (예: `checkout_completed`)
`context`	Object	아니요	이 작업의 비즈니스 필드 (예: 금액, 채널, 결과)

Action 이름은 안정적으로 유지되어야 합니다. 주문 번호, 사용자 ID와 같은 동적 값은 context에 넣고 name에 연결하지 마세요.

NPM 예제¶

import { datafluxRum } from "@cloudcare/browser-rum"

datafluxRum.addAction("checkout_completed", {
  order_value: 42,
  payment_method: "card"
})

CDN 예제¶

동기 로드비동기 로드

window.DATAFLUX_RUM &&
  window.DATAFLUX_RUM.addAction("checkout_completed", {
    order_value: 42,
    payment_method: "card"
  })

window.DATAFLUX_RUM.onReady(function () {
  window.DATAFLUX_RUM.addAction("checkout_completed", {
    order_value: 42,
    payment_method: "card"
  })
})

검증¶

비즈니스 작업을 트리거한 후, 해당 웹 애플리케이션의 Action 탐색기에서 checkout_completed를 검색하고 Action 이름과 사용자 정의 필드가 이벤트에 기록되었는지 확인하세요.