On-Board Screens in the Guaranteed Campaigns Module

The following sections describe the configuration required in the Content and Network Management solution to properly on-board screens in the Guaranteed Campaigns module:

The following sections describe configuration to perform in the Guaranteed Campaigns module:

Display Units, Frames, and Day Parts in the Content and Network Management solution are translated into screens in Guaranteed Campaigns. The screen name in Guaranteed Campaigns is created as follows:

  • If there is one Frame, or if there is more than one Frame but only one is sellable:
    • Guaranteed Campaigns Screen Name = Display Unit Name
  • If there is more than one Frame in the Content and Network Management solution:
    • Guaranteed Campaigns Screen Name = Display Unit Name _ Frame Name

For information on loop policy configuration in the Content and Network Management solution, see Loop Policies.

Overbooking is allowed.

To configure the Loop Policy (Content and Network Management):

Guaranteed Campaigns

  1. Open the Content and Network Management solution.
  2. Open the Loop Policies resources.
  3. From the list panel, select a loop policy. Then, from the view bar, select Edit.

  4. In the Loop Policy Properties window, click the General section, and then the Duration tab.
  5. Uncheck the No time limit option.

  6. Click Apply.
  7. Click the Settings section, and then the Variables tab.
  8. Click Add on the right to add a new variable.

  9. In the Edit_Parameter window, enter the following:
    • Variable name: "audience_calculation_method"
    • Value: "prorated" or "dwell", depending on your desired calculation method

    For more details on which value to use, see Impressions Formulas in the Content and Network Management documentation.

  10. In the Overbooking tab, select This loop policy allows overbooking.

  11. Click OK or Apply.

The Guaranteed Campaigns module requires to have one player connected to one display unit. If you have many players connected to the same display unit, then we suggest to clone the display unit, including the scheduling information, and assign each player to one display unit.

For information on Display Unit configuration in the Content and Network Management solution, see Display Units.

To configure the Display Unit (Content and Network Management):

Guaranteed Campaigns

  1. Open the Content and Network Management solution.
  2. Open the Display Unit resources.
  3. From the list panel, select a Display Unit. Then, from the view bar, select Edit.

  4. In the Display Unit Properties window, click the Settings section, and then the Timezone tab.
  5. Click Custom Timezone, then select the appropriate time zone for your Display Unit in the drop-down menu.

  6. Click Apply.
  7. Click the Criteria and Conditions tab.
  8. If applicable, associate criteria and conditions with the Display Unit. For more information, see Criteria and Conditions in the Content and Network Management documentation.
  9. Click the Display Type tab.
  10. If applicable, associate a Display Type with the Display Unit. For more information, or if you need to create a Display Type, see Display Types in the Content and Network Management documentation.

    11. Warning: Changing the Display Type under Display Unit (see Display Unit Properties - Display Type Settings) in the Content and Network Management solution creates a new screen in the Guaranteed Campaigns module. The new screen will have no pressure on it as it is considered a brand new entity and any campaigns targeting the old screen will not be targeting the new screen.

  11. Click the General section, and then the Address tab.
  12. Enter the address of the Display Unit.

  13. Click Apply.
  14. Click the Day Parts section, and then the Day Parts tab. Add day parts to your setting. You can add a Ticker with a loop policy unlimited to the deny list. For more information, see Day Parts.

    15. Warning: Changing the Geometry of the Frame (see Day Parts Properties - Frames) in the Content and Network Management solution creates a new screen in the Guaranteed Campaigns module with that geometry. The new screen will have no pressure on it as it is considered a brand new entity and any campaigns targeting the old screen will not be targeting the new screen.

  15. Click OK or Apply.

For information on external saturation configuration in the Content and Network Management solution, see External Saturation Schedule.

The external Saturation Control URL must be entered in the Content and Network Management Monitor Sync configuration.

Note: Guaranteed Campaigns settings are available only to users assigned the Admin or Direct Sales Admin role. For more information, see User Permissions.

To find the Saturation Control URL:

Guaranteed Campaigns

  1. Access the Settings section.
  2. In the Guaranteed tab of the Settings section, select Digital Inventory.
  3. In the Saturation Control part, select the URL and click Copy.

    4. For more details, see Saturation Control.

Note: Any configuration profile change will cause a player restart, so it is suggested to make these changes during low-traffic or off hours.

To enable external saturation API (Content and Network Management):

