minutes de lecture
You can use the Bulk Upload flow to add a large number of screens to your Third-Party Players inventory by using a .csv data file.
Vous devez définir correctement des paramètres spécifiques pour rendre votre écran transactable par programmation. Voir Statut de transactabilité programmatique des écrans.
Note : La page Inventory est accessible aux utilisateurs disposant des rôles Admin, Direct Sales Admin, Programmatic Adminet Static Admin.
You can add a large number of screens to your Third-Party Players inventory by using a .csv file. We provide a screen data template for you.
To bulk upload screens to your Third-Party Players inventory:
Digital Inventory
Creating the .csv file requires three general steps:
- Select and export the screen data template from the Inventory list.
This template contains all the current screen information. See Step 1 – Export the Screen Data Template.
- Add the screen data information by respecting the format.
You don't need to enter the information all at once. You can enter a part of the information and enter the rest later. See Step 2 – Enter Your Screen Data.
-
Import the file, now containing your screen data, back into your network. See Step 3 – Import the File into Your Domain.
Note : Vous devez suivre le format du modèle de données d'écran. Sinon, Broadsign considérera le fichier comme invalide.
The screens data template provides the allowable columns and correct format.
To export the screen data template:
Digital Inventory
- From the Inventory list, click Add Inventory.
- In the Update a File window, click Download Excel template to download the screens data template.
Your system will download a .csv file.
The file name is inventory-sideloaded-template.xlsx.
Note : Vous devez suivre le format du modèle de données d'écran. Sinon, Broadsign considérera le fichier comme invalide.
Vous devez définir correctement des paramètres spécifiques pour rendre votre écran transactable par programmation. Voir Statut de transactabilité programmatique des écrans.
To open the screen data file:
- Open the screen data
.csvfile that you downloaded (Broadsign recommends Microsoft Excel or similar spreadsheet program). - Enter your screen data as described in Step 2B – Format the Screens File.
The screens data file includes several columns.
| Lettre de la colonne | Nom de la colonne | Description |
|---|---|---|
| A | unified_inventory_id |
ID used to represent the panel in the unified inventory. It is read-only. |
| B | programmatic_device_id |
Device ID used in programmatic campaigns. |
| C | screen_reference_id |
External reference ID available to the customer to identify the screen. This ID will be used to match the screen and update it if it already exists. Ce champ est limité à 255 caractères. C'est obligatoire. |
| D | screen_name | The name of the screen. Il doit être unique. The field is limited to 150 characters. C'est obligatoire. |
| E | screen_buyer_facing_name |
Nom court et descriptif de l'écran ou de la face (emplacement, spécialité, etc.). Il doit être unique. Exemple : Écran Times Square |
| F | orientation |
Cardinal orientation of the screen. Select between UNKNOWN, NORTH, NORTH_EAST, EAST, SOUTH_EAST, SOUTH, SOUTH_WEST, WEST, and NORTH_WEST. Example: NORTH_EAST |
| G | image_urls |
URL pour récupérer une image à afficher sur l'écran. L'URL doit pointer vers une URL d'image directement hébergée et non vers un lien menant à la page web contenant l'image. Vous pouvez ajouter plusieurs URL en les séparant par un point-virgule (« ; »). Exemples d'URL valides :
Exemples d'URL non-valides :
|
| H | size_diagonal_value |
Taille diagonale de l'écran dans l'unité de mesure définie dans Diagonal Size Unit. Il doit s'agir d'une valeur supérieure à 0. Exemple : 20 |
| I | size_diagonal_unit |
Unité de mesure pour la taille diagonale de l'écran. Choisissez entre :
Exemple : in |
| J | screen_inactivity_schedules |
List of schedules that determine when the screen is inactive. Each schedule must be separated by the "|" character. The field uses the following structure:
|
| K | screen_attached_attributes |
List of Non-Broadsign Attributes associated with the screen. The field uses the following structure:
Example: color:yellow;size:large |
| P | loop_duration_ms |
Loop duration of the schedule, in milliseconds. C'est obligatoire. Example: 10000 |
| Q | slot_duration_ms |
Default ad slot length in milliseconds. Il doit s'agir d'une valeur supérieure à 0. C'est obligatoire. Exemple : 10000 |
| R | minimum_slot_duration_ms |
Durée minimale de l'espace publicitaire en millisecondes. Il doit s'agir d'une valeur supérieure à 0. Exemple : 10000 |
| S | maximum_slot_duration_ms |
Durée maximale de l'espace publicitaire en millisecondes. Elle ne doit pas être inférieure à la valeur Min Ad Duration. Exemple : 30000 |
| T | hivestack_id | Identifiant d'écran dans Hivestack. |
| U | vistar_id | Identifiant d'écran dans Vistar. |
| V | place_exchange_id | Screen Identifier in Place Exchange. |
| W | floor_cpms |
Screen CPM floor in the following currencies, separated by semi-colons:
C'est un champ d'information dans lequel l'éditeur doit ajouter un CPM moyen pour l'écran. La tarification réelle sera définie au niveau du « Deal ID ». Example: USD:5;CAD:5;EUR:5;AUD:5;GBP:5 |
| X | screen_type |
Type de l'écran utilisé. Le type d'écran est utilisé pour soutenir les efforts de durabilité de Broadsign. Les valeurs acceptées sont :
Exemple : 101 C'est obligatoire. |
| Y | allowed_motion |
Si les contenus de type motion sont autorisés ou non à être diffusés sur cet écran. C'est obligatoire. Exemple : true |
| Z | allow_deal_creation_on_users_behalf |
Indicates whether Broadsign can create programmatic deals that include this screen without prior authorization. |
| AA | allowed_ad_type |
Types de publicités pris en charge par la Plateforme Broadsign. Si plusieurs types sont pris en charge, utilisez un « ; » pour les séparer.
Exemple : static;video;html C'est obligatoire. |
| AB | pixel_resolution_width |
The width of the screen in pixels. C'est obligatoire. Example: 1920 |
| AC | pixel_resolution_height |
The height of the screen in pixels. C'est obligatoire. Example: 1080 |
| AD | audience_data_sources |
Nom de la source de données d'audience, séparé par des « ; ». Consultez Sources d'audience pour connaître les sources prises en charge. Exemple : ACI;Blimp C'est obligatoire. |
| AE | audience_calculation_method |
Audience calculation method.
Chaque publicité au sein d'une boucle reçoit le même nombre d'impressions diffusées.
L'audience par heure doit être calculée au prorata de la durée réelle de l'emplacement. En d'autres termes, une formule au prorata tient compte des durées de créneau variables et de leur impact sur le calcul des impressions. C'est obligatoire. |
| AF | venue_name |
Nom ou description du lieu. C'est obligatoire. |
| AG | venue_reference_id |
An external reference ID provide by the customer to identify the venue. If no ID is provided, it will be automatically generated. |
| AH | venue_type |
Venue type ID. Consultez les options dans Types de lieux. Exemple : 80701 C'est obligatoire. |
| AI | venue_address |
Address of the venue where the screen is located. Example: 21 Greens Road RD 2 |
| AJ | venue_city |
City of the venue where the screen is located. Example: Boston |
| AK | venue_state |
State of the venue where the screen is located. Example: Massachusetts |
| AL | venue_country |
Country of the venue where the screen is located. Example: United States |
| AM | venue_postal_code |
Postal code of the venue where the screen is located. Example: 90210 |
| AN | venue_latitude |
Latitude coordinates of the venue where the screen is located, in decimal degrees. C'est obligatoire. Example: 48.829268 |
| AO | venue_longitude |
Longitude coordinates of the venue where the screen is located, in decimal degrees. C'est obligatoire. Example: 2.355219 |
| AP | timezone |
Time zone of the venue where the screen is located. C'est obligatoire. Example: America/New_York |
| AQ | dma |
Designated Market Area (mesure Nielsen). Applicable uniquement aux réseaux des États-Unis. Exemple : 501 |
| AR | availability_share |
The percentage share of the loop duration for a given screen. Example: 0.51 |
| AS | private_auction_only |
Whether the screen is limited to private auction only. |
| AT | auction_type |
Auction type for the screen:
For more information, see Comprendre les deals sur Place Exchange. |
| AU | unit_count |
Number of units for the screen. |
| AV | external_ids |
External identifiers associated with the screen. The field uses the following structure:
|
| AW | asset_type |
Type of asset for the screen. It is automatically set to Digital. |
| AX | impression_four_weeks |
Total impression count over a four-week period. |
| AY | impression_multiplier |
Multiplicateur d'impressions moyen pour l'écran, soit le nombre moyen d'impressions visibles par espace publicitaire. |
| AZ | open_exchange_enabled |
Si cet écran est transactionnel ou non sur l'Open Exchange de notre solution Campagnes programmatiques. Si activé, les prix plancher sont directement extraits de l'objet écran, les écrans seront visibles pour les DSP intégrées et transactionnels sans « Deal ID ». Les valeurs d'activation prises en charge sont :
Les valeurs de désactivation prises en charge sont :
|
Once the screen data file has been properly filled out, you can import it into the Broadsign Platform. If you encounter issues when importing the file, contact Broadsign Services.
The Upload a File screen allows you to select your screen data file and upload it in the system.
To upload the screen 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, .xls, or .xlsx file with any set of columns, as long as it has one record per row.
The Review & Finalize screen allows you to check the imported screen data to ensure accuracy
Review and Edit Data
You can do the following in the Review & Finalize screen:
- Edit Screen Data – Make changes to the screen data in the table by double-clicking the cell to edit. For information on the values accepted for each cell, see Step 2B – Format the Screens File.
- Display Issues – Show only the rows with issues by clicking Rows with issues.
- In the main part of the Review & Finalize screen, where problematic cells are highlighted.
- In the All issues pane after clicking the red circle icon, which lists all issues. Clicking an issue automatically takes you to the corresponding cell in the imported file to fix it.
- Correct Errors – Correct a problematic cell:
- Click a cell with an issue to get information on the problem and correct it.
- Double-click a problematic cell to edit it. The cell displays the possible values.
- Enter Missing Data – 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.
- Map Columns – If one or more columns are not properly mapped, see Map Columns.
Issues in your imported file are displayed in red in two locations:
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
Une fois terminé, cliquez sur le bouton Import.
Si vos données présentent encore des problèmes, la fenêtre suivante s'affiche :
- Cliquez sur Fix remaining errors pour revenir à la page Review & Finalize et résoudre le problème.
- Cliquez sur Import rows pour poursuivre le processus d'importation. La ligne contenant les données problématiques sera ignorée et ne sera pas importée. Les lignes valides seront importées.
La Plateforme Broadsign termine le processus d'importation et affiche votre inventaire d'écrans mis à jour.
Maintenant que vous avez mis à jour votre inventaire d'écrans, vous pouvez effectuer les opérations suivantes :
