Install the Reddit Pixel

Follow these steps to install the Reddit Pixel on your website, from Google Tag Manager (GTM), or from your Shopify store’s back end.
Apr 24, 2024•Knowledge

Content

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 allow you to track actions that visitors take after seeing or clicking your ad on Reddit.

There are a few ways to install the pixel code:

Manually add the code to your website
Install with Google Tag Manager
Install the Reddit Pixel on Shopify
Use one of our partners for frictionless onboarding

Some options require a little technical skill. If that’s not in your wheelhouse, you might want to ask the right technical support person on your team for assistance.

Tip: For faster implementation, use the setup wizard in Reddit Ads. With step-by-step instructions and dynamic code snippets, it's the easiest way to set up the Reddit Pixel. To use the wizard, Select Events Manager in the menu, and select Set Up Reddit Pixel. If you prefer static instructions, keep reading this article.

Before you start

Before you begin, you should have:

Access to your website’s code editor or Google Tag Manager (GTM)
Access to a Reddit Ads account. If you need one, check out how to create a Reddit Ads account.

You should also consider these:

Don’t modify or change the pixel code, unless you want to replace a macro
Don’t install the same pixel code twice on the same page
Make sure you install the code in the header of the page, not the footer
Verify you’re using the correct pixel ID

1. Get your Reddit Pixel base code

Log in to Reddit Ads
Select Dashboard in the top-left corner
Select Events Manager from the drop-down menu
Select Set Up Reddit Pixel
Choose Install on your website
Select the advanced matching parameters you want to pass, then select Next. Learn more about advanced matching.
You’ll see your account-specific snippet of JavaScript. Select Copy to clipboard, or download the code as a TXT file

2. Add the base code to your website

Go to your ad’s landing page from the back end of your site
Paste the code between the <head></head> tags of that page
Repeat this step for any other pages you want to track conversions on

Example:

<!DOCTYPE html>
<html lang="en">
  <head>
    PLACE PIXEL CODE HERE
  </head>

Important notes:

Installing the pixel on your ad’s landing page is required, even if you decide not to track conversions on that page.
If you want to improve attribution accuracy and capture more conversions, you can do this with advanced matching. We highly recommend passing at least one extra parameter—especially to capture those pesky cross-device or cross-browser conversions (when a user views or clicks your ad on one device/browser, but completes the conversion on another). You’ll need to incorporate these parameters into your pixel base code. Learn more about advanced matching.

3. Install event tracking

By default, the Reddit Pixel base code will register a ‘PageVisit’ event when it is triggered. To track other events/actions that happen on your website, add event tracking on the page between <script></script> tags where specific events occur.

Replace 'EventName' in the code with any event you’d like to track:

<script>
rdt('track', 'EventName');
</script>

Standard conversion events you can track:

Event name	Description	Code
PageVisit	User lands on your landing page (default event)	rdt('track', 'PageVisit');
ViewContent	User lands on a specific webpage, like a product page	rdt('track', 'ViewContent');
Search	User performs a search query	rdt('track', 'Search');
AddToCart	User adds a product to the shopping cart	rdt('track', 'AddToCart');
AddToWishlist	User adds a product to a wishlist	rdt('track', 'AddToWishlist');
Purchase	User completes the purchase	rdt('track', 'Purchase');
Lead	User submits information expressing interest in the advertised product/offer	rdt('track', 'Lead');
SignUp	User completes a registration or sign up form	rdt('track', 'SignUp');
Custom	Additional user actions outside of the predefined standard events	rdt('track', 'Custom', {customEventName:'YOUR CUSTOM EVENT HERE'});

Example for the ‘SignUp’ event:

<script>
rdt('track', 'SignUp');
</script>

Features that will help squeeze the most out of your pixel integration:

Event metadata: Pass more detailed event data to Reddit, to get back a complete picture of your conversion performance and return on ad spend (ROAS).
Custom events: Go beyond the predefined standard events we offer and make your own. Have Reddit track the actions that matter to your business and provide richer insights into the customer journey.

Tracking inline action events
You can also use the pixel to track on-page actions (where the user clicks a button but stays on the same page). Example: a user clicks an Add to Cart button but stays on the same page. The pixel can tell you how many times this happens.

Where you see the ‘Add to Cart’ button in your code, add the following:

<script>
const addToCartButton = document.getElementById('addToCart');
addToCartButton.addEventListener('click', () => rdt('track', 'AddToCart'));
</script>

4. Select the attribution type and attribution window

Your attribution window determines how long after viewing or clicking on your ad you count that user’s actions as a conversion. There are two attribution types—each with their own default window—and there are three options for configuring them: click-through, view-through, or click-through and view-through together (recommended).

If you want, you can edit your attribution window:

Log in to Reddit Ads
Click Dashboard in the top-left corner
Select Events Manager from the drop-down menu
Select Attribution settings
Choose your attribution type and attribution window

5. (Optional) Opt out users

We offer a Limited Data Use (LDU) flag to help you meet your compliance needs, including opting out users if they have not consented to behavioral targeting. You must modify the pixel code to pass the LDU flag as instructed here.

Next steps

Title

Install the Reddit Pixel

URL Name

Install-the-Reddit-Pixel-on-your-website