This guide explains how you can send Google Analytics Measurement Protocol web and app stream events to a Google Analytics server, so that you can view Measurement Protocol events in your Google Analytics reports .
Choose the platform you want to see in this guide:
Format the request
The Google Analytics Measurement Protocol only supports HTTP POST
requests.
To send an event, use the following format:
POST /mp/collect HTTP/1.1
HOST: www.google-analytics.com
Content-Type: application/json PAYLOAD_DATA
You must provide the following in the request URL:
-
api_secret: The API SECRETgenerated in the Google Analytics UI.To create a new secret, navigate to Admin> Data collection and modification> Data streams> choose your stream> Measurement Protocol API secrets> Create.
-
measurement_id: The measurement ID associated with a stream, found in the Google Analytics UI under Admin> Data Streams> choose your stream> Measurement ID.The
measurement_idisn't your Stream ID.
You must provide a request body in the JSON POST body format for the Measurement Protocol. Here's an example:
{
"client_id"
:
" CLIENT_ID
"
,
"events"
:
[
{
"name"
:
"login"
,
"params"
:
{
"method"
:
"Google"
,
"session_id"
:
" SESSION_ID
"
,
"engagement_time_msec"
:
100
}
}
]
}
While session_start
is a reserved event
name
,
creating a new session_id
creates a new session without the need to send session_start
. Understand how sessions are
counted
.
Try it
Here's an example you can use to send multiple events at once. This example
sends a tutorial_begin
event and a join_group
event to your Google Analytics server, includes geographic
information
using the user_location
field, and includes device information
using the device
field.
const
measurementId
=
" MEASUREMENT_ID
"
;
const
apiSecret
=
" API_SECRET
"
;
fetch
(
`https://www.google-analytics.com/mp/collect?measurement_id=
${
measurementId
}
& api_secret=
${
apiSecret
}
`
,
{
method
:
"POST"
,
body
:
JSON
.
stringify
({
client_id
:
" CLIENT_ID
"
,
events
:
[
{
name
:
"tutorial_begin"
,
params
:
{
"session_id"
:
" SESSION_ID
"
,
"engagement_time_msec"
:
100
}
},
{
name
:
"join_group"
,
params
:
{
"group_id"
:
"G_12345"
,
"session_id"
:
" SESSION_ID
"
,
"engagement_time_msec"
:
150
}
}
],
user_location
:
{
city
:
"Mountain View"
,
region_id
:
"US-CA"
,
country_id
:
"US"
,
subcontinent_id
:
"021"
,
continent_id
:
"019"
},
device
:
{
category
:
"mobile"
,
language
:
"en"
,
screen_resolution
:
"1280x2856"
,
operating_system
:
"Android"
,
operating_system_version
:
"14"
,
model
:
"Pixel 9 Pro"
,
brand
:
"Google"
,
browser
:
"Chrome"
,
browser_version
:
"136.0.7103.60"
}
})
});
Override timestamp
The Measurement Protocol uses the first timestamp it finds in the following list for each event in the request:
- The
timestamp_microsof the event. - The
timestamp_microsof the request. - The time that the Measurement Protocol receives the request.
The following example sends a request-level timestamp that applies to all of the
events in the request. As a result, the Measurement Protocol assigns both the tutorial_begin
and join_group
events a timestamp of requestUnixEpochTimeInMicros
.
{
"timestamp_micros"
:
requestUnixEpochTimeInMicros
,
"events"
:
[
{
"name"
:
"tutorial_begin"
},
{
"name"
:
"join_group"
,
"params"
:
{
"group_id"
:
"G_12345"
,
}
}
]
}
The following example sends both a request-level timestamp and an event-level
timestamp. As a result, the Measurement Protocol assigns the tutorial_begin
event a timestamp of tutorialBeginUnixEpochTimeInMicros
, and the join_group
event a timestamp of requestUnixEpochTimeInMicros
.
{
"timestamp_micros"
:
requestUnixEpochTimeInMicros
,
"events"
:
[
{
"name"
:
"tutorial_begin"
,
"timestamp_micros"
:
tutorialBeginUnixEpochTimeInMicros
},
{
"name"
:
"join_group"
,
"params"
:
{
"group_id"
:
"G_12345"
,
}
}
]
}
Limitations
The following limitations apply to sending Measurement Protocol events to Google Analytics:
- Requests can have a maximum of 25 events.
- Events can have a maximum of 25 parameters.
- Events can have a maximum of 25 user properties.
- User property names must be 24 characters or fewer.
- User property values must be 36 characters or fewer.
- Event names must be 40 characters or fewer, can only contain alphanumeric characters and underscores, and must start with an alphabetic character.
- Parameter names including item parameters must be 40 characters or fewer, can only contain alphanumeric characters and underscores, and must start with an alphabetic character.
- Parameter values including item parameter values must be 100 characters or fewer for a standard Google Analytics property, and 500 characters or fewer for a Google Analytics 360 property.
- Item parameters can have a maximum of 10 custom parameters.
- The post body must be smaller than 130kB.
- App Measurement Protocol events sent to Google Analytics don't populate Search audiences in Google Ads for app users.
For additional requirements of each use case, see common use cases .
