Skip to main content

Using Player Properties as a Data Feed in your Templates

Written by Giuseppe

In Qompose, a special type of Data Feed Connector is accessible via the Template Designer called PlayerProperties. This built-in data feed allows you to bind values from a Player's own properties directly onto your canvas and template designs.

What is the PlayerProperties feed?

Unlike other Data Feeds, PlayerProperties isn't something you configure yourself — it's automatically available for every Player on your Network, with no setup required in the Data Feed Manager. Instead of pulling from an external source, it pulls directly from that Player's own configured properties (its name, location, contact details, tags, and more).

Please Note

The value of a PlayerProperties field is resolved at playback time, based on whichever Player is actually displaying the Template. This means the same Template — using the same field — will automatically show different values on different Players, without you needing to build a separate Template for each one.

Accessing the PlayerProperties feed

  1. Open your Template within the Template Designer

  2. Click on Datafeed in the left-hand navigation

  3. Select PlayerProperties from the feed list

Adding a field to your Template

  • Find the field you'd like to use in the Column list

  • Click the Apply button below the Add to scene column

This places the field directly onto your canvas as a dynamic text element, which you can then reposition, resize, and restyle like any other object.

Available fields

The following Player properties are available to bind onto your canvas:

  • #Index and #Page — internal reference values

  • GroupName — the name of the Group this Player belongs to

  • PlayerName — the Player's own name

  • Company, Contact, Address, City, State, Zip, Country — the Player's configured site/contact details

  • Latitude and Longitude — the Player's configured location

  • TimeZone — the Player's configured time zone

  • Telephone and Mobile — configured contact numbers

  • Tags — any Tags assigned to the Player

  • Variables — any custom Player-level variables configured on this device

  • SerialNumber and MediaPlayerSerial — device identification values

  • Views — audience/viewership data associated with the Player, if available

Top Tip

Because this data resolves per-Player, PlayerProperties fields are especially useful for building a single "one-template, many-Players" design — for example, a store locator Template that automatically shows the correct address and contact number for whichever Player it's playing on.

Formatting and positioning a PlayerProperties field

Once added to your canvas, a PlayerProperties field behaves like any other text element in a Termplate — its position, size, and styling can be adjusted from its Properties panel.

For more on formatting field values (such as applying conditional rules or number/date formatting), see our article on What's New in the Data Feed Manager.

Summary

With PlayerProperties available directly in the Template Designer, you're able to build a single Template that automatically personalises itself to whichever Player it's displayed on — no configuration required, and no need to duplicate your design per Player.

Did this answer your question?