# Custom Tags

Custom tags are labels that allow you to **efficiently define** and **filter** your affiliates, links, or media assets by tagging them based on criterias that are most relevant to your operation.\
\
For instance, you might want to group *affiliates* by traffic source, or classify *media assets* by banner size, or tag *links* based on language.<br>

### How to create custom tags:

1. Navigate to  “Custom tags” screen and click on “**Create**”
2. Choose **entity type**&#x20;

* Affiliate
* Media or&#x20;
* Links

3. Type the “**Tag name**” - custom and defined entirely by you\
   E.g. “Traffic Source”, "Language", "Size"
4. Use the toggle "**Required**" in case you want to make the tag selection mandatory upon creating/saving changes in affiliate account, media or link (optional)
5. Type BI **dimension** ID (follow the order of numbers of allowed dimensions specified in the brackets). Based on that order, the tags will be available in the Media Report
6. **Save**

<figure><img src="/files/KgsUUbhyg7SPOHqjTJjI" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/y7W3zARJuDyEsbfc7Ma3" alt=""><figcaption></figcaption></figure>

#### &#x20;**Create related tagging Options**&#x20;

After saving the custom tag:

1. &#x20;Navigate to Options tab and click “**Create**”
2. &#x20;Type the option
3. &#x20;Save

{% hint style="info" %}
Example:\
You have created Custom tag *Traffic Source*, and you want to have the following tagging options: PPC, SEO, Facebook etc.\
Each one should be created as a separate Option
{% endhint %}

<figure><img src="/files/Ohbr1T5veSRrZTQ9QKTQ" alt=""><figcaption></figcaption></figure>

### Usage of Custom Tags

#### Affiliate

In the affiliate user profile, go to Affiliate Tags and choose from the options available.

<figure><img src="/files/dtPs9K3sqKLlAMdf7aTJ" alt="" width="439"><figcaption></figcaption></figure>

<figure><img src="/files/bEUwM4ti5LL84bfOBYAK" alt=""><figcaption></figcaption></figure>

#### Destination Links/Media Assets

You can tag your media assets or destination links in the edit screen, as shown in the example below

<figure><img src="/files/02PfVlgbomlAk6jXVzbQ" alt=""><figcaption></figcaption></figure>

### Media Report and Segmentation

\
Custom tags can be used to efficiently **filter, segment and analyze** data related to affiliates, media assets and links\
\
See example usage below.

* In **Media Report** you can use Custom Tag dimensions for filtering/grouping\
  Example: You want to filter only results related to affiliates tagged with Product: Facebook<br>

<figure><img src="/files/V1Qr3QkTcYuspEQ22xvt" alt=""><figcaption></figcaption></figure>

* **Marketing**: You can use custom tags to **segment** your audience for an event driven journey/scheduled campaign&#x20;

<figure><img src="/files/SHgN1vDazSsmqJ2kzO0i" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

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

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.theaffiliateplatform.com/affiliate-platform/custom-tags.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.