Set Up the Reddit Pixel with Google Tag Manager

Link your container with the Ads Manager to set up the Reddit Pixel in just a few clicks. Linking automatically sets up your container to use the Pixel, simplifying the setup process while enhancing the reliability and consistency of conversion metrics. We recommend giving your setup a good test run to ensure it's working as best as it can.

If you're unsure during setup, reach out to your developers. 

Potential limitations like browser-based privacy measures or ad-blocking extensions can impact data collection accuracy. Implementing the Conversions API (CAPI) can help mitigate these client-side limitations.

Do you learn better by watching? Watch the next video or check out other tutorials on the Ads Formula.

Before you start

• Set up a GTM account with a published web container. You’ll also need to install it on your site.
• Find your Reddit Pixel ID. Specify which business account should receive your conversions. You can find your Pixel ID in the Events Manager, and it should match the business account's Pixel ID found in Accounts.

1. Connect your account

1. Go to the Events Manager and select Configure Source > Reddit Pixel > Google Tag Manager.
2. Select Next then Sign in with Google.
3. Choose the account to link and Select all to permit Reddit to manage your containers and continue.
4. Choose the web container to link and select Publish. When prompted, select Yes, Publish.
5. (Optional) Enable auto-advanced matching to hash and send emails when provided. We recommend this to match users to conversion activity, boosting your campaign performance.

2. Set up events

You can set up more events at any time.

We recommend setting up events with one of these methods:

Setup method	Description	Use case
Event setup tool (recommended)	A point-and-click tool for quickly setting up events. Events created here won’t appear in GTM.	Using GTM only for Reddit Ads Testing with the Pixel Helper or Event Testing
Google Tag	Send events directly with the Google Tag. Reddit automatically maps these parameters to Reddit’s event metadata and match keys.	Automatic parameter mapping and less required customization
https://business.reddithelp.com	Push event data to the data layer for the Google Tag to read and send to Reddit.	Share custom or complex event data

When ready, select Finish to install the Pixel on your container.

Examples: Google Tag API

Page Visit

<script>
gtag('event', 'page_view', {
  user_data: {
    email_address: 'user@example.com',
    phone_number: '+15551234567'
  }
});
</script>

View Content

<script>
gtag('event', 'view_item', {
  items: [
    {
      item_id: 'sku123',
      item_name: 'Red T-Shirt',
      item_category: 'Apparel'
    }
  ],
  user_data: {
    email_address: 'user@example.com',
    phone_number: '+15551234567'
  }
});
</script>

Search

<script>
gtag('event', 'search', {
  user_data: {
    email_address: 'user@example.com',
    phone_number: '+15551234567'
  }
});
</script>

Add To Cart

<script>
gtag('event', 'add_to_cart', {
  currency: 'USD',
  value: 35.00,
  items: [
    {
      item_id: 'sku123',
      item_name: 'Red T-Shirt',
      item_category: 'Apparel',
      quantity: 1
    }
  ],
  user_data: {
    email_address: 'user@example.com',
    phone_number: '+15551234567'
  }
});
</script>

Add To Wishlist

<script>
gtag('event', 'add_to_wishlist', {
  currency: 'USD',
  value: 35.00,
  items: [
    {
      item_id: 'sku123',
      item_name: 'Red T-Shirt',
      item_category: 'Apparel'
    }
  ],
  user_data: {
    email_address: 'user@example.com',
    phone_number: '+15551234567'
  }
});
</script>

Purchase

<script>
gtag('event', 'purchase', {
  currency: 'USD',
  value: 35.00,
  items: [
    {
      item_id: 'sku123',
      item_name: 'Red T-Shirt',
      item_category: 'Apparel',
      quantity: 1
    }
  ],
  user_data: {
    email_address: 'user@example.com',
    phone_number: '+15551234567'
  }
});
</script>

Lead

<script>
gtag('event', 'generate_lead', {
  currency: 'USD',
  value: 35.00,
  user_data: {
    email_address: 'user@example.com',
    phone_number: '+15551234567'
  }
});
</script>

Sign Up

<script>
gtag('event', 'sign_up', {
  method: 'Email',
  currency: 'USD',
  value: 35.00,
  user_data: {
    email_address: 'user@example.com',
    phone_number: '+15551234567'
  }
});
</script>

Testing and next steps

After linking your container and setting up events, test your integration with the Pixel Helper or Events Manager to ensure data is being passed correctly. If you set up events in GTM, you can also verify your web container to ensure your tags are triggering.

We recommend setting up a server container to increase data collection accuracy.

Things to know

• Events created with the event setup tool won’t be debuggable in the container debugger or visible in GTM. We recommend manually setting up events to make them manageable.
• Conversion coverage may be limited due to signal loss measures that impact browser-based solutions like pixels. Integrate your setup with the Conversions API (CAPI) for remediation.
• Customer match keys, such as email and phone numbers, are automatically normalized and hashed using SHA-256. Learn more about hashing.

Troubleshooting

Error	Resolution
Reauthenticate	Your account was unlinked from the Ads Manager. Reconnect it and try again.
Permission needed	Your account doesn't have permission to manage this container. Contact your GTM account admin for edit permission.
Publish failed	We couldn't add the Pixel to this container at this time. Try again later.
Not found	Your web container couldn't be found. Check that it's published and still exists.
Something went wrong	An unknown error has occurred. Try again later.

If issues persist, contact support for more help.