Cómo configurar un Data Source de Mecánicas de participación

Este tipo de Data Source se utiliza para conectar una Mecánca y luego integrar sus datos a través de nuestro Middleware / Viz Social Plugin con tu sistema de gráficas, lo que te permite mostrar los resultados en pantalla en tiempo real.

Las Mecánicas que puedes conectar a esta fuente de datos son Poll, Scoring‍, Votos‍, Twitter Poll‍, Facebook Live, Story.


Para aprender cómo crear un Broadcast Data Source, haz clic aquí.

1. Configuración general

  • Nombre (1): Como buena práctica recomendamos nombrar tu Data Source de Mecánicas para que tu y tus compañeros de equipo puedan identificarlo para su uso posterior.

  • Mecánicas (2): Selecciona la mecánica que deseas integrar con tu sistema gráfico. Puedes elegir cualquier mecánica de tu experiencia actual u otras.

  • Título Custom (3): en el XML o base de datos; aparece en el campo/columna title.

  • Call to Action (4): Hazle a tu audiencia saber dónde deben ir para participar, por ejemplo, vote por su participante favorito en www.xxx.com.

    Configuraciones adicionales (5)


  • Poll a exponer: se refiere a los datos expuestos en el XML. Recomendamos configurarlo como Actual, de esta forma si tienes en la misma Mecánica múltiples Poll, Scoring‍, Votos, el XML solo expone la activa.

  • Decimales del Porcentaje: puedes elegir el número de decimales que deseas mostrar. Desde 0 hasta 2.

  • Formato de números: De acuerdo al idioma seleccionado, el separador de miles será un punto (.) O una coma (,). Para obtener información adicional, haz clic aquí‍.

2. Integración

  • Tipo de integración (1): Selecciona cómo deseas integrar los datos según el sistema gráfico que tengas. Si no aparece en la lista, haz clic en otros.

Integración Vizrt

Las integraciones con Vizrt se pueden realizar a través de:

  • Flowics Viz Social Plugin (FeedStreamer), elige Vizrt en el menú desplegable.
  • Flowics Middleware + Data Reader, elige otros del menú desplegable.

Si ya estás utilizando nuestro Viz Social Plugin, si se instaló antes del 20 de abril de 2018, debes actualizarlo a la última versión.


Para obtener información adicional sobre la integración con Vizrt, haz clic aquí.

  • Pasos de integración (2): Desde aquí podrás acceder al XML, JSON o encontrarás los pasos para realizar la integración de acuerdo a tu sistema de integración de contenido gráfico.

  • Versión (3): se refiere a la versión del Broadcast Data Source. Recomendamos usar siempre la versión más alta del menú desplegable. Por favor revisa este artículo‍ para mayor información.

  • Conectar con Middleware (4): habilítalo, elige tu middleware del menú desplegable y busca la ruta de destino donde el archivo o la base de datos están siendo escritos en tu unidad de destino por el middleware.

3. Previsualizando el Data Source de Mecánicas

Una vez que hayas guardado la configuración del Data Source de mecánicas, puedes obtener una vista previa de tus datos. Ten en cuenta que esta información no se actualiza en tiempo real, por lo que debes actualizar la ventana para ver los últimos resultados.


4. Integración XML

4.1 Ejemplo y descripción de campos

4.1.1 Ejemplo XML

