대화형 작업에 대한 Actions 콘솔 분석이 2022년 9월 13일에 지원 중단되었습니다. 자세한 내용은 대화 작업 지원 중단 개요를 참고하세요.

Analytics

컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

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

사용

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

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

표시되는 데이터는 다음과 같이 맞춤설정합니다.

  • 그래프 상단의 버튼을 클릭하여 일별, 주별, 월별 사용량을 확인합니다.

  • 그래프 왼쪽 하단의 기간을 클릭하여 조회할 특정 기간을 설정합니다.

    • 선택한 기간의 총 순 사용자 수가 차트 하단에 표시됩니다.

  • 필터를 클릭하면 다음 데이터를 사용하여 그래프를 변경할 수 있습니다.

    • 표면: 사용한 표면별로 사용량을 필터링합니다 (예: 휴대기기, 스마트 스피커, 스마트 디스플레이, TV, 웨어러블, 자동차, 피처폰 등).
    • 작업: 특정 인텐트별로 사용량을 필터링합니다.
    • 언어: 작업이 지원되는 특정 언어를 기준으로 사용량을 필터링합니다.
    • 국가/지역: 작업이 지원되는 특정 국가 및 지역으로 사용량을 필터링합니다.

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

사용자 유지율

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

표시되는 데이터는 다음과 같이 맞춤설정합니다.

  • 필터를 클릭하면 다음 데이터를 사용하여 그래프를 변경할 수 있습니다.

    • 표면: 사용한 표면별로 사용량을 필터링합니다 (예: 휴대기기, 스마트 스피커, 스마트 디스플레이, TV, 웨어러블, 자동차, 피처폰 등).
    • 작업: 특정 인텐트별로 사용량을 필터링합니다.
    • 언어: 작업이 지원되는 특정 언어를 기준으로 사용량을 필터링합니다.
    • 국가/지역: 작업이 지원되는 특정 국가 및 지역으로 사용량을 필터링합니다.

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

대화 데이터

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

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

표시되는 데이터는 다음과 같이 맞춤설정합니다.

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

  • 필터를 클릭하면 다음 데이터를 사용하여 그래프를 변경할 수 있습니다.

    • 표면: 사용한 표면별로 사용량을 필터링합니다 (예: 휴대기기, 스마트 스피커, 스마트 디스플레이, TV, 웨어러블, 자동차, 피처폰 등).
    • 작업: 특정 인텐트별로 사용량을 필터링합니다.
    • 언어: 작업이 지원되는 특정 언어를 기준으로 사용량을 필터링합니다.
    • 국가/지역: 작업이 지원되는 특정 국가 및 지역으로 사용량을 필터링합니다.

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

사용자 참여도

사용자 참여 그래프에는 선택한 달에 사용자가 작업에 참여한 방식이 표시됩니다. 일반적으로 고급 사용자 곡선이라고 하는 이 그래프에서는 '파워 사용자'가 몇 명인지 확인할 수 있습니다. 즉, 해당 작업에 정기적으로 참여하는 사용자 중 그날의 일수를 기준으로 작업에 참여하는 사용자의 비율을 표시하여 그 수를 파악할 수 있습니다.

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

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

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

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

건강

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

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

    • 로그 보기 링크를 선택하여 Google Cloud Console에서 프로젝트의 로그를 봅니다. 이러한 로그를 읽는 방법에 대한 자세한 내용은 문제 해결 페이지를 참조하세요.

  • 작업 지연 시간: 작업 엔드포인트의 지연 시간입니다. 지연 시간이 매우 길거나 주기적으로 급증하는 경우 사용자가 작업과 상호작용하는 동안 지연이 발생할 수 있습니다.

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

  • API 요청(작업 빌더 전용): 이 차트에는 총 API 요청 수와 상태에 대한 세부정보가 표시됩니다. API 요청에 실패하면 올바른 데이터가 반환되지 않았습니다.

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

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

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

차트에서 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. 연결 해제를 클릭하여 확인합니다.

추가 분석 도구

작업을 배포한 후에는 채택, 사용, 품질 등을 추적하여 작업의 현재 상태를 분석하고 다음과 같은 질문에 답하는 것이 좋습니다.

  • 사용자는 몇 명인가요? 사용자가 증가하고 있나요?
  • 사용자가 무엇을 해야 할지 혼란스러워 하나요? 아니면 내 작업이 이해하지 못하는 말을 하나요?
  • 사용자가 내 작업에 오랜 시간을 할애하나요? 아니면 정기적으로 대화를 취소하나요?
  • 내 액션 중 가장 인기 있는 액션은 무엇인지, 참여도가 낮은 액션은 무엇인가요?

이 데이터를 통해 액션의 장기적 성공을 개선할 기회를 파악할 수 있습니다. 이러한 데이터를 얻을 수 있도록 Google에서는 분석 도구 제공업체를 Actions on Google과 통합할 수 있으며, 사용자는 최소 5분 만에 이러한 도구를 설정할 수 있습니다.

추가 모니터링 도구

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