분석

*이 콘텐츠는 AI(베타)를 사용해 번역되었으며, 오류가 있을 수 있습니다. 이 페이지를 영어로 보려면 여기를 클릭하세요.

Analytics Query API를 사용하면 날짜 범위에 걸친 집계된 경험 지표를 쿼리할 수 있습니다. 이 API는 다음을 지원합니다:

  • 경험에 대한 일일 활성 사용자(DAU), 수익, 유지율 및 기타 지표 쿼리.
  • 플랫폼, 국가 및 연령대와 같은 차원으로 결과를 필터링하고 그룹화.
  • 결과를 폴링할 수 있는 장기 실행 작업으로 자동으로 느린 쿼리 처리.

이 API를 사용하기 전에 경험에 대한 API 키 생성이 필요합니다. 키를 생성할 때 액세스 권한에 경험을 추가하고 universe.analytics:read 작업에 대한 액세스를 부여하세요. 모든 요청에서 x-api-key 요청 헤더에 키를 포함하세요.

모든 엔드포인트는 귀하의 유니버스 ID를 사용하며, 이는 Creator Dashboard에서 귀하의 경험을 선택하고 개요 페이지에서 Universe ID를 복사하여 찾을 수 있습니다.

메트릭 쿼리

경험에 대한 메트릭을 쿼리하려면:

  1. API 키를 x-api-key 요청 헤더에 복사합니다.
  2. URL에서 ${UniverseId}를 경험의 유니버스 ID로 바꿉니다.
  3. metric을 쿼리하려는 메트릭으로 설정합니다. 예: DailyActiveUsers.
  4. granularity를 지원되는 시간 버킷 크기로 설정합니다. 예: OneDay. Granularity 옵션을 참조하세요.
  5. startTimeendTime을 RFC 3339 UTC 타임스탬프 형식의 날짜 범위로 설정합니다.
  6. 요청을 보냅니다.
일일 활성 사용자 쿼리

curl --location 'https://apis.roblox.com/analytics-query-api/v1/universes/${UniverseId}/metrics' \
--header 'x-api-key: ${ApiKey}' \
--header 'Content-Type: application/json' \
--data '{
"metric": "DailyActiveUsers",
"granularity": "OneDay",
"startTime": "2026-01-01T00:00:00Z",
"endTime": "2026-02-01T00:00:00Z"
}'

대부분의 쿼리는 즉시 완료되고 200 OK를 반환합니다:

응답 (200 OK)

{
"path": "v1/universes/1234567890/operations/metrics/abc123",
"done": true,
"metadata": {
"createdTime": "2026-01-15T00:00:00Z"
},
"response": {
"values": [
{
"breakdowns": [],
"dataPoints": [
{ "time": "2026-01-01T00:00:00Z", "value": 10000 },
{ "time": "2026-01-02T00:00:00Z", "value": 10500 }
]
}
]
}
}

큰 날짜 범의 경우 API는 202 Accepted를 반환할 수 있으며 "done": false입니다. 장기 실행 작업을 참조하세요.

요청 본문 필드

필드타입필수설명
metricstring쿼리할 메트릭입니다. 예: DailyActiveUsers. 전체 목록은 지원되는 메트릭을 참조하세요.
granularitystring각 데이터 포인트의 시간 버킷 크기입니다. Granularity 옵션을 참조하세요.
startTimestring쿼리 창의 시작, RFC 3339 타임스탬프 형식입니다. 포함적입니다. 모든 UTC 오프셋이 허용되며 결과는 항상 UTC로 버킷화됩니다.
endTimestring쿼리 창의 끝, RFC 3339 타임스탬프 형식입니다. 제외적입니다. 예: "2026-02-01T00:00:00Z"는 1월 31일까지의 데이터를 포함합니다.
breakdownstring[]아니오결과를 그룹화할 차원입니다. 각 항목은 "Platform"과 같은 단일 차원 이름입니다. 그룹화가 필요없다면 생략합니다. 그룹화 사용을 참조하세요.
filterobject[]아니오특정 차원 값으로 결과를 좁힐 필터입니다. 각 항목은 dimension, valuesoperation을 포함합니다. 필터링이 필요하지 않다면 생략합니다. 결과 필터링을 참조하세요.
limitinteger아니오전체 메트릭 값 내림차순으로 반환할 최대 차원 시리즈 수입니다. granularity"None"이고 breakdown이 설정된 경우에만 지원됩니다. 이 필드를 생략하거나 0으로 설정하면 메트릭에 따라 기본 한도가 적용됩니다.