<mechanic>
  <widgetId>33847</widgetId>
  <title>WHO WAS THE WINNER OF THE SHOW?</title>
  <mechanicId>5e853daf45340632af76aae5</mechanicId>
  <callToAction></callToAction>
  <status>live</status>
  <currentPollId>d5876bbd-9629-45a4-a7da-351ff7bd9ebf</currentPollId>
  <currentPollName>WHO WAS THE WINNER OF THE SHOW?</currentPollName>
  <updatedAt>2020-04-15T22:45:32Z</updatedAt>
  <options>
    <option>
      <id>b1211b54-be80-433f-8ed6-daaa1ebd7e6c</id>
      <name>ALAN</name>
      <isCorrect>false</isCorrect>
      <pollId>d5876bbd-9629-45a4-a7da-351ff7bd9ebf</pollId>
      <pollName>WHO WAS THE WINNER OF THE SHOW?</pollName>
      <pollStatus>live</pollStatus>
      <pollType>quick_poll</pollType>
      <votingType>scoringresult</votingType>
      <total>5</total>
      <percentage>33.4</percentage>
      <average>0.0</average>
      <formattedTotal>5</formattedTotal>
      <formattedPercentage>33.4</formattedPercentage>
      <formattedAverage>0.0</formattedAverage>
      <integrationId></integrationId>
      <image>https://s3-assets2.flowics.com/web/uploads/production/generic-resources/asset/65003/versioned_cc5a71ec58a846a0ba5e7a283fa2ed5e.jpg</image>
      <localImagePath>/path/to/image.jpg</localImagePath>
      <ranking>0</ranking>
    </option>
  
    <option>
      <id>f55a01c2-d4d5-4e91-bc37-645d1dc4858d</id>
      <name>ALEX</name>
      <isCorrect>false</isCorrect>
      <pollId>d5876bbd-9629-45a4-a7da-351ff7bd9ebf</pollId>
      <pollName>WHO WAS THE WINNER OF THE SHOW?</pollName>
      <pollStatus>live</pollStatus>
      <pollType>quick_poll</pollType>
      <votingType>scoringresult</votingType>
      <total>5</total>
      <percentage>33.3</percentage>
      <average>0.0</average>
      <formattedTotal>5</formattedTotal>
      <formattedPercentage>33.3</formattedPercentage>
      <formattedAverage>0.0</formattedAverage>
      <integrationId></integrationId>
      <image>https://s3-assets1.flowics.com/web/uploads/production/generic-resources/asset/65004/versioned_5aaa31fc8ec5a856acffd916131b96fe.jpg</image>
      <localImagePath>/path/to/image2.jpg</localImagePath>
      <ranking>1</ranking>
    </option>
  
    <option>
      <id>d8141870-c3a4-421e-bd75-ed87f11bad63</id>
      <name>MACARENA</name>
      <isCorrect>true</isCorrect>
      <pollId>d5876bbd-9629-45a4-a7da-351ff7bd9ebf</pollId>
      <pollName>WHO WAS THE WINNER OF THE SHOW?</pollName>
      <pollStatus>live</pollStatus>
      <pollType>quick_poll</pollType>
      <votingType>scoringresult</votingType>
      <total>5</total>
      <percentage>33.3</percentage>
      <average>0.0</average>
      <formattedTotal>5</formattedTotal>
      <formattedPercentage>33.3</formattedPercentage>
      <formattedAverage>0.0</formattedAverage>
      <integrationId></integrationId>
      <image>https://s3-assets1.flowics.com/web/uploads/production/generic-resources/asset/65005/versioned_59ec2bf41a1cd7ce7e056cd71702f2fd.jpg</image>
      <localImagePath>/path/to/image3.jpg</localImagePath>
      <ranking>2</ranking>
    </option>
  </options>
</mechanic>


4.1.2 Descripción de los campos

Ten en cuenta que algunos nombres de campo cambian cuando se utiliza el tipo de integración Avid Maestro.

Campo Descripción Field (integración Avid Maestro)
Mechanic.widgetId Id del widget mechanic.widgetId
mechanic.title La pregunta configurada en la configuración general del widget. mechanic.title
mechanic.mechanicId Id de la Mecánica. mechanic.
mechanicId
mechanic.callToAction Expone el conjunto de datos en el campo de call to action en la configuración general del widget. Normalmente se usa para indicar a dónde debe ir la audiencia para participar. mechanic.
callToAction
mechanic.status Hay 3 estados:
  • abierto: La audiencia puede participar en la encuesta enviando sus votos.
  • cerrado: La audiencia no puede seguir votando.
  • standby: La Poll está programada para realizarse.
