> For the complete documentation index, see [llms.txt](https://docs.overdare.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.overdare.com/korean/development/api-reference/classes/analyticsservice.md).

# AnalyticsService

AnalyticsService : `Instance`

## Overview

AnalyticsService는 월드에서 플레이어가 한 행동을 이벤트로 기록하고, Creator Hub에서 집계 결과를 확인할 수 있도록 제공되는 서비스입니다.

Custom Event로 특정 행동의 발생과 값을 기록하고, Onboarding Funnel Event로 튜토리얼 진행 단계를 기록할 수 있습니다. 이벤트는 공개 또는 비공개로 배포한 월드에서만 전송되며, 스튜디오의 플레이 테스트에서는 전달한 인자가 올바른지만 확인합니다.

AnalyticsService는 GetService()로 가져옵니다. 이 서비스는 서버 환경에서만 동작하며, 클라이언트 스크립트에서는 호출할 수 없습니다.

## Properties

## Methods

### LogCustomEvent

Custom Event 1건을 기록합니다. 전송 결과를 기다리지 않고 바로 반환됩니다.

value를 생략한 이벤트와 value에 0을 전달한 이벤트는 서로 다른 값으로 저장됩니다. eventName과 Custom Field 값은 각각 최대 50자까지 저장되며, 50자를 넘는 부분은 잘린 뒤 저장됩니다.

#### Parameters

| `Player` player           | 이벤트를 발생시킨 플레이어입니다.                                                                          |
| ------------------------- | ------------------------------------------------------------------------------------------- |
| `string` eventName        | 이벤트 이름입니다. 최대 50자까지 저장되며, 빈 문자열을 전달하면 오류가 발생합니다.                                            |
| `number` value            | (선택 사항) 이벤트에 함께 기록할 숫자입니다. 음수와 소수를 사용할 수 있으며, NaN과 무한대는 사용할 수 없습니다.                         |
| `Dictionary` customFields | (선택 사항) AnalyticsCustomFieldKeys 항목의 Name을 키로, 문자열을 값으로 사용하는 분류 테이블입니다. 최대 3개까지 지정할 수 있습니다. |

#### Return

| `void` |   |
| ------ | - |

#### Code Samples

```lua
local AnalyticsService = game:GetService("AnalyticsService")

local EventName = "MissionCompleted"

local function OnMissionCompleted(player, clearTime)
    local customFields = {
        [Enum.AnalyticsCustomFieldKeys.CustomField01.Name] = "Tutorial",
    }
    AnalyticsService:LogCustomEvent(player, EventName, clearTime, customFields)
end
```

### LogOnboardingFunnelStepEvent

온보딩 퍼널에서 플레이어가 한 단계에 도달했음을 기록합니다. 전송 결과를 기다리지 않고 바로 반환됩니다.

같은 플레이어가 같은 단계를 여러 번 기록해도 단계 전환 집계에는 처음 도달한 1회만 반영됩니다. 중간 단계를 기록하지 않고 더 높은 단계를 기록하면, 그 앞의 단계도 완료한 것으로 집계됩니다.

#### Parameters

| `Player` player           | 단계를 진행한 플레이어입니다.                                                                            |
| ------------------------- | ------------------------------------------------------------------------------------------- |
| `number` step             | 단계 번호입니다. 1 이상 100 이하의 숫자를 사용하며, 소수점 둘째 자리까지 지정할 수 있습니다. 범위를 벗어나면 오류가 발생합니다.                |
| `string` stepName         | (선택 사항) Creator Hub에 표시할 단계 이름입니다. 최대 50자까지 저장됩니다.                                          |
| `Dictionary` customFields | (선택 사항) AnalyticsCustomFieldKeys 항목의 Name을 키로, 문자열을 값으로 사용하는 분류 테이블입니다. 최대 3개까지 지정할 수 있습니다. |

#### Return

| `void` |   |
| ------ | - |

#### Code Samples

```lua
local Players = game:GetService("Players")
local AnalyticsService = game:GetService("AnalyticsService")

local JoinStep = 1
local JoinStepName = "Join"

local function OnPlayerAdded(player)
    AnalyticsService:LogOnboardingFunnelStepEvent(player, JoinStep, JoinStepName)
end
Players.PlayerAdded:Connect(OnPlayerAdded)
```

## Events

## See also

{% content-ref url="/pages/YHXkOowC7XPGzwkxtE6u" %}
[애널리틱스](https://docs.overdare.com/korean/manual/script-manual/advanced-gameplay-systems/analytics.md)
{% endcontent-ref %}
