Reddit Ads

Send conversion events to Reddit via the Conversions API for campaign attribution, audience measurement, and ad delivery optimisation.

Why route Reddit Ads through Datafly Signal

• Conversions survive ad blockers and tracking prevention. A browser tag served from an advertising domain is blocked outright for part of your traffic, and Safari’s ITP shortens the cookies it can set. Signal sends the event from your own server, so the conversions Reddit Ads optimises against are not filtered by the browser.
• Email is hashed before leaving your infrastructure. Signal normalises (trim and lowercase) and applies SHA-256 inside your own deployment, so Reddit Ads receives match keys rather than raw personal data.
• Client IP and user agent are carried in the payload. Both are taken from the original visitor request rather than your server, which is what Reddit Ads needs to attribute the event to the right session.
• Click identifiers are captured and replayed. Signal stores click_id, rdt_cid first-party at collection time and attaches them to the conversion later, so attribution survives even when the original landing cookie has expired.
• Delivery is batched, rate-limited, and retried. Signal buffers to Kafka, respects the Reddit Ads rate limit, and retries on 429 or transient failure rather than dropping the event.
• Presets for Retail and Automotive. The mapping starts from a working configuration for your vertical instead of a blank field map.
• One consent decision governs every destination. Reddit Ads is gated by the same consent state as the rest of your stack, so a withdrawal applies everywhere at once.
• No vendor tag on the page. Removing it removes its page weight and its independent access to your visitors.

Prerequisites

Complete these steps in Reddit Ads Manager before configuring the integration in Signal.

Configuration

Configure in Signal

Management UI

1. Navigate to Integrations in the sidebar.
2. Open the Integration Library tab.
3. Find Reddit Ads or filter by Advertising.
4. Enter your account_id, pixel_id, and access_token.
5. Click Install Integration to create the integration with a ready-to-use default configuration.

Management API

curl -X POST http://localhost:8084/v1/admin/integration-catalog/reddit/install \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Reddit Ads",
    "variant": "default",
    "config": {
      "account_id": "t2_abc123",
      "pixel_id": "t2_pixel_abc123",
      "access_token": "eyJhbGciOi..."
    },
    "delivery_mode": "server_side"
  }'

Identity Signals

Reddit uses a click ID to attribute conversions back to specific ad clicks.

When a rdt_cid is available in the Signal identity store, Signal automatically includes it in outbound events to Reddit. This provides deterministic click-through attribution.

// The rdt_cid is captured automatically from URL parameters.
// You can also pass it explicitly if needed:
datafly.identify({ rdt_cid: "abc123-click-id" });

API endpoint

POST https://ads-api.reddit.com/api/v2.0/conversions/events/{{pixel_id}}

Allow egress to ads-api.reddit.com from the network your delivery workers run on.

Event Mapping

The default Retail preset maps:

To customise or extend, edit the integration’s Field Mappings in the Management UI.

Example: Purchase Event

Datafly.js call:

datafly.track("Order Completed", {
  order_id: "ORD-001",
  total: 79.99,
  currency: "USD",
  products: [
    { product_id: "SKU-A", name: "Widget", quantity: 2, price: 39.99 }
  ]
});

Reddit Conversions API payload sent by Signal:

{
  "test_mode": false,
  "events": [
    {
      "event_at": "2026-03-24T12:00:00Z",
      "event_type": {
        "tracking_type": "Purchase"
      },
      "event_metadata": {
        "item_count": 2,
        "currency": "USD",
        "value_decimal": 79.99,
        "conversion_id": "ORD-001"
      },
      "user": {
        "click_id": "abc123-click-id",
        "ip_address": "203.0.113.50",
        "user_agent": "Mozilla/5.0 ..."
      },
      "products": [
        {
          "id": "SKU-A",
          "name": "Widget",
          "category": "",
          "price": 39.99
        }
      ]
    }
  ]
}

Testing

Troubleshooting

Delivery

Events are delivered server-side from your Datafly Signal infrastructure directly to the Reddit Conversions API. No client-side scripts are loaded for this integration.