Analytics

작업의 버전을 출시 채널 (알파, 베타 또는 프로덕션)에 게시하고 사용자가 작업을 호출하면 보통 24시간 이내에 Actions 콘솔에서 분석 데이터가 표시되기 시작합니다. 이러한 분석은 작업의 사용량, 상태, 검색, 디렉터리 목록에 관한 정보를 제공합니다.

사용

사용량 페이지에는 작업의 사용량 데이터와 관련된 세 개의 그래프가 표시됩니다. 다음 그래프의 데이터를 CSV 형식으로 내보낼 수 있습니다.

이 그래프는 시간 경과에 따른 사용량을 보여줍니다.

다음과 같은 방법으로 표시되는 데이터를 맞춤설정합니다.

  • 그래프 상단에서 해당 버튼을 클릭하면 일별, 주별, 월별 사용량을 확인할 수 있습니다.

  • 그래프의 왼쪽 하단에 있는 기간을 클릭하여 표시할 특정 기간을 설정합니다.

    • 선택한 기간의 총 순 사용자 수는 차트 하단에 표시됩니다.
  • 필터를 클릭하여 다음 데이터를 사용해 그래프를 변경합니다.

    • 노출 영역: 사용된 노출 영역 (예: 휴대기기, 스마트 스피커, 스마트 디스플레이, TV, 웨어러블, 자동차, 피처폰 등)별로 사용량을 필터링합니다.
    • Action(작업): 특정 인텐트별로 사용을 필터링합니다.
    • 언어: 작업에서 사용할 수 있는 특정 언어별로 사용을 필터링합니다.
    • 국가 / 지역: 작업이 제공되는 특정 국가 및 지역별로 사용량을 필터링합니다.

차트에서 CSV 형식으로 데이터를 내보낼 수 있습니다. 이렇게 하려면 내보내기 버튼을 클릭합니다.

사용자 유지율

이 그래프에는 지난 5주간의 사용자 유지율이 표시됩니다. 여기에는 작업을 사용한 모든 사용자 (신규 사용자 포함)가 포함됩니다.

다음과 같은 방법으로 표시되는 데이터를 맞춤설정합니다.

  • 필터를 클릭하여 다음 데이터를 사용해 그래프를 변경합니다.

    • 노출 영역: 사용된 노출 영역 (예: 휴대기기, 스마트 스피커, 스마트 디스플레이, TV, 웨어러블, 자동차, 피처폰 등)별로 사용량을 필터링합니다.
    • Action(작업): 특정 인텐트별로 사용을 필터링합니다.
    • 언어: 작업에서 사용할 수 있는 특정 언어별로 사용을 필터링합니다.
    • 국가 / 지역: 작업이 제공되는 특정 국가 및 지역별로 사용량을 필터링합니다.

차트에서 CSV 형식으로 데이터를 내보낼 수 있습니다. 이렇게 하려면 내보내기 버튼을 클릭합니다.

대화 데이터

이 그래프에는 작업과 관련된 대화 데이터가 표시되며 다음 탭이 포함되어 있습니다.

  • 대화: 사용자가 작업과 진행한 대화 수입니다. 대화는 호출에서 시작하여 작업의 컨텍스트를 종료하는 것으로 끝나는 작업으로, 작업과의 완전한 단일 상호작용입니다.
  • 메시지: 모든 대화의 대화 차례 횟수입니다.
  • 평균 길이: 사용자가 대화를 종료하기 전에 작업에 참여한 평균 길이(초)입니다.
  • 취소율: 사용자가 작업과의 대화를 종료하거나 취소한 시간의 비율입니다.

다음과 같은 방법으로 표시되는 데이터를 맞춤설정합니다.

  • 그래프의 왼쪽 하단에 있는 기간을 클릭하여 조회할 특정 기간을 설정합니다.
  • 필터를 클릭하여 다음 데이터를 사용해 그래프를 변경합니다.

    • 노출 영역: 사용된 노출 영역 (예: 휴대기기, 스마트 스피커, 스마트 디스플레이, TV, 웨어러블, 자동차, 피처폰 등)별로 사용량을 필터링합니다.
    • Action(작업): 특정 인텐트별로 사용을 필터링합니다.
    • 언어: 작업에서 사용할 수 있는 특정 언어별로 사용을 필터링합니다.
    • 국가 / 지역: 작업이 제공되는 특정 국가 및 지역별로 사용량을 필터링합니다.

차트에서 CSV 형식으로 데이터를 내보낼 수 있습니다. 이렇게 하려면 내보내기 버튼을 클릭합니다.

사용자 참여

