Method: projects.locations.brands.computeAnalyticsMetrics

선택적 매장 필터를 사용하여 지정된 기간 동안 특정 브랜드의 분석 측정항목을 계산합니다.

HTTP 요청

GET https://foodorderingaiagent.googleapis.com/v1beta/{brand=projects/*/locations/*/brands/*}:computeAnalyticsMetrics

URL은 gRPC 트랜스코딩 문법을 사용합니다.

경로 매개변수

매개변수
brand

string

필수 항목입니다. 분석 측정항목을 가져올 브랜드입니다. 형식: projects/{project}/locations/{location}/brands/{brand}

쿼리 파라미터

파라미터
timestamps[]

string (Timestamp format)

필수 항목입니다. 분석 측정항목이 계산되는 각 간격의 시작을 표시하는 타임스탬프입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.

storeIds[]

string

(선택사항) 분석 측정항목을 가져올 매장 ID 목록입니다. 지정하지 않으면 모든 매장의 분석 측정항목이 반환됩니다. 도시 또는 주별로 쿼리하는 데 필요합니다.

analyticsTypes[]

enum (AnalyticsType)

(선택사항) 계산할 분석 유형입니다. 비어 있거나 지정되지 않은 경우 사용 가능한 모든 분석 유형이 계산됩니다.

featureGate

object (FeatureGate)

(선택사항) 기능 게이트

요청 본문

요청 본문은 비어 있어야 합니다.

응답 본문

MenuService.ComputeAnalyticsMetrics의 응답 메시지입니다.

성공한 경우 응답 본문은 다음과 같은 구조의 데이터를 포함합니다.

JSON 표현
{
  "analyticsMetrics": {
    object (AnalyticsMetrics)
  }
}
필드
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

boolean

(선택사항) 일부 브랜드에만 적용됩니다. 설정된 경우 집계 데이터를 사용하여 분석 측정항목을 계산합니다.

AnalyticsMetrics

특정 기간의 분석 측정항목을 이전 기간과 비교하여 나타냅니다.

JSON 표현
{
  "intervalMetrics": [
    {
      object (IntervalMetrics)
    }
  ]
}
필드
intervalMetrics[]

object (IntervalMetrics)

간격의 측정항목입니다.

IntervalMetrics

특정 시간 간격의 분석 측정항목을 나타냅니다.

JSON 표현
{
  "interval": {
    object (Interval)
  },
  "totalOrderCount": string,
  "successOrderCount": string,
  "avgOrderDurationMs": string,
  "upsellSuccessRate": number,
  "upsellRevenue": {
    object (Money)
  },
  "escalationCount": string,
  "predictedFailureCategoryCounts": [
    {
      object (PredictedFailureCategoryCount)
    }
  ],
  "invalidOrderCount": string,
  "crewEscalationCount": string
}
필드
interval

object (Interval)

이러한 측정항목에 반영되는 시작/종료 시간입니다.

totalOrderCount

string (int64 format)

출력 전용입니다. 총 주문 수입니다.

successOrderCount

string (int64 format)

출력 전용입니다. 성공한 주문 수입니다.

avgOrderDurationMs

string (int64 format)

출력 전용입니다. 밀리초(ms) 단위의 평균 주문 시간입니다.

upsellSuccessRate

number

출력 전용입니다. 업셀 성공률

upsellRevenue

object (Money)

출력 전용입니다. 업셀 수익입니다.

escalationCount

string (int64 format)

출력 전용입니다. 에스컬레이션 결과 그룹 수입니다.

predictedFailureCategoryCounts[]

object (PredictedFailureCategoryCount)

출력 전용입니다. 예측된 실패 카테고리 수입니다.

invalidOrderCount

string (int64 format)

출력 전용입니다. 잘못된 주문의 총 개수입니다.

crewEscalationCount

string (int64 format)

출력 전용입니다. Crew 에스컬레이션 주문 수입니다.

PredictedFailureCategoryCount

예측된 실패 카테고리 수입니다.

JSON 표현
{
  "category": string,
  "count": string
}
필드
category

string

출력 전용입니다. 예측된 실패 카테고리입니다.

count

string (int64 format)

출력 전용입니다. 이 카테고리의 세션 수입니다.