Skip to main content

Map a Catalog

Mapping a catalog to the Reddit Pixel or Conversions API (CAPI) enables accurate conversion tracking and enhances ad performance optimization. By connecting specific products in your catalog to user actions, you can measure the effectiveness of your advertising campaigns and optimize them for better performance. 

When running dynamic product ads (DPA) with the Reddit Pixel or CAPI, you'll need to map the Pixel or CAPI to its corresponding Catalog ID. This is required to deliver and retarget effectively. Mapping helps Reddit's ad delivery system understand your products better and ensure the right audience sees the correct products. Without proper mapping, you won't be able to run retargeting campaigns. 

Connecting a catalog to a Reddit Pixel or CAPI data collection takes about thirty days to complete for proper retargeting. We recommend uploading your catalog or feed as soon as possible to ensure optimal results on your campaign launch.

If you don’t map your catalog or map it a few days before going live, you may experience delivery and performance issues with your ads.

We strongly recommend using the Reddit Pixel and Conversions API (CAPI) together.

Before you start​

The product ID for your catalog and Reddit Pixel or CAPI integration must match so we know they refer to the same product.

1. Set up conversion events​

To ensure DPA is running correctly, you’ll need to make sure these conversion events are set up for the Reddit Pixel or CAPI:

  • View Content
  • Add To Cart
  • Purchase

You'll also want to make sure you're passing all event metadata.

Manually set up the Reddit Pixel​

Look for the pixel code in the header of your ad's website.

Find the header template if you're using a web platform. If you're using Shopify, open your site template or custom pixel.

Check that every event is tracking all possible event metadata. A correctly formatted event should look like this:

rdt('track', 'AddToCart', {
   itemCount: 2,
   value: 19.99,
   currency: 'USD',
   products: [
      {
         id: 'product123',
         category: 'products',
         name: 'Product 123'
      },
      {
         id: 'product456',
         category: 'products',
         name: 'Product 456'
      }
   ]
});

Manually set up CAPI​

You can send a conversion event by calling the Conversions endpoint.

You can send a conversion event by calling the Conversions endpoint.

To send a conversion event, copy the following request and replace ad_account_id, token, and the payload parameters. You can also add additional parameters to set up custom conversion events, match keys, event metadata, and test mode. 

event_at can’t be older than seven days. This value should follow ISO 8601 and be formatted as either YYYY-MM-DDThh:mm:ss[±hhmm] or YYYY-MM-DDThh:mm:ssZ. For example, 2024-04-21T22:00:00Z is formatted correctly.

curl 'https://ads-api.reddit.com/api/v2.0/conversions/events/ad_account_id' \
--header 'Authorization: Bearer token {{auth_token}}' \
--data-raw '{
  "test_mode": {{true/false}},
  "events": [
    {
      "event_at": "{{ISO 8601 date and time}}",
      "event_type": {
        "tracking_type": "{{Conversion event}}"
      }
    }
  ]
}'

If your event is well-formatted and your fields are valid, you’ll receive a response like this:

{"message":"Successfully processed 1 conversion events."}

Set up the tag in Google Tag Manager​

Learn more about setting up tagging in Google Tag Manager.

  1. In Google Tag Manager, select your container to open its workspace.
  2. In the left-hand menu, select Tags and then New. You can also choose a pre-existing tag and edit it.
  3. Select Tag Configuration, then select the Reddit template. If you’re setting up a web container, this will be the Reddit Pixel. If you're setting up a server container, select Reddit Conversions API.
  4. Check that all your products are listed in Product Information.  Check product information
  5. Ensure all your event metadata fields are filled out. This should include:
    • Item count
    • Value
    • Currency
    • conversionId. You only need to fill this out if you’ve also integrated CAPI.

Check the Advanced Settings > Additional Tag Metadata section if you don’t see a metadata field.

Check metadata

2. Map a catalog to the pixel​

You can only map a Reddit Pixel to one catalog. This catalog should be used across all your DPA campaigns. If you have multiple catalogs, map the pixel to the one for your DPA campaign. If you map the wrong catalog, you may experience ad delivery issues.

  1. Go to Catalogs.
  2. Select the catalog to map the Reddit Pixel to, then select Settings.
  3. Add your Pixel ID for Reddit Pixel ingestion. You can find your ID in the Events Manager.
  4. When finished, save your changes. Your Pixel is now mapped! You should see your advertiser ID in the settings of your catalog. Attach Pixel

3. Verify conversion events​

Conversion events can be verified using one of two methods:

  • Events Manager and Pixel Helper: Trigger conversion events in real time to see if your events are being captured. Third-party cookies must be enabled in your browser settings for event testing. This method is recommended for quick and simple testing.
  • POST Get a report: Generate a metrics report for up to three breakdowns based on the list of fields that you provide. Reports provide detailed insights and analytics on ad performance, audience engagement, and other relevant metrics. You can also use this endpoint to verify custom conversion events. We recommend this method if you've implemented Conversions API.
Last updated on