Install the Reddit Pixel Directly

Looking for a different way to track Reddit conversions? Install the Pixel using Google Tag Manager, Shopify, or one of our third-party integrations instead.

The Reddit Pixel is a snippet of JavaScript code, but it's a powerful little thing. Once you've placed it on your website, the Pixel will help you understand what actions redditors take after viewing or clicking your ad on Reddit. It's highly customizable when you add it manually to your site, so you can adjust it to fit your needs.

This integration requires a little technical skill. If that's not in your wheelhouse, you can send the Pixel guide to a developer.

Before you start

Create a Reddit Ads account. Set up your business on Reddit Ads or join your team's account as an administrator. Don't have an account? Here's a great place to start.
Access your website's code editor. This may require admin privileges or help from a developer.

1. Install the Pixel

In the Events Manager, select Configure data source and choose Reddit Pixel > Set up manually. If you haven't set up CAPI or the Pixel yet, select Pixel Only instead.
Select Next and then select Copy to Clipboard to copy your Pixel code.
Update the init call to include match keys. This is highly recommended, especially when using the event setup tool to create conversion events. Learn more about setting up customer match keys.
Example: Init call with match keys
Remember to change the placeholder values.
rdt('init', '<PIXEL-ID>', { email: '<EMAIL-HERE>', phoneNumber: '<PHONE-NUMBER-HERE>', externalId: '<EXTERNAL-ID-HERE>', idfa: '<IDFA-HERE>', aaid: '<AAID-HERE>', });
Open your website's code editor and find the header of your ad's website. If you're using a web platform, find the header template.
Paste the Pixel code inside the <head> tags of every page where you want to track conversion events, including your ad's landing page.
Don't install the Pixel code twice on the same page since it can duplicate tracking and inflate your metrics.
```
<!DOCTYPE html>
<html lang="en">
  <head>
    
  </head>
```
Select Next to continue.

2. (Recommended) Enable auto-advanced matching

This feature is optional and only available for select advertisers.

Auto-advanced matching (AAM) automatically ingests customer-provided information from your web pages to associate a user with their conversion activity. This data is automatically hashed and normalized before being passed to the Ads Manager. We recommend keeping this enabled to improve campaign performance. Sites using sandboxed pixel environments, like Shopify and similar platforms, may experience limited functionality.

By default, this toggle is enabled for all supported parameters. Select Next to save your preference.

AAM automatically collects email addresses displayed on the webpage and those typed, pasted, auto-filled, or otherwise entered by users. If enabled, the Pixel must not be placed on a page where an email address is on screen before the user has given proper consent or been notified. Ensure your usage complies with our services agreement and any applicable laws. We recommend setting up Limited Data Use to help you meet your compliance needs. Learn more about auto-advanced matching.

Enable AAM

3. Set up events

You'll see the reporting success message if your Pixel was correctly set up:

Base Pixel successfully reporting

The Pixel will register PageVisit events by default, but you can share more standard and custom conversion events. We strongly recommend using the event setup tool to streamline the setup process. Select Set Up Events to configure events with this tool.

Set up events

Alternatively, you can manually set up events.

Manual events won't appear on this page or in the event setup tool.

When ready, select Next.

4. Set up deduplication

If you're setting up the Pixel with CAPI, you'll need to set up deduplication to ensure events aren't double-counted. For every event that is shared with CAPI and the pixel, each event shared should have a matching:

Conversion ID: Any string, like a transaction ID or event ID, that identifies a unique event. This must be manually set for Pixel events.
Event name: The event type and customEventName (if applicable) should match. You can verify this using the Events Manager and Pixel Helper.

Example: Deduplicated CAPI and Pixel event

CAPI
Pixel

curl 'https://ads-api.reddit.com/api/v2.0/conversions/events/{{Account ID}}' \
--header 'Authorization: Bearer {{auth_token}}' \
--data-raw '{
  "test_mode": true,
  "events": [
    {
      "event_at": "2024-10-31T19:37:45.380828",
      "event_type": {
        "tracking_type": "Custom",
        "custom_event_name": "Promotion"
      },
      "event_metadata": {
        "conversion_id": "MySharedConversionID1"
      }
    }
  ]
}'

rdt('track', 'Custom', {
  customEventName: 'Promotion',
  conversionId: 'MySharedConversionID1'
});

Send instructions to a developer

Need help with installation? We recommend sharing the Pixel guide with one of your developers to help with setup.

In the Events Manager, go to the Pixel onboarding guide.
Select Send to Developer.
Provide your developer's email address.
(Optional) Choose the conversion events, attribution matching, and metadata to set up.
Review the preview and check that all your requested configurations have been selected.
Select Send to notify your developer.

Before you start​

1. Install the Pixel​

2. (Recommended) Enable auto-advanced matching​

3. Set up events​

4. Set up deduplication​

Send instructions to a developer​

We're here to help