사용자 참여도 그래프에는 선택한 달에 사용자가 작업에 참여한 방식이 표시됩니다. 일반적으로 고급 사용자 곡선이라고 하는 이 그래프를 사용하면 '고급 사용자', 즉 작업에 정기적으로 참여하는 전용 사용자 수를 그달의 날짜별로 작업에 참여한 사용자의 비율을 표시하여 확인할 수 있습니다.

x축의 각 숫자는 사용자가 작업에 참여한 해당 월의 일수를 나타냅니다. 예를 들어 4 열은 한 달 중 4일 동안 작업에 참여한 사용자의 비율을 나타냅니다. 열 위로 커서를 가져가면 다음 스크린샷과 같이 이 정보가 포함된 팝업이 표시됩니다.

다음과 같은 방법으로 표시되는 데이터를 맞춤설정할 수 있습니다.

  • 그래프의 모서리에 있는 기간을 클릭하여 데이터를 확인할 월을 지정합니다.

차트에서 CSV 형식으로 데이터를 내보낼 수 있습니다. 이 데이터를 내보내려면 내보내기를 클릭합니다.

보건 정보

상태 섹션을 사용하면 작업의 품질 및 상태와 관련된 다음 측정항목을 추적할 수 있습니다.

  • 오류: 특정 날짜에 작업의 클라우드 엔드포인트에서 반환한 오류 수입니다. 오류가 많이 있는 경우 로그를 확인하여 엔드포인트가 비정상 종료되거나 예기치 않게 동작하는 원인을 식별할 수 있습니다.

    • Google Cloud 콘솔에서 프로젝트의 로그를 보려면 로그 보기 링크를 선택합니다. 이러한 로그 읽기에 대한 자세한 내용은 문제 해결 페이지를 참조하세요.
  • 작업 지연 시간: 작업 엔드포인트의 지연 시간입니다. 지연 시간이 매우 길거나 정기적으로 급증한다면 사용자가 작업과 상호작용하는 동안 지연이 발생할 수 있습니다.

  • 사용자가 경험한 지연 시간: 작업에 대한 각 요청에서 사용자가 느낀 지연 시간입니다. 이 측정항목은 작업과 상호작용할 때 사용자가 어떤 경험을 하는지 보여줍니다.

  • API 요청 (작업 빌더만 해당): 이 차트에는 총 API 요청 및 상태의 분석 내용이 표시됩니다. API 요청이 실패하면 올바른 데이터가 반환되지 않았음을 의미합니다.

차트에서 CSV 형식으로 데이터를 내보낼 수 있습니다.

필터를 클릭하면 다음과 같은 추가 보기 옵션이 제공됩니다.

  • 표시 경로: 모바일, 스마트 스피커, 스마트 디스플레이 기기로 필터링합니다.
  • 작업: 특정 작업을 기준으로 필터링합니다.
  • Language: 작업에서 지원하는 언어를 기준으로 필터링합니다.
  • 국가/지역: 작업을 사용할 수 있는 국가/지역을 기준으로 필터링합니다.

차트에서 CSV 형식으로 데이터를 내보낼 수 있습니다. 이렇게 하려면 내보내기 버튼을 클릭합니다.

디스커버리

검색 섹션에는 사용자가 작업을 검색하는 방법에 관한 정보가 표시됩니다.

사용자가 작업과 관련된 문구를 말하면 Google은 사용자가 작업의 호출 이름을 명시적으로 지정하지 않은 경우에도 작업을 사용해 보도록 권장하기도 합니다. 검색 페이지에는 Google에서 작업을 추천하게 된 구문이 정리된 표가 표시됩니다. 이 표의 열은 다음과 같습니다.

  • 호출: Google에서 작업을 추천하게 된 사용자 쿼리입니다. 실제 사용자 검색어 외에도 이 목록에는 다음 값이 포함됩니다.

    • BUILT_IN_INTENT - 이 목록은 작업이 내장 인텐트를 통해 호출되었음을 나타냅니다.
    • AUTO_MATCHED_BY_GOOGLE - 이 목록은 암시적 호출이 사용된 시점을 나타냅니다.
    • ACTION_LINK - 이 목록은 어시스턴트 링크를 통해 작업이 호출된 시점을 나타냅니다.
  • 인텐트: 사용자의 검색어와 일치시킨 인텐트입니다.

  • 노출수: 이 구문이 Google에서 작업을 추천한 횟수입니다.

  • 선택: Google이 추천한 후 사용자가 작업을 호출한 횟수입니다. 이 수는 이 문구의 노출수를 초과할 수 없습니다.

  • 선택률: 선택으로 이어진 노출수의 비율입니다. 비율 비율이 낮으면 많은 사용자가 이 특정 쿼리에 다른 작업을 사용하고 있음을 나타내며, 비율이 높으면 작업이 해당 쿼리에 인기가 있음을 나타냅니다.

