landscapeDisplay Ad ServerServe ads in standard fixed-size ad units
apiNative Ad ServerServe native ads on your web page or app
ondemand_videoVideo Ad ServerServe MP4 video ads as pre/mid/post-rolls

laptop_chromebook

For Publishers

Maximize revenue for direct deals.

campaign

For Advertisers

Optimize campaigns, real-time insights.

roofingProductsarrow_drop_downSolutionsarrow_drop_downPricing

User Guide API Support

Management

Reports

Settings

Others

Macros & Placeholders

Custom Dimensions

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

Introduction

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:

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)

Prerequisites

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:

...&cd1=premium&cd2=cars

Limitations

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:

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.

Caveats

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).