Passer au contenu principal

​
Reddit Pixel Integration

CrowdChange supports Reddit Pixel browser tracking and optional Reddit Conversions API purchase tracking. Once connected, your Reddit Pixel receives PageVisit, AddToCart, and Purchase events. If a Reddit Conversions API access token is configured, CrowdChange also sends completed purchases from the server.

​
Setup

  1. Go to Admin -> Layout Settings -> Meta & Analytics
  2. Scroll to the Reddit pixel section
  3. Enter your Reddit Pixel ID, for example t2_xxxxxxx
  4. Optional: enter your Reddit ads account ID
  5. Optional: enter your Reddit Conversions API access token
  6. Click Save
The browser Pixel snippet is automatically injected into every page once the Pixel ID is saved. Conversions API tokens are stored as write-only encrypted values; leave the token field blank to keep an existing token.

​
Tracked Events

​
PageVisit

Fired automatically on page load and virtual page navigation. 
rdt('track', 'PageVisit');

​
AddToCart

Fired when an item is added to the checkout cart.
ParameterTypeDescription
currencystringISO 4217 currency code, for example USD, CAD
valuenumberTotal value of the item payload
itemCountnumberSum of item quantities
productsobject[]Array of { id, name, category } objects
Example payload 
{
  "currency": "CAD",
  "value": 50,
  "itemCount": 1,
  "products": [
    {
      "id": "registration",
      "name": "Registration",
      "category": "registration"
    }
  ]
}

​
Purchase

Fired when a donor successfully completes a transaction.
ParameterTypeDescription
currencystringISO 4217 currency code
valuenumberTotal transaction amount
transactionIdstringCrowdChange transaction ID
conversionIdstringtransaction_<transaction_id> dedupe identifier
productsobject[]Array of { id, name, category } objects
Example payload 
{
  "currency": "CAD",
  "value": 100,
  "transactionId": "1000",
  "conversionId": "transaction_1000",
  "products": [
    {
      "id": "donation",
      "name": "Donation",
      "category": "donation"
    }
  ]
}

​
Server-Side Purchase Tracking

When both a Reddit ads account ID and Reddit Conversions API access token are configured, CrowdChange sends a server-side Purchase conversion.
FieldDescription
click_idCaptured rdt_cid URL parameter when available
conversion_idtransaction_<transaction_id>
transaction_idCrowdChange transaction ID
item_countPurchased item count
currencyTransaction currency
valueTransaction value in minor currency units
value_decimalDecimal transaction value
emailSHA-256 hashed donor email when available
external_idSHA-256 hashed CrowdChange user ID when available
ip_addressRequest IP address
user_agentRequest user agent
Ad-network failures are logged and do not interrupt the donor checkout flow.

​
Click ID Attribution (rdt_cid)

When a visitor arrives via a Reddit ad, Reddit may append rdt_cid to the URL. CrowdChange captures this value in the browser session and passes it to the server-side conversion as click_id. CrowdChange also reads the _rdt_uuid cookie when present for future server-side attribution support.

​
Verifying Your Setup

After saving your Pixel ID:
  1. Visit any page on your platform and confirm Reddit Pixel loads from https://www.redditstatic.com/ads/pixel.js
  2. Navigate between pages and confirm PageVisit events fire
  3. Add an item to the cart and confirm AddToCart fires
  4. Complete a test transaction and confirm Purchase fires with the expected value, currency, and conversionId
If you configured Conversions API, verify the server-side purchase in Reddit Ads reporting or diagnostics.

​
Additional Information

See Reddit Pixel docs and Reddit Conversions API docs for further information.