mechanic.
status
mechanic.
currentPollId
Id de la poll. mechanic.
currentPollId
mechanic.
currentPollName
El nombre de la poll. mechanic.
currentPollName
mechanic.
updatedAt
Última fecha de modificación del widget Data Source mechanic.
updatedAt
mechanic.options.
option.id
Id de la opción. mechanic.
options.option.idX
mechanic.options.
option.name
Nombre de la opción mechanic.options.
option.nameX
mechanic.options.
option.isCorrect
Opción correcta en la poll. mechanic.options.
option.isCorrectX
mechanic.options.
option.pollId
Id de la poll. mechanic.options.
option.pollIdX
mechanic.options.
option.pollName
Nombre de la poll. mechanic.options.
option.pollNameX
mechanic.options.
option.pollStatus
Estado de la poll. Puede estar abierto o cerrado. mechanic.options.
option.pollStatusX
mechanic.options.
option.pollType
Tipo de Poll . mechanic.options.
option.pollTypeX
mechanic.options.
option.votingType
Tipo de voto. Puede ser solo para votar por única vez o una vez al día. mechanic.options.
option.votingTypeX
mechanic.options.
option.total
Expone la cantidad total de votos que ha recolectado la opción. mechanic.options.
option.totalX
mechanic.options.
option.percentage
Expone el porcentaje en relación a la cantidad total de votos recolectados. mechanic.options.
option.percentageX
mechanic.options.
option.average
Expone el promedio en relación a la cantidad total de votos recolectados. mechanic.options.
option.averageX
mechanic.options.
option.formattedTotal
Similar a poll.items.item.total,pero el número se formateará de acuerdo con la configuración local solicitada (con separador de miles agregado). mechanic.options.
option.
formattedTotal
mechanic.options.option.
formattedPercentage
Similar a poll.items.item.percentage,pero el número se formateará de acuerdo con la configuración local solicitada (con separador de miles agregado).  mechanic.options.
option.
formattedPercentage
mechanic.options.option.
formattedAverage
Similar al promedio,pero el número se formateará de acuerdo con la configuración local solicitada (con separador de miles agregado). mechanic.options.
option.
formattedAverage
mechanic.options.option.
integrationId
Id que un usuario puede asignar al Flow asociado al Widget para integrarse con sistemas externos. mechanic.options.
option.integrationId
mechanic.options.
option.image
URL de la imagen cargada por el usuario en la Mecánica. mechanic.options.
option.image
mechanic.options.
option.LocalImagePath
Ruta completa a la imagen descargada. mechanic.options.
option.
LocalImagePath
mechanic.options.option.
ranking
Refleja la posición asignada para cada opción. Esta va desde cero que representa un mayor número de votos que el uno, este a su vez es mayor que el dos y así sucesivamente. mechanic.options.
option.ranking

5. Integración de bases de datos

5.1 Descripción de las columnas

Cuando se utiliza este tipo de integración, se crea una tabla de base de datos con las siguientes columnas. El tipo de columnas es textual. Para el tipo específico, verifica la configuración del middleware, pero normalmente son texto para MySQL o PostgreSQL y ntext para Microsoft SQL Server.

Columna Descripción Columna (integración de Avid Maestro)
widgetId Id del widget. widgetId
title La pregunta configurada en la configuración general del widget. title
pollId Id de la Mecánica. pollId
isLive Su valor puede ser verdadero o falso.

Un artista gráfico puede utilizar este campo para controlar el comportamiento de la escena conectada a este Data Source, es decir, puedes mostrar u ocultar la encuesta en función de su valor.

isLive
status Hay 3 estados:
  • abierto: La audiencia puede participar en la encuesta enviando sus votos.
  • cerrado: La audiencia no puede seguir votando.
  • standby: La Poll está programada para realizarse.
