Analyse
Getting startedConnect your store

Getting started

Connect your store

Link your Tebex store so every purchase is attributed to the player, campaign, and creator that drove it.

Connecting your store is what turns Analyse from "nice player stats" into "real ROI numbers". Once it's hooked up, every Tebex purchase gets linked back to the player that made it, and to the Campaign that brought that player to your server in the first place.

If you sell anything, do this step. It takes a couple of minutes.

What you'll get

Once the store is connected, Analyse can answer questions like:

  • How much revenue did the TikTok creator I sponsored last month actually drive?
  • Which Campaign has the highest average spend per player?
  • What's the average lifetime value of a player from Discord vs YouTube?
  • Which store package is my best seller, and which ones never convert?

What you need

  • A Tebex store (any plan, including free)
  • Access to your Tebex control panel
  • About 2 minutes

Don't use Tebex

You have three other options:

  • CraftingStore — first-class webhook integration, same flow as Tebex.
  • Custom webhook — any store platform that can POST JSON. See Settings → Integrations → Custom Webhook for the URL, secret and payload shape.
  • Fallback command — if your store lets you run a console command after a purchase, use /analyse purchase <player_uuid> <value> <product_name> and Analyse will record it. Works with any store.

Still not sure? Hop into our Discord.

Step 1: Open the Tebex setup in Analyse

  1. 1

    Open your Server in Analyse

    Go to the Server you want to connect the store to.

  2. 2

    Open Settings then Integrations

    Store providers live in the Integrations tab, separate from API keys.

  3. 3

    Click "Connect" on the Tebex card

    A panel opens with a unique webhook URL. You'll need it in a second.

  4. 4

    Copy the webhook URL

    Keep the Analyse tab open, you're about to paste this over in Tebex.

Step 2: Create the webhook in Tebex

This is the one part that happens inside Tebex, not Analyse.

  1. 1

    Open the Tebex control panel

    Go to creator.tebex.io and open your store.

  2. 2

    Go to Integrations then Webhooks

    On Tebex this lives under the "Integrations" section of the left sidebar.

  3. 3

    Create a new webhook endpoint

    Paste the URL Analyse gave you into the URL field.

  4. 4

    Enable the four payment events

    In Tebex’s Webhook types list, tick these (the labels are exactly as shown in the dashboard):

    • Payment Completed
    • Payment Declined
    • Payment Refunded
    • Payment Chargeback
      Those are the only ones Analyse uses for revenue. You don’t need to enable every checkbox Tebex offers.
  5. 5

    Save the endpoint

    Tebex will generate a webhook secret and show it to you. Copy that secret now, Tebex may not show it again.

Tebex also lists other webhook types (for example Payment Dispute Opened, Payment Dispute Won, Payment Dispute Lost, Payment Dispute Closed, Recurring Payment Started, Recurring Payment Renewed, Recurring Payment Cancellation Requested, Recurring Payment Cancellation Aborted, Recurring Payment Ended, Recurring Payment Status Changed, and Basket Abandoned). You can leave those off for Analyse—today we only process the four payment events above plus the validation ping during setup.

Step 3: Paste the Tebex secret back into Analyse

  1. 1

    Back in the Analyse "Connect Tebex" panel

    The secret field is labeled "Webhook Secret".

  2. 2

    Paste the secret you copied from Tebex

    This is how Analyse confirms that incoming webhooks really came from your store.

  3. 3

    Click "Save and verify"

    Analyse saves the secret and waits for a real Tebex webhook. Once Tebex sends a test event (or a real payment event), you'll see a green "Connected" badge.

The secret comes from Tebex, not Analyse

This trips people up. Analyse gives you the URL. Tebex gives you the secret. You paste the Tebex secret into Analyse.

Step 4 (optional but recommended): Filter which packages to track

By default Analyse tracks every Tebex purchase. If you'd rather only attribute specific packages (e.g. only real-money ranks, not internal admin adjustments), you can narrow it down with your Tebex Public Token.

  1. 1

    In Tebex, go to Integrations then API Keys

    Copy your "Public Token" (it starts with something like woo7-).

  2. 2

    Back in Analyse, paste it into the "Public Token" field

    Analyse uses it to pull your package list from Tebex.

  3. 3

    Tick the packages you want to track

    Anything unticked is ignored on the webhook.

  4. 4

    Save

    You can come back and change this any time.

Confirming it worked

Analyse marks the integration as connected once a Tebex webhook is received successfully. If purchases still aren't showing up after a real sale:

  • Make sure the webhook endpoint in Tebex is enabled, not paused
  • Check the Tebex webhook log for 4xx or 5xx responses (a 401 means the secret doesn't match)
  • Confirm the event types are actually checked in Tebex

Historical purchases

The webhook only catches purchases from now on. If you want your older data too, ping us on Discord and we can backfill it for you.

How purchases get linked to players

When a payment event comes in, Analyse looks up the player by their Minecraft username (case-insensitive) on the purchase. If that username has ever joined your Server, the purchase is attached to that player and inherits the Campaign they originally joined through. If no match is found, the purchase is still recorded on the Server but marked as unattributed.

Next up: Verify your domain so you can start creating tracking links.