가장 초기의 startTime은 메트릭 유형에 따라 달라집니다:

  • 표준 메트릭 (참여, 수익화, 획득, 유지율): 최대 4년의 이력.
  • 성능 메트릭 (충돌 비율, 프레임 속도 등): 최대 28일의 이력.

유지 기간을 넘어서는 쿼리는 400 오류와 코드 2001을 반환합니다.

장기 실행 작업

대부분의 쿼리는 즉시 완료되고 "done": true와 함께 200 OK를 반환합니다. 큰 날짜 범위나 많은 그룹 시리즈가 있는 쿼리의 경우 API는 "done": false와 함께 202 Accepted를 반환하고 폴링할 경로를 제공합니다.

대기 중 (202):


{
"path": "path/to/poll",
"done": false,
"metadata": {
"createdTime": "2026-01-15T00:00:00Z"
}
}

donefalse일 때, 응답에서 path 값을 사용하여 같은 x-api-key 헤더로 GET 요청을 https://apis.roblox.com/analytics-query-api/{path}에 전송합니다. donetrue가 될 때까지 반복합니다.

완료 (200):


{
"path": "path/to/poll",
"done": true,
"metadata": {
"createdTime": "2026-01-15T00:00:00Z"
},
"response": {
"values": [
{
"breakdowns": [],
"dataPoints": [
{
"time": "2026-01-01T00:00:00Z",
"value": 10000
}
]
}
]
}
}

breakdowns 배열은 요청된 그룹화가 없음을 나타냅니다. 그룹화가 사용될 때, response.values의 각 항목은 하나의 차원 값에 해당합니다. 그룹화 사용을 참조하세요.

작업이 실패하면, 본문은 response 대신 error를 포함합니다:


{
"path": "path/to/poll",
"done": true,
"metadata": {
"createdTime": "2026-01-15T00:00:00Z"
},
"error": {
"code": 2001,
"message": "요청된 그룹화는 이 메트릭에 대해 지원되지 않습니다."
}
}
필드타입설명
pathstring초기 응답에서 반환된 값과 일치하는 작업 경로입니다.
doneboolean오류가 있을 때 항상 true입니다.
metadata.createdTimestring작업이 생성된 RFC 3339 타임스탬프입니다.
error.codeinteger숫자 오류 코드입니다. 일반 오류를 참조하세요.
error.messagestring오류의 인간 친화적인 설명입니다.

response.values의 각 항목은 하나의 시리즈를 나타내며, 그룹화를 사용할 때는 차원 값마다 하나씩, 그룹화가 요청되지 않았을 때는 breakdowns: []가 있는 단일 항목입니다. dataPoints의 각 데이터 포인트는 다음을 가집니다:

필드설명
time시간 버킷 시작에 대한 UTC 타임스탬프입니다.
value숫자 메트릭 값입니다.
stringValues데이터 포인트의 텍스트 값이며, 문자열 배열입니다. 텍스트 값 메트릭에 대해서만 존재합니다. 텍스트 값 메트릭를 참조하세요.
status데이터 포인트의 상태 표시기입니다. 시리즈에 상태가 적용되지 않을 경우 생략됩니다. 데이터 포인트 상태를 참조하세요.

텍스트 값 메트릭

