Event Setup Tool

Once you've installed the Reddit Pixel on your website, you can use the event setup tool to share conversion events—no extra coding required. Select elements on your website or use URL keywords to share events with metadata. We recommend using this tool to streamline the conversion event process, significantly reducing lost time, opportunity, and revenue from incorrect implementations.

To ensure proper deduplication, don't set up multiples of the same conversion event for the Reddit Pixel. This means you should include all the metadata you need in one event. Misconfigurations can lead to more chances of duplications. Ensure you've correctly set up all the needed signals for accurate deduplication.

Before you start

• Create a Reddit Ads account. Set up your business on Reddit Ads or join your team's account as an administrator. If you're using the v2 integration, your account team must allow the Pixel IDs you want to connect in Business > Accounts. Don't have an account? Here's a great place to start.
• Install the Reddit Pixel. See the ways you can integrate it.
• Turn off ad blockers in your browser. These can prevent the Reddit Pixel from sharing conversions, causing the tool to be unable to recognize your integration.

Set up conversion events

1. In the Ads Manager navigation menu, select Events Manager.
2. Select Event Configuration and choose Set Up Events.
3. Provide the URL for your site and select Open URL.
   Keep this tab open to prevent the event setup tool from disconnecting from Event Configuration.

4. A new tab will open with your site. To start setting up a conversion event, select Add event.
5. Choose the trigger for the event.

• Web elements: Send an event when a user clicks an element on your current page, like a link or button. This option is recommended for interactions where the user stays on the same page.
• URL keywords: Send an event when a user visits a specific page, like the cart checkout or order confirmation page. This option is recommended to catch events where the user lands on a separate page.

Web elements

1. Choose a conversion event. If you're creating a custom event, provide an event name.
   You can create as many custom conversion events as you'd like, but only the twenty most recent events will be visible in the Events Manager and reporting.

2. Select trigger elements. This can be any button or link on the page and you can choose multiple elements.
3. (Optional but recommended) Set up event metadata. This shares additional information about the conversion event. We recommend filling in all the metadata values available for your event. There are two ways to set up metadata:
   • Link metadata: Select a field and select its related text on the page.
   • Input metadata: Select the Input icon next to a field and provide its value. If you're adding currency, select an option from the dropdown. If you can't set a field to a specific value, see troubleshooting.
4. Save your changes to create your event.

URL keywords

1. Choose a conversion event. If you're creating a custom event, provide an event name.
   You can create as many custom conversion events as you'd like, but only the twenty most recent events will be visible in Events Manager and reporting.

2. Select a matching type:
   • Full URL: Trigger this event when someone lands on a specific URL, like https://yoursite.com/wish-list.
   • URL keywords: Trigger this event when someone lands on a URL that includes one or more keywords. If the keyword you want isn't available in the dropdown, go to a page with a URL that contains it.
3. (Optional but recommended) Set up event metadata. This shares additional information about the conversion event. We recommend filling in all the metadata values available for your event. To link metadata, select its field and related text on the page. If you’re adding currency, select an option from the dropdown.
4. Save your changes to create your event.

Edit conversion events

You can edit a conversion event in Event Configuration or the event setup tool by selecting the Edit icon.

If you need to change trigger elements or metadata, we strongly recommend making changes in the event setup tool:

1. Go to Event Configuration and select the Edit icon for the event you'd like to change.

2. Select Open Event Setup Tool.

3. Provide the URL for your site and select Open URL.

   Keep this tab open to prevent the event setup tool from disconnecting from Event Configuration.

4. A new tab will open with your site. To edit a conversion event, select the Edit icon.

   If you don't see your conversion event, try looking in the other pages tab of the event setup tool.

   

5. Update your conversion event and then save your changes.

Delete conversion events

Go to Event Configuration in the Ads Manager and select the Edit icon.

Select delete event to remove the event from your site.

This action cannot be undone. If you'd like to share this conversion event, you'll need to recreate it.

Troubleshooting

Error	Description	Solution
Unable to connect to the tool.	See Unable to connect to tool.	See Unable to connect to tool.
Tool has disconnected from Reddit Ads.	The Events Manager has been closed and disconnected from the Events Setup Tool. This can happen if you close the tab that opened the Events Setup Tool, or the Events Setup Tool timed out.	Go to Event Configuration and reopen the tool.
Unable to see the tool on your site.	The tool popup doesn't appear on your site.	Refresh your site's page and try again.
Unable to set up events.	See Unable to set up events.	See Unable to set up events.
Tool isn't registering an element.	Your element may be contained in an iframe.	Check that your element is set up as a link or button on your page. This may require you to reach out to a developer.
Unable to add metadata to events.	See Unable to add metadata to events.	See Unable to add metadata to events.
Unable to add dynamic metadata to events.	The Events Setup Tool currently doesn't support dynamic metadata.	Consider choosing a different solution for setting up conversion events.
Events are being reported twice or not at all.	Your integration or Pixel base code has conversion events manually configured.	Add your Pixel base code to the third-party website or set up a direct integration with the Reddit Pixel.
Metadata fields aren't showing up in Events Testing.	Some fields, like those related to purchase, aren't configured to show in Event Testing.	Use the Pixel Helper to verify metadata for your events.
Experiencing network errors, such as being unable to: Save or delete the URL keyword event Save or delete the web element event Load events	The Events Setup Tool attempted to receive or send data to Event Configuration, but the server failed.	Wait a few minutes and then try again. If this issue persists, contact our Support Team.
An unexpected error has occurred.	We are unable to process the request right now.	Wait a few minutes and then try again. If this issue persists, contact our Support Team.

Unable to connect to the tool

Description	Solution
The provided site may not have the Reddit Pixel set up	Set up the Reddit Pixel and try again.
Certain types of code in your website's response header, such as a restrictive cross-origin opener policy, may block the event setup tool from detecting your pixel.	Remove this code from your website's header. This may require you to reach out to a developer.
The link provided for the source URL is a redirect URL	Set the source URL to the final destination URL and try again.

Unable to set up events

Description	Solution
Your current ads account may not have the administrator role assigned to this Reddit business.	Ask your business account administrators to add you to the team or change your role.
You aren't logged in to a Reddit business account or may be logged in to the wrong account.	Log out of Reddit Ads then log in again.

Unable to add metadata to events

Description	Solution
Only the standard metadata for each conversion event can be added to an event.	Consider choosing a conversion event that supports the metadata you'd like to add.
The field may contain too many characters or invalid characters. For example, the value field will only accept numbers and up to one period.	Provide a value that matches the field type.