Reddit Pixel

Reddit Pixel is Reddit's conversion tracking tool for ads and remarketing. It seeds the standard rdt queue before the vendor bundle loads, initializes your pixel, and by default records a PageVisit event once consent for marketing is available.

Integrate with c15t

import { type ReactNode } from 'react';
import { ConsentManagerProvider } from '@c15t/react';
import { redditPixel } from '@c15t/scripts/reddit-pixel';

const scripts = [redditPixel({ pixelId: 't2_abcdef' })];

export function ConsentProvider({ children }: { children: ReactNode }) {
  return (
    <ConsentManagerProvider
      options={{
        mode: 'hosted',
        backendURL: 'https://your-instance.c15t.dev',
        scripts,
      }}
    >
      {children}
    </ConsentManagerProvider>
  );
}

How c15t loads it

• Category: marketing (Ads & Pixels)
• Loads when: marketing consent is granted
• On revocation: retained in the DOM so c15t can call Reddit's first-party-cookie controls. c15t calls rdt('disableFirstPartyCookies') when marketing consent is denied and rdt('enableFirstPartyCookies') when it is granted again.

If you prefer to control page-view tracking yourself, disable the default PageVisit call:

redditPixel({
  pixelId: 't2_abcdef',
  trackPageVisit: false,
});

Tracking events in your app

c15t gates the Reddit Pixel script from loading until marketing consent is granted. Your application code that calls Reddit's runtime API (window.rdt(...)) is not automatically gated - window.rdt does not exist until the script is loaded, so unguarded calls before consent throw.

Guard event calls by checking consent state. From React:

import { useCallback } from 'react';
import { useConsentManager } from '@c15t/react';
import { redditPixelEvent } from '@c15t/scripts/reddit-pixel';

function CheckoutExample() {
  const { has } = useConsentManager();

  const trackPurchase = useCallback(() => {
    if (has('marketing')) {
      redditPixelEvent('Purchase', {
        currency: 'USD',
        value: 99,
        conversionId: 'order-123',
      });
    }
  }, [has]);

  // Call trackPurchase() from your conversion success path.
}

From plain JavaScript:

import { getOrCreateConsentRuntime } from 'c15t';

const { consentStore } = getOrCreateConsentRuntime();

if (consentStore.getState().has('marketing')) {
  window.rdt?.('track', 'Purchase', {
    currency: 'USD',
    value: 99,
    conversionId: 'order-123',
  });
}

When you use Reddit Pixel and Conversions API together, send the same conversionId in the browser event and the server event so Reddit can deduplicate them.

Consent and privacy

c15t keeps Reddit Pixel behind marketing consent. Before marketing consent, the Reddit script is not loaded. After marketing consent is granted, c15t loads the script and queues the Reddit init call.

For stricter first-party-cookie behavior, disable Reddit first-party cookies during initialization:

redditPixel({
  pixelId: 't2_abcdef',
  disableFirstPartyCookies: true,
});

You can also pass Reddit's initialization options directly:

redditPixel({
  pixelId: 't2_abcdef',
  initOptions: {
    optOut: true,
    disableFirstPartyCookies: true,
  },
});

Reddit supports a Limited Data Use flag through data processing fields. Use the values required by your policy and jurisdiction:

redditPixel({
  pixelId: 't2_abcdef',
  initOptions: {
    dpm: ['LDU'],
    dpcc: 'US',
    dprc: 'CA',
  },
});

Reddit can also receive attribution matching signals such as email, phoneNumber, externalId, aaid, and idfa. Only pass those fields after you have the right consent or legal basis for your use case:

redditPixel({
  pixelId: 't2_abcdef',
  initOptions: {
    email: 'person@example.com',
    externalId: 'customer-123',
    aam: {
      email: false,
      phone_number: false,
    },
  },
});

See Reddit's docs for Limited Data Use, event metadata, and event deduplication.

Types

RedditPixelOptions

RedditPixelInitOptions

RedditPixelEventMetadata

Script