ROLearn/ Documentation / SDK
Get API key →For Developers →

Brand Activation

If you run a brand inside a game, ROLearn measures it. Tag a branded area as a BrandZone and we report how many players entered it and how long they stayed, in the Brand Workspace.

Mark a Brand Zone

A BrandZone is any space in your game you want to measure, for example a sponsored lobby or a billboard area. Marking one takes about ten seconds, no scripting needed.

The fast way: the Studio plugin button

  1. Open your place in Roblox Studio with the ROLearn plugin installed.
  2. Drop a part over the area you want to measure (for example an invisible block over your booth).
  3. Select that part, then click Mark as Brand Zone in the ROLearn plugin toolbar.
  4. Type a zone name when prompted, for example nike_lobby. That name is the zone's zone_id.

That is it. The plugin tags the part with RoLearnBrandZone, saves your name as the zone_id attribute, and the SDK runtime wires the enter and exit events automatically. Mark as many zones as you like; give each a different name.

Prefer to do it by hand? Add the tag RoLearnBrandZone to the part with the Tag Editor and set a zone_id attribute. Same result.

Or fire the events yourself

If you want full control, call the track methods directly instead.

Roblox
local RoLearn = require(game:GetService("ReplicatedStorage"):WaitForChild("RoLearn"))

-- Fire when a player walks into the branded area.
zonePart.Touched:Connect(function(hit)
    local player = game.Players:GetPlayerFromCharacter(hit.Parent)
    if player then
        RoLearn.trackBrandZoneEnter(player, { zone_id = "nike_lobby" })
    end
end)

What a Brand Zone measures

  • Reach: how many players entered the zone.
  • Time in brand zone: how long they stayed, from enter to exit.

Both show up in the Brand Workspace, per country, on each experience's Audience tab. You do not build the charts; marking the zone is all the SDK needs.

The SDK also accepts equip and share events if you send them yourself. ROLearn stores them, but the Brand Workspace does not show them yet, and the runtime does not send them for you.

Brand Lift

Brand Lift, a short survey that compares players who saw your brand with players who did not, is not open yet. Studies cannot be created in the Brand Workspace today, so the runtime shows no survey. This page will explain it when it opens.

BrandZone events use the same ingest path as every other event. See the Events reference for the full field list.