diff --git a/design/backend/api/analytics-service-api.yaml b/design/backend/api/analytics-service-api.yaml index 6b0f234..0303892 100644 --- a/design/backend/api/analytics-service-api.yaml +++ b/design/backend/api/analytics-service-api.yaml @@ -18,6 +18,7 @@ info: **External API Integration:** - 우리동네TV API (조회수) - 지니TV API (광고 노출 수) + - 링고비즈 API (통화 수, 완료 수, 평균 통화 시간) - SNS APIs (좋아요, 댓글, 공유 수) - Circuit Breaker with fallback to cached data @@ -124,6 +125,7 @@ paths: 각 배포 채널별 성과를 상세하게 분석합니다. - 우리동네TV 조회수 - 지니TV 광고 노출 수 + - 링고비즈 통화 수 및 완료율 - SNS 반응 수 (좋아요, 댓글, 공유) - 채널별 참여율 및 전환율 - 채널별 ROI @@ -439,6 +441,32 @@ components: - comments - shares + VoiceCallStats: + type: object + description: 링고비즈 음성 통화 통계 + properties: + totalCalls: + type: integer + description: 총 통화 수 + example: 3000 + completedCalls: + type: integer + description: 완료된 통화 수 + example: 2500 + averageDuration: + type: integer + description: 평균 통화 시간 (초) + example: 45 + completionRate: + type: number + format: double + description: 통화 완료율 (%) + example: 83.3 + required: + - totalCalls + - completedCalls + - averageDuration + ChannelSummary: type: object description: 채널별 성과 요약 @@ -548,6 +576,7 @@ components: enum: - LOCAL_TV - CABLE_TV + - VOICE_CALL - SNS - MOBILE_APP example: "LOCAL_TV" @@ -597,6 +626,8 @@ components: example: 1850 socialInteractions: $ref: '#/components/schemas/SocialInteractionStats' + voiceCallStats: + $ref: '#/components/schemas/VoiceCallStats' required: - views - participants