이벤트 전송

개요

이 가이드에서는 요청의 형식을 지정하고 Google 애널리틱스 측정 프로토콜로 요청을 전송하는 방법을 설명합니다.

이벤트 전송

이벤트를 전송하려면 다음 엔드포인트에 HTTP POST 요청을 실행합니다.

POST /mp/collect HTTP/1.1
HOST: www.google-analytics.com
Content-Type: application/json
<payload_data>

필수 매개변수

유효한 요청에는 Firebase 또는 gtag.js를 사용하는 경우 달라지는 다음과 같은 두 가지 매개변수가 필요합니다.

  1. URL 매개변수

    • api_secret - 필수입니다. Google 애널리틱스 UI에서 생성된 API SECRET입니다. 새 비밀번호를 만들려면
      관리자 > 데이터 스트림 > 스트림 선택 > 측정 프로토콜 > 생성으로 이동합니다.

    전체 참조를 보려면 쿼리 매개변수를 참고하세요.

  2. JSON 본문

    • user_id - 선택사항입니다. 사용자의 고유 식별자입니다. 이 식별자에 대한 자세한 내용은 교차 플랫폼 분석용 User-ID를 참고하세요.

    • events - 필수입니다. 이벤트 항목의 배열입니다.

    전체 참조를 보려면 JSON POST 본문을 참고하세요.

이벤트 전송

tutorial_begin 이벤트를 전송하려면 다음 요청을 실행합니다.

제한사항

  • 요청은 최대 25개의 이벤트를 포함할 수 있습니다.
  • 이벤트는 최대 25개의 매개변수를 포함할 수 있습니다.
  • 이벤트는 최대 25개의 사용자 속성을 포함할 수 있습니다.
  • 사용자 속성 이름은 24자(영문 기준) 이하여야 합니다.
  • 사용자 속성 값은 36자(영문 기준) 이하여야 합니다.
  • 이벤트 이름은 40자(영문 기준) 이하여야 하고 영숫자 및 밑줄 문자만 사용할 수 있으며 알파벳으로 시작해야 합니다.
  • 항목 매개변수를 포함한 매개변수 이름은 40자(영문 기준) 이하여야 하고 영숫자 및 밑줄 문자만 사용할 수 있으며 알파벳으로 시작해야 합니다.
  • 항목 매개변수 값을 포함한 매개변수 값은 100자(영문 기준) 이하여야 합니다.
  • 항목 매개변수는 최대 10개의 맞춤 매개변수를 포함할 수 있습니다.
  • POST 본문은 130KB보다 작아야 합니다.