Help Centre

Step-by-step guides for setting up and using Tragly. Need more help? Contact support.

1. Create a Client

A client represents one website or brand you are tracking. Each client gets a unique Tracking ID (TRG-XXXX).

  1. Log in at tragly.com/dashboard/login.html
  2. Open the Agency or Admin panel
  3. Click Add Client and fill in the website name and domain
  4. Your new Tracking ID appears immediately (e.g. TRG-0042)

2. Install the Tracking Pixel

Add the Tragly pixel to your client's website. The pixel sends a first-party event to Tragly's server — no ad blockers can stop it.

Option A — First-party install (recommended, this is the default)

Serve the pixel from your own domain. In the dashboard, open the Launch wizard and copy the ready reverse-proxy config for your web server — nginx, Apache, Caddy or a Cloudflare Worker. Two lines of config, and the pixel and its events travel over your domain from then on.

<script async src="https://yourdomain.com/t.js"
  data-tragly-id="TRG-XXXX"></script>

Why this is the default: a script and a request on your own domain is a first-party call — that is what stays measurable when third-party requests are blocked.

Option B — Direct script tag (quick trial)

Add to the <head> of every page:

<script async src="https://tragly.com/t.js"
  data-tragly-id="TRG-XXXX"></script>

This loads from tragly.com, so on your site it is a third-party request — good for getting a first event in minutes, but for live measurement switch to Option A.

Option C — Google Tag Manager (GTM) custom HTML tag

  1. In GTM, create a new tag → type: Custom HTML
  2. Paste the script above
  3. Set trigger: All Pages
  4. Publish the GTM container

3. Find Your Tracking ID

Your Tracking ID is shown in the Agency dashboard under each client card. Format: TRG-XXXX. It is also in the Admin panel under Client Details → Tracking ID.

4. Test Your First Event

  1. Install the pixel and open your client's website
  2. In Tragly, open the Realtime dashboard
  3. Select your client from the picker
  4. Reload the tracked page — within seconds a page_view event should appear in the live feed

5. Connect Google Analytics 4 (GA4)

You need a GA4 Measurement ID (G-XXXXXXXXXX). There are two ways to get one — take whichever describes you:

  • You already have GA4. Copy the ID by hand from GA4 → Admin → Data streams → your web stream, and paste it into Tragly. Nothing else to do — Tragly does not touch your existing property.
  • You have no GA4 property yet. Tragly can create one for you: in the Launch wizard, step 1, use the Create it for me button next to the Measurement ID field. Tragly creates the GA4 property and the web data stream for your domain, then fills the G- ID in for you. Running it again on the same domain returns the property you already have — it never creates a second one. For a whole list of domains at once: Clients & domains → GA4 bulk provisioning.

The button only shows up when the provisioning module is available on your instance; if it is missing, paste the ID by hand — everything below works the same either way.

  1. In the Admin panel, open Client Details → Forwarders
  2. Enable GA4 forwarder
  3. Enter the Measurement ID from above, plus an API Secret from GA4 Admin → Data Streams → Measurement Protocol API secrets. The API secret is always yours to create — Google ties it to a data-collection acknowledgement, so Tragly never generates it for you.
  4. Click Save — events are forwarded immediately after the next pixel hit

6. Connect Meta Conversions API (CAPI)

  1. In Meta Business Suite → Events Manager, create a server-side event source → get your Pixel ID and Access Token
  2. In Tragly Admin, enable Meta CAPI forwarder and enter the Pixel ID and Access Token
  3. Save — Tragly will begin forwarding events server-to-server within minutes

7. Connect TikTok Events API

  1. In TikTok Ads Manager → Assets → Events → Web Events → Set Up Web Events → Manually → API → get your Pixel Code and Access Token
  2. In Tragly Admin, enable TikTok forwarder and enter the credentials

8. Use Webhooks

Tragly can forward any event to a custom HTTPS endpoint of your choice — CRM, data warehouse, or custom backend.

  1. Enable Webhook forwarder in Admin → Forwarders
  2. Enter your webhook URL (must be HTTPS)
  3. Optionally add an Authorization header value for security
  4. Tragly sends a JSON POST to your endpoint for every event, with automatic retry on failure

Still need help?

Submit a support ticket and we'll respond within 1 business day.

Submit a support ticket →