# Reddit Pixel

> \[!IMPORTANT]
>
> This feature is in active development and may change before general availability.

## Destination Info

* Accepts [Page](/docs/segment/connections/spec/page), [Alias](/docs/segment/connections/spec/alias), [Group](/docs/segment/connections/spec/group), [Identify](/docs/segment/connections/spec/identify), [Track](/docs/segment/connections/spec/track) calls.
* Refer to it as **Reddit Pixel** in the [Integrations object.](/docs/segment/guides/filtering-data/#filtering-with-the-integrations-object)
* This destination is not compatible with [Destination Insert Functions.](/docs/segment/connections/functions/insert-functions/)
* This integration is **partner owned.** Please reach out to the partner's support for any issues.
* This destination is **Beta.**

The [Reddit Pixel](https://business.reddithelp.com/s/article/reddit-pixel) destination lets advertisers send Segment events to the Reddit Pixel without any additional manual JavaScript installation. This destination has Segment events pre-mapped to Reddit Pixel events and metadata. You can edit this mapping and create new events - no custom code required.

## Getting started

1. From your workspace's [Destination catalog page](https://app.segment.com/goto-my-workspace/destinations/catalog), find the Reddit Pixel destination and select **Add Destination**.
2. Select the source that you'd like to connect to the Reddit Pixel destination.
3. Open the destination settings and provide your Pixel ID. This can be found in the Reddit's [Events Manager](https://ads.reddit.com/events-manager).
4. Configure and map the events you'd like to send to the Reddit Pixel. The destination pre-maps certain Segment events to Reddit Pixel events and metadata, but you can edit these values. You can also set up custom events.

After enabling the destination, Segment automatically initializes and loads the Reddit Pixel on each page that you'd like to track based on your mappings.

## Destination Settings

| Field            | Description                                                                                                                                                                                                                                                                                                                                                                                  | Required | Type    |
| ---------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------- | ------- |
| Limited Data Use | Limited Data Use - When the LDU flag is enabled, it may impact campaign performance and limit the size of targetable audiences. See \[this documentation]\(https://business.reddithelp.com/s/article/Limited-Data-Use) for more information. If enabling this toggle, also go into each event and configure the Country and Region in the Data Processing Options for each event being sent. | No       | boolean |
| Pixel ID         | Your Reddit Pixel ID                                                                                                                                                                                                                                                                                                                                                                         | Yes      | string  |

## Available Presets

Reddit Pixel has the following presets

| Preset Name     | Trigger                                                      | Default Action |
| --------------- | ------------------------------------------------------------ | -------------- |
| Page Visit      | Event type = "page"                                          | Reddit Pixel   |
| View Content    | Event type = "track" and event = "Product Viewed"            | Reddit Pixel   |
| Lead            | Event type = "track" and event = "Lead Generated"            | Reddit Pixel   |
| Add to Wishlist | Event type = "track" and event = "Product Added to Wishlist" | Reddit Pixel   |
| Search          | Event type = "track" and event = "Products Searched"         | Reddit Pixel   |
| Add to Cart     | Event type = "track" and event = "Product Added"             | Reddit Pixel   |
| Purchase        | Event type = "track" and event = "Order Completed"           | Reddit Pixel   |
| Sign Up         | Event type = "track" and event = "Signed Up"                 | Reddit Pixel   |

## Available Actions

Build your own Mappings. Combine supported [triggers](/docs/segment/connections/destinations/actions/#components-of-a-destination-action) with the following Reddit Pixel-supported actions:

> \[!NOTE]
>
> Individual destination instances have support a maximum of 50 mappings.

* [Reddit Pixel - Custom Event](#reddit-pixel---custom-event)
* [Reddit Pixel](#reddit-pixel)

### Reddit Pixel - Custom Event

Send Custom Pixel Events to Reddit.

Reddit Pixel - Custom Event is a **Web** action. The default Trigger is `type = "track"`

| Field                   | Description                                                                                                                                                                                                                                        | Required | Type   |
| ----------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------- | ------ |
| Conversion ID           | The unique conversion ID that corresponds to a distinct conversion event. This is used for deduplication. If you are using both Reddit Pixel and CAPI integrations, this field is required in order to dedupe the same events across both sources. | No       | STRING |
| Event Metadata          | The metadata associated with the conversion event.                                                                                                                                                                                                 | No       | OBJECT |
| User                    | The identifying user parameters associated with the conversion event.                                                                                                                                                                              | No       | OBJECT |
| Products                | The products associated with the conversion event.                                                                                                                                                                                                 | No       | OBJECT |
| Data Processing Options | A structure of data processing options to specify the processing type for the event. This is only used for LDU - when the LDU flag is enabled, it may impact campaign performance and limit the size of targetable audiences.                      | No       | OBJECT |
| Custom Event Name       | A custom event name that can be passed when tracking\_type is set to "Custom". All UTF-8 characters are accepted and custom\_event\_name must be at most 64 characters long.                                                                       | Yes      | STRING |

### Reddit Pixel

Send Standard Pixel Events to Reddit. This includes pagevisits, addtocarts, search, etc.

Reddit Pixel is a **Web** action. The default Trigger is `type = "track"`

| Field                   | Description                                                                                                                                                                                                                                        | Required | Type   |
| ----------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------- | ------ |
| Tracking Type           | One of Reddit Pixel's standard conversion event types. To send a Custom event to Reddit use the Custom Event Action instead.                                                                                                                       | Yes      | STRING |
| Products                | The products associated with the conversion event.                                                                                                                                                                                                 | No       | OBJECT |
| User                    | The identifying user parameters associated with the conversion event.                                                                                                                                                                              | No       | OBJECT |
| Data Processing Options | A structure of data processing options to specify the processing type for the event. This is only used for LDU - when the LDU flag is enabled, it may impact campaign performance and limit the size of targetable audiences.                      | No       | OBJECT |
| Event Metadata          | The metadata associated with the conversion event.                                                                                                                                                                                                 | No       | OBJECT |
| Conversion ID           | The unique conversion ID that corresponds to a distinct conversion event. This is used for deduplication. If you are using both Reddit Pixel and CAPI integrations, this field is required in order to dedupe the same events across both sources. | No       | STRING |

## Deduplication with the Reddit Conversions API

If you implement both the [Reddit Pixel](https://business.reddithelp.com/s/article/reddit-pixel) and [Reddit Conversions API (CAPI)](https://business.reddithelp.com/s/article/Conversions-API) and the same events are shared across both sources, deduplication is necessary to ensure those events aren't double-counted.

The integration automatically pre-maps the Segment `messageId` to the Reddit conversion ID. If you wish to change this, you can pass a different unique conversion ID for every distinct event to its corresponding Reddit Pixel and CAPI event. Reddit will determine which events are duplicates based on the conversion ID and conversion event name. This is the most accurate way to ensure proper deduplication. Reddit recommends this method since there's less risk of incorrect integration, which can impact attribution accuracy.

To ensure your events are deduplicated:

* Create a unique conversion ID for every distinct event. You can set this as a random number or ID, or the order number when tracking purchase events, for example.
* Include the event in both the Reddit Pixel and CAPI.
* Ensure the conversion event name and conversion ID for match across the Reddit Pixel and CAPI.

For more information on deduplication, see the [Reddit Event Deduplication documentation](https://business.reddithelp.com/s/article/event-deduplication).

## Settings

Segment lets you change these destination settings from the Segment app without having to touch any code.

| Field            | Description                                                                                                                                                                                                                                                                                                                                                                                  | Required | Type    |
| ---------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------- | ------- |
| Limited Data Use | Limited Data Use - When the LDU flag is enabled, it may impact campaign performance and limit the size of targetable audiences. See \[this documentation]\(https://business.reddithelp.com/s/article/Limited-Data-Use) for more information. If enabling this toggle, also go into each event and configure the Country and Region in the Data Processing Options for each event being sent. | No       | boolean |
| Pixel ID         | Your Reddit Pixel ID                                                                                                                                                                                                                                                                                                                                                                         | Yes      | string  |
