weltpixel

Reddit Pixel Conversions API Addon for Google Analytics 4 PRO

Requires the Google Analytics 4 PRO extension.

Redefining Advertising: Reddit Pixel Conversions API.

What is Reddit's Conversions API?

Reddit's Conversions API (CAPI) acts as a method of securely sharing marketing data with Reddit via a server-to-server implementation, with the added benefit of not requiring website code.

With Conversions API (CAPI), advertisers can strengthen campaign performance by improving measurement accuracy, audience targeting and, subsequently, ad optimization. This is all done through a secure and sustainable server-side connection, resilient to signal loss and other obstacles that traditional, client-side implementations face.

What are the advantages of using Reddit's Conversions API?

  • Stronger campaign performance.
  • Improved measurement.
  • Better user targeting.
  • Increased accuracy for better ad optimization.

How does it work?

Here's a handy diagram to show you how the Reddit Pixel and Reddit Pixel Conversions API work:

weltpixel

Features of the Reddit Pixel Conversions API Addon.

  • Server-side Purchase Event Tracking.
  • Server-side Add to Cart Event Tracking.
  • Server-side Add to Wishlist Event Tracking.
  • Server-side View Content Event Tracking.
  • Server-side Search Event Tracking.
  • Server-side Sign Up Tracking.
  • Reddit Pixel Conversions API Test Mode integration.
  • Ability to track selected events in conjunction with the frontend Reddit Pixel.
  • Directly and fully integrated into the Google Analytics 4 PRO extension.
  • Log functionality for in-depth debugging of events sent to the Reddit API.
  • Easy setup, all that's required is the Reddit Pixel ID and the Reddit Pixel Conversions API Key.
  • Option to track only specific customer groups
  • Ability to send data to multiple Reddit Pixel endpoints

Requirements for using the Reddit Pixel Conversions API Addon.

To use the Reddit Pixel Conversions API Addon, you'll need the following:

  • A Reddit Pixel client-side integration, in order to gain access to your Reddit Pixel Tracking Base Code. Our Google Analytics 4 PRO extension comes with the possibility of setting up the client-side Reddit Pixel out of the box, which can be done within minutes.
  • The Google Analytics 4 PRO extension enabled and configured.

How to Install the Reddit Pixel Conversions API Addon via SSH.

  • Step 1.

    Before starting the installation:

    • Ensure your Magento version is compatible - This extension is currently compatible with the following Magento versions: 2.3.0. - 2.4.8 (and all Security Patches).
    • Install the extension on a testing/development/staging environment first, then, after thoroughly testing it out, install it on a production (live) environment.
    • Make sure the Magento instance is in developer mode. You can use the php bin/magento deploy:mode:set developer command to change the mode to developer and then check to make sure the generated folder in the root of the Magento project is empty.
    • Make sure the Google Analytics 4 PRO extension is already installed and configured on your Magento 2 instance. You can find the steps for doing so in the Google Analytics 4 PRO User Guide.

  • Step 2.
    Copy the extension files to below paths of your Magento 2 instance. If the 'app/code/WeltPixel' folder is missing, please create it manually:
    app/code/WeltPixel/GA4RedditSS

  • Step 3.
    Access the root of your Magento 2 project from the command line and run the following commands:
    php bin/magento module:enable WeltPixel_GA4RedditSS --clear-static-content
    php bin/magento setup:upgrade
    php bin/magento setup:di:compile
    php bin/magento setup:static-content:deploy -f
  • Step 4.
    Flush any caches that you might still have enabled on your server or in Magento.
  • Step 5:
    If your store was in production mode before starting the installation, make sure to switch it back to production mode by running the following command in the root of your Magento installation: php bin/magento deploy:mode:set production.
  • Step 6:
    Awesome! The extension is now installed on your Magento store! Congrats!

How to Upgrade the extension.

  • Step 1.
    Remove the extension code under app/code/WeltPixel/GA4RedditSS before adding the new extension files. The extension may be refactored and old unused files may cause random issues, so it's best to only keep the latest version of the files.
  • Step 2.
    Follow the normal installation instructions above.

How to configure the Reddit Pixel Conversions API Addon.

  • Enable Reddit Pixel Server Side Tracking - When enabled, the server side Reddit Pixel functionality will use the Reddit Pixel Javascript Tracking code you configured in the client-side Reddit Pixel configuration section.
  • Reddit Pixel ID - This ID can be found in your Reddit Ads Manager account under Events Manager → Pixel ID. You can also find it in your Reddit Pixel Javascript Tracking code in the section above, within the rdt() initialization function.
  • Reddit Conversions API Access Token - The Conversions API Access Key (token) can be generated in the Reddit Pixel settings. You can follow Reddit's documentation for instructions on how to manually generate a token.
  • Track Events - Select the events you wish to send to Reddit via the Events API: Purchase / Add to Cart / Add to Wishlist / View Content / Search / Sign Up
