You can update the data for the following Static data types:
Static Data Types
Static Campaigns
- Divisions – Divisions are used to indicate internal corporate units for your company.
- Area Levels – The Area Levels creation is mandatory in the system to assign them to Assets. They are part of the setup for Sales Markets.
- Sales Markets – Sales markets are groups of geographic areas.
- Areas - The Area is the lowest-level in an Area Hierarchy.
- Media Groups – Each customer has a different hierarchy of media groups. These are used to organize the inventory of assets into logical groups.
- Sites – A Site refers to the civic address where the media is located. Faces are the installation points at the site. A Site is one of two mandatory hierarchy levels for assets, the other one being a Face.
- Vehicles – Vehicles are part of an Area Hierarchy.
- Faces – A Face represents the advertising surface. A Face is one of two mandatory hierarchy levels for assets, the other one being a Site.
- Advertisers – Clients or companies available for use in the Broadsign Platform.
- Agencies – Firms that create and are responsible for overall planning and of the advertising campaign.
Tip: Each Static data type must be updated individually.
Note: The Static Data Import page is available to users with the Admin, Static Admin, or Static Campaign Manager role.
To update the individual Static data types, you will need to create a .csv file with the appropriate data for each type. Broadsign provides a static data template for you. To speed up the import process, you can update only the data types that need an update.
To update the Static data:
Static Campaigns
Creating a .csv file requires three general steps:
- Select and export from the Broadsign Platform the Static data template for the data type that you want to update.
The template contains all the current Static data. On a new domain, the columns will be empty. See Step 1 – Export the Static Data Template.
Note: You must follow the format of the Static data template. Otherwise, Broadsign will consider the file to be invalid.
- Enter your Static data into the file, respecting the format. You can leave existing columns blank, but you cannot add columns to the file. See Step 2 – Enter Your Static Data.
- Import the file, now containing your Static data, back into your domain. See Step 3 – Import the File into Your Domain.
Note: Broadsign can import files with up to 10,000 rows.
The Static data template provides the allowable columns and correct format. On a new domain, the columns will be empty.
To export the Static data template:
- In the Static Data Import list, click the Update Static Data for the data type that you want to update.
- In the Update a File window, click Download Excel Template to download a
.csvfile for the Static data type to update. - Your system will download an Excel file.
- The file name is in this format:
static-data-import-[data_type]-template. For example: static-data-import-divisions-template.
Note: You must follow the format of the Static data template. Otherwise, Broadsign will consider the file to be invalid.
To open the Static data file:
- Open the Static data
.csvfile that you downloaded (we recommend Microsoft Excel or similar spreadsheet program). -
Enter your Static data as described in Step 2B – Format the Static Data File.
The Static data file includes several columns that differ depending on the Static data type that you are updating (see CSV File Column Details).
CSV File Column Details
The .csv file differs for each Static data type to update. The following tables list the columns for each data type.
We suggest to import your static data in the following order:
- Divisions Column Details
- Area Levels Column Details
- Sales Markets Column Details
- Areas Column Details
- Media Groups Column Details
- Sites Column Details
- Vehicles Column Details
- Faces Column Details
- Divisions Column Details
- Agencies Column Details
Divisions Column Details
Static Campaigns
Note: You can import Divisions only once. Changing the Divisions once imported could lead to issues with the data. Assets and Sales Contracts will be impacted by the change.
| Column Letter | Column Name | Requirement | Description |
|---|---|---|---|
| A | Division Code | Mandatory |
Code identifying the Division, with a maximum of 16 characters. It must be unique per Account Type. If your system has only one Company, the Division Code is automatically assigned to it. |
| B | Division Name | Mandatory | Name for the Division, with a maximum of 255 characters. |
| C | Is Selling Division? | Mandatory |
Specifies whether this is a Selling Division. Available values are:
Note: A Division can be classified as Selling, Operator, or both. |
| D | Is Operator Division? | Mandatory |
Specifies whether this is an Operator Division. Available values are:
Note: A Division can be classified as Selling, Operator, or both. |
For example:
Area Levels Column Details
Static Campaigns
Note: You can import Area Levels only once. Changing the Area Levels after all the Areas and Sales Markets have been imported could lead to issues with the data.
| Column Letter | Column Name | Requirement | Description |
|---|---|---|---|
| A | Area Level | Mandatory |
Level of the Area between 0 and 5, where 0 means the highest level. It must be unique per Account Type. |
| B | Area Level Code | Mandatory | Code identifying the Area Level, with a maximum of 16 characters. |
| C | Area Level Name | Mandatory | Name of the Area Level, with a maximum of 255 characters. |
For example:
Sales Markets Column Details
Static Campaigns
Note: To import Sales Markets, at least one Division must already exist in the system.
| Column Letter | Column Name | Requirement | Description |
|---|---|---|---|
| A | Area Group Code | Mandatory | Code identifying the Area Group, with a maximum of 16 characters. |
| B | Area Group Name | Mandatory | Name of the Area Group, with a maximum of 255 characters. |
| C | Sales Market Code | Mandatory | Code identifying the Sales Market, with a maximum of 16 characters. |
| D | Sales Market Name | Mandatory | Name of the Sales Market, with a maximum of 255 characters. |
| E | Office Code | Mandatory | Code identifying the Office, with a maximum of 16 characters. |
| F | Office Name | Mandatory | Name of the Office, with a maximum of 255 characters. |
| G | Division Code | Mandatory | Code identifying the Division, with a maximum of 16 characters. |
For example:
Areas Column Details
Static Campaigns
Note: To import Areas, at least one Sales Market must already exist in the system.
| Column Letter | Column Name | Requirement | Description |
|---|---|---|---|
| A | Area Code | Mandatory |
Code identifying the Area, with a maximum of 16 characters. It must be unique per Account Type. |
| B | Area Name | Mandatory | Name of the Area, with a maximum of 255 characters. |
| C | Area Level | Mandatory | Level of the Area between 0 and 5, where 0 means the highest level. |
| D | [Parent Area Code] | Optional | Code identifying the Area, with a maximum of 16 characters. |
| E | Area Group Code | Mandatory | Code identifying the Area Group, with a maximum of 16 characters. |
For example:
Media Groups Column Details
Static Campaigns
| Column Letter | Column Name | Requirement | Description |
|---|---|---|---|
| A | Media Category | Mandatory |
Media Category to use. Available values are:
|
| B | Media Group Code | Mandatory | Code identifying the Media Group, with a maximum of 16 characters. |
| C | Media Group Name | Mandatory | Name of the Media Group, with a maximum of 255 characters. |
| D | Media Group Description | Mandatory | Description of the Media Group, with a maximum of 255 characters. |
| E | Media Type Code | Mandatory |
Code identifying the Media Type, with a maximum of 16 characters. It must be unique per Account Type. |
| F | Media Type Name | Mandatory | Name of the Media Type, with a maximum of 255 characters. |
| G | [Media Type Description] | Optional | Description of the Media Type, with a maximum of 255 characters. |
For example:
Sites Column Details
Static Campaigns
| Column Letter | Column Name | Requirement | Description |
|---|---|---|---|
| A | Division Code | Mandatory | Code identifying the Division, with a maximum of 16 characters. |
| B | Site Number | Mandatory | Number identifying the Site, with a maximum of 30 characters. |
| C | Site Description | Mandatory | Description of the Site, with a maximum of 255 characters. |
| D | Site Type Name | Mandatory |
Name of the Site Type. Available values are:
|
| E | Area Code | Mandatory | Code identifying the Area, with a maximum of 16 characters. |
For example:
Vehicles Column Details
Static Campaigns
| Column Letter | Column Name | Requirement | Description |
|---|---|---|---|
| A | Site Number | Mandatory | Number identifying the Site, with a maximum of 30 characters. |
| B | [Site Date From (YYYY-MM-DD)] | Optional | Date as of when the Vehicle is present at that site. |
| C | Vehicle Number | Mandatory | Number identifying the Vehicle, with a maximum of 30 characters. |
| D | Vehicle Description | Mandatory | Description of the Vehicle, with a maximum of 255 characters. |
| E | Vehicle Category Code | Mandatory | Code related to the Vehicle type, with a maximum of 16 characters. |
| F | Vehicle Category Name | Mandatory |
Name of the Vehicle type, with a maximum of 16 characters. For example: Bus, Tram, Metro. |
For example:
Faces Column Details
Static Campaigns
| Column Letter | Column Name | Requirement | Description |
|---|---|---|---|
| A | Site Number | Mandatory | Number identifying the Site, with a maximum of 30 characters. |
| B | [Vehicle Number] | Optional |
Number identifying the Vehicle, with a maximum of 30 characters. It must be unique per Site. |
| C | Face Number | Mandatory |
Number identifying the Face, with a maximum of 30 characters. It must be unique per Site. |
| D | Face Description | Mandatory | Description of the Face, with a maximum of 255 characters. |
| E | Media Type Code | Mandatory | Code identifying the Media Type, with a maximum of 16 characters. |
| F | Start Date (YYYY-MM-DD) | Mandatory | Date as of when the Face must be posted. |
| G | Is Virtual? | Mandatory |
Defines whether the Face is Virtual, that is, are faces that envelope other faces. For example, full bus wraps are surfaces added to the exterior of buses that cover the sides and rear faces of the bus. Available values are:
|
For example:
Advertisers Column Details
Static Campaigns
| Column Letter | Column Name | Requirement | Description |
|---|---|---|---|
| A | Advertiser Code | Mandatory |
Code identifying the Advertiser, with a maximum of 16 characters. It must be unique per Account Type. |
| B | Advertiser Name | Mandatory | Name for the Advertiser, with a maximum of 255 characters. |
For example:
Agencies Column Details
Static Campaigns
| Column Letter | Column Name | Requirement | Description |
|---|---|---|---|
| A | Agency Code | Mandatory |
Code identifying the Agency, with a maximum of 16 characters. It must be unique per Account Type. |
| B | Agency Name | Mandatory | Name of the Agency, with a maximum of 255 characters. |
| C | [Agency Default Commission] | Optional | Default commission percentage given to the Agency between 1 and 100. If left blank, the system uses the domain default; otherwise it uses the specified value. |
For example:
Once the Static data file has been properly filled out, you can import it into the Broadsign Platform. If you encounter issues while importing, download the error logs by clicking the Download Log File button (see Download Log File) or contact Broadsign Services for assistance.
The Upload screen allows you to select your Static data file and upload it in the system.
Note: Broadsign can import files with up to 10,000 rows.
To upload the Static data file:
- In the Upload a File window, click anywhere in the right, grey part of the window.
- Navigate to your data file and select it.
You can upload any .csv or Excel file, as long as it has at least one row and one record per row.
The Review & Finalize screen allows you to check your imported Static data to ensure accuracy.
Review and Edit Data
Issues in your imported file are displayed in red in two locations:
- In the main part of the Review & Finalize screen, where problematic cells are highlighted.
- In the All issues pane, which lists all issues. Clicking an issue automatically takes you to the corresponding cell in the imported file to fix it.
You can do the following in the Review & Finalize screen:
- Show only the rows with issues by clicking Rows with issues.
- Click a cell with an issue to get information on the problem and correct it. For more information on the data required for each column, see CSV File Column Details.
- Double-click a problematic cell to edit it. The cell displays the possible values.
- If information is missing, type the correct value in the corresponding cell. The cell is displayed in red if you enter an incorrect format. A pop up explaining the issue appears. Use the pop up to correct the error.
- If one or more columns are not properly mapped, see Map Columns.
Map Columns
If columns are not mapped correctly, use the Map columns button. The Map columns pane shows if your data columns match the required template columns.
- If all columns match, click the Apply mappings button at the bottom of the screen.
- If columns do not match, select the corresponding column from the Template Columns drop-down menu and click Apply mappings.
- To exclude a column from your file, click the Delete icon next to it and then click Apply mappings.
This is useful for templates with extra columns that are not provided by Broadsign.
Import Data
When finished, click the Import button.
If your data still contains issues, the following window appears:
- Click Return to spreadsheet to return to the Review & Finalize page and fix the issue.
- Click Export to get an Excel file with the errors highlighted. The exported file can also be used as a proof of import.
The Broadsign Platform then finishes the import process, ensuring all data is checked and compliant. If you encounter issues while importing, download the error logs by clicking the Download Log File button (see Download Log File) or contact Broadsign Services for assistance.
The Broadsign Platform then updates the static data in the background.
