Skip to main content

Verify Events with the Pixel Helper

Use the Pixel Helper with Event Testing for more robust error detection.

Keeping track of your Reddit Pixel conversion events is a breeze with the Reddit Pixel Helper Chrome extension. This handy tool lets you verify conversion events and troubleshoot issues from your browser.

After installing the tool, go to any page with the Pixel setup and get details on the following:

Pixel helper

  • Verify linked ad account: Check that the correct ad account is receiving your events. This should match the ID listed in the Events Manager.
  • Check your event's status: Ensure your event is passing with minimal issues. Your status can be one of the following:
    Status colorMeaningAction needed?
    GreenYour event is healthy with no errors or warnings.No action needed
    YellowIssue detected, but still worksRecommended fix
    RedYour event is broken and won't track properlyImmediate fix required
  • Expand events for full details: See more details on your event, including any issues and whether match keys are being passed. 
    • Pixel ID: Your Pixel ID
    • Referrer URL: The page URL where the event is firing on
    • Timestamp: When the event was fired
    • Latency: The time for the event to fire after Pixel initialization
    • Metadata: Any configured event metadata for this event  
    • Customer match keys: Any configured customer match keys for this event
    • Errors/ Warnings: Errors or warnings for the event and how to fix
  • Save and download your results: Save your results as a text file. You will also receive the hashed values for your match keys.

Recommendations

Ensure all events are healthy and being passed

Explore your site and ensure the correct events are being captured. For example, when you add an item to your cart, an AddToCart event should fire. When using the Pixel with DPA, we recommend checking for these events:

ActionEvent
View a variation of a productViewContent
Add product to cartAddToCart
Make a test purchasePurchase

If an event is configured correctly you'll see a green dot next to the event and no warnings when you expand the event's panel. If you don't see an event or you see a warning, the event was improperly configured and isn't firing. This means that that page action isn't being tracked, which will affect your analytics. 

We strongly recommend troubleshooting errors as soon as possible.

Pin the extension for quick access

Open your extensions in your toolbar and select the pin icon for the Reddit Pixel Helper extension. You'll be able to open the extension right from your toolbar.

Troubleshooting

Errors

MessageDescription
Missing Pixel IDThis Pixel event is missing the Pixel ID, which you can find in Accounts.
Invalid Pixel IDThe Pixel ID is formatted incorrectly. Ensure it follows either the t2_xxxxxxxxxxx or a2_xxxxxxxxxxx format.
Invalid event typeThe Pixel attempted to fire a conversion event we don't support. Change it to a supported event and check that all custom events have a name.
No event nameThis Pixel event was fired without an event name. Provide a name and try again.

Warnings

MessageDescription
Duplicates detectedThe same Pixel event was fired multiple times.
Invalid metadataEvent metadata was provided but in the wrong format. Check that your values are in the correct format:
  • itemCount: integer
  • value: number
  • currency: string that matches a 3-letter currency code
  • conversionId: string
Missing metadatavalue or currency is missing. If currency is missing or malformed, we'll try to default to your account's chosen currency if available. Otherwise, currency will be left empty. 
Unsupported metadataThe event contains event metadata we don't support.
Unnamed custom eventYou've set this event as a custom event, but haven't added a custom event name.
Invalid customEventNamecustomEventName is in the wrong format. It needs to be a string containing at most 64 characters.
Excess arguments The event fired with too many arguments.
Metadata is not an objectThe event fired with an invalid metadata object type. You can fix this by changing the third argument.
Replace the placeholder valuePlaceholder values for customer match keys haven't been changed. Replace the value or remove the parameter from the Pixel code.
Data processing mode errorUnsupported value for data processing mode. Ensure the data processing mode is set to LDU or remove the parameter.

We're here to help

Our Reddit Ads team is ready to support you from setup to success.

Snoo Punch Up