weltpixel
weltpixel
  • Send enabled events via the frontend Reddit Pixel as well - Set this option to Yes if you want to send events via the frontend Reddit Pixel as well. Reddit Ads Manager should have built-in functionality to avoid data duplication, and this may (in some cases) enrich your data.
  • Enable Test Mode - This functionality can be used to send test events to the Reddit Pixel.
  • Enable File Log - Enable the creation of a log file that shows the pushed event data. The reddit-api.log file can be found in the var/log directory of Magento 2 root.
  • Track Only Specific Customer Groups - If set to Yes, only selected customer groups will be tracked by Reddit server-side events.
  • Send eCommerce Event Data to multiple Reddit Pixel endpoints - Adding a new property here will only send the enabled eCommerce events in the Reddit Pixel Server Side Tracking configuration. If you need to also send Page View events, in order to stitch data and ensure attribution, you'll also need to add additional Reddit Pixel Tracking codes in the Reddit Pixel Tracking Javascript Code section above.

Change Log.

What’s new in v.1.15.9 - October 28, 2025

  • Magento Compatibility: Introduced compatibility with the latest released Magento 2 Security Patches - Magento 2.4.8-p3, Magento 2.4.7-p8, Magento 2.4.6-p13, Magento 2.4.5-p15 & Magento 2.4.4-p16.
  • New Feature: Enhanced client and server-side purchases with additional data about the user (email, phone number) to significantly increase Event Match Quality.
  • New Feature: Added an interactive form that can be submitted via the Magento Admin to provide an efficient method of submitting feedback/feature requests.
  • Added adjustments to pricing parameter calculation to Begin Checkout and Add Payment Info events to ensure a higher degree of data accuracy.

What’s new in v.1.15.7 - September 2, 2025

  • New Feature: Optimized the addon's event logging functionality to increase clarity and improve the process of searching/filtering through logged events. All data logged for a specific event is now included on the same line. Before this release, every logged piece of information would take up a separate line, even if related to the same eCommerce event.
  • New Feature: The addon now features the capability of sending data to multiple Reddit properties via newly added Magento Admin settings. This allows you to send event data from the same Magento 2 instance to any number of Reddit properties. This feature is also included in the Google Analytics 4 PRO extension and other API addons.
  • Magento Compatibility: Introduced compatibility with the latest released Magento 2 Security Patches - Magento 2.4.8-p2, Magento 2.4.7-p7, Magento 2.4.6-p12, Magento 2.4.5-p14 & Magento 2.4.4-p15.
  • Fixed an issue that would, in very specific cases, prevent the addon from sending purchase events via cron. This would happen when, for any reason, the ID of the product on the order that was supposed to be sent no longer existed (deleted product, for example).

What’s new in v.1.15.3 - June 20, 2025

  • New Feature: Added options to allow for filtering of events based on Customer Groups. The extension now pulls all Customer Groups and allows merchants to select for which of those they'd like event data to be sent.
  • Magento Compatibility: Introduced compatibility with the latest Magento 2.4.8-p1, 2.4.7-p6, 2.4.6-p11 & 2.4.5-p13 Security Patches releases. Upgrade ASAP to keep your store secure.
  • Made various code optimizations related to Grand Total and Subtotal calculations in order to increase module customizability.

What’s new in v.1.15.0 - April 22, 2025

  • Magento Compatibility: Introduced compatibility with the new Magento 2.4.8 release, as well as the accompanying 2.4.7-p5, 2.4.6-p10, 2.4.5-p12 and 2.4.4-p13 Security Patches.
  • PHP Compatibility: Introduced compatibilty with PHP 8.4, which is now officially compatible with the latest Magento 2.4.8 version.

What's new in v.1.14.19 - April 8, 2025

  • Fixed an issue that caused the incorrect user IP address to be sent when utilizing CDNs such as Cloudflare. Previously, the extension would always send the IP assigned by the CDN.
  • Fixed an issue that sometimes prevented the extension's Order Exclusion by Status functionality from properly working when sending orders via cron.
  • Added a default User Agent the extension uses when orders are sent via cron.
  • Fixed an incorrect namespace used throughout the extension files.

What's new in v.1.14.13 - February 17, 2025

  • New Feature: The addon now benefits from the Google Analytics 4 PRO extension's Measurement Protocol Log functionality, which generates a log file in the var/log directory that includes information about each triggered event. The functionality can be enabled in the addon's Magento Admin configuration section.
  • Removed deprecated Magento 2.2.x code version from extension package.


v.1.10.1 - November 14, 2024

weltpixel