대부분의 메트릭은 숫자이며 value에 결과를 보고합니다. 몇몇 메트릭은 점수를 숫자 대신 텍스트로 설명합니다. 이러한 경우에는 데이터가 stringValues 배열에 반환되고 value는 의미가 없습니다. 숫자 메트릭의 경우 stringValues 필드는 완전히 생략됩니다.

예를 들어, ThumbnailWinningSegments는 각 시간 버킷에 대한 승리한 썸네일 세그먼트를 문자열 목록으로 보고합니다:


{
"time": "2026-01-01T00:00:00Z",
"value": 0,
"stringValues": ["TopEngagement", "HighCTR"]
}

데이터 포인트 상태

상태설명예시
Valid데이터 포인트가 완전하고 전체 시간 버킷을 커버합니다.최종화된 Creator Rewards 지급.
Projected값이 추정치이며 변경될 수 있습니다.아직 최종화되지 않은 기간에 대한 Creator Rewards 지급에 대한 예상치.
NotStatisticallySignificant샘플 크기가 신뢰할 수 있는 값을 생성하기에 불충분합니다.작은 국가의 crash rate에서 실제 회귀로 잘못 인식될 수 있는 변동 값.

Granularity 옵션

granularity 필드는 응답의 각 시간 버킷 크기를 제어합니다. 버킷 경계는 UTC에 맞추어 조정됩니다. 예를 들어 OneDay 버킷은 UTC 자정부터 UTC 자정까지 이므로, startTime이나 endTime에서 UTC 오프셋은 버킷화 전에 UTC로 정규화됩니다.

모든 메트릭이 모든 granularity를 지원하는 것은 아닙니다. 지원되는 메트릭을 참조하여 자세한 내용을 확인하세요.

Granularity설명비고
OneMinute1분 버킷성능 메트릭 전용입니다.
HalfHour30분 버킷성능 메트릭 전용입니다.
OneHour1시간 버킷성능 메트릭 및 일부 수익화 및 추천 이벤트 메트릭을 포함합니다.
OneDay1일 버킷모든 메트릭에서 지원됩니다.
OneWeek1주 버킷대부분의 참여, 수익화 및 획득 메트릭에서 사용됩니다.
OneMonth1개월 버킷대부분의 참여, 수익화 및 획득 메트릭에서 사용됩니다.
None전체 범위에 대해 단일 데이터 포인트대부분의 참여, 수익화 및 획득 메트릭에서 사용됩니다.

그룹화 사용

모든 메트릭이 모든 그룹화를 지원하는 것은 아닙니다. 각 메트릭에 대해 사용할 수 있는 그룹화는 지원되는 메트릭을 참조하세요.

그룹화는 차원별로 메트릭 결과를 그룹화하여 고유한 차원 값마다 하나의 시리즈를 반환합니다. 요청에 하나 이상의 차원 이름이 포함된 breakdown 배열을 추가합니다.

플랫폼별로 수익 쿼리

curl --location 'https://apis.roblox.com/analytics-query-api/v1/universes/${UniverseId}/metrics' \
--header 'x-api-key: ${ApiKey}' \
--header 'Content-Type: application/json' \
--data '{
"metric": "DailyRevenue",
"granularity": "OneDay",
"breakdown": ["Platform"],
"startTime": "2026-01-01T00:00:00Z",
"endTime": "2026-02-01T00:00:00Z"
}'

response.values의 각 항목은 해당 시리즈의 차원 값을 식별하는 breakdowns 배열을 포함합니다:


{
"response": {
"values": [
{
"breakdowns": [{ "dimension": "Platform", "value": "Computer" }],
"dataPoints": [{ "time": "2026-01-01T00:00:00Z", "value": 8200 }]
},
{
"breakdowns": [{ "dimension": "Platform", "value": "Phone" }],
"dataPoints": [{ "time": "2026-01-01T00:00:00Z", "value": 3400 }]
}
]
}
}

