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 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 --request POST \
  --url https://ads-api.reddit.com/api/v3/pixels/{pixel_id}/conversion_events \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer 123' \
  --header 'Content-Type: application/json' \
  --data '{
  "data": {
    "test_id": "string",
    "events": [
      {
        "click_id": "3184742045291813272",
        "event_at": 1514764800000,
        "action_source": "WEBSITE",
        "type": {
          "custom_event_name": "PromotionEvent",
          "tracking_type": "PAGE_VISIT"
        },
        "metadata": {
          "conversion_id": "H72B9A4YXQ",
          "currency": "USD",
          "item_count": 5,
          "value": 10.99,
          "products": [
            {
              "category": "Food Items",
              "id": "item-213",
              "name": "Carne Asada Burrito"
            }
          ]
        },
        "user": {
          "email": "snoo@example.com",
          "external_id": "7c73f2ae-a433-4d7b-9838-f467da98f48e",
          "ip_address": "192.0.2.1",
          "phone_number": "+15554441234",
          "user_agent": "Mozilla/5.0 (Windows NT 6.1; Win64; x64; rv:47.0) Gecko/20100101 Firefox/47.0",
          "aaid": "cdda802e-fb9c-47ad-9866-0794d394c912",
          "idfa": "EA7583CD-A667-48BC-B806-42ECB2B48606",
          "uuid": "1684189007728.7c73f2ae-a433-4d7b-9838-f467da98f48e",
          "data_processing_options": {
            "country": "US",
            "region": "US-CA",
            "modes": [
              "LDU"
            ]
          },
          "screen_dimensions": {
            "height": 1440,
            "width": 3440
          }
        }
      }
    ]
  }
}'

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

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

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