대화형 작업에 대한 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. 연결 해제를 클릭하여 확인합니다.

추가 분석 도구

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

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

이 데이터는 액션의 장기적인 성공을 개선할 기회를 파악하는 데 도움이 됩니다. 이러한 데이터를 얻기 위해 분석 도구 제공업체가 Actions on Google과 통합되었습니다. 다음 도구를 사용하여 5분 만에 이러한 도구를 설정할 수 있습니다.

추가 모니터링 도구

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