breakdowns의 각 객체는 다음과 같은 속성을 가집니다:

필드설명
dimensionbreakdown 요청 필드의 항목과 일치하는 차원 이름입니다.
value원시 차원 값입니다. 이를 사용하여 filter 쿼리를 구성합니다.
displayValue차원 값에 대한 인간 친화적인 레이블입니다. 표시 레이블이 존재하지 않으면 생략됩니다. 제품 ID나 퍼널 단계 이름과 같은 경우 value와 다를 수 있습니다.

결과 필터링

필터는 쿼리 결과를 특정 차원 값으로 좁힙니다. 각 항목이 dimension, 일치할 values 및 적용할 operation을 지정하는 filter 배열을 요청에 추가합니다.

모바일 장치에 대해서만 DAU 쿼리

curl --location 'https://apis.roblox.com/analytics-query-api/v1/universes/${UniverseId}/metrics' \
--header 'x-api-key: ${ApiKey}' \
--header 'Content-Type: application/json' \
--data '{
"metric": "DailyActiveUsers",
"granularity": "OneDay",
"filter": [
{
"dimension": "Platform",
"values": ["Phone", "Tablet"],
"operation": "In"
}
],
"startTime": "2026-01-01T00:00:00Z",
"endTime": "2026-02-01T00:00:00Z"
}'

필터 작업

작업설명
In차원 값이 제공된 세트에 포함된 결과를 포함합니다.
NotIn차원 값이 제공된 세트에 포함된 결과를 제외합니다.
GreaterThan숫자 차원 값이 제공된 값보다 큰 결과를 포함합니다.
GreaterThanOrEqual숫자 차원 값이 제공된 값보다 크거나 같은 결과를 포함합니다.
LessThan숫자 차원 값이 제공된 값보다 작은 결과를 포함합니다.
LessThanOrEqual숫자 차원 값이 제공된 값보다 작거나 같은 결과를 포함합니다.
Match차원 값이 제공된 문자열 패턴과 일치하는 결과를 포함합니다.

필터와 그룹화를 같은 요청에 결합할 수 있습니다.

차원 값 검색

차원 값 엔드포인트는 날짜 범위 내에서 메트릭의 하나 이상의 차원에 대한 사용 가능한 값을 나열하며, 메트릭 자체를 계산하지 않습니다. 이를 통해 filterbreakdown 쿼리에 유효한 값을 발견할 수 있습니다. 예를 들어, 국가, 제품 ID 또는 퍼널 단계 ID 등을 검색할 수 있습니다.

귀하의 경험에 대한 차원 값을 쿼리하려면:

  1. API 키를 x-api-key 요청 헤더에 복사합니다.
  2. URL에서 ${UniverseId}를 경험의 유니버스 ID로 바꿉니다.
  3. metric을 차원에 대한 컨텍스트를 제공하는 메트릭으로 설정합니다.
  4. dimensions를 값이 필요한 차원 이름으로 설정합니다.
  5. startTimeendTime을 RFC 3339 UTC 타임스탬프 형식의 날짜 범위로 설정합니다.
  6. 요청을 보냅니다.
DAU에 대한 국가 값 검색

curl --location 'https://apis.roblox.com/analytics-query-api/v1/universes/${UniverseId}/dimension-values' \
--header 'x-api-key: ${ApiKey}' \
--header 'Content-Type: application/json' \
--data '{
"metric": "DailyActiveUsers",
"dimensions": ["Country"],
"startTime": "2026-01-01T00:00:00Z",
"endTime": "2026-02-01T00:00:00Z"
}'

요청 본문 필드

