Display Ad Server
Serve ads in standard fixed-size ad units
Native Ad Server
Serve native ads on your web page or app
Video Ad Server
Serve MP4 video ads as pre/mid/post-rolls
For Publishers
Maximize revenue for direct deals.
For Advertisers
Optimize campaigns, real-time insights.

Custom Dimensions

Home chevron_right User Guide
1. Introduction
2. What are custom dimensions?
3. Why use them?
4. Prerequisites
5. How to implement them?
6. Limitations
7. Generating reports
8. Changing labels
9. Caveats


Custom dimensions is a feature that allows you to capture non-standard data in AdGlare. Think of them as customized data fields tailored to your own specific needs. Once recorded, this data can be organized, filtered and analyzed to gain deeper insights into your campaign's performance.

What are custom dimensions?

Custom dimensions go beyond built-in dimensions like the user's device, geolocation data or ad format. Here's an example:
Reports Custom Dimensions Ss3 AdGlare AdServer
Now your custom dimensions can be anything that completes this pre-defined list of dimensions. Examples are:
  • The user's subscription: Free, Essential, Premium
  • Some A/B test data: variation_X, variation_Y, variation_Z
  • Category: cars, books, houses
  • ...

Why use them?

Based on your persona, you can use custom dimensions for a variety of reasons. Examples are:
  • Understand which categories perform best (publisher)
  • Do some A/B testing with different ad copies or variations (advertiser)
  • Get to know which user subscription leads to more conversions (in-house)


  • Custom dimensions are available on the Enterprise plan. Contact support in case you wish to upgrade.
  • You also need coding knowledge to dynamically add your custom data to the ad tag, or use macros in case you serve ads via a third party.

How to implement them?

A total of 5 indices are available for your custom dimensions. They are called cd1, cd2, cd3, cd4 and cd5. Here, "cd" stands for "custom dimension". To add them to the ad tag, append your data as a key/value pair. For example, if you want to log the subscription name in cd1 and the category in cd2, you can add:


The following limitations apply:
  • Max 5 custom dimensions (1-5).
  • The value length for each custom dimension is limited to 20 characters.
  • The cardinality is limited to 1000 per day. Anything beyond that number will collapse into '(other)' in the reports.

Generating reports

To get insights based on your custom dimensions, go to the Reports page and click your dimension from the list at the left:
Reports Custom Dimensions Ss2 AdGlare AdServer

Changing labels

By default, custom dimensions are labeled as "Custom 1-5". You can change the label to match the dimension that you're actually logging. As per the example above, this would be Subscription and Category. To do so, go to the Settings page, then choose Customizations => Dimensions. Change the labels accordingly.
Reports Custom Dimensions Ss1 AdGlare AdServer


In AdGlare's reporting system, your custom dimensions are stored under the keys cd1-5. The label is only used in the UI. Consequently, if you happen to change the type of data you're sending for a specific dimension, please keep in mind that existing data logged under that custom dimension will not be erased. Old custom data may appear under your new label, which may seem wrong. It's best practice to stop using your custom dimension for a while (cd1 for example) before switching data types, or use one of the other available indices (cd2-4).