Las variables dinámicas de URL insertan los datos de cada pantalla en una dirección web. Escriba una variable como {player.id} o {player.tags.store} en la URL y cada pantalla la sustituye por su propio valor al cargar la página. Úselas para enviar datos de la pantalla a API, feeds de contenido, analítica o sus propios paneles, de modo que una misma lista de reproducción muestre contenido distinto en cada pantalla.
Nota: Las variables funcionan en la aplicación Sitio web y en las demás aplicaciones que cargan una página web desde una URL.
Variables disponibles
| Variable | Valor |
|---|---|
{player.id} | El ID del reproductor de EasySignage |
{player.name} | El nombre de la pantalla |
{player.serial} | El número de serie del dispositivo, si el dispositivo lo indica |
{player.manufacturer} | El fabricante del dispositivo, si el dispositivo lo indica |
{player.osPlatform} | El sistema operativo del dispositivo, si el dispositivo lo indica |
{player.tags.key} | El valor de la etiqueta key:value de la pantalla, por ejemplo {player.tags.store} |
{player.tags.all} | Todas las etiquetas de la pantalla, separadas por comas |
- Los valores se codifican para URL automáticamente.
- Si una pantalla no tiene valor para una variable, se sustituye por nada. Para usar un valor por defecto, añádalo después de
|:{player.tags.store|default}. - Los nombres de las etiquetas distinguen entre mayúsculas y minúsculas.
Usar etiquetas
Añada etiquetas a una pantalla con el formato key:value. Consulte Pantallas. Por ejemplo:
store:AU-001
zone:MenuBoard
city:Sydney
| Variable | Se convierte en |
|---|---|
{player.tags.store} | AU-001 |
{player.tags.zone} | MenuBoard |
{player.tags.city} | Sydney |
{player.tags.all} | store:AU-001,zone:MenuBoard,city:Sydney |
Solo las etiquetas escritas como key:value se pueden usar por su nombre. Una etiqueta sin dos puntos, como lobby, solo se incluye en {player.tags.all}.
Ejemplos
Enviar el ID del reproductor y la tienda:
https://example.com/sync?player={player.id}&store={player.tags.store}
Usar etiquetas en la ruta:
https://example.com/{player.tags.store}/{player.tags.zone}
Enviar todas las etiquetas:
https://example.com?tags={player.tags.all}
Probar las variables
Vea cómo se expande una URL con la herramienta de prueba: url-variable-tester.easysignage.com.
Por ejemplo, la plantilla:
https://url-variable-tester.easysignage.com?device={player.id}&store={player.tags.store}
se expande en una pantalla a algo como:
https://url-variable-tester.easysignage.com?device=player_abc123&store=AU-001
Buenas prácticas
- Use nombres de etiqueta cortos y en minúsculas, como
store,zoneochannel. - Evite los espacios en los valores de las etiquetas: use
-o_. - Dé un valor por defecto con
|a las variables importantes, para que la URL funcione también en pantallas sin esa etiqueta. - Pruebe sus URL con la herramienta de prueba antes de publicar.