필드타입필수설명
metricstring차원의 값을 확인할 메트릭입니다. 차원 조회를 위한 네임스페이스 컨텍스트를 제공합니다.
dimensionsstring[]값을 조회할 차원 이름입니다. 각 항목은 "Country"와 같은 단일 차원 이름입니다.
startTimestring쿼리 창의 시작, RFC 3339 타임스탬프 형식입니다. 포함적입니다. 모든 UTC 오프셋이 허용되며 결과는 항상 UTC로 버킷화됩니다.
endTimestring쿼리 창의 끝, RFC 3339 타임스탬프 형식입니다. 제외적입니다. 예: "2026-02-01T00:00:00Z"는 1월 31일까지의 데이터를 포함합니다.
filterobject[]아니오특정 차원 값으로 결과를 좁힐 필터입니다. 각 항목은 dimension, values, 및 operation을 포함합니다. 필터링이 필요하지 않다면 생략합니다. 결과 필터링을 참조하세요.
granularitystring아니오시간 버킷 크기입니다. 메트릭 엔드포인트와는 달리 이 필드는 선택적입니다. Granularity 옵션을 참조하세요.
limitinteger아니오차원당 반환할 최대 값 수입니다. 총 메트릭 값 내림차순으로 정리됩니다. granularity가 생략되거나 "None"일 때만 지원됩니다. 이 필드를 생략하거나 0으로 설정하면 메트릭에 따라 기본 한도가 적용됩니다.

대부분의 쿼리는 즉시 완료되고 200 OK와 함께 "done": true를 반환합니다. 큰 날짜 범위를 가진 쿼리의 경우 API는 202 Accepted"done": false를 반환하고 폴링할 경로를 제공합니다. 폴링 흐름은 장기 실행 작업을 참조하세요. 폴링할 때는 응답의 path 값을 사용하세요. 해당 값은 v1/universes/{universeId}/operations/dimension-values/{operationId}를 가리키며, 메트릭 폴링 경로와는 다릅니다.

완료 (200):


{
"path": "path/to/poll",
"done": true,
"metadata": {
"createdTime": "2026-01-15T00:00:00Z"
},
"response": {
"values": [
{
"dimension": "Country",
"values": [{ "value": "US" }, { "value": "GB" }]
}
]
}
}

response.values의 각 항목은 하나의 요청된 차원을 나타냅니다. values의 각 객체는:

필드설명
value원시 차원 값입니다. 이를 사용하여 filter 쿼리를 구성합니다.
displayValue차원 값에 대한 인간 친화적인 레이블입니다. 제품 ID와 같은 ID 유사한 차원의 경우에만 존재합니다. 대부분의 차원, 특히 Country에 대해서는 생략됩니다. value와 다를 수 있습니다.

오류는 메트릭 엔드포인트와 동일한 done: trueerror 구조를 사용합니다. 지정된 메트릭에 대한 지원되지 않는 차원은 400과 코드 2001을 반환합니다. 일반 오류를 참조하세요.

일반 쿼리

다음 예제는 Creator Dashboard 분석 페이지에서 사용할 수 있는 메트릭을 포함한 일반 쿼리를 보여줍니다.

수익

Robux의 일일 수익 쿼리

curl --location 'https://apis.roblox.com/analytics-query-api/v1/universes/${UniverseId}/metrics' \
--header 'x-api-key: ${ApiKey}' \
--header 'Content-Type: application/json' \
--data '{
"metric": "DailyRevenue",
"granularity": "OneDay",
"startTime": "2026-01-01T00:00:00Z",
"endTime": "2026-02-01T00:00:00Z"
}'

D1 유지율

D1 유지율 쿼리

curl --location 'https://apis.roblox.com/analytics-query-api/v1/universes/${UniverseId}/metrics' \
--header 'x-api-key: ${ApiKey}' \
--header 'Content-Type: application/json' \
--data '{
"metric": "ForwardD1Retention",
"granularity": "OneDay",
"startTime": "2026-01-01T00:00:00Z",
"endTime": "2026-02-01T00:00:00Z"
}'

신규 사용자 vs. 복귀 사용자

신규 vs. 복귀 사용자로 나누어진 DAU 쿼리

