BloxMetrics SDK

local BM = require(127217366828209)

BM:Init("YOUR_API_KEY")
  :EnablePlayerTracking()    -- sessions, devices, countries (automatic)
  :EnableRevenueTracking()   -- gamepass purchases (automatic)
  :EnableEventTracking()     -- custom events
  :EnableErrorTracking()     -- Lua errors (automatic)

-- ✅ Done! Data will appear in your Dashboard within 60 seconds.

BM:Init("bm_live_abc123", {
    debug = true,  -- prints SDK logs to the Output window
})

-- Set properties on join
Players.PlayerAdded:Connect(function(player)
    BM:SetPlayerProperty(player, "level", 1)
    BM:SetPlayerProperty(player, "clan", "none")
    BM:SetPlayerProperty(player, "vip", false)
end)

-- Increment on events
BM:IncrementPlayerProperty(player, "kills", 1)
BM:IncrementPlayerProperty(player, "coins_earned", 50)

-- Read
local level = BM:GetPlayerProperty(player, "level")

-- Manual tracking (if not using HandleProcessReceipt)
BM:TrackPurchase(player, 12345, "VIP Pass", 499, "gamepass")

-- Or pass a table:
BM:TrackPurchase(player, {
    productId = 12345,
    name = "100 Coins",
    robux = 25,
    type = "devproduct",
})

BM:HandleProcessReceipt({
    -- Product ID → handler
    [111111] = {
        name = "100 Coins",
        handler = function(player)
            -- Your reward logic:
            PlayerData:AddCoins(player, 100)
            BM:TrackSource(player, "Coins", 100, "iap", "100_coins_pack")
            return true  -- must return true to confirm
        end,
    },
    [222222] = {
        name = "VIP Boost",
        handler = function(player)
            PlayerData:ActivateVIP(player)
            return true
        end,
    },
})

BM:EnableEconomyTracking({ "Coins", "Gems", "Tickets" })

-- Sources (player EARNS currency)
BM:TrackSource(player, "Coins", 100, "quest", "daily_quest_1")
BM:TrackSource(player, "Coins", 50,  "combat", "kill_reward")
BM:TrackSource(player, "Gems",  10,  "iap", "starter_pack")

-- Sinks (player SPENDS currency)
BM:TrackSink(player, "Coins", 500, "shop", "speed_potion")
BM:TrackSink(player, "Gems",  25,  "gacha", "legendary_crate")

-- Simple: tutorial
BM:StartProgression(player, "Tutorial")
BM:CompleteProgression(player, "Tutorial")

-- 2-level: world + stage
BM:StartProgression(player, "Enchanted Forest", "Stage 3")
BM:FailProgression(player, "Enchanted Forest", "Stage 3", nil, 2500)

-- 3-level: world + stage + level
BM:StartProgression(player, "World1", "Zone3", "Boss")
BM:CompleteProgression(player, "World1", "Zone3", "Boss", 9800)

-- Simple event
BM:TrackEvent(player, "shop_opened")

-- With metadata
BM:TrackEvent(player, "item_purchased", {
    item = "Golden Sword",
    cost = 500,
    currency = "Coins",
})

BM:TrackEvent(player, "boss_defeated", {
    boss = "Dragon King",
    time = 45.2,
    deaths = 3,
})

-- Onboarding funnel
BM:TrackFunnelStep(player, "onboarding", 1, "game_opened")
BM:TrackFunnelStep(player, "onboarding", 2, "tutorial_started")
BM:TrackFunnelStep(player, "onboarding", 3, "tutorial_completed")
BM:TrackFunnelStep(player, "onboarding", 4, "first_purchase")

-- Shop flow
BM:TrackFunnelStep(player, "shop_flow", 1, "shop_opened")
BM:TrackFunnelStep(player, "shop_flow", 2, "item_viewed")
BM:TrackFunnelStep(player, "shop_flow", 3, "purchased")

-- Weapon usage tracking
BM:TrackDesign(player, "Combat:Kill:Sword", 1)
BM:TrackDesign(player, "Combat:Kill:Bow", 1)

