Este tipo de Middleware 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, Story.
1. Configuración general
Nombre (1): Como buena práctica recomendamos nombrar tu Middleware 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)
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
Integración Vizrt
Las integraciones con Vizrt se pueden realizar a través de:
Flowics Middleware + Data Reader, elige otros del menú desplegable.
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 Middleware Source. Recomendamos usar siempre la versión más alta del menú desplegable.
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 Middleware Source de Mecánicas
Una vez que hayas guardado la configuración del Middleware 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.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. |
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. |
mechanic.status | Hay 3 estados:
| mechanic. |
mechanic. | Id de la poll. | mechanic. |
mechanic. | El nombre de la poll. | mechanic. |
mechanic. | Última fecha de modificación del widget Middleware Source | mechanic. |
mechanic.options. | Id de la opción. | mechanic. |
mechanic.options. | Nombre de la opción | mechanic.options. |
mechanic.options. | Opción correcta en la poll. | mechanic.options. |
mechanic.options. | Id de la poll. | mechanic.options. |
mechanic.options. | Nombre de la poll. | mechanic.options. |
mechanic.options. | Estado de la poll. Puede estar abierto o cerrado. | mechanic.options. |
mechanic.options. | Tipo de Poll . | mechanic.options. |
mechanic.options. | Tipo de voto. Puede ser solo para votar por única vez o una vez al día. | mechanic.options. |
mechanic.options. | Expone la cantidad total de votos que ha recolectado la opción. | mechanic.options. |
mechanic.options. | Expone el porcentaje en relación a la cantidad total de votos recolectados. | mechanic.options. |
mechanic.options. | Expone el promedio en relación a la cantidad total de votos recolectados. | mechanic.options. |
mechanic.options. | 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. |
mechanic.options.option. | 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. |
mechanic.options.option. | Similar al promedio,pero el número se formateará de acuerdo con la configuración local solicitada (con separador de miles agregado). | mechanic.options. |
mechanic.options.option. | Id que un usuario puede asignar al Flow asociado al Widget para integrarse con sistemas externos. | mechanic.options. |
mechanic.options. | URL de la imagen cargada por el usuario en la Mecánica. | mechanic.options. |
mechanic.options. | Ruta completa a la imagen descargada. | mechanic.options. |
mechanic.options.option. | 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. |
5. Integración de bases de datos
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 Middleware Source, es decir, puedes mostrar u ocultar la encuesta en función de su valor. | isLive |
status | Hay 3 estados:
| status |
updatedAt | Última fecha de modificación del widget Middleware 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.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 Middleware Source(no los datos en sí). Formato ISO8601. |
Mechanic.id | Id de la Mecánica . |
mechanic.status | Hay 3 estados:
|
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:
|
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). |