Skip to content

Integrations

Broadsign

Connect your Broadsign network to see your screens and publish approved artwork to them.

Where it lives

Broadsign’s pages are in the Player app at player.withmestra.com, under Broadsign in the Connected group of its menu: Overview, Screens and Published. An owner turns Broadsign on in Settings > Integrations in the Mestra hub. Mestra Studio’s publish dialog publishes to it.

What it does

  • Shows every screen and frame in Broadsign with its size and online status, and flags covered frames and stretched artwork.
  • Turns your real screens into the sizes Mestra makes.
  • Publishes approved artwork to the screens you pick, as campaigns in Broadsign.

Mestra never deletes anything in Broadsign and only changes campaigns it made.

Who can do what

  • Owners turn Broadsign on, connect it, replace the token, disconnect, and choose who can publish.
  • Editors link frames to brands, set screen sizes and make format sets. They can publish and go live if an owner allows it.
  • Reviewers can’t publish.

Owners choose each editor’s publishing level under Publishing on Broadsign’s Overview page in the Player app: Can’t publish, Can publish (from an approved review) or Can publish without review (also from a run). Owners can always publish. A size that failed its layout checks is held, and only an owner can publish it, with a reason.

Broadsign has no publishing defaults to set. There’s nothing to choose.

Connect

An owner connects Broadsign once. You need an API token or a client certificate for a Broadsign Control API user.

To publish, use a token for a user that can add content and campaigns. Publishing with a certificate isn’t available yet. You can still connect with one to see your screens.

  1. Open Settings > Integrations, turn on Broadsign and read what Mestra stores, reads and sends. Select Turn on.
  2. Select Open Broadsign. It opens Broadsign’s Overview page in the Player app.
  3. Paste your Broadsign API token into API token and select Connect.

A Broadsign key can do whatever its user can, so keep it safe. Mestra shows only its last few characters after you connect.

Mestra reads your screens, players, day parts, frames, sizes and online status, and which campaigns are playing. It doesn’t send your screen data to the AI provider. After the first connection you land on Screens.

To change the token later, select Replace token on the Connection card.

Screens

The Screens page lists each screen with its frames, sizes and what is playing on them. Select Refresh to read Broadsign again.

  1. Link frames to a brand. Tick the frames, then choose Link to brand….
  2. If a screen’s size isn’t known, select Set size and enter it once. Mestra remembers it.
  3. Select Make a format set to turn the frames into the sizes Mestra makes for that brand.

Each frame can show a check, such as Stretched, Cropped, Covered, Offline, Size needed or OK. Fix the ones that matter before you publish.

Publish

You can publish approved artwork from a run or from a review.

  • From a review: open the review, choose the menu and select Publish to screens. The round needs approved sizes.
  • From a run: open the run and select Publish to screens.

In the Publish to screens dialog:

  1. Check the Start date and End date.
  2. Choose All day, or Custom to pick hours and Slots.
  3. For each size, tick the frames to publish to. A frame with a problem shows it beside the name. Some problems stop you publishing it. Others need a reason in Reason for publishing anyway.
  4. Select Publish.

Studio stays on the page you were on and shows Published. See it in Mestra Player. The link opens Broadsign’s Published page in the Player app.

Publishing makes draft campaigns. A draft is held in Broadsign, so nothing plays until someone chooses Go live.

Publishing the same campaign again after a new approved round swaps the artwork in the existing campaign. If the campaign is already live, you confirm first, and the new artwork plays as soon as Broadsign takes it.

Screens with several frames can’t be published to yet. Mestra shows them, but won’t let you pick them.

The Published page

Published, in the Player app, lists every publish, newest first. Select Show screens to see each size and its frames. Each size has a pill:

  • Sending: Mestra is sending it to Broadsign.
  • Draft: it’s in Broadsign but won’t play yet.
  • Sent to screens: it’s live in Broadsign.
  • Replaced: newer artwork took its place.
  • Ended: its dates have passed, or it was ended.
  • Failed: it didn’t go through. The reason shows beside it.

Go live and Retry the rest

  1. On the publish, select Go live.
  2. Select Send to screens. The campaigns start playing on their dates.

If some sizes failed, select Retry the rest. Mestra sends only what didn’t go through. If a publish is partly ready when you go live, Mestra says how many it sent and how many weren’t ready.

Report plays

Turn on Report plays to see how often your artwork played. Only an owner can turn it on.

  1. In the Player app, open Broadsign > Overview.
  2. In the Report plays card, select Turn on.

There’s nothing to set up in Broadsign. Mestra reads the play counts from Broadsign every few hours. The card shows Last checked with its date, or Not checked yet.

Once plays arrive, a size shows Played, with the number of plays and the last day it played. Broadsign gives daily totals for all screens together, so Mestra doesn’t show the number of screens or play times.

While Report plays is on, the Published page shows Plays reported since and the date reporting started.

On the Rules page, each version that has plays shows how many times it played under Versions. When artwork is replaced, the plays on the day it changed count for the new artwork.

Turn off stops reading new counts at once. The plays Mestra already has stay.

Dynamic variants

Broadsign is one of the places dynamic variants publish, as is Doohly. Publish a campaign from its Publish tab with Publish to Broadsign, and Mestra switches the booking between your approved, checked variants. See Dynamic variants.

Network bookings

If your organisation runs a Mestra Network, bookings on Broadsign screens work as they do on the other connected screens.

  • Free slots show. A booking shows how many slots are free on each screen, hour by hour. Mestra works them out from the screen’s loop length and slot length in Broadsign, less every campaign already on the screen, including the ones booked in Broadsign itself, so a time that shows as free is free.
  • A request holds its times. The times are held until your staff answer, as a held campaign in Broadsign that plays nothing. Mestra ends the held campaign if the request is declined, changed or runs out of time.
  • An approval publishes. When staff approve a booking, Mestra puts the approved artwork on the held campaign, and it goes live as a Broadsign campaign does (see Publish above).

If a screen’s loop policy in Broadsign has no loop length or slot length, its free slots aren’t shown and a booking on it is a request.

Disconnect

An owner selects Disconnect on the Connection card, then confirms. Mestra forgets your token or certificate and who may publish. Your screens, links, sizes, publish records and play records stay as history. Campaigns already in Broadsign stay as they are, and a publish in progress stops. You can also revoke the token or certificate in Broadsign.

Troubleshooting

I can’t publish. Check that you connected with an API token, not a certificate, and that its user can add content and campaigns in Broadsign. Then check with an owner that your publishing level isn’t Can’t publish.

A screen won’t let me pick it. It has several frames. Publishing to those isn’t available yet.

A campaign is in Broadsign but isn’t playing. It’s a draft. Select Go live on the Published page.