status
updatedAt Última fecha de modificación del widget Data Source. updatedAt
callToAction Expone el conjunto de datos en el campo de call to action en la configuración general del widget. Normalmente se usa para indicar a dónde debe ir la audiencia para participar. callToAction
id Id que un usuario puede asignar al Flow asociado al Widget para integrarse con sistemas externos. integrationId
total Expone la cantidad total de votos que ha recolectado la opción. totalX
percentage Expone el porcentaje en relación a la cantidad total de votos recolectados. percentageX
formattedTotal Similar al total,pero el número se formateará de acuerdo con la configuración local solicitada (con separador de miles agregado). formattedTotal
formattedPercentage Similar a percentage, pero el número se formateará de acuerdo con la configuración local solicitada (con separador de miles agregado).  formattedPercentage
image URL de la imagen cargada por el usuario en la Mecánica. image
ranking Refleja la posición asignada para cada opción. Esta va desde cero que representa un mayor número de votos que el uno, este a su vez es mayor que el dos y así sucesivamente. ranking

6. Integración de archivos JSON

6.1 Ejemplo y descripción de campos

6.1.1 Ejemplo JSON

 {
   " widgetId " : 34312 ,
   " title " : " Mechanic s " ,
   " cta " :  Vaya a www.sports.com para enviar su voto! " ,
   " updatedAt " : " 2020-10-08T16: 18: 03Z " ,
   " mecánico " : {
      " id " : " 5f7b2e679570bc6e084a099d " ,
      " status " : "en vivo " ,
      " actual " : " 043714a7-7052-4348-bb03-8ff2626d69f7 " ,
      " elementos " : [
         {
            " id " : " 043714a7-7052-4348-bb03-8ff2626d69f7 " ,
            " type " : " quick_poll " ,
            " status " : "en vivo " ,
            " voteMode " : " simple_mode " ,
            " pregunta " : "¿ QUIÉN FUE EL JUGADOR DEL PARTIDO? " ,
            " opciones " : [
               {
                  " id " : " acd560e1-1358-4b1a-a6cb-8dad858eab06 " ,
                  " nombre " : " DYBALA " ,
                  " integrationId " : nulo ,
                  " imagen " : " https://s3-assets1.flowics.com/web/uploads/production/generic-resources/asset/85978/versioned_ea3600c8b32484ce4756958e768cb7dd.png " ,
                  " ranking " : 0 ,
                  " total " : 0 ,
                  " formattedTotal " : " 0 " ,
                  " porcentaje " : 25 ,
                  " formattedPercentage " : " 25 " ,
                  " promedio " : 0 ,
                  " formattedaverage " : " 0 " ,
                  " localImagePath " : " C: \\ Midlleware test \\ media \\ https \\ s3-assets1.flowics.com \\ 83f1c3dfcf3a1a66a3ee666d417bc718916eea70.png "
               } ,
               {
                  " id " : " 5b4d975f-34f8-466d-9419-6148ee48ab45 " ,
                  " nombre " : " GOMEZ " ,
                  " integrationId " : nulo ,
                  " image " : " https://s3-assets0.flowics.com/web/uploads/production/generic-resources/asset/85980/versioned_967afcc89c0179d9164a5ab7f930147b.png " ,
                  " ranking " : 1 ,
                  " total " : 0 ,
                  " formattedTotal " : " 0 " ,
                  " porcentaje " : 25 ,
                  " formattedPercentage " : " 25 " ,
                  " promedio " : 0 ,
                  " formattedaverage " : " 0 " ,
                  " localImagePath " : " C: \\ Prueba de Midlleware \\ media \\ https \\ s3-assets0.flowics.com \\ e849cca0140df07acb0d978714ff3b0dfcff65df.png "
               } ,
               {
                  " id " : " 9604d21b-8d70-4b4c-81a9-342d3aa4c7db " ,
                  " nombre " : " ZAPATA " ,
                  " integrationId " : nulo ,
                  " imagen " : " https://s3-assets2.flowics.com/web/uploads/production/generic-resources/asset/85981/versioned_e75b4da69d3fb07303ade0ae91a788a2.png " ,
                  " ranking " : 2 ,
                  " total " : 0 ,
                  " formattedTotal " : " 0 " ,
                  " porcentaje " : 25 ,
                  " formattedPercentage " : " 25 " ,
                  " promedio " : 0 ,
                  " formattedaverage " : " 0 " ,
                  " localImagePath " : " C: \\ Prueba de Midlleware \\ media \\ https \\ s3-assets2.flowics.com \\ 56f09b77ffc3758945c1be9fcc356bec9578bb56.png "
               } ,
               {
                  " id " : " 0651ee62-a728-4b70-bd47-050250356a62 " ,
                  " nombre " : " RONALDO " ,
                  " integrationId " : nulo ,
                  " image " : " https://s3-assets0.flowics.com/web/uploads/production/generic-resources/asset/85979/versioned_e5aead5801320ee2887794744de733b9.png " ,
                  " ranking " : 3 ,
                  " total " : 0 ,
                  " formattedTotal " : " 0 " ,
                  " porcentaje " : 25 ,
                  " formattedPercentage " : " 25 " ,
                  " promedio " : 0 ,
                  " formattedaverage " : " 0 " ,
                  " localImagePath " : " C: \\ Midlleware test \\ media \\ https \\ s3-assets0.flowics.com \\ c1fdcd2d780340590ea5ff91e6827efc20896aa7.png "
               }
            ]
         }
      ]
   }
}

