## 내용
이 통합을 통해 Botpress 봇을 Google Analytics 에 연결하여 봇의 플로우 내에서 바로 사용자 프로필을 업데이트하고, 노드 보기 및 사용자 지정 이벤트를 추적할 수 있습니다.
## 작동 방식
연동은 액션을 사용하여 측정 프로토콜을 통해 Google Analytics 와 상호 작용하는 방식으로 작동합니다. 다음은 액션에 대한 간략한 개요입니다:
1. **사용자 프로필 업데이트**: 사용자 프로필 업데이트를 Google Analytics 으로 보냅니다.
2. **트랙 노드**: 봇 내 특정 노드가 트리거되는 시점을 추적하여 이벤트 데이터를 Google Analytics 으로 보냅니다.
3. **이벤트 추적**: 페이로드에 정의된 선택적 속성을 포함하여 사용자 지정 이벤트 데이터를 Google Analytics 으로 보냅니다.
이러한 작업은 안전한 데이터 전송을 위해 Google Analytics 측정 ID와 선택적으로 API 시크릿을 활용합니다.
## 통합 기능
### 액션
- **사용자 프로필 업데이트**
- 사용자 프로필 정보 업데이트를 Google Analytics 으로 보냅니다.
- 입력값: 입력: 사용자 ID, 사용자 프로필(선택 사항인 사용자 메타데이터의 JSON 문자열)
- **트래킹 노드**
- 봇 내 노드 활성화에 대한 추적 데이터를 Google Analytics 으로 전송합니다.
- 입력값: 입력: 사용자 ID, 노드 ID
- **이벤트 추적**
- 사용자 지정 이벤트에 대한 데이터를 Google Analytics 으로 전송합니다.
- 입력값: 사용자 ID, 이벤트 이름, 이벤트 페이로드(선택적 이벤트 속성의 JSON 문자열)
### 구성
- **측정 ID**: 이 ID는 Google Analytics 으로 데이터를 전송하는 데 필요합니다. 이 ID는 Google Analytics 대시보드의 관리 > 데이터 스트림에서 찾을 수 있습니다.
- API 비밀**: 데이터 전송 보안을 위해 사용됩니다. 측정 프로토콜 API 비밀 아래의 측정 ID와 동일한 섹션에서 얻을 수 있습니다.
## 설정 지침
#### Google Analytics 설정
1. Google Analytics 대시보드에 로그인합니다.
2. 2. 기존 GA4 속성을 생성하거나 선택합니다.
3. 3. 데이터 스트림을 구성하거나 확인하여 측정 ID 및 API 시크릿을 얻습니다.
#### Botpress 설정
1. 오른쪽 상단의 '설치'를 클릭하고 봇을 선택합니다.
2. 팝업 안내에 따라 연동을 구성합니다.
3. 해당 필드에 Google Analytics 측정 ID와 사용 중인 경우 API 시크릿을 입력합니다.
4. 4. 연동을 활성화하여 설정을 저장합니다.
