Custom Dimensions

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 auto_storiesCampaign'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:

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 emailAdGlare Support in case you wish to upgrade.
• You also need coding knowledge to dynamically add your custom data to the ad tag.

Implementation

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:

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