-- Map interaction
BM:TrackDesign(player, "Map:Zone:Entered:Forest", 1)

-- Gacha results
BM:TrackDesign(player, "Gacha:Premium:Legendary", 1)

BM:EnableErrorTracking()  -- auto-captures Lua errors

-- Manual error tracking
local ok, err = pcall(function()
    -- risky DataStore operation
    DataStore:SetAsync(key, data)
end)

if not ok then
    BM:TrackError(player, "critical", "DataStore save failed: " .. tostring(err))
end

-- Warnings
BM:TrackError(player, "warning", "Player inventory near limit: " .. #inventory)

-- Server-wide errors (no player)
BM:TrackError(nil, "error", "Matchmaking service unavailable")

-- Grant on gamepass ownership
if MarketplaceService:UserOwnsGamePassAsync(player.UserId, VIP_PASS_ID) then
    BM:GrantAccess(player, "vip")
end

-- Check
if BM:HasAccess(player, "vip") then
    -- give VIP perks
end

-- Revoke
BM:RevokeAccess(player, "beta_tester")

-- Get all levels
local levels = BM:GetAccessLevels(player)
-- → { "vip", "beta_tester" }

BM:Identify(player, "user_abc123")

-- Toggle debug logs
BM:SetDebug(true)

-- Check status
print(BM:IsInitialized())  -- true/false

local status = BM:GetStatus()
-- → { initialized = true, queueSize = 5, modules = {...} }

-- Force-send queued events (useful before server shutdown)
BM:Flush()

local Players = game:GetService("Players")
local BM = require(127217366828209)

-- ═══ STEP 1: Initialize ═══
BM:Init("YOUR_API_KEY", { debug = true })
  :EnablePlayerTracking()
  :EnableRevenueTracking()
  :EnableEventTracking()
  :EnableEconomyTracking({ "Coins", "Gems" })
  :EnableProgressionTracking()
  :EnableErrorTracking()

-- ═══ STEP 2: Developer Products ═══
BM:HandleProcessReceipt({
    [111111] = {
        name = "100 Coins",
        handler = function(player)
            -- your reward logic
            BM:TrackSource(player, "Coins", 100, "iap", "100_coins_pack")
            return true
        end,
    },
})

-- ═══ STEP 3: Player Setup ═══
Players.PlayerAdded:Connect(function(player)
    BM:SetPlayerProperty(player, "level", 1)
    BM:TrackFunnelStep(player, "onboarding", 1, "game_opened")
end)

-- ═══ GAME LOGIC ═══

-- Level complete
local function onLevelComplete(player, world, stage, score)
    BM:CompleteProgression(player, world, stage, nil, score)
    BM:IncrementPlayerProperty(player, "levels_completed", 1)
    local reward = math.floor(score / 10)
    BM:TrackSource(player, "Coins", reward, "level_reward", stage)
end

-- Shop purchase
local function onShopPurchase(player, item, cost)
    BM:TrackSink(player, "Coins", cost, "shop", item)
    BM:TrackEvent(player, "item_purchased", {
        item = item, cost = cost,
    })
end

-- Safe DataStore save
local function safeSave(player, data)
    local ok, err = pcall(function()
        DataStore:SetAsync(tostring(player.UserId), data)
    end)
    if not ok then
        BM:TrackError(player, "critical", "Save failed: " .. tostring(err))
    end
end

print("[Game] BloxMetrics ready ✅")

local ReplicatedStorage = game:GetService("ReplicatedStorage")
local UserInputService = game:GetService("UserInputService")
local VRService = game:GetService("VRService")

local remotes = ReplicatedStorage:WaitForChild("BloxMetricsRemotes", 10)
if not remotes then return end

local reportDevice = remotes:WaitForChild("ReportDevice", 5)
if not reportDevice then return end

local function getDevice()
    if VRService.VREnabled then return "vr"
    elseif UserInputService.TouchEnabled
        and not UserInputService.KeyboardEnabled then return "mobile"
    elseif UserInputService.GamepadEnabled
        and not UserInputService.KeyboardEnabled then return "console"
    else return "desktop"
    end
end

reportDevice:FireServer(getDevice())