차트에서 CSV 형식으로 데이터를 내보낼 수 있습니다. 이렇게 하려면 내보내기 버튼을 클릭합니다.

디렉터리

디렉터리 섹션에는 어시스턴트 디렉터리에 있는 작업의 트래픽과 평점이 표시됩니다.

  • 평점 요약: 작업의 평균 평점, 총 평점 수, 각 점수에서 작업을 평가한 사용자 수입니다.
  • 평균 평점: 시간 경과에 따른 작업의 누적 평균 평점 또는 특정 날짜의 모든 리뷰의 평균입니다.
  • 시간 경과에 따른 평점: 시간 경과에 따른 또는 특정 날짜의 작업의 누적 평점 분포입니다.
  • 어시스턴트 디렉터리 페이지 조회수: 하루에 작업의 디렉터리 페이지를 방문한 횟수입니다. 뷰는 국가/지역, 언어 및 기타 유용한 카테고리 지정 옵션을 기준으로 필터링할 수 있습니다.
  • 어시스턴트 디렉터리에서 시작된 호출: 사용자가 디렉터리에서 '사용해 보기' 버튼을 눌러 작업을 호출한 횟수입니다. 작업, 국가/지역, 기타 유용한 분류 옵션을 기준으로 호출을 필터링할 수 있습니다.

BigQuery로 내보내기

BigQuery는 Google의 완전 관리형 서버리스 데이터 웨어하우징 솔루션입니다. 작업의 분석 데이터를 매일 BigQuery 계정으로 내보내도록 설정할 수 있습니다. 데이터가 BigQuery에 저장되면 자체 대시보드 빌드 및 데이터 시각화를 포함하여 데이터에 대한 추가 분석을 수행할 수 있습니다.

BigQuery에 연결

작업을 BigQuery에 연결하려면 다음 단계를 따르세요.

  1. 애널리틱스 페이지의 왼쪽 메뉴에서 내보내기를 클릭합니다.
  2. 시작하기를 클릭합니다.
  3. 내보내기를 시작하려는 날짜를 선택합니다.

  4. 내보내기를 클릭합니다.

요약 페이지에 내보내기 프로세스의 일일 상태가 대기 중, 실패 또는 완료됨으로 표시됩니다.

내보내기는 완료될 때까지 대기 중으로 표시됩니다.

이전 데이터 백필

이전 날짜의 데이터를 내보내려면 이전 데이터를 백필하면 됩니다. 힙 덤프를 분석하려면 다음 단계를 따르세요.

  1. 애널리틱스 페이지에서 내보내기를 클릭합니다.
  2. 톱니바퀴 아이콘을 클릭합니다.
  3. 이전 데이터 백필을 클릭합니다.
  4. 원하는 날짜 옵션을 선택합니다.
  5. 내보내기를 클릭합니다.

내보내기가 완료될 때까지 백필 프로세스는 대기 중으로 표시됩니다.

내보내기 중지

BigQuery로 내보내기를 중지하려면 다음 단계를 따르세요.

  1. 애널리틱스 페이지에서 내보내기를 클릭합니다.
  2. 톱니바퀴 아이콘을 클릭합니다.
  3. BigQuery에서 연결 해제를 클릭합니다.
  4. 연결 해제를 클릭하여 확인합니다.

추가 분석 도구

작업을 배포한 후에는 작업의 현재 상태를 분석하고 다음과 같은 질문에 답하는 데 도움이 되도록 채택, 사용량, 품질과 같은 항목을 추적할 수 있습니다.

  • 사용자는 몇 명인가요? 사용자가 증가하고 있나요?
  • 사용자가 무엇을 해야 하는지 혼란스러워하거나 내 작업이 이해하지 못하는 말을 하는가?
  • 사용자가 내 작업을 오랫동안 사용하나요? 아니면 정기적으로 대화를 취소하나요?
  • 어떤 작업이 가장 인기 있고 어떤 작업은 참여도가 낮은가요?

이 데이터는 장기적인 성과를 개선할 수 있는 기회를 파악하는 데 도움이 됩니다. 사용자가 이러한 데이터를 얻을 수 있도록 당사는 분석 도구 제공업체를 Actions on Google과 통합할 수 있도록 했으며, 5분 이내에 이러한 도구를 설정할 수 있습니다.

추가 모니터링 도구

작업을 개발하고 배포할 때 로깅, 모니터링, 알림을 추가하는 것이 좋습니다. 모니터링 및 알림 도구는 업타임을 추적하고 오류 및 예외에 대한 알림을 제공합니다. 이러한 도구를 사용하면 어시스턴트의 실제 요청으로 작업을 디버그하고 테스트할 수도 있습니다. 다음 모니터링 도구가 Actions on Google과 통합되었습니다.