Las variables dinámicas de URL te permiten insertar valores específicos del reproductor en las URLs automáticamente. Úsalas para enviar información del dispositivo a APIs, feeds de contenido, sistemas de análisis o paneles personalizados.
Esto te permite:
- Pasar atributos del reproductor dinámicamente sin entrada manual
- Personalizar solicitudes de datos por dispositivo
- Activar reglas de contenido o flujos de trabajo de API basados en metadatos de la pantalla
- Usar etiquetas personalizadas para definir lógica de negocio (ID de tienda, zona, región, canal, etc.)
Nota: Esta función se usa con la app Website/URL. Consulta App Website/URL.
Variables Disponibles
| Variable | Descripción |
|---|---|
{player.id} | ID único del reproductor EasySignage |
{player.serial} | Número de serie del dispositivo (si está disponible) |
{player.name} | Nombre del reproductor |
{player.manufacturer} | Fabricante del dispositivo (Samsung, LG, Android, etc.) |
{player.osPlatform} | Sistema operativo / plataforma |
{player.tags.all} | Todas las etiquetas en formato key:value, separadas por coma |
{player.tags.key} | Valor de etiqueta por clave (ejemplo a continuación) |
Las etiquetas distinguen entre mayúsculas y minúsculas. Usa claves en minúsculas cuando sea posible.
Uso de Etiquetas
Las etiquetas te permiten establecer metadatos personalizados para cada reproductor.
Ejemplo de etiquetas agregadas a un reproductor:
store:AU‑001
zone:MenuBoard
city:Sydney
| Plantilla | Resultado |
|---|---|
{player.tags.store} | AU‑001 |
{player.tags.zone} | MenuBoard |
{player.tags.city} | Sydney |
{player.tags.all} | store:AU‑001,zone:MenuBoard,city:Sydney |
Las etiquetas se escriben como
key:value. Puedes agregar múltiples etiquetas por reproductor.
Ejemplo de Uso de URL
https://example.com/sync?player={player.id}&store={player.tags.store}
Usar múltiples variables de etiquetas
https://example.com/{player.tags.store}/{player.tags.zone}
Enviar todas las etiquetas
https://example.com?tags={player.tags.all}
Probar tus Variables
Puedes previsualizar cómo se expanden las variables usando nuestra herramienta de prueba:
url-variable-tester.easysignage.com
Ejemplo de Prueba
Plantilla:
https://url-variable-tester.easysignage.com?device={player.id}&store={player.tags.store}
Ejemplo de resultado del probador:
https://url-variable-tester.easysignage.com?device=PL12345&store=AU‑001
Usa esta herramienta para verificar los formatos de URL antes de publicar.
Mejores Prácticas
- Usa claves de etiquetas en minúsculas:
store,zone,channel - Evita espacios — usa
-o_:store‑id:001 - Mantén los valores de etiquetas cortos y limpios
- Prueba las URLs usando la herramienta en línea
Resumen
Las variables dinámicas te permiten:
- Automatizar flujos de trabajo de contenido conscientes del dispositivo
- Construir redes de señalización inteligentes y escalables
- Integrar con APIs fácilmente