구성 가능한 대시보드를 사용하여 시간이 지남에 따라 고객 경험 통계의 사용량 및 의견 측정항목을 확인합니다. 구성 가능한 대시보드는 다양한 차트로 맞춤 뷰를 빌드하고 유지할 수 있으므로 데이터 표현과 레이아웃을 유연하게 관리할 수 있습니다. 구성 가능한 대시보드를 사용하면 차트 유형을 선택하고, 구성을 저장하고, 다음에 페이지를 방문할 때 검색할 수 있습니다.
대시보드 구성요소
대시보드에는 다음 구성요소가 포함됩니다.
| 구성요소 | 설명 |
|---|---|
| 대시보드 | 전체 구조와 차트 정의를 저장하는 최상위 리소스입니다. |
| 섹션 | 섹션에는 타일 또는 중첩된 섹션 (탭으로 표시됨)이 있을 수 있습니다. 대시보드 섹션에는 표시 이름과 설명이 있을 수 있습니다. date_range 필터를 전체 탭의 모든 차트에 적용할 수 있습니다. 섹션은 그리드 단위의 너비와 높이를 사용하여 실제 크기를 정의합니다. |
| 타일 | 대시보드 내의 요소로, 중첩된 섹션 또는 차트로 정의됩니다. 기본 기간은 지난주입니다. date_range를 지난 1일, 지난 2일, 지난 1주, 지난 2주, 지난 1개월, 지난 1분기, 지난 1년 또는 맞춤 시작일과 종료일로 추가 쿼리할 수 있습니다. |
대시보드 필드 정의
각 대시보드는 다음 필드로 구성됩니다. display_name 및 description만 콘솔에 표시됩니다.
| 필드 | 설명 | 제약 조건/참고 |
|---|---|---|
name |
대시보드 이름 | 형식: projects/{project}/locations/{location}/dashboards/{dashboard} |
display_name |
대시보드에 사용자가 제공한 이름 | 최대 100자(영문 기준) |
description |
대시보드 설명 | 선택사항 |
create_time |
대시보드 생성 타임스탬프 | 출력 전용 |
update_time |
대시보드 최종 업데이트 타임스탬프 | 출력 전용 |
filter |
대시보드의 모든 차트에 대한 필터 | 선택적 문자열 필터 지원 |
데이터 및 쿼리
차트에서는 고객 경험 통계가 SQL 쿼리로 변환하는 자연어 (NL)를 사용합니다. 이러한 쿼리는 차트를 표시하기 위한 데이터 및 시각적 사양을 생성합니다. 시각적 사양은 VEGA-LITE 형식입니다. 차트 API는 GenerativeInsights data 소스, session_id, revision_id를 사용하여 차트의 현재 SQL 및 시각적 사양 상태를 저장합니다.
대시보드 작업
구성 가능한 대시보드에서 다음 작업을 실행할 수 있습니다.
대시보드 만들기
다음 단계에 따라 대시보드를 만듭니다.
콘솔
CX Insights 콘솔로 이동하여 Google 계정으로 로그인하고 프로젝트를 선택합니다.
대시보드를 클릭합니다. 여기에는 사전 빌드된 대시보드와 맞춤 대시보드가 모두 표시됩니다.
대시보드 스튜디오에서 + 대시보드 추가를 클릭하여 맞춤 대시보드를 만듭니다.
각 대시보드는 타일 형태로 표시됩니다.
대시보드를 클릭하면 모든 차트의 개요가 표시됩니다.
REST API
다음 예와 같은 요청을 제출합니다.
{
"displayName": "My New Dashboard with Container",
"root_container": {
"displayName": "Overview tab",
"widgets": [
{
"container": {
"displayName": "Inner Chart Group 1",
"widgets": [
{
"chart": {
"displayName": "Most Reported Issues"
"dataSource": {"generativeInsights": "What are top 5 issues?"}
}
},
{
"chart": {
"displayName": "Topic Distribution"
"dataSource": {"generativeInsights": "What are the topics?"}
}
}
]
}
}
]
}
}
Curl
다음 curl 명령을 실행합니다. 이 예시에서는 페이로드가 create_dashboard_nested.json에 저장됩니다.
curl -X POST \ -H "Authorization: Bearer $(gcloud auth --impersonate-service-account=$SA_EMAIL print-access-token)" \ -H "Content-Type: application/json; charset=utf-8" \ -d @create_dashboard_nested.json "https://$ENDPOINT/v1/projects/$PROJECT/locations/$LOCATION/dashboards?dashboard_id=$DASHBOARD_ID"
대시보드 수정
다음 단계에 따라 대시보드를 수정하세요.
콘솔
대시보드를 선택하고 더보기 more_vert > 수정을 클릭하여 대시보드를 수정합니다.
다음 옵션 중 하나를 선택합니다.
- + 타일 추가
- + 섹션 추가
- 수정 탭 이름 바꾸기
- content_copy 탭 복제
- 삭제 탭 삭제
- 결과를 보려면 기간을 선택하세요.
- 타일을 선택하고 더보기 more_vert를 클릭합니다. AI 질문, 타일 설정, 쿼리 편집기 옵션이 있는 측면 패널이 표시됩니다.
추가 옵션
AI에게 질문하기: 'AI에게 질문하기'를 클릭하고 변경사항에 관한 텍스트 설명을 입력합니다. AI 어시스턴트는 대시보드를 빌드하는 데 도움을 줄 수 있습니다. AI 어시스턴트에게 후속 질문을 할 수도 있습니다. 차트 저장을 클릭하면 이전 시각화로 롤백할 수 있습니다. 자연어 (NL)를 사용하면 가상 에이전트의 일별 평균 대화 수는 얼마인가요?와 같은 설명이 포함된 질문을 지정하여 시각화 자료를 생성할 수 있습니다. 이러한 쿼리는 BigQuery에 대해 실행하기 위한 SQL과 표시를 위한 시각적 사양 (VEGA lite)으로 변환됩니다.
타일 설정: 이 섹션에서 시각적 사양을 직접 업데이트하여 차트 속성을 제어할 수 있습니다. 예: 차트의 표시 이름을 변경합니다. 드롭다운 메뉴에서 원하는 차트 유형을 선택할 수 있습니다. 차트 API는 다음 차트 유형과 데이터 표현을 지원합니다.
- BAR
- LINE
- AREA
- PIE
- SCATTER
- 테이블
- SCORE_CARD
- SUNBURST
- 게이지
- SANKEY
대시보드를 새로고침할 때 대화 필터 또는 새 기간을 추가로 지정할 수 있습니다.
쿼리 편집기: AI 어시스턴트와 상호작용하고 대시보드를 빌드할 수 있습니다. AI 생성 SQL 응답이 마음에 들지 않으면 SQL을 직접 업데이트하여 차트를 재생성할 수 있으며, SQL 응답이 기존 시각적 사양을 추가로 채웁니다. 쿼리 편집기에는 생성된 SQL이 표시되며, 테이블 이름은 미리 정의된 자리표시자 문자열 INSIGHTS_DASHBOARD_VIEW을 참조하도록 마스크 처리됩니다. 참고: SELECT 작업만 수행할 수 있습니다.
Curl
다음 curl 명령을 실행합니다. 이 예시에서는 페이로드가 update_dashboard.json에 저장됩니다.
curl -X PATCH \ -H "Authorization: Bearer $(gcloud auth --impersonate-service-account=$SA_EMAIL print-access-token)" \ -H "Content-Type: application/json; charset=utf-8" \ -d @update_dashboard.json \ "https://$ENDPOINT/v1/projects/$PROJECT/locations/$LOCATION/dashboards/$DASHBOARD_ID?update_mask=root_container"
대시보드 삭제
대시보드와 모든 관련 차트를 삭제하려면 다음 단계를 따르세요.
콘솔
대시보드를 선택하고 더보기 more_vert > 삭제를 클릭하여 대시보드를 삭제합니다.
Curl
다음 curl 명령을 실행합니다.
curl -X DELETE \ -H "Authorization: Bearer $(gcloud auth --impersonate-service-account=$SA_EMAIL print-access-token)" \ "https://$ENDPOINT/v1/projects/$PROJECT/locations/$LOCATION/dashboards/$DASHBOARD_ID"