This article explains how to set up the cortex software on a device and deliver a programmatic campaign through the Vistar ad server. Let's get started by ensuring the following requirements and prerequisites are met.
- Minimum memory: 2 GB (4+ recommended). Minimum storage: 10 GB.
- Supported operating systems: Win 7/10, Linux x64 (any distribution), ChromeOS 71, or WebOS Signage 3.0/3.2 (supported WebOS models: 43SM5KE-BJ, 43SM5KD-BH, 43SM5C-BF)
- Access to the staging trafficking dashboard at staging-trafficking.vistarmedia.comtrafficking.vistarmedia.com.
Plan, activate, and monitor ad campaigns
Pull reporting on ad delivery
- Access to Fleet at fleet.cortexpowered.com.
Manage devices and their behavior
Monitor the network
If you do not have access to the trafficking dashboard, Fleet, or both, please reach out to email@example.com.
Staging Trafficking Dashboard Setup
In order to deliver content from the ad server, you must complete the following steps in the staging trafficking dashboard:
- Log into the staging trafficking dashboard.
- To add a new venue, click Networks in the side navigation bar, then select the network from the Networks table.
- Click Add Venue and enter your venue's information.
If you don't have your own data, you can use the below mock inputs to get started:
- Venue ID: TestVenue
- Name: TestVenue
- Venue Type: Outdoor|Urban Panels
- Screens: 1
- Impressions per spot: 1
- Latitude: 40.7128
- Longitude: -74.0060
- Activation Date: 01/01/2022
- Exchange enabled: Checked
- Direct enabled: Checked
- Click Save. The venue is added to the network and appears in the Venues table.
- To create a new order, click Ad Serving, then click +Order and enter the following information:
- Schedule type: Flexible
- Name: Test Order
- Advertiser: Choose any available advertiser in the dashboard
- Click Save. The order detail view appears.
- To create a new line item, click +Line Item and enter the following information:
- Line item name: Test Line Item
- Priority: House
- Goal: 100,000,000,000 impressions
- CPM: $0.00
- Click Next: Add Targeting, then click Save.
- To reserve the order, click Ad Serving in the side navigation bar, then select the order name in the table with a status of Open.
- Click Reserve in the top-right corner. The Confirm Reservation modal appears. Click Reserve to confirm.
- Click Review & Book to book the order. The Review & Book modal appears. Click Book. The status of the order updates to Booked.
- Click Launch in the top-right corner. The Launch Confirmation modal appears. Click Yes, Launch. The order detail view appears.
- To upload a creative, click the Creatives tab, then click Add Creatives. Click Next, then click Browse Files to upload an image, video, or SWF file.
- Choose a creative with a resolution that matches your test venue. For static creatives, enter 15 for Duration.
- Choose 401(K)s for Category.
- Click Add Creatives. Select the checkbox next to one or more creatives, then click Associate with… The Pick Line Items modal appears.
- Select the checkbox next to Test Line Item and click Save.
- To activate your line item, click the Line Items tab and select the checkbox next to Test Line Item. Click the Actions drop-down list and click Activate.
- Click Confirm to close any warnings.
- Click on Test Line Item. Uncheck Even Pace, then click Save.
In order to connect the Cortex software on a device to the Vistar ad server, you must use the UAS application. Complete the following steps to enable campaign delivery:
- Log into the Fleet Dashboard.
- To create a new network in Fleet, click Networks, then click New in the side navigation bar.
- Enter the network name in the Network field. Use the identical network name that is in the trafficking dashboard. Click Create.
- To create a new strategy and add an application, click Strategies in the side navigation bar, then click New.
- Enter a name in the Strategy Name field. Click +Add to Strategy in the Main Loop section.
- Click the Applications tab, then click +Add next to Vistar Media UAS.
- Click Close to exit the modal, then click Save.
- Click Networks, then click your network's name. Click ⚙Configure, then click Update parameters.
- Click Vistar Media UAS. Enter the API Key and Network ID.
- The API key and Network ID can be found under Networks in the staging trafficking dashboard. Leave Venue ID blank.
- In the bottom-right, click Update.
- Install Cortex on a Windows, Linux, ChromeOS, or LG WebOS TV device.
- After you successfully install the Cortex player, a registration code appears on your device. The six letter code displayed at the center of your device screen is the registration code for this player.
- To manually register the device, click Devices in the side navigation bar, then click New. Enter the following information:
- Registration code: The six letter code displayed at the center of your device screen.
- Network: Click the network drop-down list and select your network.
- Device name: Enter the venue name you used when creating a venue in the trafficking dashboard.
- Click Register. A message appears to confirm that your device was registered and is now included in the device list in Fleet. Your device screen indicates that the player is now registered.
Now that the device is registered, you need to set device level parameters and deploy a strategy to the device. The UAS app connects your device to the Vistar ad server so the Venue ID set as the device parameter must exactly match the venue ID in the staging trafficking dashboard.
- Click Devices. Click the Name of your device.
- Click ⚙Configure, then click Update parameters.
- Enter the Venue ID.
- The venue ID must exactly match the venue ID you set for the venue in the staging trafficking dashboard.
- If your device is not 1920x1080, update Height and Width. Enable Override default application value and enter your height and width values.
- In the bottom-right, click Update.
- To deploy a strategy, click Strategies in the side navigation bar, then click Deploy. The Deploy Strategy view appears. Enter the following information:
- Strategy: Click the drop-down list and select your strategy.
- Target Devices: Click the drop-down list and select your test device.
- Start Date: Deploy Now checked.
- End Date: Keep Running Indefinitely checked.
- Click Deploy. Your device is now scheduled to deploy immediately.
The test campaign starts delivering. 🎉
If there are issues with delivery, please go through troubleshooting below.
- Check if network level parameters are correct.
- Programmatic API Endpoint URL is set to production environment (https://api.vistarmedia.com/api/v1/get_ad/json).
- Check if device level parameters are correct.
- Device level height and width match the height and width of the test creative.
- Mime types includes the test creative's mime type (for example, image/jpeg).
- Check if the test strategy has the Vistar Media UAS application added to the Main Loop.
- Check if the test strategy is deployed to the test device.