- HTTP 요청
- 경로 매개변수
- 쿼리 파라미터
- 요청 본문
- 응답 본문
- 승인 범위
- AnalyticsType
- FeatureGate
- AnalyticsMetrics
- IntervalMetrics
- PredictedFailureCategoryCount
선택적 매장 필터를 사용하여 지정된 기간 동안 특정 브랜드의 분석 측정항목을 계산합니다.
HTTP 요청
GET https://foodorderingaiagent.googleapis.com/v1/{brand=projects/*/locations/*/brands/*}:computeAnalyticsMetrics
URL은 gRPC 트랜스코딩 문법을 사용합니다.
경로 매개변수
| 매개변수 | |
|---|---|
brand |
필수 항목입니다. 분석 측정항목을 가져올 브랜드입니다. 형식: projects/{project}/locations/{location}/brands/{brand} |
쿼리 파라미터
| 파라미터 | |
|---|---|
timestamps[] |
필수 항목입니다. 분석 측정항목이 계산되는 각 간격의 시작을 표시하는 타임스탬프입니다. 생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 |
storeIds[] |
(선택사항) 분석 측정항목을 가져올 매장 ID 목록입니다. 지정하지 않으면 모든 매장의 분석 측정항목이 반환됩니다. 도시 또는 주별로 쿼리하는 데 필요합니다. |
analyticsTypes[] |
(선택사항) 계산할 분석 유형입니다. 비어 있거나 지정되지 않은 경우 사용 가능한 모든 분석 유형이 계산됩니다. |
featureGate |
(선택사항) 기능 게이트 |
요청 본문
요청 본문은 비어 있어야 합니다.
응답 본문
MenuService.ComputeAnalyticsMetrics의 응답 메시지입니다.
성공한 경우 응답 본문은 다음과 같은 구조의 데이터를 포함합니다.
| JSON 표현 |
|---|
{
"analyticsMetrics": {
object ( |
| 필드 | |
|---|---|
analyticsMetrics |
출력 전용입니다. 브랜드의 분석 측정항목입니다. |
승인 범위
다음 OAuth 범위가 필요합니다.
https://www.googleapis.com/auth/cloud-platform
자세한 내용은 Authentication Overview를 참조하세요.
AnalyticsType
계산할 분석 유형입니다.
| 열거형 | |
|---|---|
ANALYTICS_TYPE_UNSPECIFIED |
지정되지 않은 분석 유형입니다. |
GENERIC |
일반/전체 측정항목 (예: 주문 수, 에스컬레이션 수, 업셀 수)을 계산합니다. |
DAILY |
일일 측정항목 (예: 일일 주문 및 에스컬레이션 수)을 계산합니다. |
PREDICTED_FAILURE_CATEGORIES |
예측된 실패 카테고리 측정항목 (예: 예측된 실패 카테고리 수)을 계산합니다. |
FeatureGate
분석 계산 동작을 제어하는 기능 게이트입니다.
| JSON 표현 |
|---|
{ "enableAggregationData": boolean } |
| 필드 | |
|---|---|
enableAggregationData |
(선택사항) 일부 브랜드에만 적용됩니다. 설정된 경우 집계 데이터를 사용하여 분석 측정항목을 계산합니다. |
AnalyticsMetrics
특정 기간의 분석 측정항목을 이전 기간과 비교하여 나타냅니다.
| JSON 표현 |
|---|
{
"intervalMetrics": [
{
object ( |
| 필드 | |
|---|---|
intervalMetrics[] |
간격의 측정항목입니다. |
IntervalMetrics
특정 시간 간격의 분석 측정항목을 나타냅니다.
| JSON 표현 |
|---|
{ "interval": { object ( |
| 필드 | |
|---|---|
interval |
이러한 측정항목에 반영되는 시작/종료 시간입니다. |
totalOrderCount |
출력 전용입니다. 총 주문 수입니다. |
successOrderCount |
출력 전용입니다. 성공한 주문 수입니다. |
avgOrderDurationMs |
출력 전용입니다. 밀리초(ms) 단위의 평균 주문 시간입니다. |
upsellSuccessRate |
출력 전용입니다. 업셀 성공률 |
upsellRevenue |
출력 전용입니다. 업셀 수익입니다. |
escalationCount |
출력 전용입니다. 에스컬레이션 결과 그룹 수입니다. |
predictedFailureCategoryCounts[] |
출력 전용입니다. 예측된 실패 카테고리 수입니다. |
invalidOrderCount |
출력 전용입니다. 잘못된 주문의 총 개수입니다. |
crewEscalationCount |
출력 전용입니다. Crew 에스컬레이션 주문 수입니다. |
PredictedFailureCategoryCount
예측된 실패 카테고리 수입니다.
| JSON 표현 |
|---|
{ "category": string, "count": string } |
| 필드 | |
|---|---|
category |
출력 전용입니다. 예측된 실패 카테고리입니다. |
count |
출력 전용입니다. 이 카테고리의 세션 수입니다. |