curl --location 'https://apis.roblox.com/analytics-query-api/v1/universes/${UniverseId}/metrics' \
--header 'x-api-key: ${ApiKey}' \
--header 'Content-Type: application/json' \
--data '{
"metric": "DailyActiveUsers",
"granularity": "OneDay",
"breakdown": ["IsNewUser"],
"startTime": "2026-01-01T00:00:00Z",
"endTime": "2026-02-01T00:00:00Z"
}'

주간 집계

더 긴 범위를 보기 위해 데이터를 더 적게 나누기 위해 더 굵은 granularity를 사용합니다. OneWeek granularity에서 각 버킷은 전체 7일 기간에 걸쳐 구별된 사용자를 집계하며, 일일 값을 합산하지 않습니다.

주간 granularity에서 DAU 쿼리

curl --location 'https://apis.roblox.com/analytics-query-api/v1/universes/${UniverseId}/metrics' \
--header 'x-api-key: ${ApiKey}' \
--header 'Content-Type: application/json' \
--data '{
"metric": "DailyActiveUsers",
"granularity": "OneWeek",
"startTime": "2026-01-01T00:00:00Z",
"endTime": "2026-04-01T00:00:00Z"
}'

상위-N 그룹화

하나의 메트릭으로 순위를 매기고 동일한 값 집합에 대해 다른 값을 표시하려면 두 개의 요청을 사용합니다. 예를 들어, 상위 5개 국가의 DAU에 대한 유료 사용자 전환율을 확인하려면:

1단계: 상위 N 차원 값을 발견하십시오. granularity: "None"을 사용하여 단일 집계 결과를 얻고 limit으로 반환되는 시리즈 수를 제한합니다:

DAU 기준으로 상위 5개 국가 발견

curl --location 'https://apis.roblox.com/analytics-query-api/v1/universes/${UniverseId}/metrics' \
--header 'x-api-key: ${ApiKey}' \
--header 'Content-Type: application/json' \
--data '{
"metric": "DailyActiveUsers",
"granularity": "None",
"breakdown": ["Country"],
"startTime": "2026-01-01T00:00:00Z",
"endTime": "2026-02-01T00:00:00Z",
"limit": 5
}'

2단계: 1단계에서 반환된 값을 필터링하여 표시 메트릭을 쿼리합니다:

상위 5개 국가의 유료 사용자 전환율

curl --location 'https://apis.roblox.com/analytics-query-api/v1/universes/${UniverseId}/metrics' \
--header 'x-api-key: ${ApiKey}' \
--header 'Content-Type: application/json' \
--data '{
"metric": "PayingUsersCVR",
"granularity": "OneDay",
"breakdown": ["Country"],
"filter": [
{
"dimension": "Country",
"values": ["US", "GB", "PH", "VN", "DE"],
"operation": "In"
}
],
"startTime": "2026-01-01T00:00:00Z",
"endTime": "2026-02-01T00:00:00Z"
}'

퍼널 단계

퍼널은 사용자들이 경험에서 정의된 단계 순서를 진행하는 방법을 보여줍니다. 퍼널 메트릭을 쿼리하려면 두 개의 요청이 필요합니다. 단계 ID가 동적이기 때문입니다.

1단계: 퍼널 단계를 발견하세요. 퍼널 단계는 최소한 하나의 사용자가 해당 단계에 도달한 날에만 결과에 나타납니다. 더 긴 과거를 사용하는 것이(90일이 안전한 기본값입니다) 드물게 도달하는 단계를 아직 발견하는 데 유리합니다. granularity: "None"을 사용하여 각 단계에 대한 단일 집계 결과를 얻습니다:

Levels 퍼널에 대한 퍼널 단계 발견