6.1.2 Descripción de los campos

Campo
Descripción
widgetId
Id del widget
title Título de la mecánica, según lo configurado en el widget.
cta Call to Action
updatedAt Fecha y hora de la última modificación del Data Source(no los datos en sí). Formato ISO8601.
Mechanic.id Id de la Mecánica .
mechanic.status Hay 3 estados:
  • abierto: La audiencia puede participar en la encuesta enviando sus votos.
  • cerrado: La audiencia no puede seguir votando.
  • standby: La Poll está programada para realizarse.
mechanic.current Id de la mecánica actual (participación).
Mechanic.items.id Id del item.
mechanic.items.type Tipo de Mecánica
mechanic.items.status Hay 3 estados:
  • abierto: La audiencia puede participar en la encuesta enviando sus votos.
  • cerrado: La audiencia no puede seguir votando.
  • standby: La Poll está programada para realizarse.
mechanic.items.votingMode Modo de votación de la Mecánica
mechanic.items.question Es la pregunta de la Mecánica.
mechanic.items.options.id Id de la opción.
mechanic.items.options.name Nombre de la Mecánica .
mechanic.items.options.integrationId Id que un usuario puede asignar al Flow asociado al Widget para integrarse con sistemas externos.
mechanic.items.options.image URL de la imagen cargada por el usuario en la Mecánica.
Mechanic.items.options.localImagePath Ruta completa a la imagen descargada.
mechanic.items.options.ranking Refleja la posición asignada para cada opción. Esta va desde cero que representa un mayor número de votos que el uno, este a su vez es mayor que el dos y así sucesivamente.
mechanic.items.options.total Expone la cantidad total de votos que ha recolectado la opción.
mechanic.items.options.formattedTotal Similar a mechanic.items.options.total, pero el número se formateará de acuerdo con la configuración local solicitada (con separador de miles agregado).
mechanic.items.options.percentage Expone el porcentaje en relación a la cantidad total de votos recolectados.
mechanic.items.options.formattedPercentage Similar a mechanic.items.options.percentage, pero el número se formateará de acuerdo con la configuración local solicitada (con separador de miles agregado). 
mechanic.items.options.average Expone el promedio en relación a la cantidad total de votos recolectados.
mechanic.items.options.formattedaverage Similar al promedio, pero el número se formateará de acuerdo con la configuración local solicitada (con separador de miles agregado).

Was this article helpful?