Broadsign Reach

This tutorial provides steps for setting up Broadsign Control Administrator and Broadsign Control Player to support your Broadsign Reach domain.

Note: If you have yet to get started with Broadsign Reach, please contact Broadsign Services.

Note: If you are already a Broadsign Reach client, then you have access to its product-specific documentation. This tutorial focuses only on those elements that require setup in Broadsign Control Administrator.

Prerequisites

Broadsign Reach requires that you be familiar with the following resources in Broadsign Control Administrator:

• Configuration Profiles - Players
• Ad Copies
• Display Units

Workflow

In general, the workflow to enable Broadsign Reach in Broadsign Control Administrator is the following:

• Step One: Configure Broadsign Control Player
• Step Two: Create Broadsign Reach Content
• Step Three: Bulk Import Display Unit Addresses

In order for Broadsign Control Player to grab content from Broadsign Reach, you need to configure your player.

To configure the player:

1. Create a configuration.

2. Create a player configuration profile.

   Note: Ensure that both your player and your player configuration profile are v12.0 or higher.

3. Open the Configuration Profile Properties, and go to Add-ons > Reach. See The Reach Tab.



4. Configure the Broadsign Reach settings. For our example, we will configure the following:

1. Select Enable Broadsign Reach Integration.

   Note: If Broadsign has yet to enable this service on your domain, you will be unable to select this option.

2. Enter your Broadsign Reach API key. For more details, see Find the Broadsign Reach API Key in the Broadsign Reach documentation.
3. If you want to control audio at the ad copy level, select Allow Audio. See Step Two: Create Broadsign Reach Content.
4. If you want Broadsign Control Player to respect existing network controls, select Respect network controls. See Network Control.

If Bypass Network Controls for Bid Requests and Proof of Plays is selected, players can send requests to the Broadsign Reach server to get winning bids during restricted hours. Players can also send Proof of Plays while blocking pre-caching requests. This can be used, for example, to restrict downloads of creatives (both pre-caching and on-demand) to occur only during off hours, while still allowing Broadsign Reach Ad Requests and Broadsign Reach Proof of Plays at all times.

5. If you want to allow pre-caching of approved Broadsign Reach creatives (ad copies), select Pre-cache Reach creatives.
6. Select when the Ad Requests should be sent to Broadsign Reach in the Acquire winning deals drop-down menu.

You have the choice between Just in Time (which is the default value) and At the beginning of the loop. This feature is available on Broadsign Control Player Configuration profiles v13.2+. For more information, see Sending a Broadsign Reach Ad Request and Ad Request in Broadsign Reach.

5. Click OK or Apply.
6. In the Configuration Properties, go to the Resources tab.
7. To associate this configuration to a player, click Add.
8. From the Select Resources dialogue box, select the player or players that will play your programmatic Broadsign Reach content.



This player can now receive content from Broadsign Reach.

Broadsign Reach ad copies create a holding place which a DSP (demand-side platform) will fill during real-time-bidding. The creation of this ad copy is required for integration with Broadsign Reach.

For more information, see Broadsign Reach Content.

To add Broadsign Reach content:

To add Broadsign Reach content, use one of the following methods:

1. Go to the Schedules ribbon and select the arrow on the Ad Copy icon. Then, from the drop-down menu, select Broadsign Reach.

   

2. From the resource tabs on the left, select Ad Copies. Then, right-click anywhere in the work area. From the contextual menu, select New, then select Broadsign Reach Content.

   

By default, the Add Broadsign Reach Content Wizard contains the following pages:

• Welcome – Name the Broadsign Reach content.

  

• Add Broadsign Reach Content Wizard – The default value is to allow any Broadsign Reach deals to win a bid.

  If you want only specific Broadsign Reach deals to win a bid, check the Only these deals can win option and enter the allowed Broadsign Reach deals IDs in the field. The deals IDs must be comma-separated. When scheduled to play, the specific deal ID ad copies can only fill a slot with bidders responding to those deals.

  

In Broadsign Reach, the location of your screens and display units is very important. To save you time setting up your domain, you can bulk import display unit location data.

You will need to import .csv files containing the following information:

• Display Unit ID
• Display Unit Name
• Folder Name
• External ID
• Location Code
• Address (in Google format)
• Latitude
• Longitude

Ensure that your .csv files are in the following format:

[Display Unit ID#], [Display Unit Name], [Folder Name], [External ID#], [Location Code], [Address], [Latitude], [Longitude]

Here is a sample .csv file:

4527458, JFK Terminal 1, Folder Name?, 6080, Location Code?, "705 Rue Sainte-Catherine, Montreal, QC H3B 4G5", 45.5027544, -73.5714715

To bulk import display unit addresses:

Note: The process for exporting display unit addresses is basically the same. From the contextual menu, select Export Addresses.

1. Select a display unit from your domain.

2. In the Work Area, right-click anywhere. The contextual menu appears. From the menu, select Import Addresses.

   

3. The Import Display Unit Addresses wizard opens. To import your .csv file, click Select CSV File.

   

4. Windows File Explorer opens.

Navigate to the location of your .csv file.



5. Click Open. On the Import Display Unit Addresses page, click Next.

The Import Results page appears, along with a status of the import.



6. In this example, of the five display units we tried to update, all but one were successful. For more details, click OK.

Note: If you are a client of Broadsign Direct or Broadsign Reach, display units with complete address details (i.e., display unit ID#, address, latitude, and longitude) will appear in your domain.