Tokei LogoTokei

Pixel Tracking

Attach your own advertising pixels to every promotion page you publish. Tokei supports the Meta (Facebook) Pixel and the Reddit Pixel — enter an ID in Dashboard Settings and the script is injected automatically, with no code to add to your page.

Overview

Where Tracking Works

Your pixels load on all four public promotion routes:

  • /contest/... - Competition pages
  • /levelup/... - Gamification pages
  • /discover/... - Landing pages
  • /promote/... - Live Promotion pages

See Page Types for which route each kind of promotion is published on.

Availability

Who Can Use This

This is a paid feature. Trial users will see the Analytics Integration section in Settings but won't be able to save tracking IDs until they upgrade. Once your subscription ends, tracking scripts are automatically disabled on your promotion pages.

Meta (Facebook) Pixel

Track visitor activity and conversions on your promotion pages with your own Facebook/Meta Pixel. Use the events it reports to build custom audiences and optimise your Facebook ad campaigns.

Events

Events Tracked

EventWhen It Fires
PageViewEvery time a visitor loads any of your promotion pages
LeadWhen a visitor successfully signs up or logs in

The PageView event helps you understand traffic patterns, while the Lead event tracks actual conversions (email signups and social logins).

Step 1

Find Your Pixel ID

  1. Go to Meta Events Manager
  2. Click Data Sources
  3. Select your Pixel
  4. Copy the Pixel ID (a 15-16 digit number)

Step 2

Add Your ID in Dashboard

  1. Go to Dashboard → Settings → Profile
  2. Scroll to the "Analytics Integration" section
  3. Enter your Facebook Pixel ID
  4. Click Save Changes

Step 3

Verify It's Working

  1. Install the Meta Pixel Helper browser extension
  2. Visit your promotion page
  3. Click the extension icon - it should show a green checkmark
  4. After signing up, check that a Lead event was also recorded

Validation

Format Requirements

The system validates your Pixel ID before saving:

FieldValid FormatExample
Facebook Pixel ID10-20 digit number123456789012345

If you enter an invalid format, you'll see an error message and won't be able to save.

Troubleshooting

Common Meta Pixel Issues

Scripts not appearing in page source?

This is expected. The tracking scripts load after the initial HTML is rendered. Use the Meta Pixel Helper extension to verify they're loading correctly.

PageView not showing in Events Manager?

  • Double-check that your Pixel ID is entered correctly
  • Make sure you have an active paid subscription
  • Try viewing your promotion page in an incognito window (ad blockers may interfere)

Lead event not firing?

  • The Lead event only fires on successful signup/login
  • Make sure you're testing on an actual promotion page, not the dashboard preview
  • Check the browser console for any JavaScript errors

Pixel still working after subscription ended?

If you see tracking still active after your subscription ends, it may be cached. Wait a few minutes and try a hard refresh (Ctrl+Shift+R).

Reddit Pixel

Track visitors from Reddit Ads on your promotion pages. The pixel reports page visits back to your Reddit Ads account so you can measure traffic, build retargeting audiences, and optimise ad delivery.

Events

Events Tracked

EventWhen It Fires
PageVisitEvery time a visitor loads any of your promotion pages

Unlike the Meta Pixel, the Reddit Pixel reports page visits only — there is no signup/conversion event on the client-side integration.

Prerequisites

Before You Start

RequirementDetails
Active paid planAnalytics integration is locked during the trial period. Upgrade from Settings → Billing first.
Reddit Ads accountSign up at ads.reddit.com if you don't have one.
Reddit Pixel createdYou must create a pixel inside Reddit Ads Manager before you can get a Pixel ID.

Step 1

Find Your Reddit Pixel ID

  1. Log in to Reddit Ads Manager
  2. Click Events Manager in the left sidebar
  3. If no pixel exists yet, click New Data Source → Reddit Pixel
  4. Your Pixel ID is displayed at the top of the pixel detail page (format: a2_xxxxxxxxxx or t2_xxxxxxxxxx)
  5. Copy the Pixel ID

Step 2

Add Your ID in Dashboard

  1. Go to Dashboard → Settings → Profile
  2. Scroll to the "Analytics Integration" section
  3. Paste your Reddit Pixel ID into the Reddit Pixel ID field
  4. Click Save Changes
Reddit Pixel ID field in Dashboard Settings

Step 3

Verify It's Working

  1. Open your promotion page in a browser
  2. In Reddit Ads Manager, go to Events Manager → Test Events
  3. Within a few minutes, you should see PageVisit events appearing

Browser verification (alternative):

  1. Open DevTools → Network tab, filter by redditstatic
  2. You should see a request to https://www.redditstatic.com/ads/pixel.js
  3. In the Console, type window.rdt — it should return a function, not undefined

Validation

Format Requirements

The system validates your ID before saving:

FieldValid FormatExample
Reddit Pixel IDStarts with a2_ or t2_ followed by 6-20 alphanumeric charactersa2_abc123def

If you enter an invalid format, you'll see an error message and won't be able to save.

Troubleshooting

Common Reddit Pixel Issues

No events in Reddit Events Manager?

Wait up to 30 minutes. Events can take time to appear in the Reddit Ads dashboard.

Pixel not loading on page?

  • Confirm your plan is active (not trial). Trial users don't get tracking pixels.
  • Check that your Pixel ID is entered correctly in Settings.

Validation error when saving?

Pixel ID must match the format a2_xxxxxx or t2_xxxxxx (6-20 alphanumeric characters after the prefix).

Events fire on production but not localhost?

This is expected. The pixel is intentionally skipped on localhost to avoid noisy test data in your Reddit Ads account.

Advanced

Reddit Conversions API

Reddit also offers a server-side Conversions API for tracking events like purchases and signups without relying on browser JavaScript. This is a separate, more advanced integration that requires OAuth2 credentials and server-side implementation. The client-side pixel covered here handles page visit tracking. For server-side conversion tracking, refer to Reddit's Conversions API documentation.

FAQ

Frequently Asked Questions

Can I use all three tracking pixels at once?

Yes. Google Analytics 4, Meta Pixel, and Reddit Pixel all work independently. They fire in parallel on your promotion pages. See Add Google Analytics for the GA4 setup.

Does this affect page speed?

No. All tracking scripts are deferred until after the page's initial paint (LCP/FCP) using a three-tier loading strategy: user interaction, idle callback, or a 4-second fallback timer.

Do I need to add code to my promotion page?

No. Enter your Pixel ID in Dashboard Settings and the system handles script injection automatically.

Do pixels fire inside the embeddable widget?

No. Pixels are injected by the hosted promotion pages only. A widget embedded on your own site should use your site's existing pixel installation.

Privacy

Privacy Considerations

  • You are responsible for complying with privacy regulations (GDPR, CCPA, etc.)
  • Consider adding a cookie consent banner if required in your jurisdiction
  • Meta provides its own privacy controls and documentation
  • Reddit provides its own privacy controls via its Privacy Policy
  • See Data & Privacy for how Tokei handles entrant data

Analytics Integration Section

Analytics Integration section in Dashboard Settings showing Google Analytics, Meta Pixel, and Reddit Pixel fields

The Analytics Integration section in Dashboard → Settings → Profile with all three tracking pixel fields.

Need help with your analytics setup? Contact support@tokei.io.

Analytics

Track performance with the built-in Analytics dashboard.

Next

Full documentation index: tokei.io/llms.txt