OpenReplay 트래커 Analytics SDK를 설정하는 방법을 알아봅니다.

Analytics SDK는 옵트인(opt-in) 방식입니다. 트래커 생성자에 analytics.active를 전달할 때만 인스턴스화되며, 그 전까지는 tracker.analytics가 null이고 tracker.track()은 아무 동작도 하지 않습니다(no-op).

import Tracker from '@openreplay/tracker'

const tracker = new Tracker({
  projectKey: "YOUR_PROJECT_KEY",
  analytics: { active: true },
})

tracker.start()

• active: boolean Analytics SDK를 켭니다. 기본값: false.
• ingestPoint?: string Analytics 배치를 전송할 엔드포인트입니다. 셀프 호스팅 배포에서만 사용하며, OpenReplay Cloud에서는 무시되고 https://api.openreplay.com/ingest가 사용됩니다. 기본값은 트래커의 ingestPoint입니다.

OpenReplay UI에서 Analytics 데이터를 관리하는 방법을 더 알아보려면 데이터 관리를 참고하세요.

// Identify a user with an id (e.g. email, username, etc.)
tracker.analytics.identify(userId: string): void
// same as
tracker.analytics.people.identify(userId)

// Add event to batch with option to send it immediately
tracker.analytics.track(eventName: string, tempProperties?: Record<string, any>, options?: { send_immediately: boolean })
// same as
tracker.analytics.events.track(eventName, tempProperties, options)

// Clear user id, people properties and super properties, and stop the batcher
tracker.analytics.reset(): void

이 메서드들은 트래커 자체에 있으므로 tracker.analytics를 거치지 않고도 안전하게 호출할 수 있습니다(Analytics가 비활성화된 동안에는 아무 동작도 하지 않습니다):

// Same as tracker.analytics.track(...)
tracker.track(eventName: string, properties?: Record<string, any>, options?: { send_immediately: boolean })

// Sets the replay's user ID *and* calls analytics.people.identify() with it
tracker.setUserID(id: string): void
tracker.identify(id: string): void // alias of setUserID

// Send analytics events under your own token, without session recording
tracker.setAnalyticsToken(token: string): void

식별된 사용자(영구 디바이스 ID 포함), 모든 People 속성, 모든 슈퍼 속성을 지우고 배처를 중지합니다. 로그아웃할 때 호출하세요.

tracker.analytics.reset()

문제가 발생하면 Slack에 접속하여 커뮤니티의 도움을 받으세요.