설정 → Google Analytics에 GA4 측정 ID를 붙여넣습니다. 위젯은 모든 상호작용을 기존 속성으로 전달하며, 필터링을 위해 에이전트 ID가 첨부됩니다.
대부분의 팀은 이미 Google Analytics를 사용하고 있습니다. 이제 AI 위젯이 이를 직접 피드백할 수 있습니다. Google Analytics 통합을 통해 위젯 참여를 기존 사이트 데이터와 함께 볼 수 있습니다 — 이미 신뢰하는 동일한 대시보드, 세그먼트 및 보고서에서.
G-XXXXXXXXXX — GA4 → 관리자 → 데이터 스트림 → 귀하의 스트림에서 찾을 수 있습니다).그게 전부입니다. 위젯은 다음 로드에서 새로운 ID를 감지하고 이벤트를 전달하기 시작합니다. 사이트에 대한 코드 변경이 필요 없습니다. 새로운 추적 스크립스를 관리할 필요가 없습니다. ID를 변경할 수 있는 것은 관리자와 소유자뿐입니다.
임베드 스크립트가 부팅될 때, 위젯은 WIDGET_GA_INIT postMessage를 통해 어떤 GA4 속성으로 보낼지를 알려줍니다. 임베드 스크립트는 다음과 같이:
window.gtag를 재사용합니다 — 이중 초기화 없음, 충돌하는 config 호출 없음.googletagmanager.com에서 gtag.js를 로드하고 측정 ID로 초기화합니다.send_to: <your-measurement-id>를 통해 라우팅하여 이벤트가 항상 올바른 속성에 도착하도록 보장합니다. 여러 GA 스트림이 있는 사이트에서도 마찬가지입니다.다섯 가지 위젯 상호작용이 GA4 이벤트가 됩니다:
| 이벤트 | GA4 이름 | 추가 매개변수 |
|---|---|---|
| 위젯 열림 | widget_open | agent_id |
| 위젯 닫힘 | widget_close | agent_id |
| 메시지 전송 | widget_message_sent | agent_id, message_length |
| AI 응답 수신 | widget_response_received | agent_id |
| 오류 발생 | widget_error | agent_id, error_type |
모든 이벤트는 agent_id를 포함하므로 GA4에서 특정 에이전트로 필터링할 수 있습니다 — 여러 에이전트를 한 조직에서 운영하는 경우 유용합니다. message_length (문자 수)는 메시지 내용을 캡처하지 않고 짧은 쿼리와 자세한 쿼리를 구별할 수 있게 해줍니다. error_type은 오류를 범주별로 태그하여 진단 대시보드에 제공합니다.
메시지 콘텐츠는 Google Analytics로 전송되지 않습니다. 전송되는 것은 메타데이터만입니다: 이벤트 유형, 에이전트 ID, 숫자 길이 및 오류 범주. 위젯은 페이지의 컨텍스트 내에서 GA를 실행하므로 기존 쿠키 동의 배너 및 GDPR 준수 메커니즘이 추적이 발생하는지 제어합니다 — 사이트의 나머지 부분과 동일하게.
사이트가 이미 GA4를 로드하는 경우, 위젯은 window.gtag를 감지하고 이를 직접 사용합니다. 그렇지 않은 경우, 측정 ID를 사용하여 gtag.js를 로드합니다. 어떤 경우든 이벤트는 사이트의 나머지 부분과 동일한 세션 컨텍스트에서 동일한 GA4 속성에 도착하므로 위젯 상호작용이 사용자 여정, 전환 퍼널 및 청중 세그먼트에 자연스럽게 나타납니다.
이벤트가 흐르기 시작하면:
widget_open으로 필터링된 탐색 보고서를 작성하여 일일/주간 위젯 참여를 확인합니다.widget_open → widget_message_sent → 귀하의 전환 이벤트, 얼마나 많은 대화자가 전환되는지 측정합니다.agent_id로 세그먼트하여 에이전트를 나란히 비교합니다.send_to를 찾습니다).위젯 참여 데이터는 항상 귀하의 Companin 대시보드에 존재했습니다. 이 통합은 이를 귀하가 측정하는 모든 것과 동일한 세션, 동일한 사용자 및 동일한 목표에 귀속된 더 넓은 분석 그림의 일부로 만듭니다. 더 이상 도구 간 전환 없이 위젯이 방문자를 전환하는 데 도움이 되는지 이해할 수 있습니다.