Guaranteed Campaigns

  1. Open the Content and Network Management solution.
  2. Open the Configurations resources.
  3. From the list panel, select a configuration. Then, from the view bar, select Edit.

  4. In the Configuration Properties window, click the Configuration Profiles tab.
  5. Select a configuration, then click Edit.

  6. Click Settings.
  7. Enable the external saturation API by specifying the local path to external saturation schedule in the Local file path field. This allows you to specify the path to the file that will control the saturation values of campaigns in the player.

  8. Click Apply.
  9. Click the Monitor Sync section.
  10. Add a new synchronization URL by clicking Add.

  11. In the Synchronization URL window that is displayed, do the following:
    1. In the Remote Url field, paste the URL that you have copied from the Domain Settings in the Guaranteed Campaigns module. See Find the Guaranteed Campaigns External Saturation Control URL for more details.
    2. In the Destination path field, enter the same local path as the external saturation schedule specified in Step 7.
    3. Check Use the URL variable.

  12. Click OK in all opened windows.

For information on audience configuration in the Content and Network Management solution, see Integrations Section.

The Audience Integration URL must be entered in the Content and Network Management Monitor Sync configuration to sync audience data.

Note: Guaranteed Campaigns settings are available only to users assigned the Admin or Direct Sales Admin role. For more information, see User Permissions.

To find the Audience Integration URL:

Guaranteed Campaigns

  1. Access the Settings section.
  2. In the Guaranteed tab of the Settings section, select General.
  3. In the Audience Integration part, select the URL and click Copy.

    4. For more details, see Audience integration.

Note: Any configuration profile change will cause a player restart, so it is suggested to make these changes during low-traffic or off hours.

To enable the Audience API (Content and Network Management):

Guaranteed Campaigns

  1. Open the Content and Network Management solution.
  2. Open the Configurations resources.
  3. From the list panel, select a configuration. Then, from the view bar, select Edit.

  4. In the Configuration Properties window, click the Configuration Profiles tab.
  5. Select a configuration, then click Edit.

  6. Click Integrations.

    7. Note: The following step differs depending on the version of Content and Network Management that you are using.

  7. If you are using Content and Network Management v13.2 and higher: Enable the Audience API as follows:
    1. In the Audience tab, click Enable Audience Source.
    2. Click Use Statistical Audience.
    3. Specify the path to the audience .csv file in the Player local path to CSV file field.

  8. If you are using Content and Network Management v13.1.x and lower: Enable the Audience API as follows:
    1. In the Audience API tab, click Enable Audience API.
    2. Specify the path to the audience .csv file in the Path to CSV File field.

  9. Click Apply.
  10. Click the Monitor Sync section.
  11. Add a new sync with the audience by clicking Add.

  12. In the Synchronization URL window that is displayed, do the following:
    • In the Remote Url field, paste the URL that you have copied from the Domain Settings in the Guaranteed Campaigns module. See Find the Guaranteed Campaigns Audience Integration URL for more details.
    • In the Destination path field, enter the same path as the audience .csv file specified in Step 7.
    • Check Use the URL variable.

  13. Click OK in all opened windows.

Add the Display Unit Folder to the Allow List

Guaranteed Campaigns

Once all configuration is finalized, contact Broadsign Services to add your Display Units folder to the allow list in the Content and Network Management solution. We need to sync selected display units from your Content and Network Management domain with Guaranteed Campaigns. Any resources (including sub-folders) that appear in this folder will sync with your domain on Guaranteed Campaigns.

Warning: Be sure to only add folders to the allow list that contain display units that are in production. Refrain from including test resources in the folders added to the allow list.

Warning: Before adding the Display Unit folder to the allow list, ensure that the Display Type and Geometry of the Frame are all set. Changing these settings after adding the folder to the allow list creates a new screen in the Guaranteed Campaigns module, and any campaigns targeting the old screen will not be targeting the new screen. For more information, see Configure the Display Unit.

Add the Criteria Folder to the Allow List

Guaranteed Campaigns

Once all configuration is finalized, contact Broadsign Services to add your Criteria folder to the allow list in Content and Network Management. We need to sync selected criteria from your Content and Network Management domain with Guaranteed Campaigns. Any resources (including sub-folders) that appear in this folder will sync with your domain on Guaranteed Campaigns.

Warning: Be sure to only add folders to the allow list that contain criteria that are in production. Refrain from including test resources in the folders added to the allow list.

You must add audience data to your screen in the Guaranteed Campaigns module. For more information, see Update the Audience Information.

To properly calculate Impressions or Budget Goal in the Guaranteed Campaigns module, you must add at least one digital rate card. For more information, see Add and Edit Rate Cards.