Reddit Pixel Event Tracking and Conversion API


Installation instructions, documentation and FAQs for the Shopware plugin

Installation instructions

Install the extension via the extension area.

Reddit setup

  1. Create a Reddit account on the business.reddit.com Page.
  2. Go to Reddit's Events Manager from your Reddit account page from.
  3. The Pixel ID is located directly below the event overview.
  4. The conversion ID can be created via the „Conversion API“ option in the Events Manager. Save the ID after creation, as the token cannot be retrieved again.
Pixel ID in Events Manager
Creating a conversion ID

Setting up the extension in Shopware

Reddit Pixel ID configuration

  • Reddit Pixel ID (Account ID): Enter the ID found in Event Manager here.
  • Reddit Conversions API Access Token: Enter the conversion token you created here.
  • Disable Reddit Conversions API: disables the Conversion API.
  • Disable sending user data to Reddit Conversions API.
  • Enable asynchronous conversion API calls (message queue).
  • Enable Reddit Conversions API logging: Enable the option for troubleshooting or auditing.

customer management

  • Disable Reddit pixel tracking for specific customer groups: Disable tracking for specific customer groups.

consent management

  • Select Cookie Consent Manager: Select one of the following Cookie Consent Managers:
    • Shopware Cookie Consent Manager
    • CookieBot
    • CookieFirst
    • UserCentrics
    • CCM19
    • CMP
  • Custom data attribute for Consent Manager (expert mode): For custom Consent Manager, the data attributes to be used can be specified here.
  • Cookie category for Shopware Cookie Consent Manager: Specify the category in which the Reddit pixel should be displayed; only works for the Shopware Cookie Consent Manager.

behavioural settings

  • Do not trigger ViewContent event on home category: Enable to prevent tracking of the ViewContent event when the home/root category is loaded.

FAQs

Yes, the Reddit Conversions API is fully integrated into the extension. It enables server-side tracking and is particularly important for:

  • Bypassing ad blockers and browser tracking restrictions
  • Improved data quality and match rates
  • Compliance with data protection regulations
  • Reliable tracking even without cookies.

The Conversion API works in parallel with the browser pixel and ensures maximum tracking accuracy.

The extension automatically tracks the following standard events:

  • PageVisit: Triggered each time a page is viewed
  • ViewContent: Product detail pages and categories
  • AddToCart: Product is added to the shopping basket
  • SignUp: Registration page (checkout)
  • Lead: Confirmation page before completing the purchase
  • Purchase: Successful purchase completion with order details

All events are sent via both the browser pixel and the Conversion API (if configured).

Reddit does not process conversion data in real time. There is a normal delay of:

  • Pixel events: 15–30 minutes
  • Conversion API events: up to 48 hours

This is a normal process for Reddit Ads. The data is collected, deduplicated, and processed before it appears in the dashboard.

Debug tip: Use the browser console to check whether the pixel is loading correctly. If the pixel ID is missing, an error message will appear in the console.

For optimal shop performance, you should use the message queue for conversion API calls:

Step 1: Enable „Asynchronous Conversions API Calls“ in the plugin settings
Step 2: Ensure that your message queue is running (e.g. via cron job or supervisor).

This ensures that API calls are processed in the background and do not affect your shop's performance.

Yes, the extension is fully GDPR-compliant:

  • Compatible with all common cookie consent managers
  • Built-in opt-out function for users
  • No data transfer without consent (when Consent Manager is activated)
  • Encrypted transmission of user data (SHA-256 hashing)
  • Option to disable user data transfer

Important: Ensure that you mention Reddit Pixel in your privacy policy and that you have configured your cookie consent manager correctly.

Yes, in the extension settings, under „Customer Management,“ you can select any customer groups that you want to exclude from tracking. This is particularly useful for:

  • Internal staff and test purchases
  • B2B customers with special conditions
  • Resellers and partners

Neither the pixel nor the Conversion API is loaded for excluded customer groups.