> For the complete documentation index, see [llms.txt](https://docs.relevant-digital.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.relevant-digital.com/ad-revenue-insights/mapping/adding-your-own-placement-labels.md).

# Adding Your Own Placement Labels

Add custom placement labels to group inventory in Ad Revenue Insights and use them as a reporting dimension.

A placement label allows you to organise your different placements for Ad Revenue Insights reporting. The function is primarily used as an alternative grouping or reporting dimension compared with the standard “placement” dimension.

## How Does It Work?

If you go to your placements (in Publisher accounts → edit a publisher → choose and expand a website), you will see the placement label as an empty field next to the placement’s name:

<div data-with-frame="true"><img src="https://content.gitbook.com/content/thyujPhgXh1WtJZy8bjr/blobs/r0xOW8FpM30DPDxzCfY7/N%C3%A4ytt%C3%B6kuva%202021%2011%2016%20kello%209.38.19.png" alt=""></div>

When you start typing a label, a list will automatically populate. This list can then be used from the drop-down menu on the next placement, so you do not need to re-enter the same value multiple times.

The label list will always consist of the labels actively used in the system. To remove a label entry, simply ensure it is not used by any of your placements.

## What Can You Use It For?

A label can be anything, as it is an open label that your organisation can use to group placements in a way that is important to you. Here are a few examples to get you started:

* **Media type:** Display, Native, Video, App
* **Above or below the fold**
* **Front page vs articles** (if you use different placements for this)
* **Content groupings across websites:** News, Cars, Sports, Fashion

Please note that only one placement label can be attached to each placement, so it is worth considering which approach brings your organisation the most value.

## How to Report on It

Once you have entered the first placement label, a list will be generated, and this will activate Placement labels in the API reporting dimensions. Simply select the dimension and run your report, or create your dashboard using it.

If you cannot find Placement labels as a dimension, please ensure that you have added at least one placement label to a placement.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.relevant-digital.com/ad-revenue-insights/mapping/adding-your-own-placement-labels.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