curl --location 'https://apis.roblox.com/analytics-query-api/v1/universes/${UniverseId}/metrics' \
--header 'x-api-key: ${ApiKey}' \
--header 'Content-Type: application/json' \
--data '{
"metric": "FunnelUserTotalCount",
"granularity": "None",
"breakdown": ["FunnelStep"],
"filter": [
{
"dimension": "FunnelName",
"values": ["Levels"],
"operation": "In"
}
],
"startTime": "2025-11-01T00:00:00Z",
"endTime": "2026-02-01T00:00:00Z"
}'

2단계: 반환된 단계 ID에 필터링하여 각 단계에 대한 퍼널 메트릭을 쿼리합니다:

Levels 퍼널 각 단계의 사용자 이탈율

curl --location 'https://apis.roblox.com/analytics-query-api/v1/universes/${UniverseId}/metrics' \
--header 'x-api-key: ${ApiKey}' \
--header 'Content-Type: application/json' \
--data '{
"metric": "FunnelUserChurnRate",
"granularity": "None",
"breakdown": ["FunnelStep"],
"filter": [
{
"dimension": "FunnelStep",
"values": ["1", "2", "3", "4", "5"],
"operation": "In"
},
{
"dimension": "FunnelName",
"values": ["Levels"],
"operation": "In"
}
],
"startTime": "2026-01-01T00:00:00Z",
"endTime": "2026-02-01T00:00:00Z"
}'

일반 오류

대부분의 오류는 쿼리 작업 실패로 반환됩니다: 응답 본문은 "done": true와 숫자 code 및 문자열 message가 있는 error 객체를 포함합니다. 인증 및 리소스 오류(401, 404)는 본문을 포함하지 않은 일반 HTTP 응답으로 반환되므로, 아래 표에서 오류 코드는 로 표시됩니다.

상태코드원인해결책
4002001필수 필드가 누락되었거나 필드 값이 잘못되었습니다(예: 인식되지 않는 metric 또는 granularity).요청 본문 필드 표를 확인하고 모든 값이 올바르게 철자가 적혀 있는지 확인합니다.
4002001요청된 granularity가 지정된 메트릭 또는 날짜 범위에 대해 지원되지 않습니다.Granularity 옵션을 참조하세요. 두 년을 초과하는 날짜 범위의 경우 OneWeek, OneMonth 또는 None을 사용하세요.
4002001filter 또는 breakdown에 있는 차원이 지정된 메트릭에 대해 지원되지 않습니다.지원되는 메트릭을 참조하세요.
4002001startTime이 메트릭에 대한 데이터 보관 기간을 초과합니다.표준 메트릭은 4년까지 데이터를 보관합니다. 성능 메트릭은 28일 동안 데이터를 보관합니다.
401x-api-key 헤더가 누락되었거나, 잘못되었거나, 취소되었거나, 키가 이 우주에 대한 분석 권한을 갖고 있지 않습니다.키 값을 확인하고 API 키가 Creator Dashboard에서 올바른 권한을 가지고 있는지 확인합니다.
404작업 ID가 존재하지 않습니다.초기 응답에서 반환된 작업 ID를 확인하고 유니버스 ID가 올바른지 확인합니다.
4293000쿼리가 데이터 포인트 예산을 초과했습니다.날짜 범위를 줄이거나 더 굵은 granularity를 사용하거나 limit를 사용하여 그룹 시리즈 수를 줄입니다.
5002000예기치 않은 서버 오류가 발생했습니다.요청을 재시도하세요. 오류가 지속되면 새로운 DevForum 게시물을 작성하세요.
5032002일시적인 오류가 발생했습니다.잠시 후 요청을 재시도하세요.
5041000쿼리가 최대 재시도 수 후 시간 초과되었습니다.더 짧은 날짜 범위, 더 적은 그룹화 또는 더 굵은 granularity를 시도하십시오.
©2026 Roblox Corporation. Roblox 및 Roblox 로고, 'Powering Imagination'은 미국 및 기타 국가 내 당사의 등록 및 미등록 상표입니다.