How to set up third-party analytics?

Help and Feedback Platform Usage Support
, ,
#1

Roblox has a guide for adding third-party analytics to your game, but this guide seems to be out of date, using deprecated Google services, and is no longer followable.

I want to add third-party analytics to my game but don’t know how since this guide seems to have fallen apart. Could somebody provide some tips on how to go about this?

That old guide used a ModuleScript from 2014 that used a HttpService postAsync to send data to Google’s servers.

local hs = game:GetService("HttpService")
hs:PostAsync(
	"http://www.google-analytics.com/collect",
	"v=1&t=event&sc=start" ..
	"&tid=" .. id .. 
	"&cid=" .. googleUserTrackingId ..
	"&ec=" .. hs:UrlEncode(category) ..
	"&ea=" .. hs:UrlEncode(action) .. 
	"&el=" .. hs:UrlEncode(label) ..
	"&ev=" .. hs:UrlEncode(value),
	Enum.HttpContentType.ApplicationUrlEncoded
)

Could this be adapted to use Google Analytics 4 instead of Universal Analytics? The GA4 documentation I looked at seemed to insist on inserting JavaScript into a web page.

#2

I’m unsure of the new API as I’ve never used it, but I do know that it should be possible with HttpService.

It likely accepts JSON.

#3

Here’s what I’ve got so far:

local HTTPService = game:GetService("HttpService")

local MeasurementId = "G-XXXXXXXXXX"
local ApiSecret = "xXXxXXXXXXxXXxXXXXXXXx"

local ServerSessionId = game:GetService("HttpService"):GenerateGUID()

local url = string.format("https://www.google-analytics.com/mp/collect?measurement_id=%s&api_secret=%s", MeasurementId, ApiSecret)
local data = HTTPService:JSONEncode({
	client_id = game.JobId;
	events = {
		name = 'UserVisit',
		params = {
			exampleParam = 1234;
		},
	}
})

while wait(5) do
	print("response: ", HTTPService:PostAsync(url, data, Enum.HttpContentType.ApplicationJson))
end

Placing this code in a server script will result in an event being sent every 5 seconds.

I don’t see any change in my analytics dashboard on the main page at first

image
image1920×1080 152 KB

However, if I select “View realtime”, I get this:
image
image1608×1015 216 KB

So my problem now is; how come the data in that itty bitty box in the bottom right of this random page won’t show up anywhere else in the dashboard? As shown above, it still says I have zero users. Their documentation says I can’t use any event names reserved for their web services like “session_start” which makes things hard.

#4

Ok I just made some more progress.

According to this page:

“In order for user activity to display in reports like Realtime, engagement_time_msec and session_id must be supplied as part of the params for an event .”

So I updated my code to the following:

local HTTPService = game:GetService("HttpService")

local MeasurementId = "G-XXXXXXXXXX"
local ApiSecret = "xXXxXXXXXXxXXxXXXXXXXx"

local ServerSessionId = game:GetService("HttpService"):GenerateGUID()

local url = string.format("https://www.google-analytics.com/mp/collect?measurement_id=%s&api_secret=%s", MeasurementId, ApiSecret)
local data = HTTPService:JSONEncode({
	client_id = game.JobId;
	events = {
		name = 'UserVisit',
		params = {
			exampleParam = 1234;
			engagement_time_msec = "100";
			session_id = "123";
		},
	}
})

while wait(5) do
	print("response: ", HTTPService:PostAsync(url, data, Enum.HttpContentType.ApplicationJson))
end

Now I need to figure out what other secret parameters I can use to make the dashboard acknowledge the data I’m sending it.

#5

have you gotten anyfurther in this?