Links

Labels

Organizing your audiences

What Are Labels?

Located in the Settings > Labels section of your DCN, labels are a simple way to organize and filter your audiences.

Label attributes

Attribute
Description
Label name
1-20 characters, including special characters.
Description
An optional field helping your users understand the purpose of each of your labels. 50 characters maximum.
Color
An additional way of categorizing your audiences and understanding them at a glance. (e.g. by using the same color for all labels for audiences using connected tv data).
An example of filtered audience list using labels

Creating Labels

From the UI
From the CLI
  • Navigate to <your dcn>.cloud.optable.co/admin/labels
  • Click the Create Label button at the top right of the page
  • Name your label
  • Describe your label (optional)
  • Choose a color. There are 2 options to do so:
    • Optable uses HTML Hex color code. You can directly type the hex code if you know it, the # is mandatory
    • Click the current assigned color
      and change it using visual color picker
Use the label create CLI command
Optable uses HTML Hex color code. The # sign will be added automatically to the color code if not detected in your command
Upon success, you will receive a confirmation message similar to this:
{
"id": 35,
"name": "example label",
"author": "Paul",
"color": "#BD533C",
"created_at": "2022-09-15T17:15:06.428105912Z",
"updated_at": "2022-09-15T17:15:06.428105912Z"
}

Updating Labels

From the UI
From the CLI
  • Navigate to <your dcn>.cloud.optable.co/admin/labels
  • Click the
    button beside an existing label
  • Click "edit"
  • Change the specified label's attributes as desired
Use the label update command
You can find the relevant label id by using the label list command
Upon success, you will receive a confirmation message similar to this:
{
"id": 35,
"name": "example label",
"author": "Paul",
"color": "#BD533C",
"created_at": "2022-09-15T17:15:06.428105912Z",
"updated_at": "2022-09-15T17:17:36.128896911Z"
}

Deleting Labels

From the UI
From the CLI
  • Navigate to <your dcn>.cloud.optable.co/admin/labels
  • Click the
    button beside an existing label
  • Click "delete"
  • Confirm your choice
Optable will not prevent you from deleting a label currently assigned to 1+ audiences. You can see how many audiences are assigned to a specified label in the DCN's UI.
Use the label delete command
You can find the relevant label id by using the label list command
Upon success, the CLI will return an empty object:
{
}

Assigning Labels to Audiences

You can assign labels when creating or updating an audience.