측정 프로토콜을 사용하여 GA4에 웹 이벤트 전송

1. 소개

최종 업데이트: 2019년 4월 30일

빌드할 항목

• 이 Codelab에서는 측정 프로토콜을 사용하여 외부 이벤트를 GA4로 전송하는 방법을 알아봅니다.
• 이 Codelab에서는 Google 애널리틱스 4가 구현된 웹페이지/사이트가 이미 있다고 가정합니다.

학습할 내용

• 첫 MP 호출을 빌드하는 단계
• 호출에 필요한 매개변수에 대한 이해
• 테스트 호출 전송 및 검증
• Python에서 호출을 실행하는 샘플 스크립트 빌드

필요한 항목

• 웹사이트/웹페이지
• 변경할 수 있는 IDE
• GA4 계정
• 선택사항 - Python 개발 환경 (또는 Colab)

2. 필수 입력란 수집

GA4에서 API 보안 비밀번호 만들기

GA4로 이동하여 관리 > 데이터 스트림 > 스트림 선택 > 측정 프로토콜 > 만들기로 이동하여 새 API 보안 비밀을 만듭니다.

닉네임을 입력하면 보안 비밀 값이 표시되며, 이 값을 호출에 사용할 수 있습니다.

client_id 수집

아래 방법 중 하나를 사용하여 client_id를 수집할 수 있습니다.

1. gTag를 통해 수집

두 가지 모두 아래에 자세히 설명되어 있습니다.

gTag를 통한 수집

다음 코드를 사용하여 웹사이트를 통해 client_id를 가져올 수 있습니다.

gtag('get', 'UA-XXXXXXXX-Y', 'client_id', (clientID) => {
  Do something with clientID)
}

아래는 인프라에 따른 추가 링크입니다.

• gtag.js(‘get')

3. 통화 구성

GA4의 이벤트 빌더를 사용하여 샘플 호출을 빌드할 수 있습니다. 이렇게 하려면 로그인이 필요하고 쿠키를 사용 설정해야 합니다. 전환 스위치가 'gtag.js'로 설정되어 있어야 합니다.

다음 필드를 입력해야 합니다.

• api_secret - 이미 GA4에서 이전에 생성됨
• measurement_id - 이 값을 가져오려면 관리 > 데이터 스트림 > 스트림 선택으로 이동하세요 . 아래와 같이 표시됩니다.

• client_id - 이 값을 이미 가져왔습니다.
• user_id는 필수가 아닙니다. 지금은 비워두어도 됩니다.
• 카테고리 - 드롭다운에서 '맞춤'으로 변경하고 원하는 이벤트 이름을 입력합니다 (자동 수집 이벤트는 사용하지 않음). 여기서는 'test_from_codelab'을 사용합니다.

선택적으로 아래 버튼을 클릭하여 이벤트 매개변수 또는 사용자 속성을 제공할 수도 있습니다.

모든 항목을 입력하면 '이벤트 검증' 버튼이 있는 다음과 같은 화면이 표시됩니다.

이 단계에 도달하면 주황색으로 강조 표시된 '이벤트 확인' 버튼을 클릭합니다. 이벤트가 유효하다는 아래 메시지가 표시되고 이제 'GA로 보내기' 버튼이 표시됩니다. 이때 이벤트가 유효하지 않은 것으로 표시되면 문제가 있는 정확한 필드가 표시되므로 해당 필드를 수정하고 다시 시도할 수 있습니다.

이제 버튼을 클릭하면 테스트 이벤트가 GA4로 전송됩니다.

4. GA4에서 이벤트 유효성 검사하기

이벤트를 전송한 후 GA4 계정으로 이동하여 실시간을 확인할 수 있습니다. 이벤트가 표시됩니다.

이벤트가 실시간 보기에서 실제 이벤트 보고 탭으로 전파되는 데 약 24시간이 걸릴 수 있으므로 일반 이벤트 보고에 바로 표시되지 않더라도 걱정하지 않으셔도 됩니다.

5. Python 스크립트 빌드

이제 테스트를 완료했으므로 API 호출과 이벤트 페이로드를 검사하여 이 호출을 실행할 수 있는 유사한 아키텍처를 Python (또는 원하는 언어)으로 빌드할 수 있습니다. 그런 다음 원하는 빈도로 예약하고 운영할 수 있습니다. 이 부분에서는 Python을 지원하는 원하는 IDE를 사용하거나 기기에 설치가 필요 없는 Google Colab 노트북을 사용하면 됩니다.

GA4 이벤트 빌더를 다시 살펴보면 엔드포인트가 다음과 같음을 알 수 있습니다.

POST /mp/collect?measurement_id=XXXX&api_secret=XXXX 
HTTP/1.1
Host: www.google-analytics.com

이벤트 페이로드는 다음과 같습니다.

{
  "client_id": XXXX,
  "non_personalized_ads": false,
  "events": [
    {
      "name": "test_from_codelab",
      "params": {
        "test_param": "test_123"
      }
    }
  ]
}

다음과 같은 코드를 사용하여 이를 Python으로 변환할 수 있습니다.

import requests
import json
url = "https://www.google-analytics.com/mp/collect?measurement_id=XXXX&api_secret=XXXX"
payload = {
  "client_id": XXXX,
  "non_personalized_ads": false,
  "events": [
    {
      "name": "test_from_codelab",
      "params": {
        "test_param": "test_123"
      }
    }
  ]
}
r = requests.post(url,data=json.dumps(payload),verify=True)
print(r.status_code)

올바른 값으로 실행하면 GA4에서 이벤트가 실시간으로 반영되는 것을 확인할 수 있습니다.

6. 축하합니다

축하합니다. GA4에서 측정 프로토콜을 성공적으로 사용하셨습니다. 이제 강력한 솔루션 아키텍처를 구축하여 Google 애널리틱스로 더 의미 있는 데이터를 전송하고 마케팅 및 비즈니스 분석을 개선할 수 있습니다. 이 기능을 최대한 활용하려면 Google Ads에 연결하고 이러한 이벤트를 전환으로 가져오는 것이 좋습니다.

학습한 내용

• MP 통화를 위해 올바른 변수를 수집하는 방법
• 테스트 이벤트를 전송하고 검증하는 방법
• MP 호출을 전송하는 스크립트를 빌드하는 방법

참조 문서

• 측정 프로토콜 - 참조
• GA4 측정 프로토콜 - 이벤트 빌더
• 측정 프로토콜 - 개요